Installation Guides › Upgrade Guide › Upgrading from r12 › How to Migrate from r12.0 › Upgrade an r12.0 Policy Server › Run the SOA Security Gateway Configuration Upgrade Utility on Windows

Run the SOA Security Gateway Configuration Upgrade Utility on Windows

The SOA Security Gateway configuration upgrade utility takes an existing r12.0 Entity Store configuration file (entities.xml) and upgrades it for use with the r12.1 SOA Security Gateway.

To run the Configuration Upgrade Utility on Windows

1. Start the r12.0 SOA Security Gateway Configuration Manager and SOA Security Gateway (in that order) from their renamed install directories:
   1. Open a command prompt window.
   2. Navigate to the renamed r12.0 SOA Security Gateway Configuration Manager bin directory, SOA_HOME\SOASecurityGatewayCM.backup\win32\bin.
   3. Run the Configuration Manager startup script:

      soagatewayconfigmanager.bat
      

   4. Open another command prompt window.
   5. Navigate to the renamed r12.0 SOA Security Gateway bin directory, SOA_HOME\SOASecurityGateway.backup\win32\bin.
   6. Run the SOA Security Gateway startup script:

      soagateway.bat
      

2. Open a command prompt window and navigate to SOA_HOME\SOASecurityGateway\upgrade\win32.
3. Run the configuration upgrade utility:

   upgradeconfig.bat
   

4. When prompted to enter the location of the installation to upgrade, hit Enter to search for the renamed r12.0 SOA Security Gateway.

   The Update Utility searches for and displays a numbered list of possible r12.0 install directories.

5. When prompted to select the install to upgrade, type the numerical entry corresponding to the renamed r12.0 SOA Security Gateway install directory and hit Enter. For example, if the backup directory for the r12.0 SOA Security Gateway (C:\Program Files\CA\SOA Security Manager\SOASecurityGateway.backup by default) is listed as the second entry, type "2".
6. When asked whether you want to upgrade the configuration at http:localhost:8090/configuration/policies, type "y" and hit Enter.
7. When asked whether you want to push the configuration back to the originating SOA Security Gateway Configuration Manager, type "n" and hit Enter.
8. When prompted to enter a location for the newly upgraded entities-upgraded.xml file, hit Enter to accept the default (SOA_HOME\SOASecurityGateway\upgrade\win32).
9. When prompted to enter the host name, hit Enter to accept the default (localhost).
10. When prompted to enter the process name, hit Enter to accept the default value (SOA Security Gateway).
11. When prompted to enter the configuration service host name, hit Enter to accept the default value (locallhost).
12. When Prompted to enter the configuration service process name, hit Enter to accept the default value (SOA Security Gateway Configuration Manager).

    The upgrade proceeds. If successful, the upgraded Entity Store configuration file (entities-upgraded.xml) is created in the current directory.

13. Stop the r12.0 SOA Security Gateway and SOA Security Gateway Configuration Manager.