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.

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

  Last updated