Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
To publish a desktop:
In the RAS Management Portal, select the Publishing category
In the middle pane, click the plus-sign icon (or choose Add from the ellipsis menu). The publishing wizard opens.
On the Publishing Type page, select Desktop and click Next.
On the Sites page, select one or more Sites (if available) from which the application should be available.
Click Next.
On the Publish from page, select from the following options:
All servers in the Site: Publish from all hosts that are available in this Site.
Server host pools: Specify one or more host pools from which to publish the application.
Individual servers: Specify one or more specific individual hosts.
Click Next.
On the Desktop page, specify the following:
In the Published Resource Settings section, specify the following:
Name: Type a name for this desktop.
Description: Type an optional description.
Connect to administrative session: Select this option if you want users to connect to the administrative session.
Start automatically when user logs in: Select if you want to open the desktop as soon as the user logs in.
Exclude from session prelaunch: The desktop will not be considered in session prelaunch scenarios.
Icon: Select an application icon.
In the Desktop Session Settings section, specify the following:
Desktop size: Specify the size. You can select from the available options and screen resolutions or you can specify custom settings. To set custom width and height, select Custom and specify the desired values in the fields provided.
Multi-Monitor: Select whether the multi-monitor support should be enabled or whether the client settings should be used.
On the next page, specify the initial status of the resource. Choose from the following options:
Enabled: End users can launch the resource.
Disabled: The resource will not appear in Parallels Client.
In maintenance: The resource will appear in Parallels Client but users will not be able to launch it. When a resource is in maintenance and a user tries to launch it, they will see a message. To customize the message, click the Configure button. For more info, see Site Defaults (Publishing).
Click Next and then click Finish to publish the desktop.
Publishing is a process of making a resource available in Parallels RAS for end users. The resources that can be published from RAS Management Portal include:
Application
Desktop
Document
Folder on the file system
Publishing is performed from the Publishing category in the RAS Management Portal.
When you select the Publishing category, the published resources are displayed in the middle pane. When you select a resource, the information about it is displayed in the right pane. If a resource is placed in a folder, you first need to expand the folder and then select the resource. To modify an existing published resource, click the Edit button in the top-right corner of the right pane.
To perform publishing tasks, use the menu bar at the top of the middle pane. From here, you can publish a new resource, add a folder (e.g. to group resources of the same type), duplicate a resource, enable or disable a resource, sort the list, and perform some other tasks.
To publish an application:
In the RAS Management Portal, select the Publishing category
In the middle pane, click the plus-sign icon (or choose Add from the ellipsis menu). The publishing wizard opens.
On the Publishing Type page, select Application and click Next.
On the Sites page, select one or more Sites (if available) from which the application should be available.
Click Next.
On the Publish from page, select from the following options:
All servers in the Site: Publish from all hosts that are available in this Site.
Server host pools: Specify one or more host pools from which to publish the application.
Individual servers: Specify one or more specific individual hosts.
Click Next.
On the Application Type page, select from the following:
Select from installed and predefined application: Choose this option to select from preinstalled and standard Windows applications.
Add single application manually: Choose this option to configure all of the application settings yourself.
Click Next.
Depending on the application type that you selected on the previous page, the next page will appear as follows:
Select from installed and predefined application: The page displays the list of preinstalled applications and application groups. You can select an entire group or individual applications. When done, click Next and follow the onscreen instructions to complete the wizard and publish the application(s). You can skip the rest of this section.
Add single application manually: The page will open where you have to specify the application settings. Read on.
If you selected Add single application manually, a page opens where you need to configure the application as described below.
In the Target Application section, specify the following:
Target: The application executable filename and path.
Start in: Path that the application should use as the current working directory (by default, the executable path).
Parameters: Application startup parameters (if any).
In the Published Resource Settings section, specify the following:
Name: Type a name for the application.
Description: Type an optional description.
Window mode: Choose from Normal, Maximized, or Minimized.
Start automatically when user logs on: Select this option if you want to start an application as soon as a user logs on. This option works on desktop versions of Parallels Client only.
Exclude from session prelaunch: The application will not be considered in session prelaunch scenarios.
Icon: Click Browse and select an icon for the application.Change Icon. Change the application icon (optional).
On the next page, specify the initial status of the resource. Choose from the following options:
Enabled: End users can launch the resource.
Disabled: The resource will not appear in Parallels Client.
In maintenance: The resource will appear in Parallels Client but users will not be able to launch it. When a resource is in maintenance and a user tries to launch it, they will see a message. To customize the message, click the Configure button. For more info, see Site Defaults (Publishing).
Click Next and then click Finish to publish the application.
To view published resources, select the Publishing category in the RAS Management Port.
The Publishing pane lists currently published resources. You can rearrange the list by dragging an item and dropping it in a desired row.
Use the ellipsis menu to perform general management tasks. The menu has the following options:
Add: Starts the publishing wizard. The plus-sign icon is the corresponding toolbar item for this menu option.
Duplicate: Creates a copy of a selected resource.
New Folder: Creates a folder in the Publishing list. This is a virtual folder, used only to group resources in the application list. The folder will appear in the application listing in Parallels Client. The folder icon is the corresponding toolbar item for this menu option.
Refresh: Refreshes the displayed information.
Set Status: Enable/disable a resource or put it into maintenance mode. A disabled resource is unavailable to users. A resource in maintenance shows up in the list on the client side but cannot be used. When the status of a resource is changed to "Disabled" or "In maintenance", the resource name in the list becomes grayed and the current state is indicated in parentheses.
Move Up: Moves a published resource up in the list. This does not change the resource ID or anything else.
Move Down: Moves a resource down in the list.
Sort: Sorts resources alphabetically. For this action item to become enabled, you must select the Published Resources node (the topmost one) or a folder containing individual resources.
Delete: Deletes a published resource. This only removes the published resource from the Farm. The actual application is not affected.
The subsequent sections describe how to manage individual published resources of different types.
To publish a folder on the file system:
In the RAS Management Portal, select the Publishing category
In the middle pane, click the plus-sign icon (or choose Add from the ellipsis menu). The publishing wizard opens.
On the Publishing Type page, select Folder on the file system and click Next.
On the Sites page, select one or more Sites (if available) from which the application should be available.
Click Next.
On the Publish from page, select from the following options:
All servers in the Site: Publish from all hosts that are available in this Site.
Server host pools: Specify one or more host pools from which to publish the application.
Individual servers: Specify one or more specific individual hosts.
Click Next.
On the Folder page, specify the following:
Name: Type a name for this folder.
Description: Type an optional description.
Window mode: Select a window mode from Normal, Maximized, or Minimized.
UNC path: Enter the UNC path of the folder you wish to publish.
Icon: Select a folder icon.
On the next page, specify the initial status of the resource (the folder). Choose from the following options:
Enabled: End users can open the resource.
Disabled: The resource will not appear in Parallels Client.
In maintenance: The resource will appear in Parallels Client but users will not be able to use it. When a resource is in maintenance and a user tries to open it, they will see a message. To customize the message, click the Configure button. For more info, see .
Click Next and then click Finish to publish the folder.
Publishing a document is similar to publishing an application, but instead of the application executable, you specify the document filename and path. See more in .
When publishing an application using a wizard, you specify multiple application parameters such as name, executable path, etc. You can modify these options after the application has been published.
To modify a published application, select it in the Publishing pane and then click Edit in the right pane to enable editing. Modify the application properties as described below.
Note that most of the settings here are the same as the settings in the application publishing wizard. For details about individual settings, please also see The descriptions below focus on settings that are not available in the wizard and can only be set here.
Most of the settings in this view are the same as in the publishing wizard. The new set of options is Per server settings. If the application is published from multiple servers, you can set the following application properties individually for each server:
Target
Start in
Parameters
As an example, you can change the above properties when different servers have the application installed in different folders, so that the Target and Start in field values are valid on each server.
The options in the Filtering category are not available in the publishing wizard and can only be set here. The category is common for published resources of all types. For complete details, see .
Please see .
This category allows you to modify file extension association for the application. To add, remove, or modify an entry, select the Associate File Extensions option. To add a new extension to the list, choose Add from the ellipsis menu and specify the desired extension. To modify an existing association, select the extension in the list and choose Properties from the ellipsis menu.
If you made changes, click the Save button or click Cancel to discard them.
This view allows you to configure where a shortcut for the application is created on a user device. These settings are inherited from site defaults, but can be customized for a given application. For details, please see .
See .
See .
To configure Site defaults for published resources:
Navigate to Infrastructure > Site defaults.
Click Publishing.
View and modify if necessary the default settings as described below.
This view allows you to configure where a shortcut for the application is created on a user device. Note that shortcuts are not available on all types of operating systems.
The options for creating shortcuts are:
Create shortcut on desktop: If selected, a shortcut will be created on the user desktop.
Create shortcut in Start folder: Creates a shortcut in the Start folder.
The edit field allows you to enter a folder name where a shortcut will be created. The default (and the only one available) %Groups% variable will add additional subfolders as they appear on the host server where the published resource is located. For example, if the resource is located in "Myapps > Games" on the host server, the same folder structure will be added to the path. Note that you cannot use any custom variables.
Create shortcut in Auto Start folder: The application shortcut will be added to the Auto Start folder and will start automatically on computer startup.
Configure the following options for better control of the application license usage:
Disable session sharing: If this option is enabled, it allows you to isolate a given published application to one session. If the same application is launched more than once, the instances of the application will share the same sessions. A different application, however, will start in its own session.
Single instance per user: If this option is enabled, a user can only launch a single instance of the application.
Concurrent licenses: Use this option to specify the maximum number of concurrent instances the application can run. For example, if the license of the application allows you to only run 10 instances of the application, set the Concurrent licenses option to 10, so once such limit is reached, other users cannot initiate other instances.
If limit is exceeded. From this drop down menu, you can specify an action that should be taken when a licensing limit is exceeded.
Configure the following options:
Wait until all RAS Universal Printers are redirected before showing the application: Enable this option to wait for printers to be redirected before the application is loaded. You can also specify the maximum wait time (in seconds) for the Universal Printers to be redirected. Please note that redirecting a printer may take some time. To avoid confusion, a progress bar is shown to the user while the printers are being redirected.
Maximum time to wait (seconds):
Color depth: Select a color depth for the application.
Start the application as maximized when using mobile clients: This option applies only to Parallels Client running on mobile devices. When the option is selected, the application will start on a mobile device in the maximized state. This gives users the best experience while working with a remote application. This option gives the RAS administrator an easy way to always maximize an application without taking any additional steps.
The Maintenance message view allows you to specify a message that users will see when trying to launch a published resource in maintenance. When a resource is in maintenance, it will still appear in Parallels Client, but will be grayed out (in User Portal, it will say so in the resource name). If a user tries to open the resource, they will see the message that you specify here. If you modified a message, but want to return the default one, select a message in the desired language and click the Reset button.
When done making changes to Site defaults, click Save.
Preferred routing is a useful feature when Parallels RAS users with different geo located deployments are connecting to the same Parallels RAS Farm/Site. A common access layer usage (RAS Secure Gateway, HALB, or a third-party load balancer) is not optimal if a resource is located in a different data center in the same RAS Farm/Site. The solution is to configure a preferred access layer server for a specific published resource, in which case any user would connect to a default Secure Gateway, but would be redirected using proximity rules set by the administrator. Typically, using the Secure Gateway closest to the session host provides improved user experience, reduced internal network traffic and associated costs along with providing better use of resources.
Note: Preferred routing doesn't apply to Azure Virtual Desktop published objects.
Here's how preferred routing works:
Parallels Client establishes a connection with a Secure Gateway using a standard authentication.
Through the RAS Connection Broker, the resource's preferred route (if configured) is identified.
Parallels Client receives the preferred public address to launch the resource.
Parallels Client then tries to launch the resource through the redirected address and falls back to the original Gateway if it fails.
To configure preferred routing, you first need to specify one or more custom public server addresses for a Site. To do so:
In the RAS Management Portal, select the Site Settings category.
In the Connection menu, select Addresses.
Click the plus-sign icon and in the dialog that opens specify a name for this custom address, an optional description, a public address, port and SSL port (it is recommended to use an SSL port for user session routing).
Once one or more custom server addresses have been configured, you can specify such an address for a published resource as follows:
Select the Publishing category.
Select a published resource.
In the middle pane, select Routing.
In the editing pane, click Edit.
Select the Enable preferred routing option.
Click the plus-sign icon.
Select a custom address from the list to be used as preferred route for this published resource.
Folders are used to organize published resources and to facilitate filtering options.
There are two types of folders that you can create:
Folders for administrative purposes. Folders of this type are intended for Parallels RAS administrators. They are used to logically organize published resources in the RAS Management Portal but they do not appear in the Parallels Client launchpad on user devices. These folders are used to help administrators manage published resources more efficiently.
Regular folders. These folders are similar to administrative folders described above but they do appear in the launchpad on user devices. You normally use these folders to group published resources by type (e.g. office applications, specific business applications, utilities, etc.).
To create a new folder:
Select the Publishing category.
In the Publishing navigation bar, click the ellipsis menu and choose New Folder (or click the folder with a plus-sign icon).
Select a Site from which the folder will be published. Click Next.
Type a name and an optional description.
Select the Use for administrative purposes option if needed (see the explanation above).
Choose an icon or use the default one.
Click Next.
On the next page, specify the initial status of the resource (the folder). Choose from the following options:
Enabled: End users can see the folder and will be able to launch published resources that it contains.
Disabled: The folder will not appear in Parallels Client.
In maintenance: The folder will appear in Parallels Client but users will not be able to launch resources that it contains. If the folder has subfolders, they inherit the status of the parent folder, which means that none of the resources contains in any of the folders in the hierarchy will be accessible to users. When a folder is in maintenance and a user tries to launch a resource from it, they will see a message. To customize the message, click the Configure button. For more info, see Site Defaults (Publishing).
Click Finish to create the folder.
To add a published resource to a folder, right-click it and use Move Up or Move Down options to position the resource under the folder icon.
Filtering rules is a feature that allows you to control who can access a particular published resource. Each rule consists of one or several criteria for matching against user connections. In turn, each criteria consists of one or several specific objects that can be matched.
You can match the following objects:
User, a group the user belongs to, or the computer the user connects from.
Secure Gateway the user connects to.
Client device name.
Client device operating system.
Theme.
IP address.
Hardware ID. The format of a hardware ID depends on the operating system of the client.
Notice the following about the rules:
Criteria are connected by the AND operator. For example, if a rule has a criteria that matches certain IP addresses and a criteria that matches client device operating systems, the rule will be applied when a user connection matches one of the IP addresses AND one of the client operating systems.
Objects are connected by the OR operator. For example, if you only create a criteria for matching client device operating systems, the rule will be applied if one of the operating systems matches the client connection.
The rules are compared to a user connection starting from the top. Because of this, the priority of a rule depends on its place in the rule list. Parallels RAS will apply the first rule that matches the user connection.
The default rule is used when no other rule is matched. You can set it to either Allow or Deny (see below), but no criteria is available for this rule.
To create a new rule:
Navigate to Publishing.
Click the resource that you want to create a rules for.
In the middle pane, select Filtering.
Click Edit.
Click the plus sign.
Specify the name and optional description for the rule.
Specify criteria for the rule. You will find the following controls:
Allow: specifies that the resource must be accessible when a user connection matches the criteria. Click Allow to change it to Deny.
Deny: specifies that the resource must be inaccessible when a user connection matches the criteria. Click Deny if to change it to Allow.
(+): adds a new criteria. If you want to match a Secure Gateway, a client device name, a client device operating system, a Theme, an IP address, or a hardware ID, click (+).
(X): Deletes a specific object from matching. For example, you want to delete IP address 198.51.100.1 from matching, click (X) next to it.
is: specifies that the resource must be accessible (or inaccessible, per Allow and Deny) when a user connection matches the criteria. Click is to change it to is not. This control appears when at least one object is added.
is not: specifies that the resource must be inaccessible (or accessible, per Allow and Deny) when a user connection does not match the criteria. Click is not to change it to is. This control appears when at least one object is added.
You can disable and enable criteria by clicking on the switch to the left of it.
Click Save when done.
To modify a published desktop, select it in the Publishing view. To view and modify desktop settings, use the navigation bar in the middle pane. To edit settings, click the Edit button.
This view lists other navigation bar items with short descriptions. You can click items here or in the navigation bar.
Lists hosts or host pools from which the desktop is published. Use the Publish from drop-down list to switch between individual hosts or host pools. Select or clear hosts or host pools as needed.
This view displays the published desktop settings. For the description of how to configure these settings, please see .
The settings in the Filtering view are not available in the publishing wizard and can only be set here. The settings are common for published resources of all types. For complete details, see .
Please see .
If you made changes, click the Save button or click Cancel to discard them.
This view allows you to configure where a shortcut for the published desktop is created on a user device. These settings are inherited from site defaults, but can be customized for a given published resource. For details, please see .