Difference between revisions of "Cluebase VMS Installation Manual"

From vCloud.ai Documentation
Jump to navigation Jump to search
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
<strong>Installation manuel Contents</strong>
<strong>Installation manual Contents</strong>
 
== Preparation ==
Download cluebase.zip from https://vcloud.ai/downloads and unzip the file. Please note that in some versions of Linux the unzip application is not included so you'll need to install it separately with the following command:
sudo apt install unzip
Now unzip the Cluebase VMS installer with the following command:
sudo unzip cluebase.zip
The above command creates a directory containing the installation files.
 
Go to CluebaseVMS directory:
cd CluebaseVMS
Now you have to provide permissions to the installation script (install.sh):
sudo chmod +x install.sh
You are all set for the installation.


== Automatic installation  ==
== Automatic installation  ==
Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation.<br>
Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation.<br>


1.1. Linux<br>
=== Installing on Linux ===
 
Please run the install.sh script to automatically install Cluebase VMS on a clean Linux OS.<br>
Please run the install.sh script to automatically install Cluebase VMS on a clean Linux OS.<br>


Line 12: Line 26:
  $ sudo sh install.sh <br>
  $ sudo sh install.sh <br>


== Installing the SSL version ==
Here are the steps to install Cluebase VMS with SSL encryption:
# Download Cluebase VMS SSL installer . Please note that it comes as a separate install package and available at https://vcloud.ai/downloads
# Prepare SSL certificate and public key that are generated for the required domain name.
# Unzip the installation package.
# Navigate to 'certs' directory in the installation package.
# Copy the SSL certificate and public key (file should be named as follows: cert.crt - SSL certificate, cert.key - public). The existing files should be replaced or removed before
# Provide permissions to the installation script by this command:
sudo chmod +x install.sh
7. Run the installation script:
  $ sudo sh install.sh


2.1.1.Installing Docker on Linux<br>
== Manual installation ==


=== Installing Docker on Linux ===
Official Docker installation guide: https://docs.docker.com/engine/install/ubuntu/<br>
Official Docker installation guide: https://docs.docker.com/engine/install/ubuntu/<br>


Line 20: Line 48:


  $ sudo apt-get update && apt-get install docker-ce docker-ce-cli containerd.io <br>
  $ sudo apt-get update && apt-get install docker-ce docker-ce-cli containerd.io <br>
2.1.2. Installing docker-compose on Linux<br>


=== Installing docker-compose on Linux ===
Run the following command:<br>
Run the following command:<br>


Line 31: Line 58:
  $ sudo chmod +x /usr/local/bin/docker-compose <br>
  $ sudo chmod +x /usr/local/bin/docker-compose <br>


<strong> 2.2. Preparation for VMS installation </strong> <br>
=== <strong>Preparation for manual VMS installation </strong> ===
2.2.1. Download Cluebase.zip. Create a VMS folder and unzip the contents of the zip file to that folder. <br>
 
You will need to edit the environment variable file, the .env file, to successfully install the VMS.<br>
You will need to edit the environment variable file, the .env file, to successfully install the VMS.<br>


Please note that this file is hidden in the folder by default. <br>
Please note that this file is hidden in the folder by default. <br>


2.2.2. Open the .env file and specify the server's IP address in the following fields: <br>
Open the .env file and specify the server's IP address in the following fields: <br>


APP_HOST=0.0.0.0 (the server's public IP address) MACHINE_HOST=0.0.0.0 (local IP address of the server) <br>
APP_HOST=0.0.0.0 (the server's public IP address) MACHINE_HOST=0.0.0.0 (local IP address of the server) <br>


If the VMS should only be used in the local network, both IP addresses will be the same. <br>
If the VMS should only be used in the local network, both IP addresses will be the same.  
 
=== Using a custom port for the VMS ===
By default the VMS installs and runs on port 80. However you can configure a different port by amending the .env file.


2.2.3. Installing and running VMS <br>Enter the VMS folder and run the following command: <br>
Open the .env file and add NGINX_PORT variable and it's value (port number) as shown on the screenshot.
[[File:Editing .env file .jpg|thumb|none|557x557px]]
 
=== Installing and running VMS ===
<br>Enter the VMS folder and run the following command: <br>


  $ sudo docker-compose up -d <br>
  $ sudo docker-compose up -d <br>


This command will automatically download, install and run VMS. <br>
This command will automatically download, install and run VMS.  
 
=== Failover ===
 
===== Description =====
Cluebase VMS supports failover (hot swap) functionality as the following options:
 
# 1 to 1 - every server in the system has a failover server
# Many to 1 - several servers can be hot-swapped by 1 failover server
# Many to Many - several servers can be hot-swapped by several failover servers
 
===== Important =====
 
# In case of using the failover functionality it’s important to make sure that network storage is being used (Object storage or NAS)
# Failover server hardware should be able to handle the required number of cameras so the failover servers’ hardware should be precisely calculated and configured.
# Configuration is automatically sent from main server to failover every 5 minutes
#Please note that shutting down the main server manually is considered as maintenance and will not initiate the failover process.
#After switching back from failover server to the main server it is required to reset failover server's configuration or reboot.
 
===== Setup =====
To set up a failover system you need to have at least 1 main server and 1 failover server.
 
Go to the main server user interface and open Failover settings: Settings->Failover->Add Failover Server and fill the fields with Failover server credentials. In the Logic field choose the server or servers that should be hot-swapped by the current Failover server. Then click Save.
[[File:Failover settings.png|none|thumb]]
 
 
<br>


== Sign in ==
== Sign in ==
Open a web browser (Google Chrome, Mozilla Firefox and Safari are recommended), enter the server's IP address and press Enter. <br>
Open a web browser (Google Chrome, Mozilla Firefox and Safari are recommended), enter the server's IP address and press Enter. <br>
[[File:Picture 24.png|thumb|none]]<br>
[[File:Picture 24.png|thumb|none]]<br>
By default login and password: admin/admin.<br>
By default login and password: admin/admin.
 
== Server IP update ==
sudo ./newIP.sh


== Stopping the VMS  ==
== Stopping the VMS  ==
Run the following command from the VMS folder to stop the VMS server:<br>
Run the following command from the VMS folder to stop the VMS server:<br>


  $ sudo docker-compose down  <br>
  $ sudo ./stop.sh<br>


== Updating VMS  ==
== Updating VMS  ==
To update the VMS version:<br> 1.stop the VMS <br> 2.Run the following command from the VMS folder:<br>  
To update VMS version:<br><br>  
  $ sudo docker-compose pull  <br>  
$ sudo ./update.sh<br>  
3.Restart VMS:<br>  
 
$ sudo docker-compose up -d<br>
== Start VMS ==
  $ sudo ./start.sh<br>
 
== Camera settings recommendations ==
1. Always use the CBR setting, as when using VBR on some camera models, the bitrate may drop to limits, which may cause the video stream to be temporarily shut down. <br>
2. Always set the minimum keyframe interval (I Frame interval or Key Frame interval).

Latest revision as of 23:09, 9 January 2024

Installation manual Contents

Preparation

Download cluebase.zip from https://vcloud.ai/downloads and unzip the file. Please note that in some versions of Linux the unzip application is not included so you'll need to install it separately with the following command:

sudo apt install unzip

Now unzip the Cluebase VMS installer with the following command:

sudo unzip cluebase.zip

The above command creates a directory containing the installation files.

Go to CluebaseVMS directory:

cd CluebaseVMS

Now you have to provide permissions to the installation script (install.sh):

sudo chmod +x install.sh

You are all set for the installation.

Automatic installation

Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation.

Installing on Linux

Please run the install.sh script to automatically install Cluebase VMS on a clean Linux OS.

To run the script, please go to the folder containing “install.sh” and run the following command:

$ sudo sh install.sh 

Installing the SSL version

Here are the steps to install Cluebase VMS with SSL encryption:

  1. Download Cluebase VMS SSL installer . Please note that it comes as a separate install package and available at https://vcloud.ai/downloads
  2. Prepare SSL certificate and public key that are generated for the required domain name.
  3. Unzip the installation package.
  4. Navigate to 'certs' directory in the installation package.
  5. Copy the SSL certificate and public key (file should be named as follows: cert.crt - SSL certificate, cert.key - public). The existing files should be replaced or removed before
  6. Provide permissions to the installation script by this command:
sudo chmod +x install.sh

7. Run the installation script:

 $ sudo sh install.sh

Manual installation

Installing Docker on Linux

Official Docker installation guide: https://docs.docker.com/engine/install/ubuntu/

Run the following command:

$ sudo apt-get update && apt-get install docker-ce docker-ce-cli containerd.io 

Installing docker-compose on Linux

Run the following command:

$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 

Grant the necessary access rights by running the following command:

$ sudo chmod +x /usr/local/bin/docker-compose 

Preparation for manual VMS installation

You will need to edit the environment variable file, the .env file, to successfully install the VMS.

Please note that this file is hidden in the folder by default.

Open the .env file and specify the server's IP address in the following fields:

APP_HOST=0.0.0.0 (the server's public IP address) MACHINE_HOST=0.0.0.0 (local IP address of the server)

If the VMS should only be used in the local network, both IP addresses will be the same.

Using a custom port for the VMS

By default the VMS installs and runs on port 80. However you can configure a different port by amending the .env file.

Open the .env file and add NGINX_PORT variable and it's value (port number) as shown on the screenshot.

Editing .env file .jpg

Installing and running VMS


Enter the VMS folder and run the following command:

$ sudo docker-compose up -d 

This command will automatically download, install and run VMS.

Failover

Description

Cluebase VMS supports failover (hot swap) functionality as the following options:

  1. 1 to 1 - every server in the system has a failover server
  2. Many to 1 - several servers can be hot-swapped by 1 failover server
  3. Many to Many - several servers can be hot-swapped by several failover servers
Important
  1. In case of using the failover functionality it’s important to make sure that network storage is being used (Object storage or NAS)
  2. Failover server hardware should be able to handle the required number of cameras so the failover servers’ hardware should be precisely calculated and configured.
  3. Configuration is automatically sent from main server to failover every 5 minutes
  4. Please note that shutting down the main server manually is considered as maintenance and will not initiate the failover process.
  5. After switching back from failover server to the main server it is required to reset failover server's configuration or reboot.
Setup

To set up a failover system you need to have at least 1 main server and 1 failover server.

Go to the main server user interface and open Failover settings: Settings->Failover->Add Failover Server and fill the fields with Failover server credentials. In the Logic field choose the server or servers that should be hot-swapped by the current Failover server. Then click Save.

Failover settings.png



Sign in

Open a web browser (Google Chrome, Mozilla Firefox and Safari are recommended), enter the server's IP address and press Enter.

Picture 24.png


By default login and password: admin/admin.

Server IP update

sudo ./newIP.sh

Stopping the VMS

Run the following command from the VMS folder to stop the VMS server:

$ sudo ./stop.sh

Updating VMS

To update VMS version:

$ sudo ./update.sh

Start VMS

$ sudo ./start.sh

Camera settings recommendations

1. Always use the CBR setting, as when using VBR on some camera models, the bitrate may drop to limits, which may cause the video stream to be temporarily shut down.
2. Always set the minimum keyframe interval (I Frame interval or Key Frame interval).