Offline Integration Store

This guide provides step-by-step instructions to download and install the Polarity Offline Integration Store.

Prerequisites

Before you begin, ensure the following requirements are met:

1. Operating System:

   1. Debian Linux

   2. Red Hat Linux

2. Polarity Platform:

   1. Version 5 must already be installed on the machine.

Step 1: Download the Installer

Download the installer file from the link provided by Polarity Support.

Step 2: Prepare the Installer

1. Open a terminal window.

2. Navigate to the directory where the installer file was downloaded.

3. Make the installer executable by running the following command:

   1. chmod +x store-installer-offline-selfextract.sh

Step 3: Run the Installer

Run the installer with the following command:

• ./store-installer-offline-selfextract.sh

The installer will:

1. Create a subdirectory in the install directory.

2. Extract necessary files to the subdirectory.

3. Begin the installation process.

Step 4: Installation Steps

The installer will perform the following actions:

1. Check that the Polarity Platform is already installed.

2. Copy its files to the appropriate locations within the Polarity Platform directory.

3. Load the required Docker container.

4. Update the docker-compose.yml file.

5. Update iptables (if iptables is enabled).

6. Add the POLARITY_INTEGRATION_STORE_HOSTNAME variable to the .env file.

7. Start the Polarity Offline Store container.

8. Restart the Polarity Web container.

Post-Installation Verification

After the installation is complete, the Polarity Integration Store should be available and integrated with your Polarity Platform. Verify the following:

• The Polarity Offline Store container is running.

• The docker-compose.yml file is updated with the Integration Store configuration.

• The POLARITY_INTEGRATION_STORE_HOSTNAME variable is correctly set in the .env file.

• The Polarity Web container has restarted successfully.

Additional Configuration Options

Unattended Installation

To run the installer without any prompts, use the following command:

POLARITY_UNATTENDED=true ./store-installer-offline-selfextract.sh

Custom Installation Directory

By default, the installer uses /app as the installation directory. To specify a different directory, use the POLARITY_INSTALL_DIR variable. For example:

POLARITY_INSTALL_DIR=/custom/path ./store-installer-offline-selfextract.sh

Troubleshooting

If you encounter any issues during installation:

• Ensure the Polarity Server v5 is properly installed and functional.

• Check the Docker logs output on the CLI for error messages and resolve any missing dependencies.

• Verify the installer file has execute permissions.

• Review the updated configuration files (docker-compose.yml and .env) for accuracy.

For assistance or questions, contact your Customer Success Team.