Upgrade Products
This topic must be used with Upgrading Software AG Products. To see which products support upgrade using Command Central, see the Software AG Command Central Feature Support Matrix. Also see Administering Software AG Products Using Command Central for any product-specific migration instructions.
Note: You do not have to upgrade Platform Manager.
If you need to upgrade multiple similar environments, you can set up composite templates that automate the upgrade (see the template instructions in this help). You can reconfigure endpoints such as host names and ports by adding commands after the migration section of the templates. You will still need to perform the manual tasks in Upgrading Software AG Products if you cannot script them.
If you need to upgrade only one environment, you can use Command Central for many upgrade tasks, as described below.
1. Read and follow the instructions in the first several chapters of Upgrading Software AG Products.
2. Use Command Central instead of Software AG Installer to install the new products.
Note: If Command Central managed the old product installation, the Command Central installation wizard offers an option that can auto-select the same set of products for the new installation.
3. Use Command Central instead of Software AG Update Manager to install the latest fixes on the new products described in Upgrading Software AG Products.
4. Use Command Central to shut down Software AG Runtime as instructed in Upgrading Software AG Products. Also disable automatic startup for the new products.
5. If Command Central did not manage the old products, use the instructions in Upgrading Software AG Products to prepare the old environment. If Command Central managed the old products, prepare the old environment as follows:
a. If you are upgrading products from 9.7 or later, use Command Central to install fixes on the old products listed in Upgrading Software AG Products.
b. Perform the other preparation tasks for the old products described in Upgrading Software AG Products. If you are upgrading Integration Server from 9.8 or later, you can pause the Integration Server instance in Command Central to suspend triggers and drain message queues.
c. Use Command Central to shut down the old product instances.
7. Use the Command Central sagcc exec administration command instead of the instructions in Upgrading Software AG Products to migrate database components. The command syntax is shown below. The parameters are the parameters you use when running the Database Component Configurator and are documented in Installing Software AG Products.
sagcc exec administration product DCC_node_alias DatabaseComponentConfigurator
database migrate [parm1=value1 ] [parm2=value2 ]...
In the examples below, the database components are on a SQL Server RDBMS at jdbc:wm:sqlserver://DBserver:1433;databaseName=TESTDB, and the database user is webmuser with password webmpass.
To upgrade
Integration Server database components from 9.9 to the latest release:
sagcc exec administration product local DatabaseComponentConfigurator
database migrate db.type=sqlserver product=IS version=latest
db.username=webmuser db.password=webmpass db.name=TESTDB
db.url=“jdbc:wm:sqlserver://DBserver:1433;databaseName=TESTDB”
To upgrade the
My webMethods Server database component to the latest release:
sagcc exec administration product local DatabaseComponentConfigurator
database migrate db.type=sqlserver component=MWS version=latest
db.username=webmuser db.password=webmpass db.name=TESTDB
db.url=“jdbc:wm:sqlserver://DBserver:1433;databaseName=TESTDB”
To check the progress of the migration in Command Central, click Jobs on the Command Central web user interface.
8. Upgrading Software AG Products provides product-specific migration chapters that describe pre-migration tasks to perform. Perform the tasks for all products you are going to migrate.
9. If you are going to install the new products on different machines than the old products, use Command Central instead of the instructions in Upgrading Software AG Products to create ZIP files of the old installations. Command Central automatically creates a ZIP file of each old installation directory. The ZIP file includes all files except .log files. If you want to decrease the size of the ZIP file, Upgrading Software AG Products lists the commands that will include only the required files for each product in the ZIP file.
10. Upgrading Software AG Products explains how to migrate your products.
Most products offer migration utilities that migrate their configurations, data, and assets, but some do not. To migrate products that do not offer migration utilities, follow the instructions in Upgrading Software AG Products.
For products that do offer migration utilities, Upgrading Software AG Products explains the actions that each product migration utility takes by default, but also provides instructions for creating customized migrations that can be called by the migration utilities instead.
Use Command Central instead of the instructions in Upgrading Software AG Products to run migration utilities. Use the Command Central command sagcc exec administration, shown below.
To find a product_ID to use in the command, run the command sagcc list inventory products node_alias.
If you want to migrate all instances, do not specify the instanceName option.
sagcc exec administration product product_node_alias
product_ID migration migrate
{srcDir|srcFile}=full_path_to_{old_Software AG_directory|ZIP file}
[instanceName name [,name ,name ...]]
[importFile=full_path_to_ migrate.dat]
[-cloneDbURL URL -cloneDbUser user -cloneDbPassword password]
To check the progress of the migration, click Jobs on the Command Central web user interface.
11. Upgrading Software AG Products provides product-specific migration chapters that describe post-migration tasks to perform. Perform the tasks for all products you migrated.
12. Perform the final upgrade tasks in the last chapter in Upgrading Software AG Products.