dragonfly/docs/en/user-guide/install/install-manager.md

Installing Dragonfly Manager Server

This topic explains how to install the Dragonfly manager server.

Context

Install manager in one of the following ways:

• Deploying with Docker: Recommended for production usage.
• Deploying with physical machines.

Prerequisites

When deploying with Docker, the following conditions must be met.

Required Software	Version Limit
Git	1.9.1+
Docker	1.12.0+

When deploying with physical machines, the following conditions must be met.

Required Software	Version Limit
Git	1.9.1+
Golang	1.12.x
Nginx	0.8+

Procedure - When Deploying with Docker

Get manager image

You can get it from DockerHub directly.

1. Obtain the latest Docker image of the manager.

   docker pull d7yio/manager
   

Or you can build your own manager image.

1. Obtain the source code of Dragonfly.

   git clone https://github.com/dragonflyoss/Dragonfly2.git
   

2. Enter the project directory.

   cd Dragonfly2
   

3. Build the Docker image.

   TAG="1.0.0"
   make docker-build-manager D7Y_VERSION=$TAG
   

4. Obtain the latest Docker image ID of the manager.

   docker image ls | grep 'manager' | awk '{print $3}' | head -n1
   

Start manager

NOTE: Replace ${managerDockerImageId} with the ID obtained at the previous step.

docker run -d --name manager --restart=always -p 8004:8004 ${managerDockerImageId}

Procedure - When Deploying with Physical Machines

Get cdn executable file

1. Download a binary package of the manager. You can download one of the latest builds for Dragonfly on the [github releases page](https://github. com/dragonflyoss/Dragonfly2/releases).

   version=1.0.0
   wget https://github.com/dragonflyoss/Dragonfly2/releases/download/v$version/Dragonfly2_$version_linux_amd64.tar.gz
   

2. Unzip the package.

   # Replace `xxx` with the installation directory.
   tar -zxf Dragonfly2_1.0.0_linux_amd64.tar.gz -C xxx
   

3. Move the manager to your PATH environment variable to make sure you can directly use manager command.

Or you can build your own manager executable file.

1. Obtain the source code of Dragonfly.

   git clone https://github.com/dragonflyoss/Dragonfly2.git
   

2. Enter the project directory.

   cd Dragonfly2
   

3. Compile the source code.

   make build-manaager && make install-manager
   

Start manager

manager --options

After this Task

• After manager is installed, run the following commands to verify if manager is started, and if Port 8004 and 8003 is available.

  telnet 127.0.0.1 8004