How to run Documentum Docker 7.3 Image in *nix host

Visibility: Open to anyone

Introduction

This document has been created to help those who wish to follow step by step instructions which have been proven on *nix host systems (Physical/Virtual/Cloud). This guide is based on the Content Server Installation Guide. It is a better version for those who get lost while going through full set of instructions.

 

Environment (Dell Vostro A840)

The environment below was targeted as host.

 

OS:

Lubuntu Xenial 16.04 (64 bit)

CPU:

2 GHz (Dual Core)

RAM:

3 GB

 

Prerequisite

In order to use or download Docker Images for Documentum, your employer needs to have Platform Service License. Below products have been evaluated to create this guide.

 

Docker:

1.12.5, build 7392c3b

Docker Compose:

1.9.0, build 2585387

Postgres:

9.6.1

Contentserver_Docker_Centos.tar:

7.3.0000.0214

 

Piecemeal

 

Checklist

Please make yourself comfortable and confident before jumping to actual steps. Allow at least 1 hr to go through this checklist. Don't worry, I have included well known troubleshooting step to go through it again.

 

  • HOST OS

     *nix 64 bit

  • Docker Engine

    Installed using https://docs.docker.com/engine/installation/linux/ubuntulinux

  • Docker Compose

    Installed using https://docs.docker.com/compose/install

  • Documentum Docker Image

     Downloaded using https://download.emc.com/downloads/DL80174_Documentum-Content-Server-7.3-Docker-Image-for-Centos.tar?source=OLS

 

Database Setup and Configuration

Setup Postgres database as per the instructions below.

 

Install

$ docker run --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=password -d postgres

Verify (Press \q to exit from PSQL Prompt)

$ docker run -it --rm --link postgres:postgres -e PGPASSWORD=password postgres psql -h postgres -U postgres

 

Create Tablespace Directory

$ docker exec -it postgres su -c "mkdir /var/lib/postgresql/data/db_centdb_dat.dat" postgres

 

 

Load Documentum Docker Image

 

Untar the Documentum Product

$ mkdir ~/Documentum

$ cd ~/Documentum

$ tar -xvf Contentserver_Docker_Centos.tar

 

Load the Documentum Docker Image from the below tar (produced in above step)

$ docker load --input Contentserver_Centos.tar

 

Verify loaded Docker Image

$ docker images

 

E.g,

REPOSITORY              TAG                  IMAGE ID         CREATED            SIZE

postgres                        latest                 0e24dd8079dc   2 weeks ago         264.9 MB

contentserver_centos     7.3.0000.0214     93ca8e54e48e   8 weeks ago         2.237 GB

Update the Documentum Scripts (provided in the steps above) ready

Untar the Scripts

$ cd ~/Documentum

$ tar -xvf Scripts.tar

 

Create environment.profile Script

 

#app server admin password

exportAPP_SERVER_ADMIN_PASSWORD=jboss

#This is install owner password

export INSTALL_OWNER_PASSWORD=password

#This is root user password

export ROOT_USER_PASSWORD=password

#Repository password. Required only for stateless configuration

export REPOSITORY_PASSWORD=password

#External Data base Server Admin password

export EXTERNALDB_ADMIN_PASSWORD=password

#Global Registry password

exportBOF_REGISTRY_USER_PASSWORD=password

#AEK passphrase

export AEK_PASSPHRASE=password

export LOCKBOX_PASSPHRASE=Password@123

 

Update statelesscs.conf Scripts

These are the important lines. Leave others default.

 

IMAGE_NAME = contentserver_centos:7.3.0000.0214

EXTERNAL_IP = 192.168.0.11

EXTERNALDB_IP = 192.168.0.11

EXTERNALDB_ADMIN_USER = postgres

EXTERNALDATA_HOST=192.168.0.11

REMOTE_DATA_PATH=/home/amit/Documentum/data

REMOTE_SHARE_PATH=/home/amit/Documentum/share

 

Create directories mentioned above

(it is not required, but did this to make myself succeed in one or two rounds)

 

$ mkdir /home/amit/Documentum/data

$ mkdir /home/amit/Documentum/share

$ chmod 777 /home/amit/Documentum/data

$ chmod 777 /home/amit/Documentum/share

 

* 192.168.0.11 : It is my IP found under wlp12s0 inet section. You could try using docker0 inet address.

* amit : It is my user account.

 

Start the final step (Compose and run the Container)

Run the commands below

 

$ cd ~/Documentum

$ source environment.profile

$ chmod 775 stateless_config.sh

$ ./stateless_config.sh

 

Good Luck!

Please follow the general steps to login and see the logs. It took 1 hr in my old slow PC

 

Important logs are:

 

$ more /opt/dctm_docker/logs/centstateless.log

$ more /opt/dctm/dba/config/centdb/dm_CreateTableSpace.out

$ more /opt/dctm/product/7.3/install/logs/install.log

This will show some BOF Registry Issues. I'm leaving Dell EMC Services to review these and provide some comments.

 

 

Troubleshooting

 

 

Support Issue (https://community.emc.com/thread/234835)

akhalid1

 

Solution:

In my experience, Documentum volumes created earlier doesn’t get flushed even if you stop, remove, reload the Documentum Conatiner image. I’d recommend to retry this guide which is similar to Content Server Installation Guide. Make sure you run below steps before you retry.

 

$ docker ps

Get Documentum Conatiner detail here.

 

$ docker stop 0fad01c9b53d

$ docker rm 0fad01c9b53d

 

$ docker stop postgres

$ docker rm postgres

 

$ docker volume rm $(docker volume ls -f dangling=true -q)

 

 

Restart the Container

There are 2 suggested options before you learn in depth.

 

Option 1 (this will keep the container ID same):

$ docker stop 0fad01c9b53d


$ docker start 0fad01c9b53d

 

Option 2 (this will changes the container ID):

$ docker stop 0fad01c9b53d

$ docker rm 0fad01c9b53d

 

$ cd ~/Documentum

$ source environment.profile

$ ./stateless_config.sh

 

 

......................................................................................THANKS--------------------------------------------------------------------------------------------------------

 

 

Any more issues?

Do not hesitate to contact me.