Upgrading the server from version 5

To upgrade the server from version 5 to version 6.0 or later, use IBM® Installation Manager.

Before you begin

Download and extract the files for IBM UrbanCode Release to a directory that contains no spaces or double-byte characters. These files are available for download from the IBM Passport Advantage® website. See the IBM UrbanCode Release download document.

Procedure

  1. Stop the server.
  2. Start IBM Installation Manager. IBM Installation Manager was used to install version 5; the default location is /opt/IBM/InstallationManager/eclipse on Linux or C:\Program Files\IBM\Installation Manager\eclipse on Windows.
  3. In IBM Installation Manager, click File > Preferences.
  4. Click Repositories.
  5. Click Add Repository.
  6. In the Add Repository window, select the file diskTag.inf, which is in the UCR/disk1 folder in the launchpad files.
  7. Click OK to close the Add Repository window and then click OK to close the Preferences window.
  8. Click Update.
  9. Select the package group that includes IBM uRelease 5.0, as shown in the following figure, and then click Next:
    Selecting the package group that contains IBM uRelease 5.0
  10. Ensure that the appropriate version of IBM UrbanCode Release is selected, as shown in the following figure, and then click Next:
    Selecting the new version of the product
  11. On the Licenses page, read and accept the license agreements for the selected products. If you agree to the terms of all of the license agreements, click I accept the terms in the license agreement and then click Next.
  12. Ensure that the appropriate version of IBM UrbanCode Release is selected and then click Next.
  13. If you are upgrading to version 6.1 or later, select the default language for the server and then click Next. After installation, each user can select a language; see Setting the language for the server.
  14. If you are upgrading to version 6.0 or later, on the licensing settings page, in the License server elements field, specify the port and host name for the license server, such as 27000@localhost. Then, click Next. For more complicated license server scenarios, see the following document: http://pic.dhe.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/r_specify_lic_servers.html. This page is not shown if you are upgrading to version 5.
  15. Optional: If you are upgrading to version 6.1 or later, to set up a mail server for sending notifications, specify the information for an SMTP server and then click Next. For more information about the properties on this page, see Configuring email notifications for deployments.
  16. On the file backup page, read the warnings and follow the instructions for backing up your files.
  17. Click Next.
  18. Click Update. The location of the server.properties file varies depending on your 5.x environment:
    • If you upgraded from 4.x to 5.x, server.properties is in the /user_home/.urbancode folder.
    • If you installed 5.x by using an existing WAR file, server.properties is in the /user_home/.ibm folder.
    • If you installed 5.x by using a new Tomcat instance, server.properties is in the /installation_directory/UCRelease folder.
  19. Start the server.

Feedback