Title
Create new category
Edit page index title
Edit category
Edit link
Internet-Free Installation
Requirements
Hardware Requirements
Infoworks recommends creating a Virtual Machine with the following hardware requirements:
- 64 GB RAM
- 8 vCPUs
- 200 GB disk space specifications
Operating System Requirements
The following are the OS requirements:
- UBUNTU 20.04.2-LTS
- AMAZON LINUX 2
- RHEL 8
Network Requirements
- Whitelist Port 3000 for accessing Infoworks UI.
- Ensure that the Databricks Workspace has connectivity with Infoworks Node.
Prerequisites
- Launch a virtual machine with the following images: Ubuntu Server 20.04-LTS and Red Hat Enterprise Linux 7.8 The recommended minimum hardware requirements for the VM are 64 GB RAM, 8 vCPUs, and 200 GB disk space.
- Ensure Java is installed with JDK version 8. If Java 8 is not installed select and SCP appropriate tar or download Linux x64 Compressed Archive and follow the install instructions: Java SE Development Kit 8 Downloads.
Installation Procedure on GCP
Step 1: Download the Internet-free Installer tar ball available at the following links:
- For Ubuntu 20.04:
https://iw-saas-setup.s3.us-west-2.amazonaws.com/5.3/iwx_installer_internet_free_ubuntu2004_5.3.0.tar.gz
- For Amazon Linux 2:
https://iw-saas-setup.s3.us-west-2.amazonaws.com/5.3/iwx_installer_internet_free_amazonlinux2_5.3.0.tar.gz
- For RHEL 8:
https://iw-saas-setup.s3.us-west-2.amazonaws.com/5.3/iwx_installer_internet_free_rhel8_5.3.0.tar.gz
Step 2: SCP (or copy) the tarball to /opt location of the machine.
Step 3: Log in to the machine as root user, by executing the following command:
sudo su -
Step 4: Untar the internet-free installer using the following commands:
- For Ubuntu 20.04:
tar -xvf iwx_installer_internet_free_ubuntu2004_5.3.0.tar.gz
Step Result: The following scripts are generated in the /opt folder of the machine:
deploy_5.3.0.tar.gz, infoworks-5.3.0-ubuntu2004.tar.gz, internet-free.sh configure.sh
- For Amazon Linux 2:
tar -xvf iwx_installer_internet_free_amazonlinux2_5.3.0.tar.gz
Step Result: The following scripts are generated in the /opt folder of the machine:
deploy_5.3.0.tar.gz, infoworks-5.3.0-amazonlinux2.tar.gz, internet-free.sh configure.sh
- For RHEL 8:
tar -xvf iwx_installer_internet_free_rhel8_5.3.0.tar.gz
Step Result: The following scripts are generated in the /opt folder of the machine:
deploy_5.3.0.tar.gz, infoworks-5.3.0-rhel8.tar.gz, internet-free.sh configure.sh
Step 5: Configure the following parameters as described in the table, and then save the file:
| Field | Description | Details |
|---|---|---|
| IW_USER | The Infoworks user name. The value is infoworks. | This field will be auto-filled. |
| IW_PLATFORM | Name of the Infoworks platform. The value to be entered in this field is saas. | This field will be auto-filled. |
| IW_HOME | Location where Infoworks will be installed. The value is /opt/infoworks. | This field will be auto-filled. |
| IW_CLOUD_PROVIDER | Name of the cloud provider. | Enter azure/aws/gcp. |
| IW_EDGENODE_IP | The IP address where Infoworks needs to be launched. | Provide the private IP of the virtual machine created. |
| METADB_MANAGED | This flag indicates whether the Mongo Installation is managed by Infoworks | If managed by Infoworks, enter Y (default). If managed by an external mongo, enter N. |
| METADB_USE_SRV | This flag indicated whether the MONGO_HOST corresponds to a DNS SRV record | Enter N (default) for No (prefix “mongodb://”), or Y for Yes (prefix “mongodb+srv://”) |
Step 6: Configure the following parameters as described in the table, and then save the file:
| Field | Description | Details |
|---|---|---|
| METADB_FORCE_DROP | This flag indicates whether the Installer should overwrite any existing Databases | Enter N(default) for No(the provided databases must be empty), or Y to allow dropping of databases. |
| MONGO_HOST | The Mongo Host URL to connect to. | Enter the Mongo Server or Seed DNS hostname (without prefix) |
| MONGO_USER | The Mongo User to authenticate as. | Enter a user that has at least read/write permissions over the databases mentioned.(defaults to Infoworks) |
| MONGO_PASS | The Password of the aforementioned MONGO_USER | Enter the Password of the MONGO_USER (defaults to Infoworks Mongo Password) |
| MONGO_DB | The Database Name that will store Infoworks MetaData | Enter a valid database name. |
| MONGO_QUARTZDB | The Database Name that will store Quartzio MetaData | Enter a valid database name. |
Step 7: Make configure.sh readable by infoworks user, and source it using: chmod +r configure.sh && source configure.sh.
Step 8: Execute the following command to install Infoworks:
./internet-free.sh -v 5.3.0
For more details, refer to our Knowledge Base and Best Practices!
For help, contact our support team!
© UNIPHORE TECHNOLOGIES 2025 | Confidential