PowerTerm WebConnect Version 5.6.1
Legal Notice This document is subject to the following conditions and restrictions: This Guide provides documentation for PowerTerm WebConnect. Your specific product might include only a portion of the features documented in this manual. The proprietary information belonging to Ericom Software Ltd. is supplied solely for the purpose of assisting explicitly and property authorized users of. No part of its contents may be used for any purpose, disclosed to any person or firm, or reproduced by any means, electronic and mechanical, without the express prior written permission of Ericom Software Ltd. The text and graphics are for the purpose of illustration and reference only. The specifications on which they are based are subject to change without notice. The software described in this document is furnished under a license agreement. The software may be used or copied only in accordance with the terms of that agreement. Information in this document is subject to change without notice. Corporate and individual names, and data used in examples herein are fictitious unless otherwise noted. Copyright 1999-2009 Ericom Software Ltd. Ericom and PowerTerm are registered trademarks of Ericom Software Ltd. Other company brands, products and service names, are trademarks or registered trademarks of their respective holders. 2
Table of Contents LEGAL NOTICE... 2 1. PRODUCT OVERVIEW... 5 2. DESKTOP VIRTUALIZATION - GETTING STARTED... 6 3. CONNECTION BROKER FOR VDI... 15 4. CONNECTION BROKER FOR PCOIP DEVICES... 20 5. CONNECTION BROKER FOR PHYSICAL MANAGED MACHINES... 27 6. ACCESSING PUBLISHED APPLICATIONS AND DESKTOPS... 30 6.1. Using the Application Zone... 30 6.2. Using the Application Portal... 30 6.3. Using PowerTerm WebConnect with PCoIP Devices... 31 7. POWERTERM WEBCONNECT ADMINISTRATION TOOL... 32 8. FAQ... 36 3
About this Document This guide is designed to help new administrators of PowerTerm WebConnect quickly get started with the product. The content is intended for technical engineers who plan to manage PowerTerm WebConnect servers. The layout of the document is structured to provide basic instruction for the administrator to install, configure, and deploy PowerTerm WebConnect for. The content will include the following: Overview of PowerTerm WebConnect Deployment Preparations and installation procedures How to configure desktops on virtual and physical machines. Launching PowerTerm WebConnect client components to access published resources Introduction to PowerTerm WebConnect Administration Tool FAQ NOTE PCoIP users please review chapters 2, 4, and 6.3 NOTE In this document, PCoIP Portals are defined as PCoIP Clients. For additional details on each feature of PowerTerm WebConnect, please refer to the PowerTerm WebConnect Administrator s Manual, included with the installation. More information is available from the Ericom website on the following products: PowerTerm WebConnect - Terminal Services, Applications and Desktops PowerTerm WebConnect - Legacy Host Access PowerTerm WebConnect for Oracle VM PowerTerm WebConnect for WS08 4
1. Product Overview PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables organizations to provide local and remote access to applications running on Windows Terminal Servers, Virtual Desktops (on top of hypervisors such as VMWare, Microsoft, Xen, and Virtual Iron), Blade PCs, Parallels Virtuozzo and legacy hosts. Once published, applications and desktops can be accessed and used by end-users in a secure and managed fashion. PowerTerm WebConnect Deployment includes the following components: PowerTerm WebConnect Server Primary server used for user authentication, application publishing, and desktop delivery. PowerTerm WebConnect DeskView Server This component acts as the Connection Broker and makes it possible to deploy desktops and applications that run on virtual or physical machines. PowerTerm Load Balancer The PowerTerm Load Balancer provides enterprise-level System and Application Load Balancing for Terminal Services. PowerTerm WebConnect Web Components These web components provide end-users with a Web interface to access published applications. Web pages are also available to initiate automatic download of PowerTerm WebConnect components (i.e., Application Zone and RemoteView). PowerTerm WebConnect Administration Tool The administration tool provides a view for all configuration and settings for the PowerTerm WebConnect Server. Install PowerTerm WebConnect Administration Tool on the server, or on an administrator s workstation. PowerTerm Webconnect Connection Broker Administration Tool This administration console is installed as a part of PowerTerm WebConnect DeskView Server, the Connection Broker. This console provides a view for all configuration and settings related to deploying virtual and physical desktops. Use this console to configure your connection broker environment. Client-side components Client side components are loaded on the user s workstation/device and connects to user requested applications and desktops managed by the PowerTerm WebConnect server. 5
2. - This overview provides steps to follow in order to configure Ericom PowerTerm WebConnect as a connection broker for VDI and PCoIP access. Review server pre-requisites for Ericom installation. Check that the hypervisor and/or devices are on. Have any hypervisor connection information ready. Install PowerTerm WebConnect Server (Full installation will include the connection broker features as well). Reboot server after installation. Launch the Connection Broker Tool to configure the VDI and/or PCoIP environment. Configure DeskView Server settings and enable logging. 6
Add Hosts to the Connection Broker Tool that will be managed. Have any hypervisor connection details prepared for this step. Create Pools to logically group devices for deployment. Assign Active Directory users/groups to pools for dynamic deployment, or assign to specific machine for static deployment. Use the Administration Tool to publish applications and additional desktops. Instruct users on how to access applications and desktops using the Application Zone or Application Web portal. For PCoIP users, verify that clients are able to connect to pools or PCoIP hosts. NOTE The evaluation package of PowerTerm WebConnect contains the PowerTerm WebConnect Enterprise product with all its components. Once activated, the product will only include the components and features of the specific PowerTerm WebConnect product you registered or purchased. Step 1: Preparation/Pre-requisites Ericom recommends certain components and roles to be present on the server for a smooth installation. Verify that the following are prepared on the destination server for PowerTerm WebConnect: Windows 2003 or higher 400 MB of free Hard-Disk space for the PowerTerm WebConnect Server and 256 KB of RAM for each active session Microsoft.NET Framework v3.0 and higher for PowerTerm WebConnect DeskView Server Microsoft Management Console 3.0, for PowerTerm WebConnect Connection Broker Administration Tool 7
For Managed Machines: IP Range and/or DNS Pattern For VDI: Connection and login information for desired hypervisors (see chapter 3 for more information) For Web Portal Access: Enable IIS role on the server Step 2: Installation The following is a summary of the installation process: 1. Click the Download button on the Product Download page. The Download ptdj.exe dialog appears. NOTE The installer file name may vary. The installer download may also have been provided via an alternate method. 2. Run the executable. The Ericom Setup dialog appears. Follow the steps of the Installation wizard. 3. Enter your Serial Number, or click Evaluate when prompted. Note that the Evaluation version has full functionality but is limited by 30-day expiration. 4. Continue with the installation and select Full Installation All PowerTerm WebConnect components (default), in the Setup Type dialog. The Connection Broker component (DeskView) will be installed as well. 8
5. Complete the installation and click Exit and Run PowerTerm WebConnect in the last dialog of the installation. Depending on your system speed this may take a few minutes. 6. It is recommended to reboot the server after the installation but not required. NOTE The first time PowerTerm WebConnect server is started it will generate a Diffie-Hellman key for SSL encryption. This process may take several minutes, depending on the speed of the computer. A visual progress indicator will be displayed (only in OS s that are older than or equal to XP), while this process is active. During this process, PowerTerm WebConnect clients will not be able to connect to the server. Step 3: Launch the Administration Tools There are two administration consoles: PowerTerm WebConnect Administration Tool, manages publishing of applications and desktops, based on Terminal Server or VDI pools. Connection Broker Administration Tool, is used to configure PowerTerm WebConnect features for VDI and managed systems (including PCoIP devices). This console manages the PowerTerm WebConnect Connection Broker (DeskView) service. Supported VDI hosts include hypervisor-based systems, Parallels Containers, and physical machines. Once hosts are added, create resource pools for managing deployment of available desktops. Other functions include assignment of desktops and pools to Active Directory users and groups and configuring controls for PCoIP devices. There are two ways to login to the Connection Broker: 1. Launch PowerTerm WebConnect Connection Broker Console directly from the Start menu, select Programs Ericom Software PowerTerm WebConnect 5.x Connection Broker. The Connect dialog appears. Continue to point 5 below. Or, Launch PowerTerm WebConnect Administration Tool from the Start menu, select Programs Ericom Software PowerTerm WebConnect 5.x PowerTerm WebConnect Administration Tool: 9
2. The PowerTerm WebConnect Administration Tool Welcome dialog appears: 3. Close the dialog. PowerTerm Administration Tool main screen opens: 10
4. Select Tools Run Connection Broker Administration Tool. The Connect dialog appears: 11
NOTE PowerTerm WebConnect Administration Tool will prompt a notification message if MMC is not installed on the OS. Follow the installation wizard to install it and then continue to connect. 5. Enter User identification and click Connect. You can use the local administrator or domain administrator credentials to login to the Connection Broker Administration Tool. The PowerTerm WebConnect - Connection Broker Administration Tool opens: 6. Click Actions Settings. The Settings dialog appears: 12
Under the Network tab, a list of available Domains will be displayed. If a desired Domain is not listed, verify that the Ericom server can properly browse the desired domain. Only domains listed in this list can authenticate via PowerTerm WebConnect. It is recommended to click on Properties and enter administrative credentials for each listed Domain. The credentials are necessary for deployment of Ericom Tools to VDI-based machines. Credentials are optional when working with PCoIP devices. Under the Logs Files tab, log parameters are listed. It is recommended to enable Errors Only and General. Enabling other log parameters are useful, but will lead to faster growing log files. Under the PCoIP tab, functions related to discovery and deployment are available. PowerTerm WebConnect supports logo and firmware deployment via FTP. 7. Click OK to complete the configuration. 13
The next step is to configure the Connection Broker for VDI (see chapter 3) or PCoIP (see chapter 4) and Physical Managed Machine (see chapter 5) access. 14
3. Connection Broker for VDI PowerTerm WebConnect is a connection broker to manage access between enduser devices and VDI based hosts. Verify that PowerTerm WebConnect Server and DeskView Server are installed and launch PowerTerm WebConnect Connection Broker Administration Tool. Step 1: Verify Pre-requisites You will need the following connection and login information to assign hypervisors to PowerTerm WebConnect: VMware Virtual Center 2.x and VMware ESX 3.x/ESX 3i Web service address (e.g. https://<server>/sdk) Username and password to the VirtualCenter Microsoft Hyper-V DNS/IP of the Hyper-V machine Username and password to the VirtualCenter Domain that can access the host Microsoft Virtual Server Name/IP of the Virtual Server XenServer Server name or IP Root username/password Xen Community, Red Hat Xen, Novell Xen, and KVM Driver Transports Server Address Username/Password Port Path Extra Parameters (if any) Oracle VM Server s agent URL and Port 15
Oracle VM hypervisor s Oracle Agent Username/Password Virtual Iron Server URL Username/Password that can access the host Step 2: Adding Hosts 1. Right-click Managed Hosts and select Add Host. The Add a New Host wizard opens. Click Next. 2. Specify desired Host Provider and click Next. 3. Enter a Display Name as you would like it to appear in PowerTerm WebConnect Connection Broker Administration Tool and a description (optional). Click Next. 4. Specify the connection information based on host type. 16
Step 3: Creating and using Pools to deploy desktops Pools are used to organize physical and virtual machines into logical groups. This enables organizations to combine and order resources from multiple systems into one entity. To access available resources, end-users simply connect to PowerTerm WebConnect to access any configured resource. 1. Right-click Pools and select Create Pool. The Create a Pool wizard opens. Click Next. 2. Enter a Pool name (this will be displayed to end-users) and a description (optional and not displayed to end-users) and click Next. 3. Specify the Assignment Type and the Assignment Duration: Static, resources in this pool are manually mapped to users, computers, and MAC addresses. If this option is selected, the Owner tab is disabled. Dynamic, a free resource in the pool will be assigned to the user making a request. Persistent, once the user receives an available resource, it will be mapped permanently to the user until the Administrator resets the mapping. Non-Persistent, the assigned resource will be available to the next user once the current user is finished. 4. Click Next and set Owners if desired. Click Add to browse your directory service for desired users and groups that will have access to this resource. 5. Click Next and specify the Logoff/Disconnect events: Select the power setting to take effect after a user logs off from a machine in this pool. Select the power setting to take effect when a user is disconnected from a machine in this pool. 6. (Optionally) Check Logoff when machine is in Idle time and insert a value for Idle time. 7. Click Next and then Finish. The new Pool was added. To change any settings in the future: 1. Select the pool. 2. Right-click Properties. Assign physical and virtual machines from your virtualization hosts to your created pool: 17
1. Right-click the pool and select Assign Machines. The Assign Machines to <your pool name> dialog opens. 2. Check the desired machine(s) and/or host(s), and click Select. Click OK. Step 4: Publishing Applications/Desktops NOTE Open port 4030 on the VM image firewall that you want to publish from. NOTE For each pool created in PowerTerm WebConnect Connection Broker Administration Tool a default full desktop connection with the same name is automatically created and displayed in the Connections list in PowerTerm WebConnect Administration Tool. 1. Return to PowerTerm WebConnect Administration Tool to publish applications and desktops. 2. Determine whether to publish a full desktop or a seamless application running from a virtual desktop: For a full desktop: Select Action New Remote Windows Desktop For a seamless application: Select Action New Windows Application 3. Select Virtual Desktop in the first step of the wizard and click Next. 4. Follow the wizard s instructions until you reach the Virtual Desktop step. 5. Select a pool that you previously created and that you would like this connection to choose physical and virtual machines from. Click Next. 6. Continue and complete the reminder of the wizard s steps. Once the resource is published, users who have been assigned access will be able to use it immediately. Step 5: Installing Ericom Tools Install the Ericom Tools (vmagent.msi) on each machine in order for PowerTerm WebConnect DeskView (VDI) to manage it. 18
Centralized Method Ericom Tools may be deployed from the PowerTerm WebConnect Connection Broker Administration Tool: NOTE PowerTerm WebConnect DeskView services require that Domain Administrator credentials be defined in the Domain (Settings) to utilize Ericom Tools deployment from the Connection Broker console. (For more information see PowerTerm WebConnect Administrator s Manual.) Right-click on the device and select Install Ericom Tools. The Connection Broker must recognize the IP of the VM in order to deploy Ericom tools to it. Installation status can be viewed under the VM s Recent Tasks. Manual Method The vmagent.msi installer is located on the PowerTerm WebConnect server in <PowerTerm WebConnect installation folder>\addons\deskview VDI folder (default installation folder is C:\Program Files\Ericom Software\WebConnect 5.6). During installation, enter the DeskView Server IP address or NETBIOS name. NOTE Installation of Ericom Tools on PCoIP devices has to be done manually and not remotely. Select the PCoIP (install GINA) checkbox during installation. If the Ericom Tools are not installed, the Ericom Tools status will show Unknown. If the Ericom Tools are properly installed the status will appear as Connected. (If the Ericom Tools later is directed to another VDI server or stopped, this server will show as Disconnected.) 19
4. Connection Broker for PCoIP Devices PowerTerm WebConnect is a connection broker that manages access between PCoIP clients and hosts. To start configuration launch PowerTerm WebConnect - Connection Broker Administration Tool. Step 1: Adding PCoIP Host 1. Right-click Managed Hosts and select Add Host. The Add a New Host wizard opens. Click Next. fa 3. Enter a Display Name as you would like it to appear in PowerTerm WebConnect Connection Broker Administration Tool and a description (optional). Click Next. Note that the user will not see this name or description. 20
4. (Optional) Specify a Default Pool if desired. A Default Pool allocates all devices of the host into one pool. Devices within a host linked to a Default Pool cannot be assigned to any other pools. This can be changed later under the host s Properties. 5. Click Next and then Finished. The new Host will be added. 6. To make any changes, right-click on the host and select Properties. Step 2: Adding PCoIP Hosts and Clients When initially viewing the PCoIP host, the device list will be empty. To populate devices in the host list, use the built-in SLP Discovery feature: 1. Right-click the PCoIP folder and select Discovery Find PCoIP Hosts/Clients respectively. The PCoIP Devices dialog appears displaying available devices. 2. Select the hosts/clients to add and click OK. The devices will appear under the PCoIP Host/Client list. NOTE SLP-based discovery is not designed for multi-subnet environments. For multi-subnet support use DNS-SRV based Discovery. Information on this may be found in the Teradici user guide. When DNS-SRV based discovery is used, devices will automatically appear in the PCoIP host list. There is no configuration required in the Ericom Connection Broker. Step 3: Creating and using Pools to deploy desktops Pools are used to organize PCoIP into logical groups. This enables organizations to order resources based on its role or function. To access available resources, end-users simply connect from a PCoIP client or login to PowerTerm WebConnect from a workstation to access any configured resource. PCoIP clients may be dynamically assigned to hosts based on availability. This is useful for situations where a group of users can share a common base of devices. For example, if there are 100 users in a call center, but only 10 users are active at any time, assign the 100 users to a pool of 10 devises. This feature eliminates the need to manage mappings and providing a desktop for every user. The next section (step 4) explains static assignments in more detail. To create a static or dynamic pool, perform the following: 1. Right-click Pools and select Create Pool. The Create Pool wizard opens. Click Next. 2. Enter a Pool name (this is displayed to end-users) and a description (optional) and click Next. 3. Specify the Assignment Type and the Assignment Duration: Static, resources in this pool are manually mapped to users, computers, or 21
PCoIP clients. Each device in the pool must be allocated to a user or device in order for it to be accessed. (See step 4 for more information.) Dynamic, a free resource in the pool will be assigned to the user when the pool is launched. This enables a fixed group of devices to be shared among users. Persistent, once the user receives an available resource, it will be mapped permanently to the user until the Administrator resets the mapping. Non-Persistent, the assigned resource is restricted during use, but will be available to the next user once the current user is finished. 4. Click Next and set Owners if desired. This is only applicable to dynamic pools as static pools have all devices previously assigned (i.e. Owners defined in the device s Properties): Click Add to browse your Active Directory service for desired users and groups that will have access to this pool. Only Owners of the pool will have access. 5. Click Next and specify the Logoff/Disconnect events. Leave these settings at default values for PCoIP pools. 6. (Optionally) Select Logoff when machine is in Idle time and insert a value for Idle time. 7. Click Next and then Finish. The new Pool will be added. To change settings in the future: 1. Select the Pool. 2. Right-click Properties. To assign PCoIP hosts to the pool: 1. Right-click the pool and select Assign Machines. The Assign Machines to <your pool name> dialog opens. 2. Check the desired machine(s) and click Select. Click OK. 22
3. Devices indicated by a red box mean that they have been assigned to another Pool. Step 4: Static assignment of PCoIP clients to hosts PCoIP clients may be statically assigned to hosts. Static assignment maps certain PCoIP clients directly to PCoIP hosts. Perform the following to create static assignments. 1. Right-click the desired machine (host) and select Properties. 2. Select the Owners tab. 23
3. Click Add PCoIP Client to select a client to assign to the host. 4. Select the desired client and press Select. 5. Click OK. The Owner will be assigned. When the user connects from an assigned PCoIP client, it will connect to the host as mapped in the Connection Broker. NOTE The PCoIP host must be allocated in a static pool in order to accept static connections from PCoIP clients. NOTE Ericom Tools are not required for Static Mapping or PCoIP connections. Step 5: Username access without using Ericom Tools For scenarios where Ericom Tools cannot be installed on the PCoIP host, username access (free seating) is still supported. NOTE When Ericom Tools is not running on the PCoIP host, the host will not be available for RDP access via PowerTerm WebConnect. To enable username access for PCoIP devices: 1. Right click and select Settings. 24
2. Select the PCoIP tab and select the Do not force PCoIP hosts to use Ericom Tools checkbox (The name of this feature may vary depending on PowerTerm WebConnect version being used.) 3. Click OK. 4. Create dynamic pools (see Step 3 previously) and assign PCoIP hosts to each pool. 5. The user must connect from a PCoIP host that is not statically mapped to a host. A PowerTerm WebConnect login dialog will appear. 6. When the user logs in one of the following will occur: If the user only has one pool assigned, the PCoIP client will make a dynamic connection to a PCoIP host in the assigned pool and display the login screen of the host operating system If the user has more than one pool assigned, a pool selection dialog will appear for the user s selection. Upon selection, the user will be directed to the login screen of the respective device. If a user is directed to a pool where no machines are available, the user will see a message stating No Machines Available. In order to provide the user with a desktop, another machine can be added to the pool, or the user can select an alternate pool that contains free machines. 25
Step 6: Install Ericom Tools Ericom Tools relay important information about the machine back to the PowerTerm WebConnect server. It is recommended to install Ericom Tools (but not required) in each virtual or physical machine that will be managed by PowerTerm WebConnect. The Ericom Tools installer (vmagent.msi) is located on the PowerTerm WebConnect server in <PowerTerm WebConnect installation folder>\addons\deskview VDI folder (default installation folder is C:\Program Files\Ericom Software\WebConnect 5.6). 1. Launch vmagent.msi from the desktop that will receive Ericom Tools. 2. During installation, enter the DeskView Server IP address or NETBIOS/DNS name. If Ericom Tools is installed successfully, a Connected status will appear under the Ericom Tools field for the respective VM in the Connection Broker Admin console. If Ericom Tools is not operating properly, Unknown will be displayed as the status. 26
5. Connection Broker for Physical Managed Machines PowerTerm WebConnect is a connection broker to manage access between Physical Managed Machine clients and hosts. This function secures access to centrally hosted desktops to users based on username (free seating), computer name (fixed seating), or MAC address (fixed seating). To start configuration launch PowerTerm WebConnect - Connection Broker Administration Tool. Step 1: Adding Hosts 1. Right-click Managed Hosts and select Add Host. The Add a New Host wizard opens. Click Next. 2. Specify Physical Managed Machines as the Host Provider and click Next. 3. Enter a Display Name for the host and a description (optional). Click Next. 27
4. Specify a default Pool if desired. A Default Pool allocates all devices of the host into one pool. Devices within host linked to a Default Pool cannot be assigned to any other pools. This can be changed later under the host s Properties. 5. Click Next and then Finished. The new Host will be added. 6. Right-click Properties to further configure the host when needed. Step 2: Creating and using Pools to deploy desktops Pools are used to organize physical and virtual machines into logical groups. This enables organizations to combine and order resources from multiple systems into one entity. To access available resources, end-users simply connect to PowerTerm WebConnect to access any configured resource. 1. Right-click Pools and select Create Pool. The Create a Pool wizard opens. Click Next. 2. Enter a Pool name (this is displayed to end-users) and a description (optional) and click Next. 3. Specify the Assignment Type and the Assignment Duration: Static, resources in this pool are manually mapped to users, computers, and MAC addresses. Dynamic, a free resource in the pool will be assigned to the user making a request. Permanently, once the user receives an available resource, it will be mapped permanently to the user until the Administrator resets the mapping. For the duration of the session, the assigned resource is restricted during use, but will be available to the next user once the current user is finished. 4. Click Next and set Owners if desired. Click Add to browse your Active Directory service for desired users and groups that will have access to this resource. Only Owners of the pool will have access. 5. Click Next and specify the Logoff/Disconnect events. 6. (Optionally) Select Logoff when machine is in Idle time and insert a value for Idle time. 7. Click Next and then Finish. The new Pool was added. To change any settings in the future: 1. Select the Pool. 2. Right-click Properties. To assign physical and virtual machines from your virtualization hosts to your created pool: 28
1. Right-click the pool and select Assign Machines. The Assign Machines to <your pool name> dialog opens. 2. Highlight the desired machine(s) and click Select. Click OK. Step 3: Install Ericom Tools Ericom Tools relay important information about the machine back to the PowerTerm WebConnect server. It is strongly recommended to install Ericom Tools in each virtual or physical machine that will be managed by PowerTerm WebConnect. There are two methods to install Ericom Tools: Manual installation The Ericom Tools installer (vmagent.msi) is located on the PowerTerm WebConnect server in <PowerTerm WebConnect installation folder>\addons\deskview VDI folder (default installation folder is C:\Program Files\Ericom Software\WebConnect 5.6). 1. Launch vmagent.msi from the desktop that will receive Ericom Tools. 2. During installation, enter the DeskView Server IP address or NETBIOS/DNS name. If Ericom Tools is installed successfully, a Connected status will appear under the Ericom Tools field for the respective VM in the Connection Broker Admin console. If Ericom Tools is not operating properly, Unknown will be displayed as the status. Centralized Deployment from Connection Broker Administration Tool NOTE PowerTerm WebConnect DeskView services require Domain Administrator rights to utilize Ericom Tools deployment. 29
6. Accessing Published Applications and Desktops Users can access the published applications from the Application Zone or from the Application Portal web interface. Go to Start menu Program Ericom Software PowerTerm WebConnect 5.x and select Start.html. Or, Use a browser and navigate to http://<web_server>/webconnect5.x/start.html 6.1. Using the Application Zone 1. Click the Application Zone link. The Application Zone client will be downloaded. 2. Enter User and Password in the Login dialog and click Login. The Application Zone window with published applications and desktops appears: 3. To launch any published resource, double-click the desired resource icon. NOTE Selecting a PCoIP desktop from the Application Zone RDP will be used as the protocol. PCoIP is only available when both the client and host device supports PCoIP. 6.2. Using the Application Portal 1. Click the Application Portal link. The Application Portal Login window is displayed. 2. Enter User and Password and click Login. The Application Portal window with published applications and desktops appears. 3. To launch any published resource, single-click the desired resource icon. 30
6.3. Using PowerTerm WebConnect with PCoIP Devices When PCoIP clients are properly configured with PowerTerm WebConnect one the following will appear: PCoIP Clients with Static Mapping If the PCoIP client is configured for Static mapping, only a Connect button will appear: Once the user clicks Connect, the client will be connected to the PCoIP host as assigned in PowerTerm WebConnect DeskView. PCoIP Clients with Dynamic Mapping If the PCoIP client does not have a static mapping assigned, a username login dialog will appear: A user will enter the username/password/domain to login. The username must be located within one of Domains configured under PowerTerm WebConnect "Directory Services" (step 7 PowerTerm WebConnect Administration Tool) When the user is authenticated, a list of pools may appear if the user has access to more than one resource. The Pool selection list look similar to the following: Once the user selects the desired Pool, a connection will be made to a machine within the selected pool. 31
7. PowerTerm WebConnect Administration Tool PowerTerm WebConnect Administration Tool manages published applications, user sessions, and server configuration. The administrator can perform operations such as multiple application publishing, sending messages to loggedon users, shutting down sessions and monitoring user activity. Once the Administration Tool is connected to the server, a Welcome screen appears. Select the desired activity to get started: Publish Multiple Applications, opens the Publish Multiple Application wizard. Configure Load Balancer, opens the PowerTerm Load Balancer Administration Tool. Create a Host Connection, opens the Add Connection dialog. Configure Active Directory, opens the Directory Services dialog. To reach the Administration Tool main window, close the Welcome screen. NOTE When PowerTerm WebConnect Administration Tool is launched for the first time, the Connection dialog is displayed with the user Administrator. No password is required to enter, just click Connect. 32
NOTE In the Connection dialog (displayed when launching the Administration Tool), the Host Name is localhost by default. This is correct only if the Administration Tool runs on the same machine as the server. If the Administration Tool runs on a different machine, change the Host Name to the IP address/host name of the PowerTerm WebConnect Server NOTE In the PowerTerm WebConnect Windows edition, by default, the Administration Tool will deny any connection attempts from any computer other than the local machine. The Administration Tool main screen has three sections: Connections, lists all connections and published applications defined in the server. Users, lists all local and Directory Services based users defined in the server. Group, lists local PowerTerm WebConnect groups defined in the server. By default, only the Connection section is displayed when the Administration Tool is first launched. To test a connection: It is recommended to test published applications or host connections before they are made available to end-users. 33
Right-click the target connection from the Connection section and select Test. Alternatively: 1. Select Tools Run <desired client>. The Login to WebConnect dialog appears. 2. Enter the User Name and Password for the individual who owns the connection that you want to test and click Login. NOTE Credential fields are case sensitive. The desired PowerTerm WebConnect client is started and the Connect dialog appears. 3. Select the desired connection and click Connect. The test is executed. To copy connections: Connections may be copied to expedite deployment. All newly copied connections are NOT enabled, to avoid conflicts. 1. Right-click a desired connection and select Copy. 2. Change the name to a unique value to enable and activate the connection. NOTE Newly copied connections are disabled by default. Go to the Advanced Settings for the application to enable it. To link a new Directory Server: In order for PowerTerm WebConnect to work with Active Directory or LDAP based users and groups, use the Administration Tool to link to the Directory Server. 1. Go to Server Directory Services. 2. Click New and enter the settings for the Directory Server. 34
3. Once a server is linked the Test button will become active. Click Test to verify that PowerTerm WebConnect is communicating with the Directory Server properly. 4. Select the desired domain in the Default Domain drop down box. To monitor a User s sessions: User sessions can be monitored or intervened using the Administration Tool. Intervention may result in your input appearing on the user s screen. The user received a notification when an administrator begins and ends monitoring the session. 1. Select View Client Sessions or click to see all the active client sessions. 2. Select the desired active session and right-click Attach. The Password Verify dialog appears. 3. Enter your password and click OK. Some notification dialogs appears and the selected PowerTerm WebConnect session is viewed. 35
8. FAQ Q: The Connection Broker was not installed as part of the Full Installation Verify that.net 3.0 and MMC 3.0 are installed on the server. Once both components are installed, run the DeskViewServer Installer from the AddOns folder: Q: How do I Start/Stop/Restart PowerTerm WebConnect Server and Connection Broker PowerTerm WebConnect server is installed as a Windows service: 1. Launch the standard Services console from the Windows Control Panel. On some computers it may be located under the Administrative Tools group. You can also run the command SERVICES.MSC. The Services window appears: 2. Select PowerTerm WebConnect Server 5.x service (the primary service of PowerTerm WebConnect), where x is the version number, and use standard Start/Stop/Restart options. 3. Select PowerTerm WebConnect DeskView 5.x service (the primary service of PowerTerm WebConnect Connection Broke), where x is the version number, and use standard Start/Stop/Restart options (not shown in the example). NOTE The PowerTerm WebConnect Server Starter 5.x service (the secondary service of PowerTerm WebConnect) is designated for restarting the primary service in cases of failure or any unexpected problems. The secondary service is controlled by internal logic of PowerTerm WebConnect, and cannot be stopped from the Services console. NOTE If the Program Folder designation was modified during installation, the Start menu path may wary. 36
Q: When I try to connect using username (fixed seating) a message appears stating No machine available Verify that there is an available device in the pool the user is selecting. Verify that expected machine OS (blade/pcoip/virtual machine) is not logged in by another user. Verify that CurrentOwner is empty or defined for the user trying to connect. Q: I have two entries in my PCoIP Device assignment. Does this mean that the user must meet both requirements? No, only one of the conditions needs to be met for access to the device. For example, if your Properties page looks like the following: Any user can access the device from the fixed seating client, or, the user visitor can connect from any device. 37
About Ericom Ericom Software is a leading provider of Application Access and Virtualization Solutions. Since 1993, Ericom has been helping users to access business-critical applications running on a broad range of Microsoft Windows Terminal Servers, Virtual Desktops, Blade PCs, legacy hosts and other systems. Ericom provides concrete business value by helping organizations realize the benefits of their IT investments. With offices in the United States, United Kingdom, EMEA, India and China, Ericom also has an extensive network of distributors and partners throughout North America, Europe, Asia and the Far East. Our expanding customer base is more than 30 thousand strong, with over 7 million installations. For more information on our products and services, contact us at the location nearest to you or visit our Web site: http://www.ericom.com North America UK and Western Europe International Ericom Software Inc. Ericom Software (UK) Ltd. Ericom Software Ltd. 231 Herbert Avenue, Bldg. #4 11a Victoria Square 8 Hamarpeh Street Closter, NJ 07624 USA Droitwich, Worcestershire Har Hotzvim Technology Park Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700 Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737 Email info@ericom.com Email info@ericom.co.uk Email info@ericom.com 38