Skip to main content

(v22) Installation Steps

  • Updated

Installation Steps

To begin the installation process, you must receive the installation instructions from Composer Technical Support. This email contains the installation script that you will run on the server where the Composer environment will reside. If you have not received installation instructions, open a ticket with ComposerTechnical Support.

Important CentOS 8 Information

CentOS 8 is no longer supported by Red Hat Linux (RHEL). Use CentOS 7 instead.

Important Ubuntu Information

Ubuntu users who have Composer or Zoomdata versions earlier than 5.8 installed must first remove the legacy repository before upgrading Composer 5.8 or later. Use this command:

sudo rm -f /etc/apt/sources.list.d/saltstack.list

Steps

After you have received installation instructions from Technical Support, complete the following steps.

After you have installed Composer, review the post-installation options in Post-Installation Options. For information about accessing Composer after it is installed, see Access Composer.

Step 1: Run the Installation Script

The email or PDF you receive from Composer Technical Support describes the command used to obtain the Composer installation bootstrap procedure and the command used to run the bootstrap procedure. Run these commands, in order, on the target server for Composer to start the automated installation process.

Linux environments: The following Composer components are downloaded to your target server:

  • Database for metadata store (using PostgreSQL v12)
  • The Composer Server
  • Query Engine
  • Data Writer microservice
  • Connector microservices

Composer uses a packaged PostgreSQL v12 database instance to store its metadata and strongly recommends using this instance due to the specific configuration and version employed. If you would like to use another PostgreSQL instance, contact Technical Support for further guidance.

Windows environments:

By default, the bootstrap script installs these core components, connectors, and required dependencies:

  • Zoomdata web application
  • Query Engine
  • MSSQL
  • Mongo DB
  • Elastic 7
  • Solr
  • Cloudera Search
  • Consul
  • PostgreSQL 12
  • Corretto JDK11
  • Chocolatey

To install other components, adjust bootstrap switches as needed. See Windows Bootstrap Reference, Composer Microservice Name Reference and Composer Data Connector Reference.

When the installation script has completed, complete the remaining steps in this section.

Step 2: Configure the Firewall

See Configure the Firewall.

Step 3: Identify the IP Address

See Identify the Composer IP Address.

Step 4: Access Composer from a Web Browser

After the installation script has completed, it will take a few minutes for Composer to complete its setup of the metadata store. Please wait a few minutes before accessing Composer from your web browser. When you are ready to access Composer, read Access Composer.

We recommend that you log into Composer for the first time using supervisor credentials. This allows you to review all the account-level features available. As a supervisor, you can access functions that let you connect your data sources to Composer. You can also create and activate user accounts, including an admin user account that will allow you to access the admin functions. See Supplied User Definitions.

If you receive a message indicating that Composer is not yet accessible, the Composer setup may not yet be complete. Wait a few more minutes before trying again or opening a Support ticket. If you continue to have issues accessing Composer from your browser, open a ticket with Composer Technical Support.

Related articles

Comments

0 comments

Please sign in to leave a comment.