5.5.3 IDIH Manual Deployment on OpenStack

Perform the following procedure to perform IDIH Manual Deployment on OpenStack using IDIH VMDK image:

1. Log in to OpenStack with valid credentials.
2. From the left side menu of the OpenStack main page, click Compute, Instances, and from the Instances page, click Launch Instance in the upper menu bar.
3. In the Launch Instance page dialog box, provide the following details:
   1. Project name is automatically populated.
   2. Provide an instance name for the MySQL VM (for example mysql-openstack). and click Next.

      Figure 5-3 Details

      
      

      

      
      
4. Select an image from Select Boot Source dropdown menu (ensure the IDIH VMDK image is already present in the cloud) and verify if Create New Volume is set to No to skip creating the new volume.

   Figure 5-4 Source

   
   

   

   
   
5. Ensure that appropriate flavors are available before launching instances. Select the appropriate flavor for the MySQL VM based on the flavor table configuration:

   Table 5-11 VM Flavors

   VNFC Type	Image Name	Flavor Name	Minimum vCPUs	Minimum RAM (GB)	Minimum Disk (GB)
   EIDIH-KAFKA	kafka-9.x.0.0.0.vmdk	kafka-eidih	6	16	170
   EIDIH-SERVICE	service-9.x.0.0.0.vmdk	service-eidih	6	16	120
   EIDIH-DB	mysql-9.x.0.0.0.vmdk	mysql-eidih	6	16	220

6. Add XMI, IMI, and XSI networks for the VM.

   Note:

   XSI network is applicable only for the Kafka VM.

   Figure 5-5 Networks

   
   

   

   
   
7. Click Launch Instance, which will create the MySQL VM with the details provided above.
8. After the VM is created, click VM and go to the Console tab. Log in with valid credentials to configure the network interface.
9. To retrieve the Name of the XMI interface, run the following command:

   nmcli con show

   Figure 5-6 Retrieving Name of the XMI Interface

   
   

   

   
   
10. Retrieve the XMI interface name from the command above, then set the metric to 1 to access the XMI IP through the CLI (Command Line Interface). To access the GUI, use the service MP XMI IP.

    
    nmcli con mod '<name of XMI interface>' ipv4.route-metric 1  
    nmcli con up '<name of XMI interface>'
    

11. After the XMI interface is configured, user can SSH into the MySQL VM using the XMI IP.
12. Repeat steps 2 through 12 for the Kafka and Service VMs.
13. After all the three VMs are created, ensure that you can ping between all three VMs using their IMI IPs.

1. MySQL Setup
   1. Log in and navigate to the MySQL directory.
   2. Navigate to the /opt folder, place manual_mysql_setup.sh, and provide the required permission to run the script.
   3. Perform the following command to run the script and provide the required IP address:

      ./manual_mysql_setup.sh

   4. 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.

2. Kafka Setup
   1. Log in and navigate to the Kafka directory.
   2. Navigate to the /opt folder where the Kafka installation script need to run and provide required permission to run the script.
   3. Perform the following command to run the script:

      ./manual_kafka_setup.sh

   4. Configuration During Execution
      1. When prompted, enter the Kafka IMI IP and Kafka XSI IP.
      2. Kafka and Kraft services will be initiated on the specified IPs.
   5. 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.

3. Service Setup
   1. Log in and navigate to the /opt directory.
   2. Edit the cnidih_VM.yaml file.
   3. Replace <REPLACE WITH SOAM VIP> with a valid active SOAM IP.
   4. Navigate to the Protrace section and enable the following property: NFCONFIG_CLIENT_ENABLED to True.
   5. Save and exit.
   6. Run the following command for the Service Setup Script:

      ./manual_service_setup.sh

   7. 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.