Convert a Single Server Deployment to a Distributed Database
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.
- OptionalIf you have docker images that you want to copy, run the following command:docker save -o <name>.tar <image>Where:
Copy the tar file you created to the machine on which you will install the application server.
- 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
- 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 that you will need to provide for the app server.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=184.108.40.206 -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> -ycommand.ParameterDescriptiondemistoserver-XThe name of the Cortex XSOAR installer, where X is the version and build number.server-onlyThe flag indicating that only the appserver is installed.db-secretA 10-character string that you will need to provide for the app server.db-addressThe database server's public IP address or hostname. Do not include the http or https prefix.external-addressThe app server's public IP address or hostname. Do not include the http or https prefix.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-- -server-only -db-secret=9876543210 -db-address=220.127.116.11 -external-address=18.104.22.168 -y
- OptionalIf 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.
- UnderServerPublic, replace the current value with an updated value.
- In Cortex XSOAR, go toSettingsIntegrationsEngines.
- ClickCreate New Engine.
- UnderInstaller Type, selectZip.
- Download the newly created engine package.
- Open thed1.conffile located in the engine package in a text editor.
- Copy the value of theServerPublicfield and past it in thed1.conffile located on your engine machine.
- 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 not found.