Docker Installation
Install the backup server and the ZMC control plane via a docker container. This process facilitates simple version upgrades.
The Docker installation allows for a more controlled operating environment, making upgrades and downtimes easy to manage. In addition, multiple backup servers can be run from one container, enabling you to distribute backup jobs evenly across backup servers.
Please get in touch with your success manager to receive the Docker installation files for the installation images, as this installation is undergoing closed customer trials. Once you receive the files, you will notice two zip files, one for the backup server and one for the ZMC control plane.
// Format of the installation files
AEE-<version series>.zip // backup server
ZMC-<version series>.zip // frontend UI
You can begin the installation process by extracting the AEE file. You can feel free to rename the files to avoid deployment issues. Once extraction is complete, use the second command to enter the extracted directory.
// extract the files
tar -xvf aee-4132.zip
// enter the extracted directory
cd < replace with the extracted directory>
2. Up next, you should create a virtual network for the backup server containers. This command has to be run only once. The subsequent backup server containers running on the same machine will use the same network.
./create-aee-network
3. We now create the “port_ranges” file in ‘/var/lib/amanda/’. The port ranges file will have the range of port numbers that can be sequentially used by the containers. The file comprises just two lines. The first line will specify the lower limit of the port range and the second line will specify the upper limit of the port range.
10020 // Sample lower port range
10030 // Sample higher port range
4. Given containers cannot access data on the host, you need to update the volume mappings of the Docker containers, from the "custom_volumes" config file. This step allows Zmanda to read the mapped host path from the container.
/home:/home // syntax -> <host path>:<container path>
5. You can now start the container with the following command
./run-docker.dist/run-docker
6. Post running step 5, you boot up the backup server. To link the backup server with the Zmanda console, you need the backup server's IP and its corresponding port number, which can be retrieved using the below command.
cat port_assigned
Now that you have installed the backup server, you can now install the ZMC control plane on the same container.
- 1.As discussed before, you can reach out to our sales representative/customer support to get the ZMC Docker source file. You can begin the installation process by extracting the ZMC file and entering the extracted directory.
// extract the files
tar -xvf zmc-4132.zip
// enter into the extracted directory
cd <extracted directory>
2. Since databases are not a part of the container, you will need to set up your own database. Your database can be a MySQL container, an on-prem setup, or even installed on a remote machine provided the rest server container is able to access the machine where the database is running. To build a local database on the rest server, use the dump file titled 'zmcDB_v5.sql' to build the database
3. To connect the server to the database, the below details are needed, which are present at db_params/my.cnf config file:
- 1.The rest server IP
- 2.The port number to which the database needs to connect
- 3.The username and password to access DB
4. If you have already created the port_ranges file during the deployment of the rest server, you can skip this step. We now create the “port_ranges” file in ‘/var/lib/amanda/’. The port ranges file will have the range of port numbers that can be sequentially used by the containers. The file comprises just two lines. The first line will specify the lower limit of the port range and the second line will specify the upper limit of the port range.
10020 // Sample lower port range
10030 // Sample higher port range
5. You can now start the container with the following command.
./run-docker.dist/run-docker
A 'password' file will be generated within the same directory on executing the deployment script and successful startup of the ZMC rest server container. You can change the credentials once you login to ZMC.
6. To upload the license, you will need the MAC id of the rest server. To get the MAC id, you should run the following command within the container:
docker-compose exec app ip addr list
7. To login to ZMC on your Docker environment, you need to enter the IP address, followed by the port number of the installation. The port number will be created once the container starts running, which can be read using the below command
// display the port assigned to the ZMC server
cat port_assigned
8. To complete the installation, you need to configure the ZMC control plane to talk to the backup server.
Last modified 4d ago