In our steps for setting up a single instance of Yellowfin, Yellowfin runs on port 8080 of your Docker Swarm cluster, with 4GB of allocated RAM.
Before deploying a single instance with these defaults, make sure you have already created a repository database and synced it with the same version of Yellowfin that will be used in the Yellowfin container. To do this, download the full application installer for Yellowfin, and install it on your workstation. This will create a Yellowfin repo DB as well as an instance of Yellowfin in a folder which can be deleted after configuring the containers.
For a list of supported database types, see the database information on Install And Deploy Yellowfin.
To deploy a single instance of Yellowfin, follow the steps below.
- Install the full application installer version of Yellowfin on your workstation (this is temporary to ensure the repo DB is available for the containers to use)
- Copy the web.xml file from this installation and save it as a backup to your preferred location (this acts as a reference for the Yellowfin credentials required to connect to your Yellowfin repo DB)
- Ensure Docker is running in swarm mode
Copy the following text and paste it into your preferred text editor:
Read through the above text and replace the environment variable placeholders with your own configuration details (these are located in the web.xml file of the Yellowfin installation); here’s an example to connect to a PostgreSQL instance (with a sample IP address for the connection):
- Save the text to a YAML file called yellowfin-single-istance.yml
- Run the following command in a terminal to deploy Yellowfin and execute it in the background:
docker stack deploy --compose-file yellowfin-single-instance.yml yellowfin
- Start Yellowfin by typing your host URL on port 8080
- Ensure that Yellowfin is running from your container and that you can login (this confirms that your login credentials are correct, so you can safely delete the workstation instance of Yellowfin)
- Delete the workstation instance of Yellowfin by removing the folder
Current topic - Install in a Container
The page is part of the Install in a Container topic contains the following pages, split by Docker and Kubernetes:
- Deploy to Docker without Swarm
- Deploy to Docker with Swarm
- Deploy to Kubernetes without load balancing
- Deploy to Kubernetes with Load Balancing
This page is part of the Install And Deploy Yellowfin section of the wiki, which has these topics:
Install in the Cloud
Install in a container