Installing OctoXLabs

Welcome to the installation guide for OctoXLabs. This document provides step-by-step instructions for setting up OctoXLabs on Linux systems.

Prerequisites

• A Linux system (Ubuntu/Debian or Red Hat-based distribution).

• Root or sudo privileges.

• OctoXLabs installation package.

Step 1: Upload the Installation Package

Upload the installation package to the /tmp directory on your Linux system. You can use tools like scp or any other file transfer method.

scp octoxlabs-package.deb user@yourserver:/tmp/

Replace octoxlabs-package.deb with the actual package file name.

Step 2: Install the Package

Navigate to the /tmp directory and install the package using the appropriate command based on your Linux distribution:

For Debian-based distributions (Ubuntu, etc.):

dpkg -i /tmp/PACKAGE_PATH

For Red Hat-based distributions (RHEL, CentOS, etc.):

rpm -i /tmp/PACKAGE_PATH

Replace PACKAGE_PATH with the actual file name of the installation package.

Step 3: Run the Setup Script

Once the installation is complete, execute the setup script:

sudo octox-ctl -x setup

Step 4: Configure the Setup

The setup script will guide you through the following configurations:

1. Select Host IP:

   1. The script will detect the available IP addresses on your host.

   2. Choose the desired IP by typing Y and pressing Enter.

2. Enter Root Company Name:

   1. The script will prompt you for a root company name.

   2. Enter the name and press Enter.

Step 5: Set the Connector's Token

1. Use the following link to access the Devocto management interface:

   https://devocto02.octoxlabs.azr/#/settings/connectors?page=1&size=50

2. On the page, locate the connector labeled Default, which is pre-configured.

3. Enter the Token in the Devocto Interface

octox-ctl -x token

1. Configure Proxy Settings (Optional)

Step 6: Finalize Setup

The setup will conclude after the script executes successfully. You should see a confirmation message indicating that OctoXLabs has been installed and configured.

Troubleshooting

• Error with dpkg or rpm: Ensure you’re using the correct package for your distribution.

• Permission Denied: Confirm that you have root or sudo privileges.