2.1. Installing Ngenea Hub¶

2.1.1. Pre-requisites¶

Before proceeding with the installation of Ngenea Hub, ensure the following conditions are met:

Ngenea Hub Version: Ensure that you are installing the latest Ngenea Hub version.

Warning

There is no direct upgrade path from Hub 1 to Hub 2.

Please contact support for guidance on performing this upgrade.

Network Requirements: Ngenea Hub must be reachable from all Ngenea Workers on the following ports:

6379/tcp
5672/tcp
8000/tcp (for Ngenea Hub versions 1.18 and above)

Software Compatibility: The interoperability page discusses compatibility between Ngenea Hub and Ngenea HSM. You can check compatibility using the Product Interoperability Matrix provided in the software documentation.

Note

For compatibility between Ngenea Hub and Ngenea Worker, the version numbers must match up to the minor version. Specifically, if the version format is major.minor.patch, both Hub and Worker must share the same major and minor versions (the patch version may differ).

Post-Installation Features: After installation, you may want to enable additional features like Search. Follow the instructions in the Feature Set-up guide for specific feature configurations.

CentOS / RedHat Systems: Ensure that the target system where you will install Ngenea Hub is running either CentOS or RedHat operating systems.

CentOS / RedHat - Offline Installation (if applicable): For offline installations, ensure that you have both the ngenea-hub and ngenea-hub-images RPM packages downloaded and available on the target system.

Docker Authentication (if applicable): If your setup requires Docker authentication (not necessary for Pixstor systems), configure it by running:

docker login eurepo.arcapix.com

2.1.2. Online Installation : CentOS / RedHat¶

Transfer the Ngenea Hub RPM Package: First, ensure that the ngenea-hub-<version>.rpm package is available on your target system. You can transfer the RPM file using various methods such as SCP, FTP, or other file transfer protocols.
Install the Ngenea Hub Package: Once the RPM file has been transferred, navigate to the directory where you stored the package and run the following command:
```
yum install ngenea-hub-<version>.rpm
```
Be sure to replace <version> with the actual version number of the Ngenea Hub RPM file.

Note

For offline installation, please refer to section Offline Installation: CentOS / RedHat.

Create Initial Configuration File (Optional): To manually set up the initial configuration for Ngenea Hub, you can edit the file located at /etc/sysconfig/ngeneahub. This configuration file includes settings for external queue systems and other deployment parameters. If you’d like to create or adjust the configuration file yourself, run:
```
ngeneahubctl createconfig
```
If you choose not to create it, the file will be automatically generated the first time you start the Ngenea Hub service.
Enable and Start the Ngenea Hub Service: To ensure the Ngenea Hub service starts automatically on system boot and also starts immediately, execute the following command:
```
systemctl enable --now ngeneahub
```
Check the Status of the Services: Verify that both the Ngenea Hub and frontend services are running correctly. Use these commands to check their status:

For the Ngenea Hub service:
```
ngeneahubctl status
```
For the frontend service:
```
systemctl status ngeneahub-frontend.path
```
These commands will display the current status of the services, indicating whether they are active and running or if any issues need to be addressed.

2.1.3. Offline Installation : CentOS / RedHat¶

When installing the Ngenea Hub on systems without internet access (due to network restrictions or other reasons), the service typically attempts to pull the necessary Docker images directly from Ngenea’s software repository. However, if this is not possible, you can perform the installation offline by using RPM packages.

Here’s how to proceed with the offline installation:

Obtain the Required RPM Packages: You need to download two RPM packages:
- ngenea-hub-<version>.rpm: This RPM contains the main application for Ngenea Hub.
- ngenea-hub-images-<version>.rpm: This additional RPM contains the Docker container images required for Ngenea Hub to operate, avoiding the need to pull them from the internet.
Both of these RPMs should be available in the same location where you obtained the main Ngenea Hub software.
Transfer RPMs to the Target System: Copy or transfer the downloaded RPM files (ngenea-hub-<version>.rpm and ngenea-hub-images-<version>.rpm) to the system where you wish to install Ngenea Hub. This can be done using USB, external storage, or any other secure transfer method.
Install the RPMs: Once the RPM files are available on the target system, you can install them using the rpm command. Open a terminal on the target system and run the following command, replacing <version> with the appropriate version number of the files you downloaded:

yum install ngenea-hub-<version>.rpm ngenea-hub-images-<version>.rpm

yum install is the command used to install RPM packages.

Verify Installation: After the RPM installation is complete, you can verify that Ngenea Hub is properly installed by checking that the service is running and the required Docker containers are available locally.