AcademyDesign SystemFeedback

Quickstart/Local Setup

iFIX Quickstart - this is not for a production

Quickstart installation helps you jump-start with the iFIX basic installation with limited functionalities.‌

iFIX is a distributed microservice-based platform that comprises many containerized services. Depending upon the required features, the specific services can be run on any container-supported orchestration platform like docker-compose, Kubernetes, etc.‌

The Quickstart guide covers the installation steps for basic services to get the platform up. Before setting up iFIX, create a lightweight Kubernetes cluster called k3d on a local machine with specified hardware requirements. The hardware requirements are listed below to ensure before we proceed further.‌

iFIX - Quickstart/local setup

1. Infra Setup

To provision a lightweight Kubernetes cluster, follow the instructions below in context to your OS and install the k3d on your machine.‌

Hardware or VM Size

  • min 4 vCPUs (recommended 8)

  • min 8GiB of RAM (recommended 16)

  • min 30GiB of HDD (recommended 30+)

Tools

  • Linux distribution running in a VM or bare metal

    • Ubuntu 18.04 or Debian 10 (VM or bare metal)

    • Install Docker​

    • ​Install kubectl on Linux

    • Open the terminal and Install k3d on Linux using the below command

  • OSX or Mac

  • Windows 10 or above

Infra (Kubernetes Cluster) Creation

Once the above prerequisites are met, run the following tasks depending on your OS.‌

  • login/ssh into the machine, go to terminal/command prompt and run the following commands as an admin user.

  • Create /Kube directory and change permission. To use this directory for persistent data mount. This means data from all container logs will be stored here.

  • Create a cluster with a single master node and 2 agents (Worker Nodes) and mount the pre-created directory (for data persistence).

  • ‌When cluster creation is successful, get the kubeconfig file, that allows you to connect to the cluster at any time.

  • Verify the cluster creation by running the following commands from your local machine where the kubectl is installed. It gives you the sample output as below

  • You can verify the workers' nodes created by using the following command.

‌Once the above steps are completed successfully, your Cluster is now up and running ready to proceed with the DIGIT Deployment.‌

2. iFIX Setup

‌Now that we have the Infra setup to proceed with the DIGIT Deployment. Below are the tools (in the Pre-requisites section) that need to be installed on the machine before proceeding with the deployment of DIGIT Services.‌

What we'll deploy in Quickstart:‌

  • iFIX core platform services

Pre-requisites

  1. iFIX uses golang (required v1.13.3) automated scripts to deploy the builds onto Kubernetes - Linux, Windows or Mac​

  2. All iFIX services are packaged using helm charts Installing Helm​

  3. ​kubectl is a CLI to connect to the Kubernetes cluster from your machine

  4. Install CURL for making API calls

  5. ​Install Visualstudio IDE Code for better code/configuration editing capabilities

  6. The iFix services deployment configurations are in GitRepo which needs to install git and then git clone it to your local.

  7. ​Install Postman to run some DIGIT bootstrap scripts.

‌After cloning the repo CD into the folder iFix-DevOps, type the "code ." This command will open the visual editor and all the files from the repo iFix-DevOps

Check the sample deployment config file that needs to be configured as per any specific values according to your needs. (For a quick start you can run as it is)

Add the following entries in your host file /etc/hosts depending on your OS, instructions can be found here.

‌3. Deployment

‌Once the prerequisite setup is complete, go to the following repo, run the command and follow the instructions.

Test the DIGIT application status in the command prompt/terminal using the below command.

Last updated

Was this helpful?