Updating

IBM® Installation Manager updates the MobileFirst Quality Assurance product, and also the operating system and software components.

Before you begin

Important: Take a snapshot of the VM.
When you apply an update to MobileFirst Quality Assurance, one or more of the server configuration files might be overwritten. If you customized any configuration files, it might be necessary to reapply the customizations after the update. Track, verify, and reapply, if necessary, any changes to the server configuration files after the update.
Stop MobileFirst Quality Assurance. See Stopping MobileFirst Quality Assurance for instructions on how to stop the server.

About this task

Updates can include changes in product code, changes to prerequisite services or libraries, or database migrations. Updates are cumulative, which means that they depend on earlier updates. The update procedure automatically handles such dependencies and migrations.

Installation Manager can process updates online from the service repository.

Tip: The following instructions assume that Installation Manager is updating over the Internet. If you are updating from downloaded files, an Internet connection is still required. Also, ensure that you download updates to Installation Manager.

For more information about Installation Manager, see www.ibm.com/support/knowledgecenter/SSDV2W. See the "Working in console mode" topics.

Important: Rollback is not supported.

If you are updating from an earlier version of MobileFirst Quality Assurance, you must first add remote repositories to enable Installation Manager to find the updates.

To update MobileFirst Quality Assurance, complete the following steps:

Procedure

Add the remote repositories to enable Installation Manager to find the updates.
1. Log in as root.
2. Change to the /opt/IBM/InstallationManager/eclipse/tools directory and start IBM Installation Manager in console mode by entering the following command:
```
./imcl –c
```
  Installation Manager starts in console mode.
3. Select option P. Preferences.
4. Select option 1. Repositories.
5. Select option D. Add Repository.
6. Enter the following repository URL to update MobileFirst Quality Assurance: https://www-912.ibm.com/software/repositorymanager/service/com.ibm.rational.wqa/.
7. Enter your IBM ID credentials:
  1. Select option P. Provide credentials and connect.
  2. Enter your user name.
  3. Enter your password.
  4. (Optional) Enter 1 to save your credentials.
8. Update the Red Hat Enterprise Linux product by repeating steps 1.e - 1.g, but enter the following repository URL: https://www-912.ibm.com/software/repositorymanager/service/com.ibm.rational.wqa.redhatUpdate/.
9. Select option A. Apply changes and return to Preferences menu.
10. Select option R. Return to Main Menu.
From the list of actions, select 2. Update.
Select the 1. IBM MobileFirst Platform package group.
Select N. Next.
If your Installation Manager is not version 1.8.4 or later, you are prompted to update it. To update Installation Manager, complete the following steps:
1. When prompted to update Installation Manager, select Y. Yes. The message Updating Installation Manager is displayed.
2. When the update process is complete, select O. OK to restart it. Installation Manager restarts.
Repeat steps 2 - 4 for all of the available updates.
When all available updates are selected, select N. Next.
Enter U to install the updates.
Stop and restart the services by entering the following command from the /opt/IBM/WQA/Apphance/setup directory:
```
fab -H utest@mqa-host.example.com restart_supervisor
```
Configure your SSL certificate to be trusted if you are not using a public certificate.
1. Connect to the 7.0 MobileFirst Quality Assurance development server by using SSH, if you are not already connected.
2. Go to the /home/utest/apphance/etc/pki directory.
3. Copy the contents of the certificate file to the clipboard, including the lines that indicate the beginning and the end of the certificate. The certificate file has a .crt extension.
4. Go to the /home/utest/apphance/env/lib/python2.7/site-packages/requests directory.
5. Paste the certificate information at the end of the cacert.pem file.
6. Restart the MobileFirst Quality Assurance server by entering the following command from the /opt/IBM/WQA/Apphance/setup directory:
```
fab -H utest@mqa-host.example.com restart_supervisor
```

What to do next

If you have to migrate existing data to version 7.0, continue with Migrating data to version 7.0.
If you are not migrating content, then continue with step 6 in Upgrading and migrating.