Registering web applications from the MobileFirst Operations Console

You can use the IBM MobileFirst™ Platform Operations Console to register your web application to an instance of MobileFirst Server.

Before you begin

Run the IBM MobileFirst Platform Operations Console on the same instance of MobileFirst Server to which you want to register your application. For information about how to install the MobileFirst Development Server and run the console, see Installing the IBM MobileFirst Platform Foundation Developer Kit.

Note: You can register an application to the server either before or after you set up your development environment and start developing the application. However, you must register your application before you can call the MobileFirst APIs from your client application and communicate with the server.

Procedure

  1. In the MobileFirst Operations Console, navigate to the Register Application page by using one of the following methods:
    • In the navigation sidebar, select New next to Appilcations.
      Console navigation-bar app-registration button
    • From the Dashboard, select Register an App.
      Console dashboard app-registration tile
  2. On the Register Application page, provide the required input for registering your web application, as demonstrated in the following image.
    App-registration console page
    1. In the Application Name field, optionally enter a display name for your application (for example, MyApplication). If you do not provide an application name, the application ID is used also as the display name.
    2. In the Choose Platform field, select Web.
    3. In the Application ID field, enter a unique identifier for your application (for example, com.example.myapplication).
      Note: The application ID that is provided during registration must be identical to the value of the applicationId initialization option that is set when initializing the web SDK. For more information, see Initializing the MobileFirst SDK.
  3. Select Register application to complete the registration.

Results

When the application is successfully registered to the target server, you can select it from the Applications section in the navigation sidebar of the MobileFirst Operations Console (under Versions or Web). The main application page displays different server-side configuration options for your application.

In the application Configuration Files console tab, you can see the content of the application's descriptor and runtime configuration files. The value of the applicationId in the application descriptor is the application ID that you specified when you registered the application.
Note: You cannot have multiple versions of the same web application. Therefore, the applicationKey object of the application descriptor does not contain a version property.

What to do next

You can proceed with other development tasks that depend on MobileFirst Server, such as making server-side configurations, testing the application's security features, and managing the application from the MobileFirst Operations Console.

Make sure to initialize the SDK from your application before calling any SDK APIs other than the initialization method. For more information, see Initializing the MobileFirst SDK.

Parent topic: Registering web applications to MobileFirst Server