CA API Gateway 9.1

9.4 9.1

Install Upgrade Files for Solaris

This topic describes how to upgrade a gateway in the Software form factor, where the host machine's operating system is Solaris.
gateway
This topic describes how to upgrade a 
CA API Gateway
 in the Software form factor, where the host machine's operating system is Solaris.
If your Software Gateway is running another operating system, refer to Install Upgrade Files for RHEL/CentOS/SUSE instead.
Prerequisite:
 Ensure that steps 1 to 3 in Upgrade a Software Gateway have been performed.
The upgrade differs depending on the database type of the Gateway:
MySQL Database
To upgrade a
CA API Gateway
 with a MySQL database:
  1. On the Solaris
    API Gateway
     server, install the JDK for Solaris and note the installation path. This JDK is available from .
  2. Download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 from the Oracle web site. Unzip the files to the following directory (assuming JDK 1.8 was installed to the default directory
    /usr/j2se/
    ):
    cp UnlimitedJCEPolicy/* /usr/j2se/jdk1.8.0_
    xx
    /jre/lib/security/
  3. If you have previously upgraded the MySQL software but not yet run "mysql_upgrade", navigate to the MySQL directory and run:
    text# mysql_upgrade --skip-write-binlog
    The following steps upgrade the Gateway software:
  4. Stop the slave in MySQL on all nodes in the cluster.
  5. Stop the Gateway:
    # /opt/securespan/gateway/runtime/bin/gateway.sh stop
  6. Remove the old installation:
    text# pkgrm L7TECHssg
  7. Copy the new Gateway software package
    L7TECHssg
    -
    <version>-<build>
    .pkg
     to the host machine.
  8. Install the package:
    # pkgadd -d L7TECHssg-
    <version>
    -
    <build>
    .pkg
  9. Select the package(s) to process.
  10. Open
    my.cnf
     for editing:
    text# edit my.cnf
  11. Add the following properties to
    my.cnf
    :
    textlog_bin_trust_function_creators=1 slave_exec_mode=IDEMPOTENT
  12. Restart the MySQL service on all nodes in the cluster.
  13. Access the Gateway main menu:
    /opt/SecureSpan/Gateway/runtime/bin/setup.sh
  14. Select option
    2
     (Configure the Gateway) and the option
    1
     (Java VM). Verify that the Java VM settings are correct.
      
  15. Select option
    2
     (Database Connection) and then verify that the database connection settings are correct. The settings from the previous version of the Gateway should be displayed as the default for each setting. Press [
    Enter
    ] to use the existing value from the previous installation. You will need to enter the password of the database from the previous installation.
    You will see an error stating ‘Database version mismatch’. This is expected because you have just updated the Gateway software. The database will be updated in the next step.
  16. Select option
    1
     (Upgrade the Gateway database) and follow the prompts to upgrade the database.
  17. Exit the main menu and restart the Gateway:
    # /opt/SecureSpan/Gateway/runtime/bin/gateway.sh start
The upgrade is now complete.
Embedded Database
To upgrade a
CA API Gateway
 with an embedded database:
  1. Stop the Gateway service:
    text# /opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop
  2. Back up the previous embedded database by copying this directory to your local directory:
    /opt/SecureSpan/Gateway/node/default/var/db
  3. Remove the old installation:
    # pkgrm L7TECHssg-
    <version>
    -
    <build>.
    pkg
  4. Remove this directory:
    /opt/SecureSpan
  5. Reboot the computer.
  6. Copy the new Gateway software package
    L7TECHssg
    -
    <version>-<build>
    .pkg
     to the host machine.
  7. Install the Gateway software:
    # pkgadd -d L7TECHssg-
    <version>
    -
    <build>
    .pkg
  8. Enter
    Y
     when prompted whether to install the conflicting files, then enter
    Y
     to confirm installing <L7TECHssg>.
  9. Access the Gateway main menu:
    text# /opt/SecureSpan/Gateway/runtime/bin/setup.sh
  10. Select option
    2
     (Configure the Gateway) and t hen option
    1
     (Java VM). Verify that the Java VM settings are correct.  
  11. Select option
    2
     (Database Connection) and then configure the Gateway to use the embedded database.
  12. Exit the Gateway main menu and reboot the computer.
  13. Restore the database by copying the backup to this directory:
    /opt/SecureSpan/Gateway/node/default/var/
  14. Change the ownership and permissions back for the database directory and all of its subdirectories/files:
    • Change the owner of database directory (in the previous step) from
      root
       to
      gateway
      .
    • Change the permissions of database directory to
      rwxrwxr-x
    • Change the permissions of the following directory and all its subdirectories to
      rwxrwxr-x
      /opt/SecureSpan/Gateway/node/default/var/db/ssgdb
    • Change the permissions of all files within the "ssgdb" directory (from above) and all its subdirectories to
      rw-rw-r- -
    • Change the permissions of the following log file to
      rw-rw-r- -
      /opt/SecureSpan/Gateway/node/default/var/db/derby.log
  15. Restart the Gateway:
    # /opt/SecureSpan/Gateway/runtime/bin/gateway.sh start
The upgrade is now complete.

Content feedback and comments