5.5.2 IDIH Raw Setup

Pre-installation Requirements for IDIH Deployment

Ensure that three separate virtual machines (VMs) are provisioned with OL8.9 dev ISO image and the appropriate resource allocation as specified in the Resource Requirements for IDIH:

1. Create three VMs:
   1. Click new VM
   2. Enter the following details:
      1. name
      2. computer name
      3. Type: New
      4. Guest OS family: Linux
      5. Guest OS: Oracle Linux 8 (64 bit)
      6. Boot Image: OracleLinux-R8-U10-x86_64-dvd.iso
      7. Boot Firmware: BIOS
      8. For CPU, Memory, and Storage, refer to the IDIH Flavor Value table.
      9. Networking: (xmi, imi and xsi interface to be attached)
         Refer the following table for flavors:

         Table 5-12 IDIH Flavor Value

         Flavor Name	VCPUs	RAM(GB)	Root Disk(GB)	Ephemeral	Swap Disk
         kafka_flavor	6	16	170	0	0
         Mysql-DB-DataNode	6	16	220	0	0
         service_profile	6	16	120	0	0

         Figure 5-22 Networking

         
         

         

         
         
   3. Launch and configure VMs:
      1. Click Launch Web Console and install the OS.
      2. Configure networks in each VM and interface (xmi, imi, xsi):

         
         nmcli device connect <interface-name>
         nmcli connection modify ens256 +ipv4.address <ip-address>/24nmcliconnection up <interface-name>

      Ensure all necessary ports are accessible across XMI, XSI, and IMI interfaces on all three VMs.

      Open ports on VMware:

      [root@localhost ~]# firewall-cmd --add-port=9092/tcp --permanent
      success
      [root@localhost ~]# firewall-cmd --reload
      success
      [root@localhost ~]# firewall-cmd --list-ports
      9092/tcp

2. Installation Package Download and Extraction:
   1. Download the installation TAR file on any of the three VMs.
   2. Extract the TAR file:

      tar -xvf <tar-file-name>.tar

3. Directory Structure: After extraction, the directory structure will be as follows:

   Figure 5-23 Directory Structure

   
   

   

   
   
4. Deployment of components across VMs:
   1. Distribute directories:
      1. MySQL directory to MySQL VM
      2. Kafka directory to Kafka VM
      3. Services directory to Service VM
5. MySQL Setup

   Perform the following procedure to set up MySQL on the MySQL VM:

   1. Access the MySQL VM:
      1. Log in and navigate to the MySQL directory.
      2. Run the MySQL Setup Script:
         1. Locate setup-mysql.sh.
         2. Run the below command to run the script:

            ./setup-mysql.sh

      3. Configuration During Execution: Enter the IMI IP of the MySQL VM when prompted for the MySQL bind address.

         Completion: After the script is complete, MySQL will be successfully set up on the VM.

6. Kafka Setup
   1. Access the Kafka VM: Log in and navigate to the Kafka directory.
   2. Run the Kafka Setup Script:
      1. Locate the setup-kafka.sh script
      2. Run the below command for the script:

         ./setup-kafka.sh

   3. Configuration during execution
      1. When prompted, enter the Kafka IMI IP and Kafka XSI IP. when prompted by the script.
      2. Kafka and Kraft services will be initiated on the specified IPs.

      After the successful health check is completed, Kafka will be successfully set up on VM.

   4. Optional step, only if you need to use Kafka XMI IP instead of the default Kafka IMI IP for communication with DSR.
      1. Uncomment:

         advertised.listeners=INTERNAL_PLAINTEXT://192.168.1.237:9092,INTERNAL_SSL://192.168.1.237:9093,EXTERNAL://[kafka_xmi]:9094 line in broker.properties file(path: /opt/kafka/config) and replace[kafka_xmi] with Kafka XMI IP

      2. Comment:

         advertised.listeners=INTERNAL_PLAINTEXT://192.168.1.237:9092,INTERNAL_SSL://192.168.1.237:9093, EXTERNAL://10.196.84.46:9094 line.

      3. Run the below commands to restart Kraft and Kafka services:

         
         systemctl restart kafka

      After successful execution of the health check, Kafka is successfully set up on VM.

7. Service Setup
   1. Access the Service VM
   2. Navigate to the directory where the setup-service.sh script is located.
   3. Move the store Directory to the /opt/ path using the following command:

      mv store /opt/

   4. Edit the Docker-compose file:
      1. Navigate to the Services/ directory.
      2. Edit cnidih_VM.yaml file:
         1. <REPLACE WITH SOAM VIP> must be replaced with a valid active SOAM IP.
         2. Navigate to Protrace section and enable the following property NFCONFIG_CLIENT_ENABLED to true.
         3. Save and exit.
      3. Run the following command for the Service Setup Script:

         ./setup-service.sh

   5. Configuration during execution: The script will prompt for several inputs during execution:
      1. Enter Service IMI IP, Service XMI IP, Kafka IMI IP, and MySQL IMI IP.

         Note:

         For IPv6 setups, the above IPs must be entered in square brackets ( [] ).

         After these inputs are provided, the script will start the required services and proceed with the health check.

      2. Run the following command to verify if all services are running:

         podman ps -a

         Access the UI at: https://<SERVICE XMI IP>/#/

      Conclusion: This completes the setup for MySQL, Kafka, and Services. The deployment is now ready for use.