Download PDF

Installing Yadle: Self-Hosted: Yadle AI


The Yadle AI is responsible for the indexing of your files. The agent runs inside a Docker container enabling ease of deployment.

Pre-requisites:
1. Successfully Deployed Yadle servers and agent containers.
2. If running on separate machine from Yadle servers…
  • a. Linux Host Machine or VM
    • RHEL/CentOS or Debian/Ubuntu Linux Distributions
    • System Minimum Requirements
      • 4 Cores, 4GB RAM, 100GB Disk Space
    • Curl and Gunzip
  • b. Install Docker Community Edition (CE) for your OS
3. Install Docker Compose
4. Host machine can reach Yadle AI server for image analysis. (see Step 1 below)
Step 1:

Validate that your host machine can reach the Yadle AI server which runs on Google Cloud Platform (GCP). 

$ curl  -X GET http://35.192.29.208:8501/v1/models/colossus/versions/1

If successful will return:

{
      "model_version_status": [
       {
      "version": "1",
      "state": "AVAILABLE",
      "status": {
      "error_code": "OK",
      "error_message": ""
      }
    }
  ]
}
Step 2:

Download Yadle AI installation script from:

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

After you download the script, set the execute bit:

$ chmod +x install_yadle_ai
Note:
  • This is a bash script that will execute the steps needed to download, deploy, and configure a Docker version of the Yadle AI on your host. Where you save the downloaded script is unimportant – it will download the container, add it to Docker, and then configure itself.
  • The installation script can be run multiple times without issue. Each time it is run, it examines and determines the state of the container, repairing or configuring any elements that are not correct.
Step 3:

Run the Yadle AI installation script. Since Docker is being used, the script must be run as a sudoer or root user.

$ sudo ./install_yadle_ai --no_tf_serving --api_port=4444

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

Organization name:
– Organization name will be provided to you by Yadle

Organization ID:
– The Organization ID is provided to you by Yadle

Host for Yadle API server:
– The Yadle API Server host is the IPv4 of where you have deployed the Yadle servers

Yadle admin account user:
– default username:yadle

Yadle admin account password:
– default password:password

Install Directory For Yadle agent:
– Recommended:/opt/<org> Replace <org> with the organization name assigned to you by Yadle.

Data Root Path:
– Recommended: /yadle

Note:
  • The script will output many messages. Progress messages will be displayed as the container is downloaded, started and configured.
  • Any problems will be displayed in red text and the script will stop.

Starting and Stopping Yadle Agent:

The installer for the Yadle AI will generate scripts to stop and start the Docker container with the proper parameters. The scripts are start_yadle.sh and stop_yadle.sh and located in the default install directory.

$ sudo /opt/<org>/ai/start_yadle.sh
$ sudo /opt/<org>/ai/stop_yadle.sh
Note:
  • If you reboot the system that is running the Yadle AI, the containers will NOT be restarted by default. Start them with start_yadle.sh
  • start_yadle.sh and stop_yadle.sh need to run as sudoer.
Updating the Yadle agent:

To update the Yadle AI, the process is the same as the initial installation. Be sure to use the same setup parameters regarding the install directory to keep things in sync. The latest Docker image will be downloaded and container launched from it