(manufacia-install)=
# Install

## Check the distribution

Copy following files to the working folder.

- manufacia_**x.x.x**-gpu.tar.gz　 (**x.x.x** is version number of the delivered package. It is **the same for all following command input examples.**)
- mosquitto_1.6.2.tar.gz
- postgres_10.5.tar.gz
- redis_5.0.tar.gz

## Unzip and load images

```console
$ gunzip manufacia_x.x.x-gpu.tar.gz && docker load -i manufacia_x.x.x-gpu.tar
$ gunzip mosquitto_1.6.2.tar.gz && docker load -i mosquitto_1.6.2.tar
$ gunzip postgres_10.5.tar.gz && docker load -i postgres_10.5.tar
$ gunzip redis_5.0.tar.gz && docker load -i redis_5.0.tar
```

## Confirmation of registered docker images

Verify that the image below is output.

```console
$ docker images
...
manufacia x.x.x-gpu 73d8cc60a81a 24 hours ago 5.61GB
redis 5.0-alpine 07103bda7d12 3 months ago 51.6MB
postgres 10.5-alpine 294f651dec48 9 months ago 71.6MB
eclipse-mosquitto 1.6.2 502279616d17 7 weeks ago 5.07MB
...
```

## Setup

Run the following command.

```console
$ docker run --rm manufacia:x.x.x-gpu install-manufacia | bash
```

After a successful installation, the path of executable files will be displayed. Set the environment variable "PATH" to include the binary file path in the manner below.

```console
$ PATH="$HOME/.manufacia/bin:$PATH"
```

Once you make this setting, you will be able to use the ```manufacia_ctrl``` command.

```console
$ manufacia-ctrl
Usage: manufacia-ctrl [COMMAND] ...
Available commands:
current
versions
path
start
```

Table: manufacia_ctrl commands
| Commands   | Description |
|:---     |  ---:|  
| current | Displays the currently enabled version of MANUFACIA. |
| versions| List MANUFACIA versions that can be installed. |
| path    | Displays path of the currently enabled MANUFACIA. |
| start   | Starts MANUFACIA. |

## Confirmation of the IP address of the host machine

```console
$ hostname -I
192.168.xxx.xxx 172.17.0.1 172.18.0.1 10.1.0.1
```

or

```console
$ ifconfig
...
```

The IP address depends on the environment, so if you are not sure, check with your system administrator. For now, assume that the IP address assigned to the host machine is **192.168.xxx.xxx.** Set this IP address to the environment variable **THIS_HOST**

```console
$ export THIS_HOST=192.168.xxx.xxx
```

## Installation

If you are installing MANUFACIA for the first time, follow the steps described here. If you are not sure if you are installing MANUFACIA for the first time, execute the command shown below and check that there is no container named ```manufacia_*```.

```console
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
```

MANUFACIA will work in the environment in which `nvidia-docker` is running. Before installing MANUFACIA, make sure to confirm if `nvidia-docker` is running.

```
$ sudo docker run --runtime=nvidia --rm nvidia/cuda:11.1-base nvidia-smi
```

Install the application.

```console
$ manufacia-ctrl start
```

Check if you can see **Up** STATUS of all following six MANUFACIA containers by calling```docker ps``` command.

- manufacia_app_1
- manufacia_jarngreipr_1
- manufacia_broker_1
- manufacia_db_1
- manufacia_redis_1
- manufacia_frontend_1

```console
$ docker ps
CONTAINER ID   IMAGE                    COMMAND                   CREATED         STATUS         PORTS                                                     NAMES
d06495da0e54   manufacia:x.x.x-gpu      "supervisord --nodae..."  38 minutes ago  Up 38 minutes  0.0.0.0:3100-3101-\>3100-3101/tcp, 0.0.0.0:3122-\>22/tcp  manufacia_app_1
63df1772426c   manufacia:x.x.x-gpu      "jarngreipr serve --..."  38 minutes ago  Up 38 minutes  0.0.0.0:3280-\>8080/tcp                                   manufacia_jarngreipr_1
a6c3cbdb3e60   postgres:10.5-alpine     "docker-entrypoint.s..."  38 minutes ago  Up 38 minutes  0.0.0.0:1883-\>1883/tcp, 0.0.0.0:32780-\>9001/tcp         manufacia_broker_1
13b6b0ae19dc   eclipse-mosquitto:1.6.2  "/docker-entrypoint...."  38 minutes ago  Up 38 minutes  5432/tcp                                                  manufacia_db_1
cda3291bb252   manufacia:x.x.x-gpu      "sh -c 'inject-env f..."  38 minutes ago  Up 38 minutes  0.0.0.0:3200-\>5000/tcp                                   manufacia_frontend_1
68e03b9681db   redis:5.0-alpine         "docker-entrypoint.s..."  38 minutes ago  Up 38 minutes  6379/tcp                                                  manufacia_redis_1
```