Appliance

Parallels Browser Isolation (PBI) Private Access

The Appliance section enables quick setup of private VMs on your premises and hosts the data plane for browser isolation. This option is only available to PBI private Access licenses.

Add an Appliance

To add an appliance:

1. Navigate to the Appliance category.

2. Click Add.

3. Configure the general settings:

   • Name: The name of the Appliance.

   • (Optional) Description: The description of the Appliance.

4. Now you should see the appliance added in the offline state.

5. Registering the appliance requires the admin to use the ellipse "..." option under the Action column.

   1. This would bring up a pop-up asking to copy the code that needs to be pasted on the console (On-Prem VM)

   

Note: You can use the "..." ellipse option to provide more info or remove an appliance

Adding VM Image

1. Download the preferred Hypervisor Image (Azure, VMware ESXi, Hyper-V) from the download option.

2. Continue setting up the image mounting onto your premises using this link for reference.

3. When the setup is completed, use the IPv4 Address to navigate the console's web page to register the Appliance.

1. Copy the code from step 5 above, and paste it into the Console's registration space.

2. The Appliance should show online, both on the appliance page and the admin portal.

Appliance Details

The table below provides various fields and their descriptions, covering the actions that can be taken on the appliance.

Field Name	Description
Name	The unique identifier or display name of the appliance. Used to distinguish it from other appliances in the system. Typically configurable during registration.
Description	A short, optional, human-readable summary providing additional context about the appliance (e.g., purpose, location, environment, or role). Optional but recommended for easier management.
Status	Indicates the current operational state of the appliance: • Not registered – Appliance exists in inventory but is not yet registered with the system. • Online – Appliance is reachable and functioning normally. • Offline – Appliance is unreachable or not responding. • Draining – Appliance is in the process of gracefully stopping services or workloads before maintenance or shutdown. • Drained – Appliance has completed draining and is safe for maintenance or shutdown.
Update State	Reflects the software/firmware update condition of the appliance: • In progress – An update is currently being installed. • Up-to-date – Appliance is running the latest approved version. • Update available – A newer version is available for installation.
CPU	Displays current CPU utilization and/or allocation metrics. Helps monitor processing capacity.
Disk	Shows disk storage usage metrics, such as total capacity, used space, and usage percentage. Useful for capacity planning and alerting.
Memory	Displays RAM usage information, including total memory, used memory, and utilization percentage. Important for performance monitoring.
Action Button	A context-aware ellipsis (⋯) button that presents available actions based on the appliance’s current state. Possible options include: • Register – Available when the appliance status is not registered. • Delete – Removes the appliance from the system (availability may depend on status being offline). • Enter Drain Mode – Initiates graceful draining process (available when Online). • Exit Drain Mode – Returns the appliance to normal operation (available when Drained).

Note: Troubleshooting an appliance requires navigating to the private appliance IP and accessing the logs, either by downloading the logs or by pushing the logs to the cloud.

Drain Mode & Appliance Upgrades

Perform Maintenance Without Disrupting Active User Sessions

Drain Mode allows administrators to perform platform maintenance and upgrades without interrupting active user browser sessions.

When enabled, the system stops assigning new sessions to selected infrastructure components while allowing existing sessions to continue normally. This ensures a seamless user experience during planned changes.

What Is Drain Mode?

Drain Mode is a controlled maintenance state that:

• Prevents new user sessions from being assigned

• Allows existing sessions to continue uninterrupted

• Gradually reduces active session count

• Safely prepares infrastructure for maintenance

Users currently working in isolated browser sessions will not be logged out when Drain Mode is enabled.

How to Enable Drain Mode

From the Admin Console, do the following:

1. Log in to the Admin Portal.

2. Navigate to: Appliance → Action Elipsis (...) → Enter Drain Mode

3. The node status will change to Draining.

4. Review:

   • Session count

   • Resource usage

5. The Appliance is ready for maintenance when:

   • Sessions Count = 0

   • Status shows Drained

6. Once fully drained, you can safely:

   • Restart the node

   • Apply updates or patches

   • Upgrade software versions

   • Delete the appliance

7. After maintenance:

   1. Navigate to

   Appliance → Action Elipsis (...) → Exit Drain Mode

   1. Confirm