CA API Gateway 9.1

9.4 9.1

Install the Gateway (Software)

This topic describes how to install the software form factor of the gatewayon your own host machine. Verify that the system requirements are met, and then refer to the appropriate section for your platform.
gateway91
This topic describes how to install the software form factor of the 
CA API Gateway
on your own host machine. Verify that the system requirements are met, and then refer to the appropriate section for your platform.
 
WARNING:
 The
CA API Gateway
 requires a large amount of RAM and manipulates or replaces system configuration files. CA Technologies strongly recommends installing the Gateway software on a dedicated server. If the server also hosts other services, there is a possibility the changes imposed by the Gateway may conflict with other applications.
System Requirements
For a list of the system requirements, see "Software Gateway" under Requirements and Compatibility.
User Accounts
The Gateway installation creates these user accounts:
  • gateway
     user
  • gateway
     group
  • layer7
     user
  • layer7
     group
The
gateway
 user/group is for running the Gateway and maintains ownership of runtime files and directories.
The
layer7
 user/group is for running the configuration scripts and maintains ownership of configuration files and directories.
Both the
gateway
 and
layer7
 accounts are created without passwords and thus can be accessed only via the "root" account (for example,
"su - gateway"
), unless the administrator creates passwords for these accounts.
RHEL/CentOS/SUSE Linux Installation
To install the Gateway under Red Hat Enterprise Linux, CentOS, or SUSE Linux for the first time:
  1. Ensure that an Oracle Java SE Development Kit (JDK) has been installed.
  2. Download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 from the Oracle web site. Unzip the files in
    UnlimitedJCEPolicyJDK8.zip
     and then copy the extracted UnlimitedJCEPolicy files to the following JDK 1.8 jre/lib/security directory (based on the JDK 1.8 having been installed to the default directory
    /usr/j2se/
    ):
    cp UnlimitedJCEPolicy/* /usr/j2se/jdk1.8.0_
    xx
    /jre/lib/security/
    Where
    "xx"
     represents the most recent update of JDK 1.8.
  3. Extract the file
    ssg-
    <version>
    -
    <build>
    .noarch.rpm
     from the "CA API Gateway Software Installer Upgrader" archive and copy it to the local machine.
  4. Log in as the
    root
     user.
  5. Run the following command:
    # rpm -Uvh ssg-
    <version>
    -
    <build>
    .noarch.rpm
    Replace 
    "<version>-<build>"
     with the version number and build number in the file name. The installation directory is "/opt/SecureSpan/Gateway".
  6. When the installation process completes, confirm the RPM installation of the Gateway:
    # rpm -q ssg
    This command displays the installed package for the Gateway.
Solaris Installation
To install the Gateway under Solaris 10 (x86 or SPARC) for the first time:
  1. On the Solaris server, install the Oracle Solaris JDK 1.8_
    xx
    .
    Tip:
     The JDK is available from: http://www.oracle.com/technetwork/java/javase/downloads/index.html
  2. Download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 from the Oracle web site. Unzip the files in
    UnlimitedJCEPolicyJDK8.zip
     and then copy the extracted UnlimitedJCEPolicy
    files to the following JDK 1.8
    jre/lib/security
     directory (based on the JDK 1.8 having been installed to the default directory
    /usr/j2se/
    ):
    cp UnlimitedJCEPolicy/* /usr/j2se/jdk1.8.0_
    xx
    /jre/lib/security/
    Where
    "xx"
     represents the most recent update of JDK 1.8.
    Ensure that the copied policy files are readable by users other than the owner. This may not be the case, depending on the umask of the user used to copy the files.
  3. Extract the file 
    L7TECHssg-
     
    <version>
    -
    <build>
    .pkg
     from the "CA API Gateway Software Installer Upgrader" archive and copy it to the local machine.
  4. Log in as the
    root
     user.
  5. Type the following command:
    # pkgadd -d L7TECHssg-
    <version>-<build>
    .pkg
Error Reporting
To get syslog messages for startup and error reporting when running the Solaris version, add the following line to "/etc/syslog.conf":
textuser.notice ifdef(`LOGHOST', /var/log/syslog, @loghost)

Content feedback and comments