IDIH Deployment on Oracle Cloud Infrastructure (OCI) with RAW Images

5.5.4 IDIH Deployment on Oracle Cloud Infrastructure (OCI) with RAW Images

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

Login to OCI with valid credentials.
Navigate to Compute, Instances, and click Create Instance.
Provide an instance name for MySQL VM. Example: MySQL_OCI.

Figure 5-28 Create Compute instance
Click Change Image, select Oracle Linux 8, and click Select Image.

Figure 5-29 Select an Image
Click Change Shape, select an appropriate shape based on the requirements and availability in the OCI compartment. Adjust the number of OCPU such as the number of vCPUs remains 6. Memory size is 16 GB. Click Select Shape and click Next.

Figure 5-30 Browse all Shapes
No changes are required in Security. Click Next.

Figure 5-31 Create Compute Instance
In the Networking, define the XMI VNIC name, VCN, and XMI subnet. Manually assign an IPv4 address.

Figure 5-32 Networking
In Add SSH keys, select own key or generate a new one. Click Next.

Figure 5-33 SSH Keys

In the Storage section, specify a custom boot volume size for the VM and click Next.

Table 5-14 VM values

VM	Boot Volume Size GB
MySQL	220
Kafka	170 GB
Services	120

Figure 5-34 Boot Volume

Review the configuration, if correct, click Create.
After the VM is created and running, navigate to Networking and click Create VNIC.

Figure 5-35 mysql-OpenStack
Provide a name for the IMI VNIC, select the IMI subnet, manually assign an IP, and click Submit, repeat step 10 for XSI1 VNIC.

Figure 5-36 Attached VNICs
SSH into the MySQL VM using the XMI interface. Use the assigned IP and SSH key. The only interface with an IP assigned is ens3.

Figure 5-37 ifconfig
Network scripts
1. Configure ens5 and ens6 by navigating to:
```
"cd /etc/sysconfig/network-scripts/"and"ll"
```
  Figure 5-38 Network Scripts
2. Run the following commands as root to configure the interfaces:
3. Configure the IMI interface:
  
  Figure 5-39 Ethernet
4. Save and close.
5. Configure the XSI1 interface
  
  Figure 5-40 XSI Interface
6. Run the following command to restart the VM:
```
[]# sudo init 6
```
7. Verify Network Interfaces: After the restart, verify if ens3, ens5, and ens6 interfaces consist IP address by running the following command:
```
[]# ifconfig
```
  Ensure the interfaces are up and running. Perform steps 1 to 22 for Kafka and Service VMs as well.
  
  Figure 5-41 ifconfig
After creating 3 VMs, ensure you can reach between all 3 VMs using their IMI IPs.
Firewall Configuration (All 3 VMs):
1. Run the following command to check firewall status:
```
sudo systemctl status firewalld
```
  Note:
  Firewall must be disabled in Services VM.
2. Run the following command if the firewall is not running, start and enable it:
```
sudo systemctl start firewalld
sudo systemctl enable firewalld
```
3. Verify the firewall is running:
```
sudo systemctl status firewalld
```
4. DNS configuration
  1. Ensure the file /etc/resolv.conf file consists the required DNS configuration.
  2. Verify that the ash proxy proxy=http://www-proxy-ash7.us.oracle.com:80is not present. Use the following configuration:
```
[main]
gpgcheck=1
installonly_limit=3
clean_requirements_on_remove=True
best=True
proxy=http://www-proxy.us.oracle.com:80
retries=100
```
  3. Unset proxies and run below commands to install tar and dos2unix utilities:
```
sudo dnf install tar
sudo dnf install dos2unix
```
Installation Package Download and Extraction: The installation TAR file can be downloaded on any of the three VMs. Extract (untar) the TAR file once downloaded.
Directory Structure: After extraction, the directory structure will appear as follows:

Figure 5-42 Directory Structure
Deployment of Components Across VMs
1. Distribute the extracted directories to their respective VMs:
  1. Copy the MySql directory to the MySQL VM at any preferred location.
  2. Copy the Kafka directory to the Kafka VM at any preferred location.
  3. Copy the Services directory to the Services VM at any preferred location.
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.
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.
```
5. 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.
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.