Versions Compared

Key

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

...

Info

Use 'lumauser' to execute all the docker container, deployment scripts, and all the docker commands instead of sudo user. 

Table of Contents

Pre-Deployment Actions

Perform the following Pre-deployment actions:

...

  1. Populate master.properties file located under /platform/deployment/itas-deployment-2.0.0/deploy/esa_onprem_agent directory. Most of the properties are self explanatory; if in doubt, please contact Serviceaide Support.

  2. Once master.properties located in esa_onprem_agent directory is setup, copy the file to /platform/deployment/itas-deployment-2.0.0/deploy/

    Code Block
    cd /platform/deployment/itas-deployment-2.0.0/deploy/esa_onprem_agent
    cp master.properties ../
  3. Configure system ulimits in file /etc/security/limits.conf

    Code Block
    centos       soft    nproc           16384      
    centos       hard    nproc           16384
    centos       soft    nofile          65536
    centos       hard    nofile          65536
    lumauser     soft    nproc           16384 
    lumauser     hard    nproc           16384
    lumauser     soft    nofile          65536
    lumauser     hard    nofile          65536
    root         soft    nproc           16384
    root         hard    nproc           16384
    root         soft    nofile          65536
    root         hard    nofile          65536
  4. Login to dockerhub using the below command:

    Code Block
    docker login https://registry-1.docker.io -u serviceaideindia
    # use the dockerhub password provided separately
  5. Setup directory structure

    Code Block
    sudo mkdir -p /platform/data/logs/itas/itas_mule_adaptor
    sudo mkdir -p /platform/data/logs/itas/itas_db_migration
    sudo mkdir -p /platform/data/logs/itas/itas_service_bus
    sudo chmod -R 777 /platform/data/logs/itas
    sudo mkdir -p /platform/data/attachment_store/itas
    sudo mdir -p /platform/data/servicebus_store/itas
    sudo chown -R 1000:1000 /platform/data/servicebus_store/itas
    sudo chown -R 1000:1000 /platform/data/attachment_store/itas
  6. Install mule_run (one time activity, not required if you are upgrading / already have mule_run installed)

    Code Block
    cd /tmp
    sudo wget -q https://repository.mulesoft.org/nexus/content/repositories/public/org/mule/distributions/mule-standalone/3.9.0-hf2/mule-standalone-3.9.0-hf2.zip
    sudo unzip -qq mule-standalone-3.9.0-hf2.zip
    sudo mv mule-standalone-3.9.0-hf2 /platform/data/mule_run
    sudo chown -R 1000:1000 /platform/data/mule_run

Start installation

Execute below commands to start installation

Code Block
cd /platform/deployment/itas-deployment-2.0.0/deploy
chmod +x */*.sh
cd /platform/deployment/itas-deployment-2.0.0/deploy/esa_onprem_agent
chmod +x onprem_stack.sh
./onprem_stack.sh deployall

Post Deployment Actions

Run the below command to clean up older unused volumes, images, etc after deployment.

Code Block
#run command to delete all the unused docker images (This command will not delete docker images that are in use)
docker rmi -f $(docker images | awk '{ print $3 }') > /dev/null 2>&1

#cleanup unsed volume, cache etc.
docker system prune

To check logs 

sudo tail -f `docker inspect --format='{{.LogPath}}' itas_muledb_migration`

Troubleshoot Errors

  1. If we get the below "permission denied error" : Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post http://%2Fvar%2Frun%2Fdocker.sock/v1.37/containers/redis/stop: dial unix /var/run/docker.sock: connect: permission denied.

    Code Block
    [lumauser@lumatrialweb01 deploy]$ docker ps --> If permission denied comes then execute below command.
    
    [lumauser@lumatrialweb01 deploy]$ sudo setfacl -m user:lumauser:rw /var/run/docker.sock
    
    [lumauser@lumatrialweb01 deploy]$ docker ps
    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES 
    
    [lumauser@lumatrialweb01 deploy]$ docker login (Enter docker credentials)

...