Preparing to Install the Services Director Virtual Appliance
Overview: Platforms
The Services Director Virtual Appliance (VA) can be installed on a number of platforms. Each platform has prerequisites that must be met before you begin installation, see Prerequisites.
You can install the Services Director VA as a Virtual Machine on the following platforms:
•VMware, see Installing the Services Director VA on vSphere.
•KVM-QEMU, see Installing the Services Director VA on KVM-QEMU.
•Amazon Web Services (AWS), see Installing the Services Director VA on Amazon Web Services.
After the Services Director VA is installed as a VM/instance, you must:
•Run the Services Director Setup Wizard to configure the Services Director VA for use, see Running the Services Director VA Setup Wizard.
•Review and update all Services Director settings, see Updating Services Director VA Settings.
Prerequisites
Before you install the Services Director VA and run the Setup Wizard, you must make sure that you have the correct software, files and configuration information.
Required Software for Installation
You need the following software to install the Services Director VA using a VMware hypervisor.
Software |
Description |
VMware vSphere ESXi 6.0+ |
Ivanti assumes that you are familiar with creating and managing VMs using vSphere. For detailed information about creating virtual machines using vSphere, refer to http://www.vmware.com/products/. |
Services Director VMware image in OVA format |
This image is used to install the Services Director VA. You can obtain the Services Director OVA package from Ivanti Support. |
You need the following software to install the Services Director VA using a KVM-QEMU hypervisor.
Software |
Description |
A virtualization toolset, such as libvirt or Virtual Machine Manager (VMM) |
Ivanti assumes that you are familiar with creating and managing VMs using your chosen toolset. For detailed information about creating virtual machines on KVM-QEMU, refer to http://wiki.qemu.org/KVM. |
Services Director KVM image in QCOW2 format |
This image is used to install the Services Director VA on a KVM-QEMU hypervisor. You can obtain the Services Director KVM image in QCOW2 format from Ivanti Support. |
You need an Amazon Web Services (AWS) account and a browser to use Services Director on AWS.
Required Hardware Resources for Virtual Machines
You need the following hardware resources to use Services Director VA on vSphere and KVM-QEMU.
VA Type |
CPU |
Memory |
Disk |
Services Director VA |
4 vCPU |
8 GB |
46 GB |
Your hardware must support the required configuration.
There are no hardware requirements for AWS, as it is cloud-based.
Required Files and Information
The following table lists the files and information required by the Services Director VA.
All required files must be in accessible locations in your infrastructure during the installation process. For example, locate the files on an accessible server, or your local machine.
Information |
Description |
Hostnames |
The hostname for the Services Director. When you are creating a High Availability pair, you will need a hostname for both the Primary and the Secondary Services Director nodes. |
DNS Server |
(Optional) The IP address for the primary name server. This is not required if you choose to configure your system using IP addresses rather than DNS hostnames. You can also specify a secondary name server if required. |
Primary Address |
The IP address for the Primary Services Director in a High Availability pair. |
Secondary Address |
The IP address for the Secondary Services Director in a High Availability pair. |
Service Endpoint Address |
The Management IP address for your High Availability Services Director installation. This IP address binds to the currently active Services Director. |
SSL certification and private key |
A self-signed Secure Socket Layer (SSL) certificate and private key file, which are used to protect and authenticate the REST API port. This is a local file or URL using HTTP, FTP, or SCP. For example: scp://username:password@host/path/filename Ivanti recommends that you do not use a CA-signed certificate. |
Services Director License |
The Services Director License, either for Cloud Service Providers or Enterprise customers. If you have not received your Services Director License, contact Ivanti Support for assistance. |
Resource Licenses |
For Enterprise Services Director Licenses/Customers only. This includes Bandwidth Resource Licenses, and Analytics Resource Pack Licenses. If you have not received your Licenses, contact Ivanti Support for assistance. |
Add-On Licenses |
An Add-On License is a historical license type, that is only supported on “old style” Services Director licenses. It is not compatible with “new style” Services Director licenses. |
Legacy FLA License |
(Optional) The Flexible Licensing Architecture (FLA) Legacy License is for: Any Virtual Traffic Manager (vTM) instances at version 10.0 or earlier. Any vTM instances that do not have an enabled REST API. vTMs that are at version 10.1 (or later) with their REST API enabled will use a pre-installed Universal License. |
Administrator user and password |
The administrator password for the Services Director. This password is used to access the Services Director GUI and CLI. The default administrator user is admin and the password is password. |
SMTP server and port |
(Optional) The hostname (or IP address if DNS is not configured) of the SMTP server and port. External DNS and external access for SMTP traffic is required for email notification of events and failures to function. |
Email notification address |
(Optional) A valid email address to which notification of events and failures are to be sent. |
Critical Ports That Must Be Open
The following table lists ports that must be open on the Services Director VA.
Port |
Open to Connections From |
Description |
Protocol |
22 |
Any machine that may legitimately need to access the Services Director CLI. |
The SSH port used by the CLI. |
TCP |
443 |
Any machine that may legitimately need to access the Services Director GUI. |
The graphical user interface (GUI). |
TCP |
8100 |
Any machine that may legitimately need to access the Services Director REST API, including HA pair peer and vTMs using Legacy FLA. |
The Services Director REST API. Also used for licensing vTMs that use Legacy FLA Licensing. |
TCP |
8101 |
vTMs using Universal FLA. |
The Services Director licensing server port. Used for licensing vTMs that use Universal FLA Licensing. |
TCP |
The following table lists ports that must be open on all vTM instances.
Port |
Description |
Protocol |
9070 |
The REST API port. |
TCP |
9080 |
The control port used for cluster operations. |
TCP |
9090 |
The graphical user interface (GUI). |
TCP |
9091 |
Internal vTM cluster communication. |
TCP |
Ports Blocked to External Access by the Firewall
To promote system security and to ensure access to the Services Director VA is not compromised, the following ports are blocked to external traffic by default.
Only external access is blocked. Other Services Director VA HA peer instances can continue to access services over these ports.
Port |
Description |
Protocol |
3306 |
MySQL server connections |
TCP |
33060 |
MySQL server monitor used by the Services Director VA vTM instance for health checks. |
TCP |
8889 |
Core monitor port used by the Services Director VA vTM instance. |
TCP |
9070 |
The REST API port of the internal vTM. |
TCP |
9090 |
vTM instance Admin UI and related API. |
TCP |
This behavior is enabled by default in the Services Director VA firewall rules. These rules can be configured on a port-by-port basis, or disabled altogether by changing the configuration of your firewall.
To check or configure the firewall, use the Services Director CLI. Full details on the relevant CLI commands can be found in the Pulse Secure Services Director Command Reference, available at https://www.ivanti.com/support/product-documentation.
For installations on Amazon Web Services (AWS), the firewall is turned off by default. The same protection is instead provided by ec2 security groups.