Configure High Availability

Last Updated: July 08, 2026

Here are the requirements and steps necessary to configure high availability for Virtual Appliance Output. The instructions included here explain how to set up your Service Agents for redundancy and storage zones. To see full details about Virtual Appliance Output high availability, see High Availability.

Requirements

Redundancy

You must specify a configured shared storage location. This storage location stores the print job while determining which Service Agent will process the job. If one Service Agent is unavailable, the job is automatically routed to another available Service Agent.

Zones (Beta)

Setting Zones gives you the choice of which Service Agents are redundant to provide high availability. If you have multiple Service Agent machines in multiple regions, this feature offers you the option to ensure redundancy is happening in the same region.

Zone requirements

  1. Each Service Agent in the same zone must use the same shared storage location.
  2. Each zone must have its own shared storage. Different zones cannot use the same shared storage.

Configure High Availability

Perform the following steps on all Service Agents you want to use for high availability.

  1. In the Admin Console, select the Service Agent.
  2. Select the Output Automation tab.
  3. In the Shared Storage section, select the type of storage location.

    1. Samba: Select Network Attached Storage Filepath field and complete the following:

      1. Enter the full file path to the storage location to store print jobs.

        Output Automation tab, Shared Storage section, showing Network Attached Storage Filepath option selected.

    2. AWS S3 bucket: Select AWS S3 Bucket and complete the following:

      1. Access Key ID: Enter the access key ID for the S3 bucket.
      2. Secret Access Key: Enter the secret access key for the S3 bucket.
      3. Region: From the dropdown menu, select the S3 bucket region.
      4. Bucket Name: Enter the S3 bucket name.

        Output Automation tab, Shared Storage section, showing AWS S3 Bucket option selected.

  4. In the Zone section, use the dropdown menu to select the zone you want to assign to this Service Agent.

    Output Automation tab, Zone section, showing Zone option.

Configure a Load Balancer Health Check for Epic

Configure the load balancer's health check to use the following curl command replacing <ServiceClientDNSName> with the DNS name of your Service Agent and the port number to the port you are using for your services.

Copy Code
curl --request GET \
  --url https://<ServiceAgentDNSName>:31990/healthcheck

Configure a Load Balancer Health Check for LPD Service

The following section covers the necessary steps to configure a load balancer health check when you use LPD Service. Of course, you can just confirm that port 515 is open, but enabling some Epic-specific settings provide more detailed information on the load balancer's status.

  1. Scroll back up to the DNS Name section.
  2. In the Domain Name field, enter the domain name of the Service Agent machine.

    Output Automation tab, DNS Name section, showing Domain Name option.

  3. In the API Print Service section, select Enable API Print Service.

    Output Automation tab, API & IPP Print Service section, showing Enable API Print Service option.

  4. Enter the information for your certificate using one of the following options:

    1. Path to Certificate: Enter the file path to where your .pem and .key files are stored on the Service Agent.

      Output Automation tab, Certificate section, showing Path to Certificate option selected.

    2. Enter Certificate: Paste the contents of the certificate body and key into the corresponding fields.

      Output Automation tab, API & IPP Print Service section, showing Certificate options.

  5. Select Save.
  6. Configure the load balancer's health check to use the following curl command replacing <ServiceClientDNSName> with the DNS name of your Service Agent.

    Copy Code
    curl --request GET \
      --url https://<ServiceClientDNSName>:31990/healthcheck