Upgrading MCS Version

Table of Contents

Download Backup Configuration

Before upgrading the MCS software, it is recommended to create a backup file of the current MCS configuration. Download the backup data to your local machine to prevent data loss in case of unforeseen circumstances. Detailed instructions can be found here.

Steps to Upgrade MCS from Version 1.2.X to 1.2.Y or
from Version 1.2.X to 1.3.Y

1. Connect to the MCS Server

1. Access your MCS server via SSH:

   ssh {user_name}@{mcs_ip}

2. Enter your server password when prompted.

2. Download the New MCS Version File

1. Log in to the TAG Video Systems Sharing Files Website.

   • Note: If you do not have an account, contact TAG customer support to request one.

2. Locate the tar build file (the new version file):

   • Use the download link provided in the email sent by TAG. The email subject will be: {TAG’s employee name}@TAGVS shared "update_{version number}.tar" with you.

   • Alternatively, navigate to the Shared with you tab on the left menu of the website to find the file.

3. Click the file name to download it to your local computer.

3. Transfer the Tar File to the MCS Server

Use the scp command to copy the tar build file from your computer to the folder on the MCS server containing your MCS directory:

4. Stop MCS Docker Containers (stop the MCS software from running)

1. Navigate to the MCS directory:

   cd {Your_Path_To_MCS_Folder}

2. Run the run.sh script:

3. Enter your MCS server password when prompted.

4. In the pop-up menu, choose option 2 (Stop) to stop all MCS containers.

   Open

   

5. Wait for all containers to stop before proceeding.

6. Press 9 to exit

5. Extract the Update File

1. Return to the the folder containing your MCS directory:

2. Extract the contents of the tar file to overwrite the existing MCS folder’s files:

3. Follow the on-screen instructions, choosing yes/no or default settings as appropriate.

Upgrade Instructions by Version

Upgrading from 1.2.X to 1.2.Y

1. Navigate to the MCS directory:

2. Execute the following command:

3. Enter your MCS server password when prompted.

4. In the pop-up menu, choose option 4 (Update) to display available images. Select the version to which you want to upgrade.

   Open

   

5. Enter "yes" to continue.

6. Wait for the operation to finish.

7. Run the ./run.sh script again and select option 1 (Start) to start the containers (start the MCS software).

Upgrading from 1.2.X to 1.3.Y

1. Navigate to the MCS directory:

2. Execute the installation script:

   Follow the instructions as necessary.

3. Execute the setup script:

   • You will be prompted to configure the .env file or select default values.

   • After completion, if needed, you can edit .env parameters using the command:

4. Run the following command to start the containers (start the MCS software):

5. Enter your MCS server password when prompted.

6. In the pop-up menu, choose option 1 (Start) to start the containers (start the MCS software).

Steps to Upgrade MCS from Version 1.3.X to 1.3.Y or Apply a New Build File for 1.3.X

1. Connect to the MCS Server

1. Access your MCS server via SSH:

2. Enter your server password when prompted.

2. Download the New MCS Version File

1. Log in to the TAG Video Systems Sharing Files Website.

   • Note: If you do not have an account, contact TAG customer support to request one.

2. Locate the tar build file (the new version file):

   • Use the download link provided in the email sent by TAG. The email subject will be: {TAG’s employee name}@TAGVS shared "update_{version number}.tar" with you.

   • Alternatively, navigate to the Shared with you tab on the left menu of the website to find the file.

3. Click the file name to download it to your local computer.

3. Transfer the Tar File to the MCS Server

Use the scp command to copy the tar build file from your computer to the following folder: {Your_Path_In_MCS_Server_To_MCS_Folder}/storage/system/versionson your MCS server.

4. Update MCS Version

1. Navigate to the MCS directory:

2. Run the run.sh script:

3. Enter your MCS server password when prompted.

4. In the pop-up menu, choose option 4 (Update) to display available versions. Select the version to which you want to upgrade.

5. Enter "yes" to continue.

6. Wait for the operation to finish.

7. The MCS containers should be running now.

Page Cache Refresh

After upgrading, refresh your browser’s page cache:

• Windows: Press Ctrl + F5.

• Mac: Press Command + Shift + R.

Elasticsearch Setup

To configure Elasticsearch:

1. Edit the .env file:

2. Update the following parameters based on your requirements:

   • Disable Internal Elastic Search:

   • Enable External Elastic Search:

3. Save changes with Ctrl + O and exit with Ctrl + X.

Add Redis Password

From version 1.1.1 onwards, MCS supports Redis password configuration.

1. Edit the .env file:

2. Add passwords to the password fields:

Related Articles

MCS Overview