5.5.3 IDIH Deployment on OpenStack with RAW Images

Perform the following procedure for IDIH Deployment on OpenStack with RAW Images:

1. Login to OpenStack with valid credentials.
2. Ensure appropriate flavors are available before launching instances.
3. Launch MySQL VM:
   1. Navigate to Compute, Instances and click Launch Instance.
   2. Provide an instance name, example: mysql-openstack
   3. Select the image (preferably ol8.10) and ensure Create New Volume is set to NO.

      Figure 5-24 Source

      
      

      

      
      
   4. Select the appropriate flavor for the MySQL VM as specified in the following table.

      Table 5-13 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

   5. Add XMI, IMI, and XSI networks to the VM.

      Figure 5-25 Networks

      
      

      

      
      
   6. Click Launch Instance to create the MySQL VM.
4. Configure Network Interfaces:
   1. Once the VM is created, access the console and log in with root/changeme credentials.
   2. Run nmcli con show to list network interfaces.

      Figure 5-26 Command

      
      

      

      
      
5. Disable IPv6 and configure IPv4 for the XMI interface (Optional step):
   1. nmcli con mod <xmi_interface_name> ipv6.method disabled
   2. nmcli con mod <xmi_interface_name> ipv4.address <xmi_ip_address/cidr> ipv4.gateway <xmi_gateway> ipv4.route-metric 1 ipv4.method manual
   3. nmcli con up <xmi_interface_name>

      SSH to the MySQL VM using the XMI IP and configure IMI and XSI interfaces similarly.

   4. Repeat for Kafka and Service VMs: Perform steps 1 to 12 for Kafka and Service VMs (Mandatory step).
6. Verify Connectivity:
   1. Ensure all VMs can reach each other using their IMI IPs:
      1. On all VMs, check firewall status:

         sudo systemctl status firewalld

      2. If not running, start and enable it:

         sudo systemctl start firewalld  
                 sudo systemctl enable firewalld 

      3. Edit /etc/resolv.conf to include:

         # Generated by NetworkManager  
                 search openstack.internal novalocal  
                 nameserver <nameserver_ip

      4. Edit /etc/dnf/dnf.conf to ensure no ash proxy is present:

         
         [main]
         gpgcheck=1
         installonly_limit=3
         clean_requirements_on_remove=True
         best=True
         proxy=http://www-proxy.us.oracle.com:80
         retries=100

      5. Clean DNF cache:

         sudo dnf clean all

      6. Install utilities:

         sudo dnf install tar dos2unix

7. Installation and Extraction:
   1. Download and extract the installation TAR file on any VM.
   2. Directory structure post extraction:

      Figure 5-27 Directory Structure post Extraction

      
      

      

      
      
   3. Distribute directories:
      1. MySQL directory to MySQL VM
      2. Kafka directory to Kafka VM
      3. Services directory to Service VM
8. MySQL Setup
   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.

9. 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.
   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 command to restart Kraft and Kafka services:

         systemctl restart kafka

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

10. 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>/#/

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