Revision as of 00:15, 26 January 2023

Pre-Requisites

Before installing or updating Command Center, please verify this section is complete.

Intro

Diagram

Hardware

Docker Pre-Requisite

Docker is a platform that allows you to easily develop, test, and deploy applications as containers. This section will walk you through the process of installing Docker on a Linux system.

On the system (most likely a VM) dedicated to Command Center, make sure you have the latest version of docker up and running. The following steps may help.

A user with sudo privileges is required to run most commands.

Uninstall old docker versions

This is an optional step in case your docker version is out of date:

   sudo yum remove docker \
                 docker-client \
                 docker-client-latest \
                 docker-common \
                 docker-latest \
                 docker-latest-logrotate \
                 docker-logrotate \
                 docker-engine

Install docker using the repository

   sudo yum install -y yum-utils
   sudo yum-config-manager \
     --add-repo \
     https://download.docker.com/linux/centos/docker-ce.repo

   sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Start Docker.

Start docker using the following command:

   $ sudo systemctl start docker

Enable the Docker service to start automatically on system boot by running the following command:

   $ sudo systemctl enable docker

Verify that Docker Engine is installed correctly

Run the hello-world image.

   $ sudo docker run hello-world

This command will run a test container and display a message indicating that the installation is working properly.

Firewall

Credentials

(internal, LDAP, SSO)

Installation

Create the database conf file

The following is provided for a CentOS system:

Uses the centos user as default user for docker

/home/centos/mysql/conf.d/mysql.cnf

   [client]
   default-character-set = utf8mb4
   [mysql]
   default-character-set = utf8mb4

Install Command Center

New Installation

[TEMPORARY-TO BE REWRITTEN ]

Install git

  sudo yum install git

You can find files at https://github.com/Lingoport/Command-Center/tree/liliDev/docker

   git clone  https://github.com/Lingoport/Command-Center/
   git checkout liliDev
   cd Command-Center/docker

Copy install/update/uninstall and install.conf file to your home directory (/home/centos or /home/ec2-user)

   install.conf
   InstallCommmandCenter.sh
   UninstallCommmandCenter.sh
   UpdateCommmandCenter.sh

Set up install.conf

You need to provide your serverURL, your Docker Hub username and token, and MYSQL root password you want to use

 #!/bin/bash
 #
 # Provide the Docker network name you want to create
 #
 database_network=mysqlnetscommand
 #
 # Provide the MYSQL root password you want to create for the MySQL database container
 #
 database_root_password=mySQL!c0mma9d
 #
 # Provide your Docker Hub username
 #
 docker_username=xxxlingoport
 #
 # Provide your Docker Hub account token
 #
 docker_account_token=dckr_xxx_bMjvwehHwO7svVHuIExj3i346eM
 #
 # Provide the Command Center version
 #
 command_center_image_version=69
 #
 # The Server URL: '"http://yourserver:8081/command-center"'
 #
 serverURL='"http://<yourserver>:8081/command-center"'
 #
 # The company name on your Localyzer license
 #
 company_name=Lingoport

Run InstallCommmandCenter.sh

    chmod +x InstallCommmandCenter.sh
    sudo ./InstallCommmandCenter.sh

To check the running container status

   sudo docker ps

If you need to re-run the InstallCommmandCenter.sh, make sure to run UninstallCommmandCenter.sh first to clean your environment.

Note: Docker image version is not the Command Center version, check latest docker image version at https://hub.docker.com/repository/docker/lingoport/command-center_dev/general

You should see at least an MySQL and a Command Center container running.

Log in to the URL based on the command-center-config.sh settings, so something like:

   https://commandcenter.mycompany.io/
   or
   http://server.mycompany.io:8081/command-center

You should now be able to install the licenses and create projects.

Update

Update install.conf

Change the version number

Run UpdateCommmandCenter.sh

    chmod +x UpdateCommmandCenter.sh
    sudo ./UpdateCommmandCenter.sh