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
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

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.4/iwx_installer_internet_free_ubuntu2004_5.4.1.tar.gz

For Amazon Linux 2:

https://iw-saas-setup.s3.us-west-2.amazonaws.com/5.4/iwx_installer_internet_free_amazonlinux2_5.4.1.tar.gz

For RHEL 8:

https://iw-saas-setup.s3.us-west-2.amazonaws.com/5.4/iwx_installer_internet_free_rhel8_5.4.1.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.4.1.tar.gz

Step Result: The following scripts are generated in the /opt folder of the machine:

deploy_5.4.1.tar.gz, infoworks-5.4.1-ubuntu2004.tar.gz, internet-free.sh configure.sh

For Amazon Linux 2:

tar -xvf iwx_installer_internet_free_amazonlinux2_5.4.1.tar.gz

Step Result: The following scripts are generated in the /opt folder of the machine:

deploy_5.4.1.tar.gz, infoworks-5.4.1-amazonlinux2.tar.gz, internet-free.sh configure.sh

For RHEL 8:

tar -xvf iwx_installer_internet_free_rhel8_5.4.1.tar.gz

Step Result: The following scripts are generated in the /opt folder of the machine:

deploy_5.4.1.tar.gz, infoworks-5.4.1-rhel8.tar.gz, internet-free.sh configure.sh

Step 5: Configure the following parameters as described in the table, and then save the file:

NOTE Ignore the following fields in configure.sh: KEYVAULT_GLOBAL_ENABLED, KEYVAULT_ENABLED, AZURE_KEYVAULT_URI, FLAG_AZURE_KEYVAULT_AUTH_SP, AZURE_SERVICE_PRINCIPAL_OBJECT_ID, AZURE_SERVICE_PRINCIPAL_SUBSCRIPTION_ID, AZURE_SERVICE_PRINCIPAL_CLIENT_ID, KEYVAULT_FLAG_METADB_HOST, KEYVAULT_FLAG_METADB_USER, KEYVAULT_FLAG_POSTGRESDB_HOST, and KEYVAULT_FLAG_POSTGRESDB_USER.

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. NOTE This field is applicable only for MongoDB Atlas.
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://”) NOTE This field is applicable only for MongoDB Atlas.

NOTE The fields mentioned in below given table under Step 6 apply only to MongoDB Atlas. If you are not using MongoDB Atlas, skip to Step 7.

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.4.1

Last updated on Mar 29, 2023

Was this page helpful?