End-of-Life (EoL)
Convert a Single Server Deployment to a Distributed Database
Deployment
Follow these instructions to convert a single server
deployment to a distributed database deployment.
This information is only intended for existing, single-server
deployments that you want to convert to a distributed database deployment.
To
ensure that you do not lose your existing data, the machine on which
Cortex XSOAR is currently installed must be converted into the database
server.
Your Cortex XSOAR Engines are currently configured
to connect to the previous configuration of the Cortex XSOAR platform,
which you have now converted to the database server. You need to
change the engine configuration so that it connects to the newly
installed Cortex XSOAR application server.
- Convert the existing deployment.
- Stop the server using thesudo service demisto stopcommand.
- (Optional)If you have docker images that you want to copy, run the following command:docker save -o <name>.tar <image>Where:
- name is the name of the output file to which you want to save the docker image
- image is the current docker image that you want to save
Copy the tar file you created to the machine on which you will install the application server. - Run the Cortex XSOAR installation package using thesudo ./demistoserver-X.sh -- -db-only -db-secret=<your_db_secret> -ycommand.ParameterDescriptiondemistoserver-XThe name of the Cortex XSOAR installer, where X is the version and build number.db-onlyThe flag indicating that only the database server is installed.db-secretA 10-character string used by the database to authenticate the app servers.yAnswers all remaining installation questions with a yes (using default settings) and enables you to continue the installation silently.For example:sudo ./demistoserver-5.0-45985.sh -- -db-only -db-secret=9876543210 -external-address=2.2.2.2 -y
- Install the Cortex XSOAR app server using thesudo ./demistoserver-X.sh-- -server-only -db-secret=<your_db_secret> -db-address=<IP or hostname> -external-address=<IP or hostname> -cluster-address=<app server address> -ycommand.ParameterDescriptiondemistoserver-XThe name of the Cortex XSOAR installer, where X is the version and build number.server-onlyThe flag indicating that only the app server is installed.db-secretA 10-character string that you defined when you installed the database server. The secret is used by the database to authenticate the app servers.db-addressThe database server's public IP address or hostname. Do not include the http or https prefix.external-addressIf not using a load balancer or a DNS server, the app server public address.If using a load balancer, the load balancer’s public IP address or hostname. Do not include the http or https prefix.If using a DNS server, the DNS server’s public IP address or hostname. Do not include the http or https prefix.cluster-addressApp server address to be used for cluster communication.yThe flag that completes the installation silently by answering yes to theremaining installation questions. Default settings are applied whereapplicable.For example:sudo ./demistoserver--5.0-45985.sh-- -server-only -db-secret=9876543210 -db-address=2.2.2.2 -external-address=3.3.3.3 -y
- (Optional)If you copied docker images from the database server to the application server, run the following command:docker load -i <name>.tarWhere name is the name of the file to which you saved the docker image(s).
- Verify that your docker images were properly loaded using thedocker imagescommand.
- Reconnect all Cortex XSOAR engines.
- Connect to the machines on which the engine is installed.
- Stop the engine service using thesudoservice d1 stopcommand.
- Navigate to/usr/local/demisto/and opend1.confin a text editor.
- UnderEngineURLsandAgentURLs, replace the current values with the app server’s external IP address or hostname.
- Restart the engine using thesudo serviced1 startcommand.
- Check the status of the engine using thesudo systemctl status d1command.The engine logs are available at/var/log/demisto/d1.log
Recommended For You
Recommended Videos
Recommended videos not found.