To upgrade from CentraSite 9.0 to 9.6 using overinstallation, you must perform the following high-level steps:
Back up the entire webMethods installation directory.
Apply the latest fix to CentraSite using the instructions in the fix readme. Fixes and their readmes are available from the Software AG Knowledge Center.
Start the CentraSite Registry Repository. Depending on the previous fix level and the content of the Registry Repository, the startup process might take some time.
Create a backup of the internal database in which CentraSite's registry and repository data is stored. You may create the backup in the default backup location or in a different location.
Before you execute the inoadmin backup command, you must perform the following:
Execute the centrasite_setenv.cmd script file (for Windows) or the centrasite_setenv.sh script file (for UNIX) before you execute the inoadmin backup command.
Shutdown the CentraSite Registry Repository and Software AG Runtime that are running on the machine on which you are going to overinstall.
Create the backup in the default backup location, using the following command:
inoadmin backup CentraSite
- OR -
Create the backup in a location other than the default backup location, using the following command:
inoadmin backup CentraSite <Location>
where <Location> is the path where the backup will be created, for example:
inoadmin backup CentraSite C:\SoftwareAG\AnotherBackupLocation
Note:
The location you specify must exist already, otherwise the backup will not run.
Shut down all non-Software AG applications that are running on the machine on which you are going to overinstall. If these applications are not shut down, product files might become corrupted.
If the products are not shut down, the installer will not be able to update key files that are locked by the operating system. For a UNIX system, use the instructions in the product documentation. For a Windows system:
Shut down products running as services from the Windows Services window. Services are listed as Software AG product release.
Shut down products running as applications from the Windows Start menu. Products are listed as .
Note:
During overinstallation, if the installer finds Software AG products
still running in the target installation directory, it will prompt you to shut
them down.
If you used Command Central to manage CentraSite 9.0, you installed Platform Manager and Platform Manager plug-ins for 9.0 in the same directory as CentraSite 9.0. If you would like to use Platform Manager and Platform Manager Plug-ins for 9.6, you must uninstall the existing Platform Manager and Platform Manager Plug-ins for 9.0, before you overinstall CentraSite 9.6. This is because the Platform Manager and its plug-ins do not support overinstallation.
Follow the instructions in Using the Software AG Installer and Installing webMethods Products 9.0 to uninstall CentraSite 9.0, with the additional guidelines below.
Log on to the machine that hosts CentraSite 9.0 as the same user that installed CentraSite 9.0.
If you are uninstalling on a UNIX machine, and you did not use the sudo password when you installed 9.0, execute the old_installation_directory/bin/beforeUninstallAsRoot
script.
Start the Software AG Uninstaller.
On the product tree, choose to uninstall the Platform Manager and the Platform Manager Plug-ins for 9.0.
Continue through the uninstaller until uninstallation is complete.
If the CentraSite Registry Repository and Software AG Runtime are on different machines, overinstall the Registry Repository before you overinstall the Software AG Runtime.
Follow the instructions in Using the Software AG Installer and Installing webMethods Products 9.6 to install CentraSite 9.6, with the additional guidelines below.
Log on to the machine that hosts CentraSite 9.0 as the same user that installed CentraSite 9.0.
If you are installing on a UNIX machine, and you did not use the sudo password when you installed 9.5, check whether a file named
afterInstallAsRootLog.txt exists in the Software AG installation directory. If
it does, execute the
old_installation_directory/bin/beforeInstallAsRoot
script.
Start the Software AG Installer.
For installation directory, specify the installation directory that contains CentraSite 9.0.
On the product tree, existing products are shown in gray followed by the word "Installed" (wizard mode) or the letter "I" (console mode). Perform the following steps to overinstall CentraSite 9.6:
Select CentraSite 9.6.
If you want to use Command Central to manage CentraSite, select Platform Manager and Platform Manager Plug-ins for CentraSite 9.6.
Note:
However, if you have the Platform Manager and Platform Manager Plug-ins for CentraSite 9.0 installed in the same machine,
on overinstallation, the installLog.txt will contain the APP_ERRORs resulting from the OSGiProfileImpl, NERV and OSGI. Generally, you can ignore these errors.
If you installed a language pack for the previous version, CentraSite will use the old language pack after the overinstallation.
Note:
You can overinstall this language pack when the 9.6 language pack
becomes available. For language pack availability, go to Software AG Empower
Product Support website, then go to .
On the CentraSite panel, specify the full path to the CentraSite license file.
After you finish upgrading CentraSite on UNIX machine, if you did not use the sudo password, execute the new_installation_directory/bin/afterInstallAsRoot script.
Modify product files or assets to accommodate changes to product behavior, services, parameters, properties, or APIs in the 9.6 release. For detailed information about these changes, read the product readme, available on the Software AG Documentation website. Also read the product release notes to understand new functionality.
Start the CentraSite Registry Repository.
On Windows, the CentraSite Registry Repository runs as a Windows service. You can use the Windows Services application that is provided with the operating system to start the service.
For other operating systems, and as an alternative method on Windows, you can start the CentraSite Registry Repository from the command line:
inoadmin start CentraSite
You can also use Command Central to start the CentraSite Registry Repository. The CentraSite Registry Repository is listed as a process in the instances list of your chosen Command Central environment, and you can use standard operations in the Command Central interface to start the process. Refer to the Command Central Help guide for details.
Note:
Depending on the previous release and the content of the CentraSite Registry Repository, the startup process might take some
time.
