Step 1: Deploy Omnia core container

The Omnia core container is deployed on the Omnia Infrastructure Manager (OIM) and it is managed as a Systemd service (omnia_core.service). As part of cluster setup, Omnia integrates with OpenCHAMI that provides the capabilities for node discovery and provisioning. You can use the omnia.sh script to install, uninstall, and view help on the actions that you can perform on the Omnia core container.

Prerequisites for deploying the Omnia core container

The OIM has internet access to download necessary packages for cluster deployment and configuration.
The OIM must have two active Network Interface Cards (NICs):
- One connected to the public network.
- One dedicated to internal cluster communication.
Ensure that Podman container engine is installed on your OIM.
If you want to use a NFS share for the omnia shared path, ensure the following:
- The NFS share has 755 permissions and no_root_squash is enabled on the mounted NFS share.
- Edit the /etc/exports file on the NFS server to include the no_root_squash option for the exported path.
```
/<your_exported_path>  *(rw,sync,no_root_squash,no_subtree_check)
```
Ensure that the following OIM hostname prerequisites are met.
- Hostname should not contain the following characters: , (comma), . (period), _ (underscore).
- Hostname cannot start or end with a hyphen (-).
- No upper case characters are allowed in the hostname.
- Hostname cannot start with a number.
- Hostname and domain name (hostname00000x.domain.xxx) cumulatively cannot exceed 64 characters.

Install Omnia core container

The omnia.sh --install command is used to deploy the Omnia core container on the OIM.

Download the omnia.sh script from the Dell Omnia GitHub repository. To download, run the following command:

OMNIA_BRANCH=<Omnia_Version/Branch>
wget https://raw.githubusercontent.com/dell/omnia/refs/heads/$OMNIA_BRANCH/omnia.sh
chmod +x omnia.sh

On the OIM, run the following command:
```
./omnia.sh --install
```
When promted for the shared path, enter the path for the Omnia shared directory. This can be a local file path or an NFS share path.
When prompted for the password, enter a secure alphanumeric password for accessing the OMNIA core container.

Caution

The password must not contain special characters such as , | , & , ; , ` , < > , * , ? , ! , $ , ( ) , { } , [ ] .

The omnia.sh script performs the following tasks:

Deploys and starts the omnia_core container as a Systemd service.
Generates an SSH key pair and stores them in the /root/.ssh folder in the core container.
Initializes the Podman container engine.
Creates the following directories within the Omnia Core Container:

/opt/omnia: Shared directory that is mapped to the Omnia shared path used by OIM.

/opt/omnia/input: Contains the input files for the playbooks.

/omnia: Contains the Omnia source code.

/opt/omnia/log/core/playbooks: Contains the playbook execution logs.

Note

Provide any file paths (for example, mapping file) that are mentioned in input files in the /opt/omnia directory.

Caution

Do not delete any key pairs generated by Omnia from /root/.ssh because this will lead to omnia_core.service execution failure.
Do not manually delete any files from the OMNIA shared directory. Use the following command to safely remove the entire OMNIA shared directory:
```
./omnia.sh --uninstall
```

Access the Omnia core container

You can access the Omnia core container using either of the following methods:

Podman: To access the Omnia core container using Podman, run the following command:
```
podman exec -it -u root omnia_core bash
```
SSH: To access the Omnia core container using SSH, run the following command:
```
ssh omnia_core
```

Uninstall Omnia core container

The omnia.sh --uninstall command removes the omnia_core container and its associated Systemd service (omnia_core.service). It also cleans up the Omnia shared directory and generated files, while preserving user-generated files such as inventory and mapping files.

Note

Before you uninstall the omnia_core container, ensure that no other containers are running on the OIM except omnia_core. If other containers are present, log in to the omnia_core container and run the following Ansible playbook to remove the containers:

cd /omnia/utils
ansible-playbook oim_cleanup.yml

To uninstall the Omnia core container, on the OIM, run the following script:

./omnia.sh --uninstall

View usage instructions for Omnia Core Container

The omnia.sh --help command provides usage instructions for managing the Omnia core container. The help menu lists the supported actions you can perform, such as installing and uninstalling the Omnia Core Container.

To view the usage instructions, on the OIM, run the following command:

./omnia.sh --help

The help menu includes:

--install: Deploys the omnia_core container and configures it as a Systemd service.

--uninstall: Stops and removes the omnia_core container and its associated service.

--help: Display usage information.

If you have any feedback about Omnia documentation, please reach out at omnia.readme@dell.com.