Difference between revisions of "Cluebase VMS Installation Manual"
Line 1: | Line 1: | ||
<strong> | <strong>Installation manuel Contents</strong> | ||
== | == Automatic installation == | ||
Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation.<br> | |||
1.1. Linux<br> | 1.1. Linux<br> | ||
Please run the install.sh script to automatically install Cluebase VMS on a clean Linux OS.<br> | |||
To run the script, please go to the folder containing “install.sh” and run the following command: <br> | |||
$ sudo sh install.sh <br> | $ sudo sh install.sh <br> | ||
Line 14: | Line 14: | ||
1.2. Windows<br> | 1.2. Windows<br> | ||
Please run the batch file WINDOWS_install.bat to install Cluebase VMS on Windows OS. <br> | |||
== | == Manual installation == | ||
<strong> 2.1. Docker | <strong> 2.1. Docker installation</strong><br> | ||
Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation. <br> | |||
2.1.1.Docker | 2.1.1.Installing Docker on Linux<br> | ||
Official Docker installation guide: https://docs.docker.com/engine/install/ubuntu/<br> | |||
Run the following command:<br> | |||
$ 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. | 2.1.2. Installing docker-compose on Linux<br> | ||
Run the following command:<br> | |||
$ 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 <br> | $ 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 <br> | ||
Grant the necessary access rights by running the following command:<br> | |||
$ sudo chmod +x /usr/local/bin/docker-compose <br> | $ sudo chmod +x /usr/local/bin/docker-compose <br> | ||
2.1.3. Docker | 2.1.3. Installing Docker on Windows <br> | ||
Docker Desktop | Download the latest version of Docker Desktop from the official website: https://www.docker.com/products/docker-desktop <br> | ||
Docker Desktop | The Docker Desktop installer includes the Docker engine and Docker compose.<br> | ||
<strong> 2.2. | <strong> 2.2. Preparation for VMS installation </strong> <br> | ||
2.2.1. Cluebase.zip | 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> | |||
Please note that this file is hidden in the folder by default. <br> | |||
2.2.2. .env | 2.2.2. Open the .env file and specify the server's IP address in the following fields: <br> | ||
APP_HOST=0.0.0.0 ( | 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> | ||
MACHINE_HOST=0.0.0.0 ( | |||
If the VMS should only be used in the local network, both IP addresses will be the same. <br> | |||
2.2.3. | 2.2.3. 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> | |||
== | == Sign in == | ||
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> | |||
== | == Stopping the VMS == | ||
Run the following command from the VMS folder to stop the VMS server:<br> | |||
$ sudo docker-compose down <br> | $ sudo docker-compose down <br> | ||
== | == Updating VMS == | ||
To update the VMS version:<br> 1.stop the VMS <br> 2.Run the following command from the VMS folder:<br> | |||
$ sudo docker-compose pull <br> | $ sudo docker-compose pull <br> | ||
3. | 3.Restart VMS:<br> | ||
$ sudo docker-compose up -d<br> | $ sudo docker-compose up -d<br> |
Revision as of 07:24, 20 December 2022
Installation manuel Contents
Automatic installation
Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation.
1.1. 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
1.2. Windows
Please run the batch file WINDOWS_install.bat to install Cluebase VMS on Windows OS.
Manual installation
2.1. Docker installation
Docker container framework and Docker-compose extension are required for Cluebase VMS installation and operation.
2.1.1.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
2.1.2. 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
2.1.3. Installing Docker on Windows
Download the latest version of Docker Desktop from the official website: https://www.docker.com/products/docker-desktop
The Docker Desktop installer includes the Docker engine and Docker compose.
2.2. Preparation for VMS installation
2.2.1. Download Cluebase.zip. Create a VMS folder and unzip the contents of the zip file to that folder.
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.
2.2.2. 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.
2.2.3. 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.
Sign in
Open a web browser (Google Chrome, Mozilla Firefox and Safari are recommended), enter the server's IP address and press Enter.
By default login and password: admin/admin.
Stopping the VMS
Run the following command from the VMS folder to stop the VMS server:
$ sudo docker-compose down
Updating VMS
To update the VMS version:
1.stop the VMS
2.Run the following command from the VMS folder:
$ sudo docker-compose pull
3.Restart VMS:
$ sudo docker-compose up -d