End-of-Life (EoL)
Install Cortex XSOAR Offline
Install Cortex XSOAR when you do not have internet access.
Offline installation
Use these instructions when using the Cortex
XSOAR installer script for installation with no internet connectivity.
You
need to download Cortex XSOAR dependencies and Docker images on
a machine that has internet access, and then transfer them to a
machine where you want to install Cortex XSOAR. After installing Cortex
XSOAR server, install the dependencies and images.
Always
verify that your Cortex XSOAR dependencies are updated according
to and take into account that they might change across releases.
- There are different steps for some versions and operating systems versions.
- Docker/Podman is used to run Python scripts in an isolated container.
- After installation, you need to Add a License.
- On a machine with internet access, do the following:
- Download the required dependencies for your deployment type.
- (Red Hat and CentOS) Run the following commands:sudo yum check updatesudo yum install<name of the dependency>For example,sudo yum installsystemd
- (Ubuntu and Debian) Run the following commands:sudo apt-get updatesudo apt-get install<name of the dependency>For example,sudo apt-get install systemd
- Download the Docker images by appendingdownloadName=dockerimagesto the download link you received from Cortex XSOAR.For example:wget -O dockerimages.tar "https://download.demisto.com/download-params?token=xxxxxxx&email=user@paloaltonetworks.com&downloadName=dockerimages&eula=accept"
- Download Cortex XSOAR (if not already installed).For example:wget -O demisto.sh "https://download.demisto.com/download- params?token=xxxxxxx&email=user@paloaltonetworks.com&eula=accept"
- On the machine you want to install Cortex XSOAR, do the following:
- Install Cortex XSOAR, by running one of the following commands:
- (CentOS)sudo ./demisto.sh -- -tools=false -do-not-start-server=true -C
- (Red Hat, Ubuntu, or Debian)sudo ./demisto.sh -- -tools=false -do-not-start-server=true
- (Red Hat v8 & above or CentOS v8 & above) Install and configure Podman, by following the steps in Migrate From Docker to Podman (from step 2 onwards).
- Load the Docker images that you downloaded in step 1.2, by doing one of the following:
- (Ubuntu, Debian, Red Hat v7 & below, or CentOS v7 & below) Run the following command:sudo docker load -i <YOUR_DOCKER_FILE>.tar
- (Red Hat v8 & above, or CentOS v8 & above) Do the following:
- Ensure that the docker file hasdemisto:demistoownership.
- Ensure that you are in the root directory (cd /).
- Run the following commands:sudo -su demistopodman load -i <YOUR_DOCKER_FILE>.tar
- (Optional) To verify that images are able to run, use thepodman imagescommand. You can also run thepodman images -q "demisto/python:1.3-alpine"command to validate specific images and identify any issues.
- Start the server, by running the following command:sudo systemctl start demisto
- (Optional) After installation has completed, do the following:
- Confirm that the Cortex XSOAR server status is active, by running thesystemctl status demistocommand.
- (Ubuntu, Debian, Red Hat v7 & below, or CentOS v7 & below) Confirm that the Docker service status is active, by running thesystemctl status dockercommand.
- In a web browser, go to thehttps:// serverURL: portto verify that Cortex XSOAR was successfully installed.When you open Cortex XSOAR for the first time you need to add the license.
Troubleshoot
Offline Installation
If you receive the following message, ensure you use
a version of Podman that supports archives with multiple images.
Error: error pulling "": unable to pull dir:./xsoar_docker_images.tar: error determining pull goal for image "dir:./xsoar_docker_images.tar": error parsing dest reference name "localhost/./xsoar_docker_images.tar": error parsing named reference "localhost/./xsoar_docker_images.tar": invalid reference format
Recommended For You
Recommended Videos
Recommended videos not found.