Check System Requirements

Hardware Requirements

Operating System Requirements

Network Requirements

Software Requirements

Docker Requirements

Storage Requirements

Install Docker

Configure the NodeSource Repository

Install Node.js

Remove Existing Docker-related Libraries

Configure the Docker Repository

Update System Packages

Install Docker Engine and Components

Start and Enable the Docker Service

Verify the Docker Installation

Get the INNORIX Container

Download the On-premise Package

Extract the Installation Package

Verify the Installation Directory

Deploy INNORIX

Configure the Docker Swarm Environment

Run the Server Installation

Start the INNORIX Service

Run the Hyperlink Agent

Verify the Deployment Status

Configure Your Environment

Configure Server Access

Configure the Domain

Configure Ports

Configure Environment Variables

Configure the Service

Configure Network & Storage

Configure the Network

Configure the Firewall

Configure File Storage

Configure Persistent Storage

Configure Security

Configure HTTPS

Configure the SSL Certificate

Configure Access Control

Configure Security Policies

Complete Initial Setup

Access the Web Console

Verify the Server Status

Create a Workspace

Generate an Authentication Key

Complete the Initial System Configuration

Verify Initial Configuration Completion

Verify Your Installation

Verify the Service Status

Verify the System Status

Verify Network Connectivity

Perform a File Transfer Test

Back Up & Restore

Verify Backup Targets

Back Up the System Configuration

Back Up Operational Data

Restore Procedure

Verify the Restore

Verify Backup and Restore Completion

Upgrade INNORIX

Prepare for the Upgrade

Update the Container Images

Upgrade the Services

Verify the Upgrade

Rollback Procedure

Verify Rollback Completion

Troubleshooting

Docker Installation Issues

Container Deployment Issues

Service Execution Issues

Network Connectivity Issues

License Activation Issues

Verify Logs and Analyze Issues

Verify Troubleshooting Completion

Troubleshooting

To quickly identify and resolve issues that may occur during the installation and operation of INNORIX, this section provides troubleshooting procedures for common issue scenarios.

This section describes how to troubleshoot Docker installation, Container deployment, service execution, network connectivity, license activation, and log analysis.

Docker Installation Issues

During the Docker installation process, the installation may fail due to package conflicts, Repository configuration issues, or Docker service startup problems.

Common Symptoms and Causes

Symptom	Cause	Resolution
Docker installation failed	Existing Docker package conflicts	Remove the existing Docker packages and reinstall
Repository configuration failed	Repository configuration error	Verify the Repository for the operating system
Docker command unavailable	Docker is not installed or the service is stopped	Verify the Docker installation and service status
Docker permission error	Insufficient user permissions	Run the commands with administrator privileges

Verify Docker Status

Verify the Docker service status.

bash

systemctl status docker

Verify the Docker version.

bash

docker --version

Verify the Docker Compose version.

bash

docker compose version

Actions

If the issue persists, verify the following.

Supported operating system version
Required Docker Engine version
Existing Container Runtime conflicts
Server internet connectivity

Container Deployment Issues

During INNORIX Container deployment, Containers may fail to be created due to Docker Compose configuration errors or Image download issues.

Common Symptoms and Causes

Symptom	Cause	Resolution
Container creation failed	Docker Compose configuration error	Verify the `docker-compose.yml` configuration
Image download failed	Network or authentication issue	Verify access to the Docker Repository
Container exits immediately	Environment configuration error	Verify the Container logs
Storage connection failed	Volume configuration error	Verify the storage path and permissions

Verify Container Status

Verify the status of the deployed services.

bash

docker stack services exacoola

Verify that the REPLICAS value for each service is displayed correctly.

Verify the status of individual Containers (tasks).

bash

docker stack ps exacoola

Verify that the CURRENT STATE of each task is Running.

Verification Checklist

If a Container deployment issue occurs, verify the following.

Docker service status
docker-compose.yml configuration
Server IP configuration
Storage Mount status
Successful download of the Container Images

Service Execution Issues

Even if the Containers are running successfully, issues may occur when accessing the INNORIX service or using its functionality.

Common Symptoms and Causes

Symptom	Cause	Resolution
Unable to access the Web Console	Service is not running	Verify the Container and service status
Service initialization failed	Environment configuration error	Verify the configuration files
Agent startup error	Hyperlink Agent issue	Verify the Agent status
Feature malfunction	Internal service error	Verify the logs

Service Verification Items

Item	Verification
Deployment Status	Verify that the new services and Containers have been deployed successfully
Service Status	INNORIX service status
Agent Status	Hyperlink Agent status
Configuration	Verify that the service configuration has been applied correctly

Verify the Hyperlink Agent

If you need to verify the Agent status, use the following commands.

Start:

bash

/opt/INNORIX/INNORIX_Exacoola start

Stop:

bash

/opt/INNORIX/INNORIX_Exacoola stop

Network Connectivity Issues

INNORIX requires stable network connectivity for Web Console access and file Transfer between systems.

Common Symptoms and Causes

Symptom	Cause	Resolution
Unable to access the Web Console	Blocked port	Verify the firewall configuration
Unable to access the server	IP address or DNS issue	Verify the network configuration
File Transfer failed	Target system connectivity issue	Verify the communication status
External connectivity failed	Blocked by security policy	Verify the network policy

Network Verification Items

Item	Verification
Server IP	Verify that the server IP is configured correctly
DNS	Verify domain resolution
Firewall	Verify that the required ports are allowed
Network Route	Verify the communication path

Actions

If a network issue occurs, verify the following in order.

Verify server network connectivity.
Verify the IP address and DNS configuration.
Verify the firewall policy.
Verify access to the service ports.
Verify connectivity with the target systems.

License Activation Issues

A valid license activation is required to use all INNORIX features.

Common Symptoms and Causes

Symptom	Cause	Resolution
License registration failed	Invalid License Key	Verify the issued License Key
Authentication failed	Invalid Authentication Key	Verify the Authentication Key
Feature restrictions	License not applied	Verify the license activation status
Server activation failed	Environment information mismatch	Verify the server information

License Verification Items

Item	Description
Workspace	Verify that the Workspace has been created
Authentication Key	Verify that the Authentication Key has been generated successfully
License Key	Issued license information
Server Information	Installed server information

Resolution Procedure

Verify the Workspace status.
Verify the Authentication Key.
Re-enter the License Key.
Verify the server activation status.

Verify Logs and Analyze Issues

When an issue occurs, analyze the logs to determine the root cause.

Log analysis is used to identify service errors, Container issues, and network-related problems.

Log Sources

Log Type	Description
Docker Log	Container execution and error information
Service Log	INNORIX service operation records
System Log	Server operating environment information
Network Log	Connection and communication information

Verify Docker Logs

Verify the service logs.

bash

docker service logs exacoola_[service_name]

Issue Analysis Procedure

Identify the time when the issue occurred.
Verify the service status.
Verify the Container status.
Review the relevant logs.
Analyze the cause and perform corrective actions.
Verify that the service is operating normally.

Verify Troubleshooting Completion

Verification Item	Status
Docker installation issue resolved	✓
Container deployment issue resolved	✓
Service execution issue resolved	✓
Network connectivity issue resolved	✓
License activation issue resolved	✓
Log verification and issue analysis completed	✓