Add a Host

Add a new host server and scale out Cortex XSOAR multi-tenant deployments by spreading tenants across host servers.
It is recommended that you continually monitor your servers' CPU, memory, and storage usage. When capacity is reached, consider moving tenants to a new host server.
The host installation package installs and configures the new host, including the settings that will automatically connect the new host to your existing main server.
You can use the same package for all hosts that you want to add, unless you need to change the server's External Host Name or the default admin. In this case, you need to create a new host installer package for each host.
You access a new host with the multi-tenant default admin credentials that generates the host installation file.
All machines (hosts and main accounts) must be time synced, even if they are located in different time zones.
The host machine must meet the Multi-Tenant Sizing Requirements.
Run all installation commands as root user.
  1. In Cortex XSOAR, go to
    Settings
    Account Management
    .
  2. Scroll to the bottom of the page and click the
    Add Host
    button.
  3. When prompted, click the
    Download
    button to download and save the installation package.
  4. On the new host server machine, run the
    chmod +x demistohost-xxx.sh
    command to make the installer package an executable file.
  5. Run the
    sudo ./demistohost-xxx.sh
    command to install the host package.
  6. When prompted, enter the listening port used by the Cortex XSOAR server.
    The default listening port is 443.
After you add a host, the host UI is accessible, but there is no content. It serves as a proxy to the tenant accounts from the main account.
Troubleshooting
If the new host does not appear in the
Account Management
page, try the following.
  • Check the status of the host to make sure that the new service is up and running. Try restarting the host server, and if the issue persists, check the logs for potential errors. You can connect to the host using a browser with the Cortex XSOAR server default admin user to access logs and view status.
  • Check that there are no firewalls or other network devices that might block access from the new host to the Cortex XSOAR server. You can try telnet or curl from host to the Cortex XSOAR server listening port (default is 443 default) to check if the server is accessible.
  • If the host does not connect, log in to the host machine and make sure you can reach the external hostname defined on the main machine.

Recommended For You