For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Troubleshooting an error when an application or an adapter is pushed to a MobileFirst Server

Symptoms

When we push an application or an adapter to a MobileFirst Server, a message reports the following error: Runtime '<YourRuntime>' is not available on this server.

Causes

All applications and adapters are pushed to a MobileFirst Server runtime. The runtime is defined by the MobileFirst server that is running. Before you push these applications and adapters to the MobileFirst Server, make sure the server is running. The error that you encountered indicates that the CLI cannot locate the associated runtime on the target MobileFirst Server.

The CLI cannot detect a runtime on a MobileFirst Server in the following cases:

• The MobileFirst Server is not running.
• No network connection is established between the system that runs the CLI and the MobileFirst Server.
• You have not deployed the runtime to the MobileFirst Server.

Resolving the problem

1. Confirm that the MobileFirst Server is running.

   Local MobileFirst Server

   1. Start your MobileFirst Server if it is not running.

   Remote MobileFirst Server

   1. Run the mfpdev server info command and identify the target remote server. Note the corresponding URL and Name values.
   2. Ping the host specified in the target server URL. Do not include the port or protocol. For example: ping remotehost.com. If the host is unreachable or the pings timeout, contact the server administrator to have the server started and verify that no network connectivity issues exist.
   3. Assuming the server is running, run the mfpdev server info <server> command, where <server> is the Name value from the previous mfpdev server info command.
   4. If the MobileFirst Server information is displayed, the MobileFirst Server is running. Otherwise, contact your server administrator to start the MobileFirst Server. For more information, enter mfpdev help server info on the IBM MobileFirst™ Platform Foundation command line interface.

2. If you know that the MobileFirst Server is running, confirm that the required runtime is installed and running on that MobileFirst Server. For both a local and remote server:
   1. Run the mfpdev server info command and identify the target remote server Name value. The local MobileFirst Server name is typically local.
   2. Run the mfpdev server info <server> command, where <server> is the Name value from step 2.a.
   3. Look at the command output and find the runtimes listed under the Runtime section.
   4. Determine whether you are pushing to one of the runtimes that are listed in step 2.c by looking at the log output of the push command. The log output should include the following information:

      Pushing app_name_or_adapter_name to server: 'server_url' 
      runtime:'runtime_name'.

   5. If you are not using one of the runtimes in step 2.c, complete one of the following steps:
      • Specify the name of the target runtime when you run the mfpdev app push command. Run the mfpdev help app push command for more information about how to specify the name of the runtime.
      • Change the runtime name in your app config by entering the following command:

        mfpdev app config runtime runtime_name

Parent topic: Develop the server side of a MobileFirst application