IQ Server High Availability Installation

Sonatype IQ Server High Availability (HA) enables you to recover from failures or disruptions to the underlying host infrastructure with minimal downtime.

• IQ Server High Availability is tested and verified with the named technologies and platforms mentioned in this section. Equivalent technologies and platforms may work as well. Serverless architecture such as AWS Fargate is not supported.
• Deploy and test in a staging environment before deploying to production.

General Requirements for HA Installation

1. PostgreSQL database (10.7 or higher) or PostgreSQL-compatible service

Note
IQ Server reads the database password only at startup. Database authentication methods that rely on short-lived access tokens or external proxy layers (for example, Microsoft Entra ID or Cloud SQL Auth Proxy) are not supported for IQ HA. If such methods are used, token expiration may require restarting IQ with updated credentials.

2. The most recent version of the IQ Server HA Helm chart; instructions are found in the Helm chart README file

3. A Kubernetes cluster to run the IQ HA Helm chart:

   1. Amazon EKS for AWS deployments
   2. Kubernetes cluster for on-premises deployments

4. Each node meeting IQ Server's system requirements

5. Shared network storage
   (IQ HA supports NFSv4 and AWS EFS storage options)

   Note
   When Sonatype IQ Server is deployed in a High Availability (HA) configuration, the SCM source-control directory must be configured on shared storage that is accessible by all IQ Server HA nodes. Local (node-specific) storage is not supported.

6. A load balancer

The following deployment models have additional specific requirements.

• IQ Server HA on Amazon Web Services (AWS)
• IQ Server HA On-Premises