ISC Virtual Appliance Deployment in Virtual Box

Identity Security Cloud (ISC) ISC Community Knowledge Base
,
1

Problem

Many users face challenges when installing the SailPoint ISC Virtual Appliance on virtualization platforms such as VMware or VirtualBox. The installation process can be difficult for users who are unfamiliar with virtualization settings, network configurations, or resource requirements. Common issues such as failed imports, boot errors, and connectivity problems often lead to frustration and delays. As a result, users spend significant time troubleshooting instead of focusing on onboarding applications and configuring SailPoint. A simpler and more user-friendly deployment experience would help reduce setup time and improve overall adoption.

Diagnosis

To help users overcome Virtual Appliance installation challenges, a step-by-step deployment guide has been created for Oracle VirtualBox. The guide covers VM setup, network configuration, and connectivity validation to reduce common installation errors. This enables users to deploy the SailPoint ISC Virtual Appliance more efficiently and with minimal troubleshooting.

Solution

1. Prepare the Virtual Appliance Files

  1. Create a directory on your local machine to store the Virtual Appliance (VA) installation files. For example:

    mkdir ~/staging

  2. Download the SailPoint Virtual Appliance package from the SailPoint tenant.

  3. Extract the downloaded archive into the staging directory. After extraction, you should see one or more virtualization files, depending on the package you downloaded, such as:

    • .ova – Open Virtualization Format descriptor

    These files will be used during the VirtualBox import process.

2. Import the Virtual Appliance Files

  1. Click File → Import Appliance.

image
image586×237 9.72 KB

  1. Select the .ova file and click Next.

image
image667×451 40.1 KB

  1. Keep the default settings and click Finish.

image
image678×447 48.9 KB

  1. This will import the Virtual Appliance. Once it is imported, start the VA.

3. Configuring VA in Virtual Appliance Cluster.

  1. Navigate to Admin → Connections → Virtual Appliances.
  2. Click on Create New
  3. Provide the information for Virtual Appliance Cluster and save it.

image
image929×811 29.3 KB

  1. Under Virtual Appliances section, click Add VA.

    image
    image907×895 45 KB

  2. Login to your VA that you have imported in the Oracle VMBox with the default credentials:

username: sailpoint
password: S@ilp0int

NOTE: Change the password as soon as you login.
  1. Enter the command to set up your passphrase:
va-bootstrap set-passphrase -t internal

Note: Your passphrase must be identical for every VA in the cluster. The passphrase cannot start with a special character, and cannot include !, /, \, or spaces.

  1. Enter the command to get a pairing code:
    va-bootstrap pair -t internal

  2. Enter the pairing code within 4 hours and select Pair.

  3. After few minutes, It starts showing the status as Connected.

Conclusion
VirtualBox is a powerful and flexible tool for developers and IT professionals working with IDN and other platforms. It enables easy setup of test environments, supports snapshot functionality, and offers reusable templates, making it an excellent choice for sandboxing and experimenting with virtual environments. Whether you’re new to virtualization or an experienced developer, VirtualBox can streamline your IDN development and testing workflows.

4 Likes