Installing Oracle Utilities Live Energy Connect V8.0.0.2.2
The following sections describe how to install and configure Oracle Utilities Live Energy Connect V8.0.0.2.2.
Downloading and Running the Live Energy Connect V8.0.0.2.2 Installer
Oracle Utilities Live Energy Connect V8.0.0.2.2 is distributed as a self-extracting archive. After downloading to a host machine that can access the target OCNE 2.x cluster, run the archive from a shell prompt to start the installation. Running the archive will install all components needed by Oracle Utilities Live Energy Connect V8.0.0.2.2 to the OCNE 2.x cluster.
To install Oracle Utilities Live Energy Connect V8.0.0.2.2:
-
Sign into My Oracle Support.
-
Click the Patches & Updates tab.
-
Find the Patch Search section, click the Search tab, and then select Product or Family (Advanced) from the left column.
-
In the Product field, enter
Oracle Utilities Live Energy Connect
. -
In the Release drop-down list, select Oracle Utilities Live Energy Connect 8.0.0.2.0, and then click Search.
-
Check the Updated column to find the latest release, and then select the patch.
-
Click Download and then click the TAR link to download the archive; the archive will have a name of the form
lec_8.0.0.2.X.gz.run
. -
Save the archive to a machine that has network access to the running OCNE 2.x cluster. If running a libvirt cluster, this will be the host machine - for Bring Your Own model clusters, this will be a remote box with SSH access to the cluster.
-
Move the archive to a directory from which you wish to run the installation. The directory should be owned by the user that will run the installer.
-
From a shell prompt, cd to the directory containing the archive, and enter ./<ARCHIVE> to run the install (where <ARCHIVE> is the name of the archive, for example, lec_8.0.0.2.X.gz.run). The installer will detect the running OCNE 2.x cluster, and properly deploy LEC artifacts.
Note: You may need to adjust the permissions on the lec8.0.0.2.X.gz.run file to run it if you encounter any errors. To do this run the following command:
chown ${USER}: lec_8.0.0.2.X.gz.run && chmod 700 lec_8.0.0.2.X.gz.run
Troubleshooting Installation Problems
The following is a list of troubleshooting steps you can use if you encounter certain problems during the installation process:
Problem: Uncompressing Oracle Utilities Live Energy Connect ... Extraction failed
When the self-extracting archive is run, it will use the tar program to untar the contents of the installer. If it cannot call the tar command it will print the following error:
[opc@nod1 ~]$ ./lec_8.0.0.2.x.gz.run Creating directory installer Verifying archive integrity... 100% MD5 checksums are OK. All good. Uncompressing Oracle Utilities Live Energy Connect ... Extraction failed. Terminated [opc@node1 ~]$ 0% ... Decompression failed.
Solution: The tar program can be installed with the following shell command:
sudo dnf install tar
Verifying the Live Energy Connect V8.0.0.2.2 Installation
The Oracle Utilities Live Energy Connect V8.0.0.2.2 installation can be verified using the kubectl client CLI tool. To do this, run the following steps:
-
Reload the user’s Bash environment variables by exiting the interactive shell and then starting a new one.
Alternatively, you could run the command:
source ~/.bashrc
-
At the command prompt, check the status of all the pods in the “lec” namespace of the Kubernetes cluster by running the command:
kubectl get pods -n lec
This command should return a list of the LEC-specific pods in the cluster with information about their running status. If the installation was successful the status should say
Running
. The following is an example output:[opc@node1 ~]$ kubectl get pods -n lec
NAME READY STATUS RESTARTS AGE
fluentd-fld-fluentd-2g5qr 1/1 Running 1 4m
fluentd-fld-fluentd-knzfb 1/1 Running 1 4m
fluentd-fld-fluentd-m4fm7 1/1 Running 1 4m
kafka-0 1/1 Running 4 (58m ago) 3m
kafka-zookeeper-0 1/1 Running 1 3m
opensearch-cluster-master-0 1/1 Running 1 5m
os-dashboards-lec-747cdcd4cf-8874d 1/1 Running 1 5m
[opc@node1 ~]$
-
For information about a specific pod use the ‘kubectl describe pod’ command:
[opc@node1 ~]$ kubectl describe pod kafka-0
Name: kafka-0
Namespace: lec
Priority: 0
Service Account: kafka
Node: node1/192.168.122.101
Start Time: Wed, 27 Mar 2024 04:45:24 +0000
Labels: app.kubernetes.io/component=kafka
app.kubernetes.io/instance=kafka
app.kubernetes.io/managed-by=Helm
app.kubernetes.io/name=kafka
controller-revision-hash=kafka-57445667b
helm.sh/chart=kafka-20.0.2
statefulset.kubernetes.io/pod-name=kafka-0
Annotations: <none>
Status: Running
IP: 10.244.0.20
IPs:
IP: 10.244.0.20
Controlled By: StatefulSet/kafka
...
Configuring a Front-End Processor (FEP) on Your Oracle Utilities Live Energy Connect V8.0.0.2.2 Cluster
The Oracle Utilities Live Energy Connect V8.0.0.2.2 message bus is configured by clients (for example, Oracle Utilities Network Management System Flex SCADA) that send configuration information to LEC. From the client's perspective, Oracle Utilities Live Energy Connect V8.0.0.2.2 acts as a Front-End Processor (FEP) for the client.
Note: A single Oracle Utilities Live Energy Connect V8.0.0.2.2 cluster can host multiple FEPs. For example, NMS Flex SCADA users will use the Oracle Utilities Live Energy Connect V8.0.0.2.2 cluster's various applications by creating a FEP in NMS and configuring it to the connect to a particular FEP service running on the Oracle Utilities Live Energy Connect V8.0.0.2.2 cluster. The FEP service (for example, "fep7-grpc-service") running on the Oracle Utilities Live Energy Connect V8.0.0.2.2 cluster will then create and manage the resources requested by NMS FlexSCADA. By default, no FEP services are deployed on your Oracle Utilities Live Energy Connect V8.0.0.2.2 cluster. The FEP service needs to be initialized with a specified, unique FEP ID that may vary depending on the client's configuration state.
Use the following steps to create and configure a FEP on the Oracle Utilities Live Energy Connect V8.0.0.2.2 cluster so that a client, such as NMS Flex SCADA, can use the FEP service. These steps will install the FEP service on the cluster and configure the required nginx service configuration and firewalld configuration on the nodes in the cluster.
Add a FEP Service on Your Oracle Utilities Live Energy Connect V8.0.0.2.2 Cluster
On the OCNE localhost (the host from which the OCNE cluster was created), run the following steps:
-
Open a Bash shell session and cd to the
/opt/lec/scripts
directory. -
Run the following command:
./create-fep-on-ocne2.sh --id <fep_id> --port <port_number>
Where <fep_id> is the unique numeric ID assigned to the FEP service by Flex SCADA, and <port_number> is a currently unassigned port (configured in Flex SCADA) on which the FEP service shall listen.
For example:
./create-fep-on-ocne2.sh --id 7 --port 50051
-
You will be prompted to press Enter to continue with this step. You can also exit by pressing CTRL + C.