Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Upgrading
Info

Important

Use one Gateway dedicated to running as Service Proxy for your cluster administration (using Swarm UI and Management API) in production , and additional Gateway appliances to handle all content management at scale. Enable both cluster administration and content management on a single Gateway instance if the cluster is for testing or less usage.

Info

Note

See the Upgrade section in Content Gateway Release Notes for the version being installed for information about upgrading.

Info

Info

Installing To Install Gateway Offline?See ,see Install Swarm Lifecycle Nudger Offline.

  1. Apply all current operating system patches before installing the Gateway. The Installer preserves the existing versions of pip and requests detected.

  2. Install Java. Gateway requires a Java 8 SDK. The SDK must be Oracle’s Java or OpenJDK. Use the same JVM and version on all Gateway appliances.

    1. Install the Java language on the server.

      Code Block
      yum install java-1.8.0-openjdk
    2. After installing, verify the correct Java version is active.

      Code Block
      languagebash
      java -version
    3. Run the following command to change the active Java version.

      Code Block
      languagebash
      alternatives --config java 
  3. Download the Swarm bundle from the Downloads section on the DataCore Support Portal to get the Gateway distribution, and unzip it.

  4. Locate the RPM for the Gateway software. If the Caringo RPM public key is not added, which is included with the distribution bundle to your system, run the following command:

    Code Block
    rpm --import RPM-GPG-KEY
  5. Run this command to install the Gateway package, substituting the exact version number for the RPM in the distribution file for the {version} string:

    Code Block
    yum install caringo-gateway-{version}.rpm
  6. Navigate to the examples directory for configuration file examples to study and clone.

    Code Block
    languagebash
    /etc/caringo/cloudgateway/examples
  7. Complete authentication for Gateway.

    1. Complete the IDSYS Document Formatfor user authentication.

      Code Block
      languagebash
      /etc/caringo/cloudgateway/idsys.json
    2. Complete the Policy Document for access control.

      Code Block
      languagebash
      /etc/caringo/cloudgateway/policy.json

Note

The plain-text passwords in both Gateway configuration and IDSYS are replaced by encrypted versions during Gateway's startup. (v7.1)

...

  1. Verify NTP time synchronization is used on the Gateway server to guarantee storage transaction handling and that the audit log timestamps match across servers. NTP is critical for the Swarm operation and should be used on all hosts interacting with Swarm.

  2. Optionally, install and start Docker on the Gateway server to utilize video clipping and hybrid cloud on Gateway version 7.8 and higher.

    1. Install docker-ce following instructions in https://docs.docker.com/engine/install/centos/.

    2. Run any needed post-installation step to start Docker, such as enabling the systemd services:

      https://docs.docker.com/engine/install/linux-postinstall/#configure-docker-to-start-on-boot-with-systemd

    3. Features will fail with SElinux set to "Enforced" on RHEL7 installations. Check the OS setting with the "getenforce" command. If this extra layer of security is not needed, reduce to "Permissive" or "Disabled" to allow features to proceed.