Standalone Install (Script)

Requirements

Access the machine through either a cloud shell or SSH. The snippet below is an example SSH command.

ssh -i <your_key> <user>@<public-ipv4-ip-address> 

ssh -i ~/.ssh/abc.pem [email protected]

Your pem file should have correct permissions. Confirm you have the correct permissions with the command: sudo chmod 400 <your_key>

Steps

After you enter your SSH into the Centos or Redhat VM, run these commands from the command line:

Step 1: Download the script

curl -o cdq_install.sh https://owl-packages.s3.amazonaws.com/MP/cdq_install.sh

Step 2: Modify script permission

sudo chmod +x cdq_install.sh 

Step 3: Run the script

echo | ./cdq_install.sh

Note The most common directory to use for installation is your user directory (/home/<user>). You do not need to create any directories because the install script creates the correct directory structure. You should have sudo access to perform the installation and the directory should not be a restricted system directory.

Note If you run the setup script in a non-interactive mode, such as an automated deployment, you must export the following variables for the script to run correctly:

export DQ_ADMIN_USER_PASSWORD
export DQ_ADMIN_USER_EMAIL

In this step, you are prompted to enter a default admin user email and password associated with the default admin user account.

The password must adhere to the following password policy:

• A minimum of 8 characters.
• A maximum of 72 characters.
• At least one upper-case character.
• At least one numeric character.
• At least one supported special character (!@#%$^&*?_~).
• Cannot contain the user ID (admin).

Warning As part of Collibra's password policy, you cannot proceed with installation until you enter a valid password.

Step 4: Click the URL

Sign in to the application with the username admin and the default admin password you provided in the setup script.

http://<server_name/ip>:9000

Note Make sure you have access to the server and port. Adding the correct security group or whitelisting your IP address is a common step to be able to access an application running on a cloud server.

BYOL (Optional)

Using the same command, you can bring your own license or use a different download link.

./cdq_install.sh "<Installer Download Link>" "<License Key>"

Confirmation (Optional)

Once the installation script is complete, check the details of the processes on the server.

ps -ef | grep -i spark  
ps -ef | grep -i owl-web
ps -ef | grep -i owl-agent
ps -ef | grep -i postgres

When all of the processes are up and running, sign in to your standalone instance of Collibra Data Quality & Observability.

Configure your Agent and Adding Connections as normal.

Troubleshooting

Common error messages

If you receive an error with the message, "Application already running on port 8080," enter the following command:

sudo netstat -plten |grep java

You can then use a kill command to kill the process.

kill -9 <appId>

Note If you receive a "permission denied" error message, make sure that you are using sudo.

Known Limitations

The dollar sign $ is not a supported character for passwords created via Helm during the admin password creation process in Step 3. Because passwords require at least one special character, use one of the following supported characters instead: !@#%^&*?_~.