Deploying the GridServer Engine Dockerfile into OpenShift

The following procedure deploys an Engine to the OpenShift environment with the OpenShift CLI using the oc command.

Prerequisites

• This process assumes you are familiar with OpenShift. See the OpenShift web site at https://www.openshift.com/ for more information.
• Obtain an OpenShift account and login credentials from the OpenShift web site.
• Install the OpenShift CLI. This is available from the Red Hat customer portal after you have created an account.
• Download the GridServer SDK from the GridServer Administration Tool.
• Install git on your local workstation.
• Add the Engine Dockerfile to your git repository.

It’s also suggested to add all the folders under the container directory of the GridServer SDK into the git repository.

Procedure

1. Log in to OpenShift with following command: 
   oc login
2. Create a new project: 
   oc new-project ProjectName --description="your description"\
     --display-name="your display name"

For example:

   oc new-project gs-engine --description="GridServer Engine \
      Container Deployment" --display-name="GridServer Engine"
3. Create a new application: 
   oc new-app your_dockerfile_git_repository --build-env \
      GS_ARCHIVE_URL=location_of_Engine_archive_file \
      DIRECTOR_URL=location_of_GridServer_Primary_Director
      ENGINE_CONFIG=Engine_Configuration

For example:

   oc new-app https://git.example.com/tibco/gridserver.git \
      --context-dir=engine --build-env \
      GS_ARCHIVE_URL=http://192.168.0.100:8080/livecluster/public_html/register/install/unixengine/DSEngineLinux64.tar.gz \
      DIRECTOR_URL=192.168.0.100:8080 ENGINE_CONFIG=default

Note that if the GridServer Engine is running in an OpenShift cluster with its internal IP address and is not visible by the Driver or Manager, you need to create a route in the OpenShift project, and then configure the File Server URL in the Engine Configuration.

For example: create a route in OpenShift project as:

    http://gs-engine.gs-engine.cluster-proxy-host

and then set Engine Configuration > File Server > File Server URL to http://gs-engine.gs-engine.cluster-proxy-host.

This routes external communication from the GridServer Driver and Manager to the Engine internal file server (the default port is 27159).

After Deployment

After deployment, you can perform application lifecycle management tasks with the OpenShift CLI. See the OpenShift documentation for more details.