Cloudera Octopai Client - Linux Installation

Learn about installing Cloudera Octopai Client on supported Linux systems.

You must verify that your environment meets the general system requirements before starting the installation. For instructions, see General System Requirements for Cloudera Octopai Data Lineage Client.
You must have root or sudo access to the Linux system that must comply with the Cloudera Octopai Client system requirements.

Install required dependencies.

sudo yum update -y
sudo yum install libicu -y
sudo yum install keyutils -y

Install .NET 8 by running the following script to install .NET 8 in your preferred directory, for example, ~/.dotnet.

sudo wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
sudo chmod +x dotnet-install.sh
sudo ./dotnet-install.sh --channel 8.0 --install-dir ~/.dotnet

Add .NET to the PATH.

echo 'export DOTNET_ROOT=$HOME/.dotnet' >> ~/.bashrc
echo 'export PATH=$HOME/.dotnet:$PATH' >> ~/.bashrc
source ~/.bashrc
dotnet --version

Configure firewall rules.
Use an existing or newly installed firewall and open the required ports.
```
sudo firewall-cmd --zone=public --permanent --add-port=80/tcp
sudo firewall-cmd --zone=public --permanent --add-port=5656/tcp
```
note
For external firewalls, ensure that ports 80 and 5656 are open for both inbound and outbound traffic.
Set SELinux to disabled or permissive.
```
sudo nano /etc/selinux/config
```
1. Locate the line that starts with SELINUX= and update it to one of the following values:
```
SELINUX=disabled
```
```
SELINUX=permissive
```
2. Reboot the machine, then verify the status by using the following command:
```
sestatus
```
  The output should look like this:
```
SELinux status: disabled
```
Download TAR or zip archive file from File Manager, and extract the Cloudera Octopai Client package at /opt/Octopai-Client.
```
sudo tar xvf Octopai-Client.tar.gz
sudo yum install unzip -y
sudo unzip Octopai-Client.zip -d /opt/
```
Figure 1. License file example
Move the client folder and set permissions by using the following command:
```
sudo mv Octopai-Client /opt/
cd /opt/
sudo chmod -R 777 Octopai-Client
```
note

Apply full control using the chmod -R 777 command only to the Cloudera Octopai Client folder so that the application can read, write, and execute the files it requires.
Copy the license file by downloading the license file from File Manager and placing it in the /opt/Octopai-Client directory on the Linux host.
Run the Cloudera Octopai Client by using the following command:
```
cd /opt/Octopai-Client
dotnet OctopaiClient.dll --Urls http://0.0.0.0:5656
```
The following example shows a sample Cloudera Octopai Client output.

Figure 2. Sample Cloudera Octopai Client output
Open the Cloudera Octopai Client interface.

Go to http://localhost:5656/index.html to begin connecting systems for metadata analysis.

Create a Linux service

Configure a systemd service so the Cloudera Octopai Client starts automatically after reboots.

Create the service definition.

Edit the service file.

sudo nano /etc/systemd/system/octopai.service

Paste and adjust the following content to match your environment.

[Unit]
Description=Octopai Client
[Service]
ExecStart=/usr/bin/dotnet /opt/Octopai-Client/OctopaiClient.dll --Urls http://0.0.0.0:5656
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=octopai-client
User=octopai
Group=octopai
WorkingDirectory=/opt/Octopai-Client/
Environment=USER=octopai
[Install]
WantedBy=multi-user.target

Reload systemd configuration by using the following command:
```
sudo systemctl daemon-reload
```
Enable the service by using the following command:
```
sudo systemctl enable octopai.service
```
Start or restart the service by using the following command:
```
sudo systemctl restart octopai.service
```
Check the service log by using the following command:
```
sudo journalctl -u octopai.service
```