Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device.
Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
A standard Syndeia Cloud deployment requires an internet connection to automatically download infrastructure components like Cassandra, JanusGraph, Zookeeper, and Kafka. This process will fail in an air-gapped (offline) environment.
This guide provides the necessary steps for an offline installation. You will first download the required components onto an internet-connected machine, then transfer them to your target server.
The installation scripts are designed to automatically detect these components in the user's home directory and use the local files, bypassing the need for an internet connection.
Pre-requisites
You will need two machines for this process:
Download Host
Any computer with an internet connection (Windows, macOS, or Linux).
5 GB of available disk space.
Python 3.6+ installed.
To check if Python is installed, open a terminal or command prompt and run:
python3 --version
The output should show a version number, e.g., Python 3.9.6.
If you need to install Python, you can find downloads and instructions at the official Python website: python.org/downloads/
Python requests module:
This module is required to download the necessary installation files.
After confirming Python and pip are installed, run the following command in your terminal or command prompt to install the requests module:
python3 -m pip install requests
Syndeia Cloud docker package and credentials downloaded : Download the following python script from the password-protected link provided in the Intercax Helpdesk request where you originally received your Syndeia Cloud license. To request a copy of these, visit https://intercax.com/help and enter an Evaluation Request - or find the existing request that your colleagues or organization may have sent to Intercax in the past. This python script is provided using Intercaxβs secure, access-controlled file share service.
syndeia-cloud_infrastructure_downloader.py
Target Syndeia Server
The secure Linux server where Syndeia Cloud will be installed or upgraded.
The server must meet the OS and Hardware requirements specified here: Automated Deployment
The tarutility must be installed.
Note Regarding RLM Licensing: Syndeia utilizes RLM Intercax License Server 15.1 for floating licensing. Please refer to the requirements below:
RLM Intercax License Server 15.1 must be up and running if using a floating license pointer file. See this document for installation instructions if one has not been set up:
A valid license file or license pointer file must be present in the home directory of the user/admin that will be running the script. Syndeia requires a valid license, which you should have received when you purchased the software. Please see Linux - Intercax License Server Installation and Setup for details regarding license types. If you need help acquiring a license, you can open a ticket at intercax.com/help.
Steps
Step 1: Create the Offline Zip File on the Download Host
ON DOWNLOAD HOST: Download the syndeia-cloud_infrastructure_downloader.py script and the syndeia-cloud and infrastructure installation zip files from the password-protected links provided in the Intercax Helpdesk request where you originally received your Syndeia Cloud license. The files should be downloaded to the same directory.
ON DOWNLOAD HOST: Open a shell (e.g., Terminal, PowerShell, or Command Prompt) and navigate to the directory containing the syndeia-cloud_infrastructure_downloader.py script.
# Example Path
cd /home/user/Downloads
ON DOWNLOAD HOST: Execute the syndeia-cloud_infrastructure_downloader.py script. This script will download all required infrastructure components and package them into a single zip file along with the Syndeia-Cloud software and infrastructure zips.
The script is finished when you see the π SYNDEIA CLOUD INFRASTRUCTURE ARCHIVE READY message. The final zip file, named syndeia-cloud_infrastructure.zip, will be created in your current directory on your Download Host (/home/user/Downloads).
ON TARGET SERVER: Log in as the installation user and navigate to your home directory.
cd ~
ON TARGET SERVER: Verify that the syndeia-cloud_infrastructure.zip file is present.
ls -l
[user@target-server ~]$ ls -l
-rw-r--r-- 1 user user 1014056738 Jul 2 10:30 syndeia-cloud_infrastructure.zip
ON TARGET SERVER: Extract the syndeia-cloud_infrastructure.zip file. This will place all the required infrastructure files directly into your home directory.
ON TARGET SERVER: Confirm that the following files are present in the userβs home directory after extraction using the ls -l ~ command. - apache-cassandra-4.1.9-bin.tar.gz - cpython-3.10.17+20250517-x86_64-unknown-linux-gnu-install_only.tar.gz - janusgraph-full-1.0.0.zip - kafka_2.13-3.7.0.tgz - OpenJDK11U-jre_x64_linux_hotspot_11.0.27_6.tar.gz - packaging-25.0-py3-none-any.whl
Your Target Server is now prepared with all the necessary offline infrastructure components. The standard Syndeia Cloud Infrastructure installers are designed to detect these pre-staged files in your home directory and will use them instead of attempting to download them from the internet.
You can now proceed with the standard installation or upgrade processes from one of the following installation guides on the target server.