Upgrade: Stop all Worklight Server instances
Before you complete subsequent upgrade steps, you must shut down all Worklight runtime environments. You must also disable the auto start mode of the Worklight Console if you upgrade from IBM Worklight v6.0.0.x on WebSphere Application Server full profile.
About this task
If we installed Worklight Server on multiple servers, whether networked or not, stop all Worklight runtime environments before you move on to the next steps.
You must do so even if you installed only one Worklight runtime environment.
This step is mandatory because in step Upgrade the runtime and reports databases, you upgrade the schema of the databases so that it can be used with MobileFirst Server v6.3.0. No database schema can be upgraded while a Worklight runtime environment is running.
After the database is upgraded, only upgraded MobileFirst runtime environments can run, because only upgraded applications can read and write to the new databases. Alternatively, the database might be corrupted.
| Is this step required for the upgrade path? | System status after this step, if both Application Center and MobileFirst Server are on the same application server | |||||
|---|---|---|---|---|---|---|
| Worklight Server V5.0.6.x to MobileFirst Server v6.3.0 | Worklight Server v6.0.x to MobileFirst Server v6.3.0 | Worklight Server v6.1.x to MobileFirst Server v6.3.0.x | Worklight Server v6.2.x to MobileFirst Server v6.3.0 | v6.3.0 to v6.3.0.x (fix pack or interim fix) | Application Center Status | MobileFirst Server Status |
| Yes | Yes | Yes | Yes | See the installation instructions for the fix pack or interim fix | Upgraded | Stopped (all instances) |
Important: In addition to stopping all Worklight runtime environments, if you upgrade from IBM Worklight v6.0.0.x on WebSphere Application Server full profile, you must also disable the auto start mode of the Worklight Console application during the upgrade before you shut down the Worklight Server. If the auto start mode is not disabled, the Worklight Console modifies the database when the server is started in step Upgrading the MobileFirst runtime environment for MobileFirst Server v6.3.0 and prevents the new MobileFirst runtime environment from starting.
To disable the auto start mode:
- Log in to the WebSphere Console.
- Go to the menu Applications > Application Types > WebSphere enterprise applications, and list the applications.
- In the table, click Worklight Console application, whose default name is IBM_Worklight_Console.
- In Detail Properties click Target Specific Application Status.
- Select all the target servers, or the cluster where the application is installed.
- Click Disable Auto Start.
- Click Save to save the configuration.
- Verify that the Auto Start property in the table is set to No.
Figure 1.
Parent topic: Upgrading the MobileFirst runtime environment for MobileFirst Server v6.3.0