Giter VIP home page Giter VIP logo

dctmlifescienceviadocker's Introduction

DctmLifeScienceViaDocker

This script is not for Prod rather a quick way to spin up a specific version of Documentum Life Sciences to either demo the product or reproduce an issue. I use this as my Dev when I do not have access to the target environment. I created and tested this on my bare metal and it worked really well so thought of sharing with the wider DCTM community.

What all the script installs:

  • Postgres DB
  • Content Server
  • Process Engine
  • Documentum Administrator
  • D2
  • D2-Config
  • Life Sciences
  • xPlore
  • IndexAgent

  • The script can setup 16.4,16.6, 16.6P2, 16.6.1 and 20.2 DCTM LS environments.

    If something is not clear on this ReadMe, I would recommend to download the script and take a look as I have added comments to make it easy for others to understand and customize as needed.

    Getting Started

    Connect/SSH to your server/node and create a directory where we will keep all the Documentum Life Sciences Docker images (Ex: mkdir -p /media/dctmimages4 ). Login to support.opentext.com and download all the LS Docker images for the version you want to install. If you downloaded the image to your local machine, upload them to the server and place in the directory (/media/dctmimages4) created in step 1.

    It would be quicker if you have updated your server/node and have setup Docker before proceeding with installation.

    Prerequisites

    The script is relatively self contained and fetches necessary files from github repo. To execute the script successfully we need:

  • Access to Internet
  • Respective Documentum images
  • Running Linux environment with Docker.
  • SSH, SUDO access to your server
  • LS Images

    To keep it as streamlined as possible, I have predefined images in YAML files being used by the script. This means that the script would fail when it is unable to fetch the required Docker image. thus it is important to download exact images used by the script and put them in the /media/dctmimages4 folder before executing the script.

    Below is the list for latest 2 LS versions. For older LS versions, take a look at the respective YAML file present in the YAML folder on github.

    20.2

  • xcp/centos/stateless/xcp-pe-setup:20.2.0000.0054
  • contentserver/centos/stateless/cs:20.2.0000.0110
  • artifactory.otxlab.net/bpdockerhub/lifescience/centos/stateless/lsd2cs:20.2.0000.0232
  • xplore/centos/stateless/indexserver:20.2.0000.0015
  • xplore/centos/stateless/indexagent:20.2.0000.0015
  • artifactory.otxlab.net/bpdockerhub/da/centos/stateless/dastateless:20.2.0000.0051
  • artifactory.otxlab.net/bpdockerhub/lifescience/centos/stateless/lsd2config:20.2.0000.0232
  • artifactory.otxlab.net/bpdockerhub/lifescience/centos/stateless/lsd2client:20.2.0000.0232
  • artifactory.otxlab.net/bpdockerhub/lifescience/centos/stateless/lswebapps:20.2.0000.0232
  • 16.6.1

  • xcp/centos/stateless/xcp-pe-setup:16.4.1040.0131
  • contentserver_centos:16.4.0170.0234
  • lsd2cs_docker_centos:16.6.1000.0126
  • xplore_ubuntu:16.4.0000.0197
  • indexagent_ubuntu:16.4.0000.0197
  • da_centos:16.4.0170.0027
  • lsd2config_docker_centos:16.6.1000.0126
  • lsd2client_docker_centos:16.6.1000.0126
  • lswebapps_docker_centos:16.6.1000.0126
  • Installation

    After completing the prerequisite step defined above, connect to your server (terminal or SSH session), got your home directory and run below commands :

    wget https://raw.githubusercontent.com/piyushkumarjiit/DctmLifeScienceViaDocker/master/LS_on_Docker.sh

    Update the permissions on the downloaded file using:

    chmod 755 LS_on_Docker.sh

    Now run below script and follow prompts:

    ./LS_on_Docker.sh |& tee -a LS_Install.log

    Post Installation Steps

    If everything went well so far, we would have a working Documentum Life Sciences platform. We would be able to login to D2 application (using dmadmin) but there are few more tasks to be completed before everything is ready.

    Setting up Privileged client for JMS

    Login to DA and grant necessary permissions under Client rights management node to JMS. This is required for Workflows to work properly.

    Mounting remote location for SSV import

    If using SSV, we need to mount remote folder from where SSV would import submissions. We can exec into the lsd2cs container and use mount command to mount the remote directory.

    Setting up User accounts

    For testing, we need to add users to the application. Login to DA, create/import users and set them in LS specific roles.

    Testing

    LS validation is too big to put here. For sanity testing, Import a PDF file as a Cat 2 document, send it to a workflow and complete the workflow. If all the steps involved proceed as expected, the environment should be OK.

    Start and Stop

    The script generates 2 scripts "start_LS.sh" and "stop_LS.sh" which can be used to start and stop the entire LS stack.

    To Start

    sudo ./start_LS.sh

    To Stop

    sudo ./stop_LS.sh

    Do not delete the directories created by the script as it contains Documentum and DB data.

    Whats Next

    This is just a start and all the steps outlined under Post Installation steps could be automated via shell scripts.

    Other components CTS/Render services, iHub, Brava etc. need to be set up (if needed).

    Authors

    Piyush Kumar - (https://github.com/piyushkumarjiit)

    License

    This project is licensed under the Apache License - see the LICENSE.md file for details

    Acknowledgments

    Thanks to below URLs for providing me the necessary understanding and material to come up with this script.

  • https://support.opentext.com
  • https://www.docker.com
  • https://www.Stackoverflow.com
  • https://www.DuckDuckGo.com
  • dctmlifescienceviadocker's People

    Contributors

    piyushkumarjiit avatar

    Stargazers

    Roberto Dossi avatar

    Watchers

    James Cloos avatar  avatar

    Recommend Projects

    • React photo React

      A declarative, efficient, and flexible JavaScript library for building user interfaces.

    • Vue.js photo Vue.js

      ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

    • Typescript photo Typescript

      TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

    • TensorFlow photo TensorFlow

      An Open Source Machine Learning Framework for Everyone

    • Django photo Django

      The Web framework for perfectionists with deadlines.

    • D3 photo D3

      Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

    Recommend Topics

    • javascript

      JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

    • web

      Some thing interesting about web. New door for the world.

    • server

      A server is a program made to process requests and deliver data to clients.

    • Machine learning

      Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

    • Game

      Some thing interesting about game, make everyone happy.

    Recommend Org

    • Facebook photo Facebook

      We are working to build community through open source technology. NB: members must have two-factor auth.

    • Microsoft photo Microsoft

      Open source projects and samples from Microsoft.

    • Google photo Google

      Google โค๏ธ Open Source for everyone.

    • D3 photo D3

      Data-Driven Documents codes.