Upgrading the server

To upgrade the server, stop the server and run the new installation program. These instructions apply to upgrades to versions 6.0 and later.

Before you begin

If you are upgrading from a version prior to version 4.8.5, upgrade the server to version 4.8.5 before following these upgrade instructions.

If you are upgrading from version 4.8.5 or later but prior to 6.0, migrate the security before you upgrade the server. See Migrating security from previous versions.

About this task

You can upgrade the server to version 6.0 or later from versions 4.8.5 or 5.0. If you use a version prior to version 4.8.5, you must upgrade to 4.8.5 first.

Procedure

  1. Download and extract the installation files for IBM UrbanCode Deploy. These files are available for download from the IBM Passport Advantage® website. See the IBM UrbanCode Deploy download document.
  2. Stop the server.
  3. From the command line, run the installer program.
    • On Windows, run the install-server.bat file.
    • On Linux, run the install-server.sh file.
    • To install a FIPS-compliant server, add the switch -fips to the command, such as install-server.sh -fips .
      Note: If you install a FIPS-compliant server, cloud provisioning is not available.
    Depending on your system settings, you might need to run this file as an administrator.
  4. Read the license agreements for the software package. Press Enter to show one page at a time, or press F and then press Enter to show the entire license at once.
  5. If you agree to the terms of all of the license agreements, press Y and then press Enter.
  6. At the prompt that says Enter the directory where the IBM UrbanCode Deploy server should be installed., specify the folder of the existing installation and press Enter.
  7. At the prompt that says A previous version exists in the specified directory. Do you want to upgrade the currently installed version? press Y and then press Enter.
  8. Verify that the server is stopped and then press Enter to start the upgrade process.
  9. Start the server and verify that the server has been migrated.
  10. Ensure that licensing is set up for the server. See Managing licenses.

What to do next

When you run the server for the first time, you might see an error message that says that no agent or tag is configured to import new component versions. To make this error go away, you must specify a default agent or agent tag to use when importing component versions. You can override this default setting when you create a component. Follow these steps to specify a default agent or agent tag:
  • To specify a default agent, click System > System Settings and under General Settings, clear the Use Agent Tag For Integration check box. Then, select an agent in the Agent for Version Imports list. Then, at the bottom of the page, click Save.
  • To specify a default agent tag, click System > System Settings and under General Settings, clear the Use Agent Tag For Integration check box. Then, select an agent tag in the Agent Tag for version imports list. Then, at the bottom of the page, click Save. If no tags are listed add a tag to one or more agents on the server.

Feedback