Installing Yadle: Self-Hosted: Yadle microservices

The Yadle microservices are responsible for the generation of a variety of different thumbnail types, metadata collection and file tagging.

This installation guide assumes Yadle servers, agent and microservices containers will be running on the same Linux host machine or VM.

Pre-requisites:
1. Successful deployment of Yadle servers.
2. Successful deployment of Yadle agent.

Step 1:

Download Yadle microservices installation script.

$ curl -O https://download.yadle.com/docker/install_yadle_microservices

Once downloaded, set the executable bit.

$ chmod +x install_yadle_microservices

Note
  • This is a bash script that will execute steps needed to download, deploy, and configure multiple Docker containers for the Yadle microservices.
  • Where you save the installation script doesn’t matter.
  • The installation script can be run multiple times without issue. Each time it is run, it examines and determines the state of the microservices containers, repairing or configuring any elements that are not correct.

Step 2:

Run the Yadle microservices installer with the selfhosted flag. Since Docker is being used, the script must be run as sudo or root user.

$ sudo ./install_yadle_microservices --selfhosted

The Yadle microservices installation script will execute and you will be prompted for the following values:

Installation Type:
– agent

Protocol used where Yadle servers are running:
– Will be either http:// or https://

IP address where Yadle servers are running:
– IPv4 address where you have deployed Yadle servers.

Yadle service account password:
– The service account password is provided to you by Yadle.

API Application ID:
– The API Application ID is provided to you by Yadle.

Install Directory:
– Recommend using the same install location for agent. /opt/<org> Replace <org> with your provided organization name.

Data Root:
– Recommended: /yadle

Note:
  • The installer script will output many messages. Progress messages will be displayed as each container is downloaded, started and configured.
  • Any problems that occur will be displayed in red text and the script will stop.
  • Successful installation will output docker status and “Installation completed”.

Step 3:

Run the Yadle microservices installer again with the selfhosted flag. This time the Installation Type will be “server”. Since Docker is being used, the script must be run as sudo or root user.

$ sudo ./install_yadle_microservices --selfhosted

The Yadle microservices installation script will execute and you will be prompted for the following values:

Installation Type:
– server

Protocol address where Yadle servers are running:
– Will be either http:// or https://

IP address where Yadle servers are running:
– IPv4 address where you have deployed Yadle servers.

Yadle service account password:
– The service account password is provided to you by Yadle.

API Application ID:
– The API Application ID is provided to you by Yadle.

Install Directory:
– Recommend using the same install location for agent. /opt/ Replace with your provided organization name.

Note:
  • The installer script will output many messages. Progress messages will be displayed as each container is downloaded, started and configured.
  • Any problems that occur will be displayed in red text and the script will stop.
  • Successful installation will output docker status and “Installation completed”.

Starting and Stopping Yadle microservices:

The installation script of Yadle microservices will generate scripts to stop and start the Docker containers for both the agent and server installation types with proper parameters. The scripts are stop_yadle and start_yadle and live in each microservices install type directory.
$ sudo /opt/<org>/microservices/agent/stop_yadle
$ sudo /opt/<org>/microservices/server/stop_yadle

$ sudo /opt/<org>/microservices/agent/start_yadle
$ sudo /opt/<org>/microservices/server/start_yadle
Note:
  • If you reboot the host machine or VM that is running the Yadle microservices, the containers will NOT restart automatically by default.
  • The start_yadle and stop_yadle scripts must be run as sudo or root user.

Updating Yadle microservices:

The installation script for the Yadle microservices will also generate scripts to run for future updating of both agent and server microservices. They are both named <org>_update_yadle_microservices and located in default installation directory for microservices.

$ sudo /opt/<org>/microservices/agent/<org>_update_yadle_microservices
$ sudo /opt/<org>/microservices/servers/<org>_update_yadle_microservices
Note:
  • The microservices update scripts must be run as sudo or root user.