IDIH Manual Deployment on OpenStack Using VNFM Heat Templates

5.5.4 IDIH Manual Deployment on OpenStack Using VNFM Heat Templates

Perform the following procedure for IDIH manual deployment on OpenStack using VNFM heat templates:

Log in to the Jumpbox where you have installed all the required OpenStack libraries.
Source the OpenStack cloud RC file and upload all the three VMDK images, MySQL, Kafka, and Service, in the OpenStack.

Note:
To download the IDIH deliverable images, contact Oracle Support Team.
Download Manual Installation Scripts: Download the zip file containing all manual installation scripts for the specific version from the OHC. Extract the content for that specific version.

Figure 5-11 Oracle Help Center
Update the parameter file with the required configuration information.

To provision the IDIH setup (Kafka, MySQL, and Service VMs) on OpenStack, run the relevant creation commands below:

For deployments requiring Fixed IP addresses, run:

openstack stack create -t template/eidih_fixedIps.yaml -e environment/eidihResources_fixedIps.yaml -e environment/vnfm-eidih-fixedIp61-Params.yaml <StackName> --wait

For deployments requiring Dynamic IP addresses, run:

openstack stack create -t template/eidih_provider.yaml -e environment/eidihResources_provider.yaml -e environment/vnfm-eidih-dynamicIp61-Params.yaml <StackName> --wait

Following are the steps to configure Chrony (NTP) for all the 3 VMs:
1. Optional Step (If Required):
  1. If outbound traffic is restricted at the OpenStack security group level, ensure UDP port 123 (NTP) is allowed for egress communication.
```
Direction: Egress
Protocol: UDP
Port: 123
Destination: <NTP server IP>/32(recommended)
```
  2. From the VM, run the following command to configure the NTP:
```
vi /etc/chrony.conf
```
  3. Comment below lines at the beginning of the file, if present:
```
#server cosprings1-swi-5-rtr-1.us.oracle.com iburst
#server cosprings1-swi-6-rtr-1.us.oracle.com iburst
#server brmdc04-102-ck-rtr-1-lo0.us.oracle.com iburst
#server brmdc04-102-ck-rtr-2-lo0.us.oracle.com  iburst
```
  4. Run the following command to add the NTP server IP:
```
server <NTP_SERVER_IP> iburst
```
  5. Run the following command to restart Chrony:
```
systemctl restart chronyd
```
  6. Run the following command for Force Immediate Time Synchronization:
```
chronyc makestep
```
  7. Run the following command to verify NTP Synchronization:
```
chronyc sources -v
```
  8. Run the following command to set system Timezone:
```
EX: timedatectl set-timezone Asia/Kolkata
```
  9. Run the following command to verify Timezone and NTP Status:
```
timedatectl
```

Run the lsblk command for MySQL and Kafka VMs to verify the mount points. If /dev/vdb is mounted, perform the following steps on both the VMs. Run the steps only if the mentioned entries are present, or skip this section.

- vi /etc/fstab

Comment below lines, if they are present:
#/dev/vdb /mnt/tempVol  ext4 defaults 1 2
#/dev/vdb /var/lib/mysql  ext4 defaults 1 2

- save and close the file.
- Reboot VM by running command "reboot" in both mysql and kafka vm. 
- Login and check mysqld service: "systemctl status mysqld" and kafka service by "systemctl status kafka".

Application Setup

MySQL Setup
1. Log in to the MySQL VM and navigate to the /opt directory.
2. Copy the manual_mysql_setup.sh script to /opt and provide the required permission.
3. Run the setup script:
```
./manual_mysql_setup.sh
```
4. When prompted, enter the IMI IP address for the MySQL bind address.
5. Upon script completion, MySQL will be configured successfully.
Kafka Setup
1. Log in to the Kafka VM and navigate to the /opt folder.
2. Ensure the Kafka installation script is present and executable.
3. Run the following setup script:
```
./manual_kafka_setup.sh
```
4. During execution, provide the Kafka IMI IP and XSI IP when prompted.
5. Kafka and Kraft services will start on the specified IPs.
6. (Optional) To use the Kafka XMI IP instead of the default Kafka IMI IP for communication with DSR.
  1. Uncomment the following property:
```
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 the following property:
```
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 kraft-controller
systemctl restart kafka
```
  After running the health checks, Kafka is successfully set up on VM.
Service Setup
1. Log in to the Service VM 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 set the NFCONFIG_CLIENT_ENABLED property to true.
5. Uncomment below command only for the IPv6 setup:
```
networks:
  cnidih-network:
   external: true
#    enable_ipv6: true
# Uncomment above line if you are using IPv6 setup
# please take care of indentation ( Both of the below properties should be at same level )
# enable_ipv6: true
# external: true
```
6. Save and exit.
7. Run the service setup script:
```
./manual_service_setup.sh
```
8. 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 the services are running:
```
podman ps -a
```
    Access the UI at: https://<SERVICE XMI IP>/#/
  This completes the setup for MySQL, Kafka, and Services. The IDIH deployment is now ready for use.