For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationAPI referenceRelease notes
DocumentationAPI referenceRelease notes
  • Platform On-Prem
    • Overview
    • Navigate
      • Platform
      • Properties and environment variables reference
        • HTTP headers
        • TLS/SSL
        • Configure server
    • Search resources
  • Apps
    • FlowAI
    • Itential Automation Gateway
  • Resources
    • Itential Academy
    • Version lifecycle
    • Itential MCP
    • Accessibility conformance
    • Get support
    • FAQs
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • serverId property
  • Sample configurations
  • Single server
  • Multi-server
  • Implement serverId
Platform On-PremConfigureNetwork and security

Configure server

Was this page helpful?
Previous

Configure Redis Sentinel shared tokens

Next
Built with

Itential Platform reads properties.json at startup to get its basic configuration, including the serverId property described below.

The serverName property was removed in Platform 6 and replaced with serverId. See Server name property replaced for migration guidance.

serverId property

Don’t use a colon (:) in serverId. Redis uses colons as queue name delimiters; a colon in serverId causes Platform to broadcast to the wrong queue, which can result in a service outage.

Use serverId to assign a unique name to each Itential Platform server in your environment. Set in properties.json, it provides a consistent alternative to generated IP addresses. You can also use serverId in Blue-Green deployments.

PropertyTypeDescription
serverIdStringA unique identifier for the server. Must be unique within a Platform instance. If not provided, Platform defaults to a hashed value derived from the server’s MAC address.

Sample configurations

Single server

1"serverId": "iap-1"

Multi-server

1"serverId": "IAP1.primary"
2"serverId": "IAP2.primary"
3"serverId": "IAP3.primary"
1"serverId": "IAP1.secondary"
2"serverId": "IAP2.secondary"
3"serverId": "IAP3.secondary"

Implement serverId

If you change or add serverId and restart Platform, tasks in a running state that aren’t one of the following types are orphaned:

  • childJob
  • manual
  • forEach
  • eventListener

This only happens the first time you set or change serverId. Subsequent restarts don’t orphan jobs as long as serverId doesn’t change. Pause the task worker and verify no jobs are running before setting serverId.

Disaster recovery stacks

If your Platform stack uses Disaster Recovery (DR), don’t reuse serverId values from the primary cluster in the DR cluster. Platform checks for duplicates at the cluster level only, not globally. Duplicates across clusters can cause tasks to be orphaned when the load balancer switches from DR to the primary cluster.