Upgrade Command Central
When you upgrade Command Central, these configurations and data are migrated for Command Central:
Binary cache.
Composite templates.
Credentials.
Port, SSO, proxy, environment, JAAS, LDAP, and outbound SSL configurations.
HTTPS, LDAP, and SSO certificates.
License reports.
Local mirror and image repositories.
Users, groups, and roles, and password manager data.
Any Java system properties that have been customized from the defaults.
Command Central bootstrap installers.
These configurations and data are migrated for the Platform Manager that is installed with Command Central:
Port, SSO, and proxy configurations.
HTTPS and SSO certificates.
Users, groups, and roles, and password manager data.
Any Java system properties that have been customized from the defaults.
Follow the instructions below to upgrade.
1. If you are going to install the new Command Central on a different machine than the old Command Central, create a ZIP file of the old Command Central. These instructions use the Java Archive tool to create the ZIP file.
a. Go to the old Command Central machine and stop Command Central.
b. In the JAVA_HOME and PATH system variables, specify the location of the Java Archive tool as Software AG_directory\jvm\jvm\bin.
Note:
On some systems, the lower-level jvm directory name includes additional information, such as \jvm\jvm160_32, or \jvm\jvm170, or \jvm\jvm_64.
c. Open a command window or shell and go to the Software AG directory that contains the old Command Central.
d. If you want to reduce the size of the ZIP file, move the log files out of the old_Software AG_directory\profiles\CCE\logs and SPM\logs directories.
e. Enter this command:
jar cfM ZIP_file common\conf profiles\CCE profiles\SPM install\products
f. Copy the ZIP file to any directory on the new Command Central machine.
Important:
If using FTP to copy, use the binary file transfer mode\type. If you use another mode\type, the ZIP file might become corrupted.
2. Use the Command Central bootstrapper to install Command Central and to migrate configuration files from the old installation to the new installation. Follow the instructions in the topic in this help for installing Command Central with the additional guidelines below.
Specify the argument
-m full_path_to_old_Command Central_dir_or_ZIP_file.
You must specify the argument
-p password by providing the administrator user password of the source
Command Central. After completing the upgrade, you can change the password by following the steps in
Change or Reset the Command Central Administrator Password.
Software AG recommends that you change the
Command Central administrator user password periodically.
9.12 and higher: If you want to use the same ports for the new
Command Central that you used for the old one, do not specify the -c and -C port arguments; the bootstrapper will migrate the port configurations and HTTPS and SSO certificates. If you want to use new ports for the new
Command Central, specify the -c and -C port arguments; the bootstrapper will not migrate any port information.
Important:
Command Central migration automatically migrates the local Platform Manager port configurations. However, if you provide new port values for the local Platform Manager using the -s and -S port arguments, Platform Manager will appear offline and any mirror repositories that were migrated will not work. You will have to specify the new ports in the new Command Central to bring Platform Manager online, and fix the mirror repositories by running the command sagcc update repository products mirror repository_name location=new_repository_URL.
3. 9.7 upgrade: If you set a custom password for Platform Manager, set the custom password for the new Platform Manager. To do so, in the new Command Central, on the Instances tab, click the new Platform Manager (SPM), then click next to Authentication on the Overview tab.