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
- 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.
- Stop the server.
- From the command line, run the installer
program.
Depending on your system settings, you might need to run this
file as an administrator.
- 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.
- If you agree to the terms of all of the license
agreements, press Y and then press Enter.
- 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.
- 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.
- Verify that the server is stopped and then press Enter
to start the upgrade process.
- Start the server and verify that the server has been migrated.
- 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 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 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.