Home

Teradici PCoIP® Management Console User Manual

1. The device creates the following FQDNs and sequentially attempts contact with the MC attempt 1 pcoip mcl sales europe companyname com attempt 2 pcoip mcl europe companyname com attempt 3 pcoip mcl companyname com lt device delays for 5 minutes gt attempt 4 pcoip mcl hostmachinel sales europe companyname com attempt 5 pcoip mcl sales europe companyname com attempt 6 pcoip mcl europe companyname com attempt 7 pcoip mcl companyname com lt device delays for 5 minutes gt attempt 8 pcoip mcl sales europe companyname com repeat 1 7 Attempts 1 to 3 use the domain name from DHCP options 15 string Failing to contact the MC the device uses the DHCP options 12 string for attempts 4 to 7 Failing transmissions for attempt 4 to 7 the device cycles back to using DHCP options 15 Manual Device Discovery Manual device discovery is not an automated discovery mechanism This mechanism supports discovering devices that are powered on and connected to the network when the MC is commanded to discover devices The MC supports manually discovering devices at a specific IP address in a range of IP addresses or at an FQDN This option is useful to quickly begin using the MC or when a deployment uses the PCoIP MC DNS Based Discovery Prefix configuration setting described in PCoIP Management Console DNS Based Discovery Prefix on page 23 In this situation TERO812002 Issue 14 24 te rad ICi T
2. Create a Profile The Add New button lets you create a new profile After you click Add New enter the profile name and description Duplicate a Profile Click the Duplicate Profile link to create a new profile with the same profile properties as the selected profile Click the Edit link to configure the profile name and description after you copy a profile Note You may find it useful to create an initial profile containing the settings that are common across all devices in the deployment After the initial profile is set up you can copy the profile and then configure the unique profile settings TERO812002 Issue 14 72 te rad ICi Teradici PCoIP Management Console User Manual 5 4 3 Delete a Profile Click the Delete link to delete a profile The Delete link does not work if a profile is associated with one or more groups To delete a profile assigned to one or more groups use the Group Management webpage to first assign a different profile to the group s currently using the profile 5 4 4 Modify Profile Name and Description Click Edit to configure the profile name and description 5 4 5 Modify Profile Properties Click the Set Properties link to configure the properties of a profile Figure 5 22 shows the Profile Management Set Properties webpage a a teradici PColP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Manage Profiles Back to Profile List Set Properties En
3. Manage AutoConfig p View AutoConfig Discovered while AutoConfig Disabled 0 Apply AutoConfig Status Devices displayed 2 View All target groups All statuses y fAlltime nece aga status mac Last Updated d Tease Marketing cata 10 0 4 32 00 30 04 0E 47 CO 2013 11 29 08 45 03 PST group Discovered Marketing adedin 192 168 655 141 00 12 droa FB11 E0 25 2013 11 29 08 45 03 PST Figure 5 20 View AutoConfig Status Webpage 4 3 5 1 View Status Information The status information shows if devices were discovered and whether they matched the criteria of existing AutoConfig rules It also shows the profile application status TER0812002 Issue 14 70 te rad ICi Teradici PCoIP Management Console User Manual The following describes each status category e notstarted The MC has not yet checked this device for AutoConfig rule compatibility e failed error The device failed to be added to this group for a reason other than AutoConfig criteria e failed offline The device could not be reached for verification of AutoConfig rule criteria e failed IP range check The device does not match the AutoConfig rule IP range criteria e failed password check no password The device does not match the no password setting for the rules that matched the device s IP address e failed password check no match The device does not match the password criteria for the rules that matched the device s IP address e
4. TERO812002 Issue 14 94 teradici Teradici PCoIP Management Console User Manual 6 5 teradici HOME DEVICES GROUPS Device Management Device Discovery optional HOSTS deselect PROFILES POWER T Link De He ink Devices PCoIP Management Console UPDATE SETTINGS 10 0 4 95 192 168 65 124 10 0 4 23 10 0 4 240 192 168 65 100 192 168 65 139 192 168 65 208 192 168 65 230 ae RRRRERARARARARALAAASA ZERO CLIENTS deselect 10 0 4 46 192 168 65 140 10 0 4 10 10 0 4 12 10 0 4 13 10 0 4 14 10 0 4 17 10 0 4 18 10 0 4 21 10 0 4 22 10 0 4 24 10 0 4 25 10 0 4 27 10 0 4 30 10 0 4 33 10 0 4 34 10 0 4 36 10 0 4 37 10 0 4 38 10 0 4 39 10 0 4 42 10 04 47 Engineering E Figure 6 2 Peering a Pair of Devices Configuring Zero Clients for VMware View ver LOGOUT Legend Update Devices Field IP Address Processor Family All Devices Peerings All Devices I Groups All Devices E Status All Devices Destination Group Engineering z Device Password Add 225csems Delete Devices You can configure zero clients for VMware View After a zero client is configured a PCoIP session can be started from the zero client To start a PCoIP session the end user must click the Connect button on the zero client OSD To configure zero clients for VMware View PWN p v Open the MC Profile Management webpage Click the Add New button to cr
5. a a teradici PCoIP Management Console I DEVICES GROUPS PROFILES UPDATE SETTINGS LOGOUT Hep Settings Manage Database Environment Settings amp O ves Manage Device Naming f Web Interface Session Timeout Disabled bd Figure 5 38 Settings Webpage TERO812002 Issue 14 88 te rad ICi Teradici PCoIP Management Console User Manual 5 8 1 Database Management Click the Manage Database link to upload and download database files from the MC VM When you click this link the webpage shown in Figure 5 39 appears a a teradici PColP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Database Management Use this page to view and download the archives stored in the PCoIP MC and to upload new archives into it Use the YM s console interface to create database archives or restore the database using an archive Upload a Management Console database archive for restoring Browse No file selected Upload Download existing Management Console Database Backups a KT ME EE Figure 5 39 Database Management Webpage Uploading a Database Click Browse and Upload to transfer a database archive from the host PC running the web browser to the MC VM Click Browse and then select the database archive to upload Click Upload to start the transfer of the database file into the VM After a database is uploaded to the VM you must restore the database from the imported file
6. te rad ICi Teradici PCoIP Management Console User Manual 5 3 1 a a teradici PCoIP Management Console DEVICES GROUPS PROFILES UPDATE SETTINGS LOGOUT HELP O Group Management Manage Groups Manage Groups p view Profile Application Status indicates that the profile includes a property that requires a device restart for the new setting to take effect imaneneauoconta EE re p View AutoConfi Default 3 Default grou N A status snup Engineering Engineering 0 R amp D NIA i Delete 0 Scheduled D In Progress Marketing a 0 Successful Department EVER 0 Failed Apply Profile 1 Unapplied View Details Marketing Add New Figure 5 15 Group Management Webpage Manage Groups The Manage Groups subcategory lets you view create edit and delete groups and select a profile to associate with each group For groups with profiles this page shows an application status summary and provides a way to apply the profile settings to the entire group Create a Group Click Add New to create a group Enter the group name description and profile Note When the MC is initially started the Default group is created This is done to simplify the use of the MC by not forcing users to create a group You can use this group or delete it Modify a Group Click the Edit link to modify the group name description or profile Delete a Group Click the Delete link to delete a group You can only delete a group can if there
7. 2 2 2 3 e All PCoIP devices in a deployment are located on the same network subnet as the MC In this situation the MC can find the devices using SLP discovery All devices have the Enable SLP Discovery configuration setting set to True The PCoIP MC DNS Based Discovery Prefix setting for all devices is set to the hostname prefix of the MC You can only access this setting through the MC You cannot access it through the device AWI or zero client OSD PColP Management Console DNS Based Discovery Prefix on page 23 describes how PCoIP devices use the PCoIP MC DNS Based Discovery Prefix setting to contact the MC It also describes the system requirements to use this option If none of the previous conditions are true include a DHCP server in your system and configure the PColP DHCP Vendor Class options See Configuring DHCP Vendor Class Options on the DHCP Server on page 19 for details on configuring this record Note DHCP Options discovery is only available on PCoIP devices with firmware version 3 5 0 or higher Management Console Limitations This section describes some limitations of the MC e PColP devices managed by the MC must be loaded with firmware release 0 19 or greater The MC cannot discover devices loaded with older firmware releases You must use the device AWI to load and activate new firmware on each device running firmware releases less than or equal to 0 18 See the PCoIP Zero Client and Host Administrator Guide
8. Connect a computer to the same network to which the MC server machine is connected Note This computer can be the server machine itself Open a web browser and then enter the webpage URL of the MC see Figure 3 1 The MC web server is compatible with Firefox 23 or later Internet Explorer 8 and 9 and Internet Explorer 11 in compatibility view If you try to log into the MC web interface using a different browser an error message appears that lists the supported browsers When the web browser first connects to the MC a security warning appears that is similar to the message shown in Figure 5 1 for Internet Explorer or the message shown in Figure 5 2 for Firefox For details on installing the required certificate see section 5 1 1 Installing the MC Certificate in Internet Explorer and section 5 1 2 Installing the MC Certificate in Firefox y There is a problem with this website s security certificate The security certificate presented by this website was not issued by a trusted certificate authority Security certificate problems may indicate an attempt to fool you or intercept any data you send to the server We recommend that you close this webpage and do not continue to this website Y Click here to close this webpage Y Continue to this website not recommended More information Figure 5 1 Web Interface Security Warning in Internet Explorer TERO812002 Issue 14 44 te rad ICi Teradici PCoIP Management
9. Graphics Processing Unit GUI Graphical User Interface When not oper ating in a PCoIP session this interface is TERO812002 Issue 14 presented by the zero client OSD On Screen Display HPDET Hot Plug Detect MC PColP Management Console MTU Maximum Transmission Unit NTP Network Time Protocol OS Operating System OSD On Screen Display PColP Personal Computer over Internet Pro tocol PC over IP PCoIP host Host side of the PCoIP system PCoIP zero client Desktop or client side of the PCoIP sys tem PC over IP Personal Computer over Internet Pro tocol SLP Service Location Protocol SSL Secure Socket Layer security protocol VPD Vital Product Data Factory provisioned information to uniquely identify a zero cli ent or host 98 te rad ICI Teradici PCoIP Management Console User Manual VPN Virtual Private Network TERO812002 Issue 14 99
10. IP 192 168 65 149 MAC 00 30 04 0D F2 A6 FRRARERARARREAREERERERE EERE RE RER ERE ARANA RARA BREE REREREEERERE EERE EEE RARA EERE RE RERERERE EERE AARRRA RARA RRA RA RARAARAAARRARRARAAS Device Configuration TITTTTRRRTARA RARA ERARANARAARAAAR ARRRRAR RARA RAAR RARE ARRE ARRE ARRE ARAN RAR RA ER EERE EERE EERE EEREEEE EERE RARA EE EERE EERE RERERERERE Enable DHCP IP Address Subnet Mask Gateway Primary DNS Secondary DNS Maximum MTU Size Enable SNMP SNMP NMS Address Enable SNMP Cold Start Trap Enable SNMP 1 Traps Enable SNMP V2c Traps Enable Static IP Fallback Static Fallback IP Address Static Fallback Subnet Mask Static Fallback Gateway Address Static Fallback Timeout SNMP Community Name True 192 168 65 149 255 255 255 0 192 168 65 1 192 168 65 2 0 0 0 0 1400 bytes True Empty string False False False False one oe oe ee oe eo Figure 5 14 Device Event Log Webpage 5 3 Group Management The Group Management webpage shown in Figure 5 15 lets you view the currently defined groups view the number of devices in each group manage AutoConfig rules and view profile application status information The Group Management web page lets you e Create Modify Edit Delete groups e Apply a profile to all devices in a group e View profile application status information e Create Modify Edit Delete AutoConfig rules e Enable Disable AutoConfig e View AutoConfig status information TERO812002 Issue 14 61
11. The total number of failed devices is displayed in the same box Apply AutoConfig Click Apply AutoConfig to apply AutoConfig to ungrouped devices that were discovered while AutoConfig was turned off The total number of devices being applied appears in the same box TERO812002 Issue 14 71 te rad ICi Teradici PCoIP Management Console User Manual 5 4 5 4 1 5 4 2 Profile Management The Profile Management webpage shown in Figure 5 21 lets you view the currently defined profiles along with the time each profile was last modified updated The Profile Management webpage lets you e Create new profiles e Duplicate profiles e Delete profiles e Modify the profile name and description e Modify the profile properties device configuration settings e Import profiles e Export profiles a a teradici PCoIP Management Console HOME DEVICES GROUPS PROFILES UPDATE SETTINGS LOGOUT HELP 0 Profile Management indicates that the profile includes a property that requires a device restart for the new setting to take effect Frame TT Last Updated Basic Basic Profile 2013 11 29 15 04 00 PST Duplicate Profile Set Properties Edit Delete Export Engineering Engineering Profile 2013 11 29 15 39 14 PST Duplicate Profile Set Properties Edit Delete Export Marketing Marketing 2013 11 29 15 39 41 PST Duplicate Profile SetProperties Edit Delete Export Add New Import Figure 5 21 Profile Management Webpage
12. and devices in individual groups Status drop down menu Lets you display all devices online offline with an active session and without an active session Configuring a Device Group You should add all devices that are managed by the MC to a group If a device is not in a gro up you cannot perform the following actions Apply a profile to the device Peer the device Send power management commands to the device Update firmware on the device Edit the device name See section 2 3 1 Groups and Profiles for details about MC groups To add or reassign one or more devices to a group 1 Select the device or devices to be added to the group To select multiple zero client or host devices hold down the Shift key while you select the devices Select the group to add the devices to using the Destination Group drop down menu Enter the device password in the Password field Click Add The selected devices are added to the specified group if the device password is correct The Group field for each device successfully added to the group is updated to that ofthe new group Figure 5 9 shows the Device Management webpage when adding two zero clients D iscovered 131202 100 and Discovered 131202 102 to the Marketing group TERO812002 Issue 14 53 teradici Teradici PCoIP Management Console User Manual 5 2 6 TERO812002 Issue 14 teradici GROUPS Device Management Device Discovery op
13. 1 5 7 2 teradici PCoIP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP 0 Device Log Monitoring Select Devices 1 of 200 E All Devices Display Filters E Marketing Clear Name B en e Tree Expand All Collapse All Zero Client 2013 12 02 17 10 08 View Log Hosts Logging Controls Start Stop verbose Terse Download Collected Logs Logging Started At Logging Stopped At Free Log Space Figure 5 37 Device Log Monitoring Webpage Device Tree The device tree displays grouped devices and lets you select which devices are monitored When you use the checkboxes for individual devices you can select all zero clients or hosts within a group an entire group or all grouped devices for monitoring Once log monitoring is started you cannot change the selection until it is stopped The same display filters that appear in the Devices page are included here You can enable up to 200 devices for log monitoring at a time Logging Controls After you select the devices using the device tree you can set the event log filter mode to verbose or terse This setting overrides profile settings and settings made directly on the device If the device is set to a different event log filter mode during log monitoring it is overwritten to the setting made here the next time logs are retrieved by the log monitoring process To begin monitoring logs click Start This e
14. Console into Your Existing VMware ESXi Server _ 2 2 22 2 33 3 4 Installing the Management Console Using VMware Player _ 2 2 2 2 02 22 e eee ee eee eee eee 33 3 5 Running the Management Console occ 34 3 6 Migrating to a New Version of the Management Console 2 2 2 222 e eee ee eee eee ee ee eee 35 3 6 1 Potential Problems and Workarounds 202 2 02 202 e ee cee cee eee ee ee ee cece eee eee 35 3 6 2 What Information Is Imported 2 eee eee eee cece cece cece cr 36 3 6 3 Database Migration Procedure etica ti tit 36 4 Virtual Machine Features occ 38 4 1 Refresh Status e a ne eee een a cee nee a a E E 38 4 2 Set Web Interface Password ccoo 39 4 3 Change HOstname sr eat et Race A hee ae ated delete Gills IS a Pea ee oes 39 4 4 Manage Networking 2002 a a LA ele 39 4 4 1 View Network Configuration o oooccoccccccccocccccc eee ce eee eee eee eee eee eee 40 4 4 2 Configure IP Address 2 022 2 c cece cece ee ee eee eee eee ee ee cece eee eee eee e eee 40 4 43 Configure DNS 40 S358 coll ul bet heat dl dt AB e Meiers e AO e e NR es la 40 TERO812002 Issue 14 6 te rad ICi Teradici PColP Management Console User Manual 4 5 Database Management td ts A ee e ts ASI 41 4 5 1 Back Up Database 2 2 22 ee ee ee ee ee eee cece cece cece e eee eee 41 4 5 2 Restore Databases saci A ees se A is 42 4 5 3 Delete Database di iii 42 A 6ChangeliMeiLone dr e A a en de E ee e d
15. Name FQDN of the SNMP NMS Enable SNMP Cold Start False N file When this property is true the Host or Zero Client sends SNMP cold start Trap Piera traps to the SNMP NMS after the device is powered on or reset Figure 5 13 Device Details Webpage for a Zero Client Device Configuration and Status The Device Details webpage displays device configuration and status data as well as device profile data When the webpage first appears the device categories are collapsed e To open individual categories click the symbol next to the category name For example Figure 5 13 shows the Network Configuration category expanded e To view all of the categories click the Expand All link e Tocollapse the categories click the Collapse All link The following is a list of the possible values assigned to each Profile Value and a description of the meaning e lt value gt The parameter is specified in the profile and defined to equal lt value gt e Not in profile The parameter is not specified in the profile e Read only The parameter cannot be specified in the profile e Not valid for current session configuration The parameter is not specified in the profile because the currently selected session connection type does not support this parameter TERO812002 Issue 14 59 te rad ICi Teradici PCoIP Management Console User Manual The following is a list of the possible values assigned to each Device Value and a description oft
16. Restart Management Console Daemon To restart the MC daemon select the Restart MC daemon option on the MC VM console A message indicating the daemon is restarting appears on the MC VM console This lets you know when the restart is complete You should execute this command TERO812002 Issue 14 42 te rad ICi Teradici PColP Management Console User Manual e Ifthe MC daemon status reported on the console interface shown in Figure 4 1 is stopped e Ifthe Management Console Health shown in the Site Status section of the Home page is not Good 4 8 Halt Virtual Machine To perform a clean shutdown ofthe MC VM select the Halt virtual machine option on the MC VM console You can restart the MC VM at a later time When the MC VM is restarted the MC database is restored to the state it was in when the MC VM was last stopped TERO812002 Issue 14 43 te rad ICi Teradici PCoIP Management Console User Manual 5 1 Web Interface The MC web interface is the primary tool used to manage PColP devices in a deployment This section describes the features accessed and controlled through this interface Accessing the Management Console Web User Interface Note It is recommended that you install the PCoIP Management Console CA root certificate before using the MC web user interface See section 3 2 Contents of the Management Console Package for information about this certificate To access the MC web user interface 1
17. TER1206003 for details on uploading firmware to a device using the AWI The current release of the MC is only compatible with the following browsers e Firefox 23 or later e Internet Explorer 8 and 9 e Internet Explorer 11 in compatibility view The MC supports linking PCoIP host and zero client devices in fixed seating mode where the same zero client always connects to the same host If dynamically assigning zero clients to hosts is required include a connection broker in the deployment The MC supports managing up to 2000 PCoIP devices The tool may be able to support more than 2000 devices but the current version was tested with a maximum of 2000 devices Support for more than 2000 devices will be included in a future release of the tool If your deployment has more than 2000 devices contact your PColP equipment supplier for help on managing more than 2000 devices Management Console Concepts This section describes some key concepts to note before using the MC TERO812002 Issue 14 14 te rad ICi Teradici PCoIP Management Console User Manual 2 3 1 Groups and Profiles The MC manages the PCoIP devices using two important concepts groups and profiles e Profile a set of device configuration settings e Group a set of one or more devices with a single profile Figure 2 2 shows an example of how groups of host devices could be related to profiles The figure shows three groups of devices Two of the groups share the same prof
18. added to group The MC finished adding the device to this group and applies the profile e AutoConfig disabled The device was discovered while AutoConfig was disabled on the Manage AutoConfig webpage e failed DHCP option group name check The device failed to be added to a group because the group specified in the MC AutoConfig Group could not be found e failed AutoConfig DHCP option matching off The device failed to be added to this group because the DHCP Option Matching was disabled e failed AutoConfig disabled by DHCP option The device failed to be added to this group because the MC AutoConfig Behavior option was set to 2 Do not AutoConfig e Persistent AutoConfig Pending The MC has not yet checked this device for Persistent AutoConfig rule compatibility e Persistent AutoConfig Success The MC finished checking the compatibility and moved the device to this group if needed The profile is applied e Persistent AutoConfig disabled The device was found to have the settings different from the group s profile but Persistent AutoConfig was disabled on the Manage AutoConfig webpage Note A device with a status of not started shows an AC Pending label in the Device Management page While a device is in this state you cannot manually add it to a group Once the device is completed with AutoConfig its assigned group name is shown Retry AutoConfig Click Retry to re apply AutoConfig to devices that had previously failed AutoConfig
19. and click the Support Login link Note You can also access the online support link by clicking the Support link at the bottom of any of the MC webpages me a teradici PCoIP Management Console DEVICES GROUPS PROFILES UPDATE SETTINGS o cieti HELP View Help File Online Support Figure 5 42 Help Webpage TER0812002 Issue 14 92 te rad ICi Teradici PCoIP Management Console User Manual 6 1 6 2 6 3 Getting Started This section provides instructions on how to begin using the MC After completing the following steps you can establish a PCoIP session using a pair of PCoIP host and zero client devices Start the Management Console Follow the instructions described in sections 3 3 Installing the Management Console into Your Existing VMware ESXi Server or 3 4 Installing the Management Console Using VMware Player to install the MC and then read section 3 5 Running the Management Console to start using it Performing these steps will activate the MC VM on the MC host machine Follow the instructions described in section 5 1 Accessing the Management Console Web User Interface to open a web browser and log in to the MC web interface Discover Devices Open the MC Device Management webpage Verify the MC has discovered the devices you want to link peer If the devices are not discovered use the Manual Device Discovery feature to discover the devices The Manual Device Discovery feature is described
20. ees 56 532 9 Summary Deviceinformation civil eke cheek ded each lee th dedi eee leas 56 5 2 10 Configure Device Name 2 2 2 eee eee ee eee ee ee eee eee eee eee e eee 57 5211 Device Details t2 lt 2 ht eis lt isc 58 53 Group Management 22 aa RIS oh EN A A AEE NO AS EBB aiat 61 5 3 1 Manage Groups js icocc Medea ase anu iota ceed it Seec anes oh Un ss isla 62 5 3 2 View Profile Application Status 2 0 00 000222 eee ee ee eee eee eee ee eee eee eee 64 5 33 Manage AutoContis nc e eee isa bea as dl ee be ee ee le Lo a dle ede tk 66 5 3 4 Persistent AutoConfig 0 0 00 oe eee eee eee ee ee ee ee ee eee eee eee eee eee eee 68 5 3 5 View AUtOCOnfig Status ti A eet ate atk Gols ater aan is 70 54 Profile Management tt e do e e ia ec doo Bl ho 72 5 41 Create Profile 2c 252ch cee oo idad isidro std riada idad 72 5 42 Duplicate a Provile a o A ol ok Ly 72 5 4 3 Delete a Profile oooooocccccccccccnconconcononconcoronrnr rr 73 5 4 4 Modify Profile Name and Description o ococcccococccccccccccncnccncncrccncncn cnn 73 545 Modify Profile Properties 0 ti sie 73 5 4 6 Import a Profile occ ce eee eee eee ee eee ee eee cece eee eens 76 SAA Exporta Profile peta Are ch te all a nee Ste bee a tris th Ae Bie ta 77 TERO812002 Issue 14 7 te rad ICi Teradici PCoIP Management Console User Manual 5 5 Power Management anta tE ye a ts ies 77 5 5 1 Sending Reset and Power off Commands _ 22222222 eee ec e
21. in Manual Device Discovery on page 24 Adding Devices to a Group Once the PCoIP devices are discovered you must add them to a group through the Device Management webpage see Figure 6 1 The following process is an example of the steps you would take to add two zero clients to the Engineering group To add two zero clients to the Engineering group 1 Open the MC Device Management webpage 2 While pressing the Shift key click the devices you want to add to a group The selected devices are highlighted 3 From the Destination Group drop down menu on the right hand side of the screen select the group you want to add the devices to In this example the Engineering group was selected 4 Enter the device password in the Password field on the right hand side of the screen In this example the devices are assigned the same password It s a good idea to assign the same password to all devices in your deployment 5 Click Add The MC adds the selected devices to the Engineering group TERO812002 Issue 14 93 teradici Teradici PCoIP Management Console User Manual 6 4 teradici HOME DEVICES Device Management Device Discovery optional HOSTS deselect GROUPS PROFILES POWER 10 0 4 95 192 168 65 124 10 0 4 23 10 0 4 240 192 168 65 100 192 168 65 139 192 168 65 208 192 168 65 230 UPDATE PCoIP Management Console SETTINGS ae ae A p p T T p p p p p p T p T o T T T
22. logo to the device e firmware pending reboot The MC completed writing the profile s selected firmware to the device and requires a reboot before the profile properties are written e firmware done The MC has completed writing the profile s selected firmware to the device which was also rebooted e SCEP pending The MC has completed writing the profile to the device and requires the SCEP certificate installation to finish before completing the profile application e unapplied The profile was modified since it was last written to the device This lets you know when you must reapply a profile to one or more devices in a group a a teradici PColP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Group Management Manage Groups Profile Application Status View Profile Application Status Manage autoconf indicates that the profile includes a property that requires a device restart for the new setting to take effect View AutoConf indicates that the profile was scheduled by AutoConfig View AutoContig Status indicates that upon profile application the device will be rebooted automatically View Marketing All statuses y All time y f croun f Prone J neme a FE ETT 3 firmware pending Marketing KiE K pcoip 7009963 192 168 655 143 00 00 87 00 9D 63 reboot 2013 11 29 16 16 09 PST A firmware pending Marketing Marketing PA pcoio 4063389 192 168 65 232 00 30 04
23. must be met before the firmware is pushed to each device To associate firmware with a profile 1 Make sure the firmware file is imported into the MC see section 5 6 1 Import Firmware 2 Choose Profile Firmware and then Set Firmware in the profile properties 3 Choose the firmware version from the existing firmware versions in the select box Figure 5 25 shows the Link to Imported Firmware dialog 4 Choose the firmware replacement criteria from these options e Different Firmware is overwritten on the device if its version is different from the firmware version listed in the select box e Less than Firmware is overwritten on the device if its version is less than the x y z firmware version you enter in the text entry field Link to Imported Firmware Firmware Version Tera2 4 2 0 rc2 Teral 4 2 0 rc2 Firmware y Apply when existing firmware is different kyz Cancel Figure 5 25 Link to Imported Firmware Property Note All supported device family types are indicated in the sqaure brackets Devices that do not match the device family type are ignored during the profile application Certificates in a Profile You can upload up to 16 certificate files into a profile and set their usages The available storage indicates the remaining number of certificates and how much space is left in the certificate store TER0812002 Issue 14 75 te rad ICi Teradici PCoIP Management Console User Manual 5 4 6 Not
24. only device configuration field provisioned at the factory e MAC Address Read only device configuration field provisioned at the factory e IP Address Configured statically in the device or dynamically by a DHCP server e FW Version Determined by the firmware loaded on the device e FQDN The device FQDN if one is registered with the deployment s DNS server If the FQDN is not registered with the DNS server the MC displays the device IP address TERO812002 Issue 14 52 te rad ICi Teradici PColP Management Console User Manual 5 2 5 e Last Updated Displays the timestamp of when the MC last updated its internal database with the actual device configuration settings e Label Name The PCoIP device name read from the device e Label Description The PCoIP device description read from the device e Label Generic Tag The generic tag read from the device e Description Displays the PCoIP device type description Text field Lets you enter a text string The MC displays all devices in which the device Field value matches the string For example ifthe Field menu specifies Firmware Version and you enter the string 1 9 in the Text field the tool displays all devices loaded with release 1 9 Processor Family drop down menu Lets you display all devices Tera1 devices or Tera2 Peerings drop down menu Lets you display all devices peered devices or unpeered Groups drop down menu Lets you display all devices grouped ungrouped
25. only one instance of the MC See Installing a DNS Service Record on the DNS Server on page 17 for details Install PColP DHCP Vendor Class When DHCP Options discovery is used the PCoIP devices advertise themselves to the MC Devices that use the DHCP server can find the MC If DHCP is not enabled the MC must locate devices using methods that are often subject to limitations such as being unable to search more than its local subnet Note Do not install DHCP Options if e Your network does not have a DHCP server e You have PCoIP devices with a firmware version earlier than 3 5 0 in the network DHCP Options discovery is only available to PCoIP devices with firmware version 3 5 0 or higher See Configuring DHCP Vendor Class Options on the DHCP Server on page 19 for details TERO812002 Issue 14 16 te rad ICi Teradici PCoIP Management Console User Manual Ifyou cannot install a DNS SRV record or DHCP Vendor Class Options you may be able to configure the devices to automatically notify the MC of their existence PColP devices support a configuration setting called the PCoIP MC DNS Based Discovery Prefix Note You can only access the PColP MC DNS Based Discovery Prefix setting using the MC You cannot access it through the device AWI or zero client OSD interface See PColP Management Console DNS Based Discovery Prefix on page 23 for details If you cannot install a DNS SRV record or use the PCoIP MC DNS Based Discovery Prefi
26. the names of any available servers RFC 2052 Global Logs Ez _ cm Figure 2 3 DNS Service Configuration Menu 3 Right click and then select Other New Records Select Service Location SRV and then Create Record Fill in the entries as shown in Figure 2 4 Enter the hostname where the MC is installed under the heading Host offering this service Note The PCoIP devices do not use the Port number setting You can choose to set it to 50000 to reflect the listening port of the CMI server TERO812002 Issue 14 18 te rad ICi Teradici PCoIP Management Console User Manual _pcoip tool Properties El Ed Service Location SAW Security Domain terasele Service _pcoip tool Protocol Fr Priority pa Weight jo Port number 0000 Host offering this service machine teradici local Cancel Apply Help Figure 2 4 DNS Service Location SRV Dialog Box Configuring DHCP Vendor Class Options on the DHCP Server Before you can install the DHCP options e The deployment must have a DHCP server in the network e ThePColP devices must enable DHCP to send a request and receive the address of the MC in response e The DHCP server must support both DHCP Options 60 Vendor class identifier and 43 Vendor specific information See RFC 2132 for details on the DHCP options Note The following steps are an example of howto configure DHCP Vendor Class Options in a DHCP server in Wind
27. type Configure minimum image quality and maximum initial image quality on host devices Enable disable build to lossless Configure maximum frame rate Configure IPv6 Configure 802 1x authentication Configure Hotkey to reset Zero Clients to factory default Configure disconnect message dialog filter Configure enhanced logging mode Configure audio in mode Configure USB 2 0 1 5 20 0 19 current 0 19 3 4 1 1 5 30 1 6 0 Added the ability to Configure syslog Configure static IP address fallback Choose the Czech Romanian and Slovenian keyboard layouts Configure the USB bridging override table 0 19 current 0 19 3 3 0 Added the ability to Configure View desktop name to select Enable disable zero client web interface Selective display of zero client On Screen Display menu entries VMware View Connection Server address cache behavior and content Choose the Estonian Hungarian Latvian and Serbian keyboard layouts Configure VMware View auto logon TERO812002 Issue 14 30 te rad ICi Teradici PCoIP Management Console User Manual MC Version Compatible with Fully Configures FW Versions FW Versions 1 3 30 0 19 current 0 19 3 2 0 Added the ability to Danish Finnish Norwegian Swedish Turkish Dutch Polish Belgian Russian and Lithuanian Keyboard Layouts Advanced VMware View Settings VMware View Kiosk Mode Enable disable Peer Loss Overlay 1 2 20 0 19 current 0 19 3 1 0 Added the ability to E
28. 0E 33 89 reboot 2013 11 29 16 15 55 PST i complete a 65 149 00 30 04 0D F2 A Marketing Marketing pcoip 40df2a6 192 168 65 149 00 30 04 0D F2 AB Zoro 9 16 2244 PST Figure 5 18 Profile Application Status Webpage TERO812002 Issue 14 65 te rad ICi Teradici PCoIP Management Console User Manual 5 3 3 Manage AutoConfig The Manage AutoConfig subcategory shown in Figure 5 19 lets you enable or disable the AutoConfig feature and configure the AutoConfig rules By default AutoConfig is disabled and no AutoConfig rules are defined You can optionally create an AutoConfig rule for each group Newly discovered zero client devices are automatically added to a group and have that group s profile applied when conditions 1 2 and 3 are true e Condition 1 e The AutoConfig feature is enabled e Condition 2 e The group s AutoConfig rule has no IP address ranges OR e The zero client s IP address is within one of the rule s IP ranges OR e The DHCP Option Matching is on The MC AutoConfig Group option is set to the identical group name and the MC AutoConfig Behavior option is not set to 2 e Condition 3 e The zero client has either a blank password or password protection is disabled and the AutoConfig rule has Add device with no password checked OR e The zero client s password is one of the rule s passwords The following examples show how AutoConfig rules are applied The MC is configured with AutoConfig enabled and has tw
29. 2 9 To access a device s webpage from the Device Management webpage select the symbol to the left of the Device field de Host symbols are either LA or oF based on whether or not the device is linked and zero de client symbols are either A or oe Deleting Devices You can delete one many or all PCoIP devices by clicking the Delete button e Single Device Delete Select a device from the list of HOSTS or ZERO CLIENTS and then click the Delete Device button e Multiple Devices Delete Select multiple devices by Shift clicking from the list of HOSTS or ZERO CLIENTS and then click the Delete Devices button e All Devices Delete Deselect devices if already selected and then click the Delete All button Once a device is deleted its information no longer exists in the database To manage the deleted device it should be rediscovered by the MC Rediscovered devices act the same as newly discovered devices Summary Device Information You can view summary information about each device by clicking on the Device field in the list of HOSTS or ZERO CLIENT devices A dialog box appears that provides information about the device Figure 5 11 displays a summary information dialog box Device Summary Name pcoip portal 0030040df2a6 Label pcoip portal 0030040df2a6 Unique ID 00 30 04 0D F2 46 Mac address 00 30 04 0D F2 46 FQDN pcoip portal 0030040df2a6 terase local Firmware 4 2 0 rc1 Processor Tera2 ID TERA2321 rev 0 0 IP a
30. 65 208 Processor Family All Devices ha 192 168 65 230 Peerings All Devices had Groups All Devices E Status All Devices hd Destination Group Choose E Device Password Delete All Figure 2 8 Management Console Manual Device Discovery Feature TER0812002 Issue 14 25 te rad ICi Teradici PCoIP Management Console User Manual 2 3 4 AutoConfig When the MC discovers new PColIP zero clients it automatically adds them to a group and applies the group s profile You can create AutoConfig rules to let one group have one or more criteria defined The MC supports the following criteria to decide how zero clients are automatically assigned to groups using AutoConfig e Each group can have an optional AutoConfig rule associated with it e Rules are sets of optional password settings and optional IP address ranges No Password Add discovered zero clients to this group if they have no password configured Password Add discovered zero clients to this group if they have the identical password configured for the criteria IP address range Add discovered zero clients to this group if the IP address falls within the range configured by the criteria Not specifying an IP address range adds zero clients that match the password criteria DHCP Option Matching Add discovered zero clients to this group if their PColP DHCP option values are configured so that the group name is set in the MC AutoConfig G
31. 7 2010 Updated document for release 1 3 30 e Added Device Log Monitoring e Added support for firmware release 3 2 Apr 03 2009 Created document for initial release TERO812002 Issue 14 5 te rad ICI Teradici PCoIP Management Console User Manual Contents Revision STO ost a Sa Ne td a o as a asa IE ada EG 3 LT IMEFOMUCTION acs cis rl SA A NU Ie a tos alos obs 9 1 1 About this Document o ta 9 2 OVEIVIEW 85 2 82005 So E wees SRS ue Ge eee A A RE 11 2 1 PColP Deployment Components oro 11 2 1 1 Managing PColP Devices ooooccccccccccccnccnocnncnncr rc 11 2 1 2 DNS OIE Es aid Ataca 13 2 1 3 DEEP Server 20 a A SO eee sh ote att eis ace 13 2 2 Management Console Limitations 0 000 000222 e eee eee eee eee eee eee eee cece eee 14 2 3 Management Console Concepts cc 14 2 3 1 Groups and Profiles occ 15 2 3 2 FixediSGating 222 22 8cc dd oe Se el EE cet oleo ir Se tes ae 16 2 3 3 DEVICE DISCOVElY erica scar yor idos eased hee om can atid Sadan ode sanear shee 16 23 4 AUtOCONTIE a OO 26 2 4 Management Console and Firmware Version Compatibility 2 0 00 02220 0 2 e eee eee eee eee ee 27 3 lnstallationzdnd Setup cc deen oe faces sea one illa its lla sa 32 3 1 Management Console Host System Requirements 00 0022 e eee eee eee eee eee eee eee eens 32 3 2 Contents of the Management Console Package 2 0 2222 e cece e eee eee eee eee eee eee eee ee 32 3 3 Installing the Management
32. AutoConfig rule 1 Optionally disable AutoConfig before adding or editing rules This is recommended practice so interim rule configurations do not result in unexpected group memberships 2 Choose an existing group from the Choose Group select box and then click Add rule for group When a rule is created it has no IP ranges DHCP Option Matching is off no specific passwords are set and Add device with no password is checked If AutoConfig is enabled this rule matches all zero clients with no password 3 To restrict the rule s password matching click Add Password and then add one or more specific passwords to the rule Once the rule contains one or more specific passwords you can clear the Add devices with no password checkbox if desired There is no limit on the number of specific passwords a rule can have 4 To restrict the rule s IP address matching click Add IP Address Range and then add one or more IP address ranges A rule can have an unlimited number of IP address ranges 5 To enable DHCP option matching enable the DHCP Option Matching button DHCP option matching only works if the PColP DHCP Vendor Class Option is configured For TERO812002 Issue 14 67 te rad ICi Teradici PCoIP Management Console User Manual 5 3 4 details see the section on adding MC AutoConfig Group and MC AutoConfig Behavior options in the PCoIP Endpoint vendor class on page 22 6 If AutoConfig was disabled in step 1 enable it now to mak
33. Console User Manual This Connection is Untrusted You have asked Firefox to connect securely to 10 0 152 74 but we can t confirm that your connection is secure Normally when you try to connect securely sites will present trusted identification to prove that you are going to the right place However this site s identity can t be verified What Should I Do If you usually connect to this site without problems this error could mean that someone is trying to impersonate the site and you shouldn t continue Get me out of here Technical Details I Understand the Risks Tf you understand what s going on you can tell Firefox to start trusting this site s identification Even if you trust the site this error could mean that someone is tampering with your connection Don t add an exception unless you know there s a good reason why this site doesn t use trusted identification Add Exception Figure 5 2 Web Interface Security Warning in Firefox 5 1 1 Installing the MC Certificate in Internet Explorer 1 In a Windows Explorer window right click on the pcoipmc_cacert p7b certificate file and then select Install Certificate When the Certificate Import Wizard appears click Next Select Place all certificates in the following store Click the Browse button select Trusted Root Certification Authorities in the Select Certificate Store dialog and then click OK Click Next Click Finish to complete the impor
34. IP deployment along with some important concepts associated with the MC e Section 3 Installation and Setup describes how to install and set up the MC and migrate from an old version of the tool to a new version e Section 4 Virtual Machine Features details the features of the MC virtual machine e Section 5 Web Interface discusses the web interface of the MC This is the primary mechanism for managing your PCoIP devices e Section 6 Getting Started describes how to use the MC to perform some basic tasks such as starting the MC logging into the web interface discovering some devices and linking a pair of host and zero client devices It also includes recommendations for familiarizing yourself with the major capabilities of the MC Note If you haven t used the MC before and want to begin using the tool right away review Section 6 Getting Started The information in this section gets you to a point where you TERO812002 Issue 14 9 te rad ICI Teradici PColP Management Console User Manual can establish a PCoIP session between the linked host and zero client devices as well as a PCoIP session in VMware View environment TERO812002 Issue 14 10 te rad ICi Teradici PCoIP Management Console User Manual 2 1 2 1 1 Overview This section describes the components found in a typical PCoIP deployment PCoIP Deployment Components Figure 2 1 shows the recommended components found in a PCoIP deployment where indivi
35. N Disable Marketing 1 Supported 17 15 Power Down in Session Devices Marketing Department 1 Not Supported Delete 1 Add schedule Choose group Add rule fo Figure 5 31 Set Remote Power Down Webpage You can schedule remote power down by specifying day s of a week and time of a day Ctrl click on the day selector to select multiple days in a single schedule You can schedule different times for each day by adding more schedules Select the Power Down in Session Devices checkbox to set the schedule to force power down devices that are in session To enable the schedule click the Enable button after configuring the day s and time Remote power down only applies to zero client devices with both hardware and firmware support Hardware support for remote power down is available with firmware version 3 2 0 or higher The four device counters include e Black The total number of devices e Green The number of devices with both hardware and firmware support e Red The number of devices without hardware support e Gray The number of devices without firmware support The MC requires firmware 3 2 0 or higher to determine if the device can perform a remote power down After scheduling the power down click the View Remote Power Down link on the left side of the screen to view the status of power down commands sent to zero client devices Note The MC cannot power on the zero clients Once the MC successfully powers off t
36. November 2013 Su Mo Tu We Th Figure 5 17 Apply Profile Date Time Picker 5 3 2 View Profile Application Status The Profile Application Status subcategory shown in Figure 5 18 provides detailed status information that shows the current state of profile application for grouped devices The Profile column also displays icons that represent the expected reboot behavior of devices when the profile is applied The following legend contains the description of each reboot icon Indicates that the profile includes a property that requires a device restart for the new setting to take effect Indicates that the profile was scheduled by AutoConfig d Indicates that on profile application the device is automatically rebooted The following describes each status category TER0812002 Issue 14 64 te rad ICi Teradici PColP Management Console User Manual e scheduled The MC has scheduled the profile to be written to the device e OSD logo scheduled The MC has scheduled the profile s included OSD logo to be written to the device e firmware scheduled The MC has scheduled the profile s selected firmware to be written to the device e complete The profile along with any included OSD logo and firmware was successfully written to the device e failed The MC attempted but failed to write the profile to the device Typically this problem occurs when devices are offline e OSD logo done The MC completed writing the OSD
37. Peering Devices 10 0 4 46 192 168 65 140 10 0 4 10 10 0 4 12 10 0 4 13 10 0 4 14 10 0 4 17 10 0 4 18 10 0 4 21 10 0 4 22 10 0 4 24 10 0 4 25 10 0 4 27 10 0 4 30 10 0 4 33 10 0 4 34 10 0 4 36 10 0 4 37 10 0 4 38 10 0 4 39 10 0 4 42 10 0 4 47 ZERO CLIENTS deselect Ungrouped Ungroured ll To peer link pairs of host and zero client devices Open the MC Device Management webpage Note Devices must belong to a group before you can link them Figure 6 1 Adding Devices to a Group O LOGOUT Legend Update Devices IC Text Clear Field IP Address hd Processor Family All Devices g Peerings All Devices x Groups All Devices Status All Devices E Destination Group Engineering z Device Password e Add 3 socs Delete Devices Note After a device is successfully added to a group the group name appears in the Group column for each device You can peer or link together each pair of host and zero client devices After a host and zero client are peered a PCoIP session can be started from the zero client To start a PCoIP session the end user must click the Connect button on the zero client OSD Select the host and zero client devices to be peered In Figure 6 2 the devices 10 0 4 23 and 10 0 4 10 are selected Click the Link Devices button to peer the devices The zero client connects to the host 10 0 4 23 when the end user clicks Connect on the zero client OSD
38. SELECTING AGREE OR I ACCEPT THE TERMS IN THE LICENSE AGREEMENT AND OR INSTALLING ACTIVATING AND OR USING THIS LICENSED PRODUCT AS DEFINED IN SECTION 1 BELOW YOU AND OR THE ENTITY THAT YOU REPRESENT LICENSEE ARE UNCONDITIONALLY CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THE LICENSE AGREEMENT WITH TERADICI CORPORATION TERADICI CONSISTING OF THIS PARAGRAPH AND THE FOLLOWING TERMS THIS AGREEMENT WITH RESPECT TO THE LICENSED PRODUCT PROVISION OF THE LICENSED PRODUCT IS CONDITIONED ON AND LICENSEE S INSTALLATION OR USE OF THE LICENSED PRODUCT SHALL CONSTITUTE LICENSEE S ASSENT TO THE TERMS AND CONDITIONS OF THIS AGREEMENT IF LICENSEE REGISTERS FOR A FREE TRIAL OF THE LICENSED PRODUCT THIS AGREEMENT SHALL ALSO GOVERN THAT FREE TRIAL IF THESE TERMS ARE CONSIDERED AN OFFER ACCEPTANCE IS EXPRESSLY LIMITED TO SUCH TERMS IF LICENSEE DOES NOT UNCONDITIONALLY AGREE TO THE FOREGOING LICENSEE SHOULD NOT SELECT AGREE OR I ACCEPT THE TERMS IN THE LICENSE AGREEMENT AND OR INSTALL ACTIVATE AND OR USE THE LICENSED PRODUCT IF YOU CONTINUE WITH USE OR INSTALLATION YOU ARE REPRESENTING AND WARRANTING THAT YOU ARE AUTHORIZED TO BIND LICENSEE E Grant of License and Restrictions Subject to the terms hereof payment of any License Fees as defined in Section 2 and any applicable user use limitations specified in this Agreement Teradici grants Licensee a personal limited revocable in accordance herewith non sub licens
39. Teradici PCoIP Management Console User Manual TERO812002 Issue 14 teradici PCoIP te rad ICI Teradici PCoIP Management Console User Manual Teradici Corporation E E 101 4621 Canada Way Burnaby BC V5G 4X8 Canada phone 1 604 451 5800 fax 1 604 451 5818 e il a i C I www teradici com The information contained in this documentation represents the current view of Teradici Corporation as of the date of publication Because Teradici must respond to changing market conditions it should not be interpreted to be a commitment on the part of Teradici and Teradici cannot guarantee the accuracy of any information presented after the date of publication This document is for informational purposes only TERADICI MAKES NO WARRANTIES EXPRESS IMPLIED OR STATUTORY AS TO THE INFORMATION IN THIS DOCUMENT Complying with all applicable copyright laws is the responsibility of the user Without limiting the rights under copyright no part of this document may be reproduced stored in or introduced into a retrieval system or transmitted in any form or by any means electronic mechanical photocopying recording or otherwise or for any purpose without the express written permission of Teradici Corporation Teradici may have patents patent applications trademarks copyrights or other intellectual property rights covering subject matter in this document Except as expressly provided in any written license agreement from Teradici t
40. Version Compatibility Revised sections 3 5 Running the Management Console and 4 Virtual Machine Features In section 5 1 3 Logging into the MC Web User Interface added details about the warning that displays during login if another user is currently logged in Updated section 5 6 1 Import Firmware to state that only firmware files containing both Tera1 and Tera2 firmware pcoip files can be imported The all file type is no longer supported Added section 5 6 4 Delete Firmware from the MC to explain how to remove a firmware file from the MC Added section 5 8 4 Web Interface Session Timeout to explain how to configure an inactivity timeout period for the web UI Updated MC screen captures to show new Teradici logo TERO812002 Issue 14 3 te rad ICi Teradici PCoIP Management Console User Manual Version bate pas O O 12 Aug 23 2013 Updated document for release 1 9 1 e Added support for firmware release 4 1 2 e Added support for Internet Explorer 9 Jul 05 2013 Updated 3 3 Installing the Management Console into Your Existing VMware ESXi Server to state that using the VMware vCenter Converter tool is mandatory when importing the MC VM into a VMware ESXi host May 24 2013 Updated document for release 1 9 e Upgraded the MC VMs guest operating system to Ubuntu Server 12 04 2 LTS e Added support for firmware release 4 1 Jan 20 2012 Updated document for release 1 7 1 e Added support for firmwar
41. a device restart after being changed Network Configuration Parameter Device Value Profile Value Description When this property is true the Host or Zero Client will contact a DHCP server to be assigned an IP address subnet mask gateway IP address and DNS servers These parameters must to be set manually when this property is false IP Address 192 168 65 149 No profile Device IP address Enable DHCP True No profile Subnet Mask 255 255 255 0 No profile Device networking subnet mask Gateway 192 168 65 1 No profile IP address of the device s gateway Primary DNS 192 168 65 2 No profile IP address of the Primary Domain Name Server Secondary DNS 0 0 0 0 No profile IP address of the Secondary Domain Name Server This property allows for configuration of the Maximum Transmission Unit MTU packet size Asmaller MTU may be required in situations such as Maximurn MTU Size 1400 bytes No profile VPN tunneling because PColP packets cannot be fragmented This property should be set to a walue smaller than the network path MTU for the end to end connection between the Host and Zero Client The device s SNMP support is enabled when this value is true When false the device will not respond to SNMP queries or generate traps Enable SNMP True No profile Host and Zero Client devices can send SNMP traps to an SNMP Network SNMP NMS Address Empty string No profile Management System NMS This property configures the IP address or Fully Qualified Domain
42. a new webpage Figure 5 29 shows the webpage that supports sending the PCoIP Processor Reset command teradici PCoIP Management Console B DEVICES GROUPS PROFILES UPDATE SETTINGS LOGOUT HELP Power Management Set Device State Set Device State gt Vier q hrai Command the PCoIP processor to reset PCoIP host devices will reset on the next host system restart PColP Zero Clients will reset 4 Set Remote Power immediately o Down p View Remote Power Down Status Command Reset PCoIP Processor Send commands to targets at Commands scheduled in the past will be sent immediately 2013 12 02 16 E 565 Y Select All Deselect All Schedule PCoIP Processor Resets Cancel Pselect Name Type ETT Vv Zero Client Zero Client Marketing 10 0 4 46 4 2 0 y Host Card GA host Marketing 10 04 95 4 20 Schedule PCoIP Processor Resets Cancel Select All Deselect All _Schedule PCoIP Processor Resets Cance Figure 5 29 Schedule Device State Change Command Webpage You can send the commands immediately or in the future by specifying the date and time the command is sent The command is sent immediately if the specified date time is less than or equal to the current time You must choose which devices the command is sent to by selecting the checkbox next to each target To schedule the command s click the Schedule PCoIP Processor Resets button after configuring the date time and selecting the devices t
43. able non transferable nonexclusive right to use a Licensed Product in object code form only and only in accordance with Teradici s applicable user documentation For these purposes Licensed Product shall include software including firmware that may be loaded on embedded in or otherwise included with a product purchased by Licensee any updates to the foregoing and all Teradici and or third party proprietary Figure 5 5 Teradici End User License Agreement 5 1 5 Using the MC Home Page After you log in the MC Home webpage shown in Figure 5 6 appears The Home page lets you Manage devices see section 5 2 Device Management Manage groups of devices see section 5 3 Group Management Manage device profiles see section 5 4 Profile Management Reset devices see section 5 5 Power Management Control the power state of host devices see section 5 5 Power Management Power off zero client devices see section 5 5 Power Management Update device firmware see section 5 6 Update Firmware Manage the monitoring of device event logs see section 5 7 Device Log Monitoring Upload download MC database archives see section 5 8 Manage Settings Customize the MC configuration settings see section 5 8 Manage Settings Set or disable a web interface session timeout see section 5 8 Manage Settings View site status information see section 5 9 Site Status Access online help see section 5 10 Onl
44. adici PColP Management Console HOME DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP Site Status Manage Devices Manage Power l PCoIP Devices Zero Clients Tera2 28 online 0 offline Tera1 24 online 0 offline Manage Groups Update Firmware Hosts Tera2 6 online 0 offline A A yy Tera1 2 online 0 offline Sessions 27 active Manage Profiles Monitor Device Logs DNS SRV Records Update DNS SRV Records Management Console w2k8 wdm terase local Connection Broker No record found Manage Settings Y Management Console Health Good 7 2 19 GB 61 free Disk Usage 1 38 GB used Extended Logging Disabled Figure 5 41 Home Webpage The following status information appears e Number of online and offline PCoIP zero clients discovered by the MC e Number of online and offline PCoIP hosts discovered by the MC e Number of active PCoIP sessions e FQDN of the MC found in the MC DNS SRV record if one exists e FQDN of the connection broker found in the PCoIP Connection Broker DNS SRV record if one exists e Current state of the MC e Disk usage information for the MC The MC uses up to 4 GB of disk space When the usage begins to approach this limit the status turns red indicating that you must clean up the MC database Options to reduce memory usage include limiting the number of firmware images stored in the database along with the number of database backups stored in the VM Note A device is c
45. agement webpage This feature lets you update one multiple or all devices discovered by the MC Note Updating a large number of devices can take a few minutes To update e One device Select the device to update and then click the Update Device button e Multiple contiguous devices Select the devices by holding down the Shift key and selecting the devices After the devices are selected click the Update Devices button e All devices Ensure no devices are selected by clicking the deselect links at the top of the HOSTS and ZERO CLIENTS columns When all devices are de selected click the Update All button Note To view the update time using the current version of the tool from the Device Management webpage set the Field option in the Filter box to Last Updated Filtering Devices The Filter box supports different ways to filter the PCoIP devices that appear in the HOSTS and ZERO CLIENTS columns This can be useful when searching for specific devices or subsets of devices You can filter devices using one or more of the following options e The Field drop down menu Select the device data field that appears in the HOSTS and ZERO CLIENTS columns You can select from one of the following e Name A user defined value assigned to each device managed by the MC This field is stored in the MC database It is not stored in the device configuration settings See section 5 2 10 Configure Device Name for more details e Unique ID Read
46. ages Consider resetting your devices in the deployment after updating device configuration settings e When devices are added to a group and the group profile has not changed apply the profile to the newly added devices and not the entire group This minimizes the number of device resets Fixed Seating The MC lets you link individual host and zero client devices so that each zero client always establishes a connection to the same host This relationship is called fixed seating To dynamically assign hosts to zero clients when your users log in you must install a connection broker The MC does not support dynamically assigning hosts to zero clients Device Discovery The MC must discover PCoIP devices before it can manage them The MC supports discovering devices in a deployment using one or more discovery mechanisms Recommended approaches e Install a MC DNS SRV record When DNS SRV record discovery is used the PCoIP devices advertise themselves to the MC Devices that use the DNS server can find the MC If DNS SRV discovery is not enabled the MC must seek out and find devices using methods that are often subject to limitations such as being unable to search more than its local subnet Note Do not install a DNS SRV record if e Your network does not have a DNS server e You want to have multiple instances of the MC on your network to manage subsets of your PCoIP devices If you install a service record the devices point to
47. are no devices in the group The Delete link is not active i e is grayed out when a group has one or more devices in it Profile Application Status The Profile Application Status column provides a summary of the state of profile application to the devices in the group When you click the Details link the tool displays the Profile Application Status page with the filter set to this group see Figure 5 18 The following is a description of each status category TERO812002 Issue 14 62 te rad ICi Teradici PColP Management Console User Manual e Successful The profile was successfully written to the device e Scheduled The MC has scheduled the profile to be written to the device e Failed The MC attempted but failed to write the profile to the device This problem typically occurs when devices are offline e Unapplied The profile was modified since it was last written to the device This lets you know when you need to reapply a profile to one or more devices in a group Apply a Profile to a Group Click the Apply Profile link to write the device profile settings to every device in a group Profiles can contain properties that require a device reboot when the profile is applied The Apply Profile confirmation dialog displays radio buttons to select automatic or manual device rebooting Figure 5 16 shows the reboot behavior choices The default behavior is to automatically reboot the device Profiles can be scheduled to be a
48. at 4 2 0 rc2 File Description Firmware 4 2 0 Begin updating targets at Updates scheduled in the past will begin immediately 2013 12 02 EJE 07 Device restart options iM immed ately restart Zero Clients when update is complete T Schedule deferred restart on hosts when update is complete Select All Deselect All Schedule Update Cancel EOI ETE Hostcard QR host Marketing 100495 420 Tera2 K Zero Client Zero Client Marketing 10 0 4 46 4 2 0 Terat Select All Deselect All Schedule Update Cancel Figure 5 35 Second Update Devices Webpage 5 6 3 View Status Click the View Status link to view the current status of all scheduled and completed firmware updates Figure 5 36 shows the Firmware Update Status webpage teradici PCoIP Management Console DEVICES GROUPS PROFILES POWER SETTINGS LOGOUT HELP 0 Update Firmware FA Import Firmware Firmware Updates Z Update Devices gt Expand All with Scheduled Downloads Collapse All Refresh Cancel Selected Updates View Status x Select Name and Group Type IP Address Update Status Zero Client in 10 0 4 46 Update completed at 2013 12 02 17 08 59 PST Marketing Zero Client Zero Client was rebooted Cancel Selected Updates Figure 5 36 Firmware Update Status Webpage TERO812002 Issue 14 85 te rad ICi Teradici PCoIP Management Console User Manual 5 6 4 Delete Firmware from the MC If the Delete link for a firmware file
49. ation Procedure This section lists the process to migrate to a new version of the MC TER0812002 Issue 14 36 te rad ICi Teradici PCoIP Management Console User Manual 1 Use the old version of the MC to back up the current MC database See section 4 5 1 Back Up Database 2 Download the backed up database to a host computer See section 5 8 1 Database Management 3 See section 3 6 2 What Information Is Imported for a list of the settings that are and are not imported by the new version ofthe MC when a database is restored Before you shut down the old version of the MC write down the values of the settings that are not imported 4 Shut down the old version of the MC See section 4 8 Halt Virtual Machine Install and begin running to the new version of the MC 6 Upload the database to the MC from the host computer See section 5 8 1 Database Management 7 Restore the database from the imported database See section 4 5 2 Restore Database 8 Configure the settings that were not imported when the database was restored TERO812002 Issue 14 37 te rad ICi Teradici PCoIP Management Console User Manual 4 Virtual Machine Features This section describes the features accessed and controlled through the MC VM console The top level menu of the MC is shown in Figure 4 1 To access the menus e Ifyou are using vSphere Client click in the window to interact with the VM To get back to your host operating sy
50. ault group 6 6 Familiarizing Yourself with the MC To become more familiar with the MC 1 10 11 Review section 2 Overview of this document to become familiar with the different components in a PCoIP deployment This section also describes some fundamental concepts to be aware of to use the MC Update the time zone of the MC using the VM Console interface See section 4 6 Change Time Zone Create a profile and set one or more properties within the profile A good parameter to use to try this out on is the Language field in the Language Configuration settings See section 5 4 Profile Management for details Create a group and assign the profile created in the previous step to the new group See section 5 3 Group Management Assign some devices to the new group See section 5 2 5 Configuring a Device Group Write the profile settings to the devices in the group and verify the settings were written to the devices See Apply a Profile to a Group on page 63 and section View Profile Application Status on page 64 Create an AutoConfig rule matching the criteria of an undiscovered zero client Choose a group for this AutoConfig rule that uses a profile with a relatively simple parameter See sections 5 3 3 Manage AutoConfig and 5 3 5 View AutoConfig Status Query and view the current device settings See section 5 2 9 Summary Device Information Query and view the data stored in the device event log Section 5 2 9 Su
51. button to display the second update devices webpage that lists the devices that match the specified version number and group name This new page is shown in Figure 5 35 This webpage lets you specify the time the update occurs with the fields under the Begin updating targets at text You can specify the reset options you want to use e Zero client devices can be commanded to reset when the firmware update completes e Host devices can be commanded to schedule a deferred reset which triggers a reset the next time the host operating systems shuts down You must also specify the devices to update by checking the boxes next to the devices you want to update After the options are configured click the Schedule Update link to initiate the firmware update TERO812002 Issue 14 84 te rad ICi Teradici PCoIP Management Console User Manual teradici PColP Management Console DEVICES GROUPS PROFILES POWER SETTINGS LOGOUT HELP O Update Firmware FF Import Firmware Update Devices gt Devices must be restarted to use the new firmware version The checkboxes below can be used to automatically restart devices after a Update Devices successful update When checked Zero Client targets will be restarted immediately while host targets will restart when the host operating 2 View Status system is shutdown and restarted Selected Firmware Version Filename fw_combined_20131127 pcoip Device Family ALL Version 4 2 0 102 Tera2 4 2 0 102 Ter
52. cess Device Peer Webpages PCoIP devices have an embedded web server known as the Administrative Web Interface AWI that provides you with access to device configuration settings and status You can access the AWI using a standard web browser The MC provides multiple quick links that you can click to access the webpage e Device s AWI from the Device Details webpage Click the IP Address link e Peer device s AWI from the Device Details webpage Click the Peer IP Address link View Device Log PCoIP devices maintain a persistent event log containing messages that may be useful in diagnosing problems To access this event log click the View Device Log link Figure 5 14 shows a Device Event Log webpage To save the event log to a file click the Save File button You can retrieve the most recent event log data from the device using the Retrieve updated log data from device link TERO812002 Issue 14 60 te rad ICi Teradici PColP Management Console User Manual a a teradici PCoIP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Device Event Log Return to previous page Retrieve updated configuration and log data from device Save File IRARRAR ERA RENA R ANTENA ANTENA RENE RNR ARENA RARE ER NARRA RRA REN RR EERE ERE EEEERREEERERREEEE RARE a LOGS RETRIEVED USING PCoIP MC 1 10 0 PCoIP MC DEVICE NAME pcoip portal 0030040df2a6 GROUP Default TYPE Zero Client we
53. ddress 192 168 65 149 Peered to MAC 00 30 04 0E 33 89 Peered to IP 192 168 65 232 Click to view Details Delete this Device View Device Log Figure 5 11 Summary Device Information Dialog Box The dialog box also lets you configure the device name view additional device details delete the device from the MC database and view the device event log TERO812002 Issue 14 56 te rad ICi Teradici PCoIP Management Console User Manual 5 2 10 Configure Device Name You should configure the name of each device in the system The device names must be unique The Name field is a string that you can set to whatever you want Consider including location information in the name to simplify locating the device but this is up to you to decide When a device is first discovered the MC sets the Name to a string containing a timestamp and a unique number To modify the device name 1 Click the device to display the Summary Device Information dialog box 2 Click the Summary Device dialog box again This opens a text editing field that shows the current device name Enter the new device name Click Save to update the device name Figure 5 12 displays the summary information dialog box while the device name is being edited Device Summary Name Label pcoip portal 0030040df2a6 Unique ID 00 30 04 0D F2 46 Mac address 00 30 04 0D F2 46 FQDN pcoip portal 0030040df246 terase local Firmware 4 2 0 re1 Processor Te
54. diately when it receives a reset command e APCoIP host device schedules a deferred reset when it receives a reset command A deferred reset is a reset that occurs the next time the host PC workstation is powered off or restarted Power Off Commands e Soft power off commands sent to host PCoIP devices trigger the same action that occurs when you click the host PC workstation Power button for less than four seconds The action taken by the host depends on how the operating system is configured It may initiate a software controlled shutdown or cause the host to enter the Standby state e Hard power off commands sent to host PCoIP devices trigger the same action that occurs when you press the host PC workstation Power button for more than four seconds This immediately shuts down the PC workstation by turning off its power Note You must configure the host workstation to support power state transitions initiated by the PCoIP host card Some systems do not support this feature or it may be optional See your PCoIP system supplier documentation to determine if this feature is supported To send a reset or power off command to a device TERO812002 Issue 14 78 te rad ICi Teradici PCoIP Management Console User Manual 5 5 2 Select the command type by selecting one of the radio buttons shown in Figure 5 28 Filter the devices the command may be sent to using the Group drop down menu Click the View Devices to Change button to display
55. dual host and zero client devices are statically grouped together peered It shows the MC used for peering and configuration The figure does not show a connection broker which is required when hosts are dynamically assigned to zero clients as users log in Server running VMware Player Web browser administering PColP MC PColP MC Virtual Machine D B a Hosts DNS Server with DHCP Server with PColP MC DNS SRY PCoIP Vendor Class Record Options Figure 2 1 PColP Deployment Components Managing PCoIP Devices APCoIP deployment is made up of one or more PCoIP host and zero client devices Each device has multiple configuration settings that you can access and control using the mechanisms explained below TERO812002 Issue 14 11 te rad ICi Teradici PColP Management Console User Manual Device Web Interface Although you can configure each device individually via the Administrator Web Interface AWI you are encouraged to use the MC especially as the deployment grows This ensures that all PCoIP devices are configured uniformly and that the MC database accurately reflects the device configuration settings For information about the device AWI see PCoIP Zero Client and Host Administrator Guide TER1206003 PColP Management Console The Teradici PCoIP Management Console MC lets you centrally manage a PCoIP deployment It lets you e Access and update the configuration of your PCoIP de
56. e Manage networking Manage database Change timezone Restart PCoIP MC daemon Halt virtual machine 2 3 4 5 6 fi 8 Refresh the displayed PCoIP MC status Figure 3 1 MC VM Console For information on how to access the MC VM console features see section 4 Virtual Machine Features Migrating to a New Version of the Management Console New releases of the MC are periodically released These releases include support for new features and or bugs fixes This section describes e Potential problems that can occur when migrating to a new version of the MC along with recommendations on howto avoid them e Information that is and is not imported from a backed up database e Steps to follow when migrating to a new version of the MC Potential Problems and Workarounds Table 3 1 lists the problems that can occur when installing a new version of the MC It includes recommendations to follow in order to avoid or work around each problem TERO812002 Issue 14 35 te rad ICi Teradici PCoIP Management Console User Manual 3 6 2 3 6 3 Table 3 1 Potential Problems Associated with Upgrading the MC The database restore Do not try to import databases created by a newer version of the feature can only import MC into older versions of the MC databases created by old versions of the MC When a deployment installs This problem does not occur if the IP address of the new a new version of the MC instance of the MC
57. e When the Simple Certificate Enrollment Protocol SCEP setting is configured only 14 additional certificate files can be uploaded since two slots are reserved for SCEP server certificates Important A device s certificate store will be replaced with the certificate s you add to a profile if at least one certificate is set in the profile For example if a device has eight certificates already in its store and you apply a profile with only one certificate all eight previous certificates will be erased and replaced with the one certificate applied by the profile If a profile has no certificates you are given the option to replace the device s certificate store causing it to empty or to leave the certificate store untouched To upload a certificate file into a profile 1 Prepare a valid certificate file 2 Choose Certificate Store and then Add New 3 Click Browse to locate your certificate file 4 Click Add Once you upload the certificate file you can assign an usage using the drop down menu in the Certificate Store tab Certificate Store Supported Device Family ALL Supported certificate size for firmware 4 1 0 or greater 8176 bytes Supported certificate size for firmware 4 0 x or smaller 6143 bytes Available Storage 14 certificate s 92400 bytes Subject DigiCert High Assurance EV Root CA Issued By DigiCert High Assurance EV Root CA No Usage Delete Expiration Date 11 09 2031 Contains Private Key Fa
58. e 2 and description MC AutoConfig Group e MC AutoConfig Behavior Enter the name MC AutoConfig Behavior data type Byte code 3 and description MC AutoConfig Behavior Then enter the data entry in the Scope Options dialog 1 MC AutoConfig Group String value of a group name 2 MC AutoConfig Behavior Byte value representing one of the following options 0 AutoConfig All new devices Persistent AutoConfig Only when device is in MC AutoConfig Group 1 AutoConfig All new devices Persistent AutoConfig All grouped devices 2 AutoConfig None Persistent AutoConfig None MC AutoConfig Behavior option is only used when MC AutoConfig Group option is configured It is recommended to configure both options together TERO812002 Issue 14 22 te rad ICI Teradici PCoIP Management Console User Manual PCoIP Management Console DNS Based Discovery Prefix Each PCoIP device reads the PCoIP MC DNS Based Discovery Prefix setting when it boots If this setting is not blank during startup the device tries to contact the MC by combining the string stored in this setting with variations of the domain name hierarchy System Requirements The system requirements for MC DNS Based Discovery are as follows e The PCoIP devices and MC must be located within the same domain name hierarchy tree e g ifa PCoIP device is located in the domain sales europe companyname com then the MC s domain name can be any one of sales europe companyname com eu
59. e appears This indicates the devices are linked in the MC database Figure 5 10 shows the zero client 10 0 4 46 now connects to the host 10 0 4 95 when you select Connect on the zero client OSD See section 5 2 2 Legend for the meaning of the lines that connect devices You can link together individual host and zero client devices After two devices are linked the zero client always establishes a PCoIP session with the linked host when you initiate a connection The host only accepts connections from the linked zero client 54 te rad ICi Teradici PCoIP Management Console User Manual 5 2 7 a a terad ICI PCoIP Management Console HOME DEVICES GROUPS PROFILES UPDATE SETTINGS o clo 101 HELP O Device Management Device Discovery optional Legend Update All HOSTS deselect ZERO CLIENTS deselect Lo 10 0 4 95 Marketing 10 0 4 46 Markesin Text 192 168 65 124 192 168 65 140 grouped _Clear 10 0 4 23 10 0 4 10 ngroupe Field 10 0 4 240 10 0 4 12 Ing IP Address z 192 168 65 100 10 0 4 13 Processor Family All Devices 192 168 65 139 10 0 4 14 ngroupe Peerings 192 168 65 208 10 0 4 17 ed All Devices y 192 168 65 230 ag 10 0 4 18 Groups 10 0 4 21 eee All Devices 10 0 4 22 Status 10 0 4 24 All Devices 100425 E 10 0 4 27 A 2 PHHHHDS Destination Group 10 0 4 30 Ungrouped Marketing E 10 0 4 33 10 0 4 34 Ungroupe Ungrouped 10 0 4 36 pp 10 0 4 37 ngroup
60. e release 3 5 1 Dec 02 2011 Updated document for release 1 7 e Added support for firmware release 3 5 e Added Certificates to profiles e Added Session Connection Type Oct 01 2011 Updated document for release 1 6 Added Remote Power Down Added Import and Export to profiles Added Retry and Apply AutoConfig Added Manage Device Naming Added Delete button to Device Management TERO812002 Issue 14 4 Aug 13 2012 Updated document for release 1 8 e Added support for firmware release 4 0 0 Added support for firmware release 4 0 1 Added support for Tera2 devices Added DHCP Option Matching in AutoConfig Added Persistent AutoConfig Added Display Topology Configuration to profiles Enhanced Login process te rad ICi Teradici PCoIP Management Console User Manual Version pate peseripton O O Jun 01 2011 Updated document for release 1 5 Added AutoConfig Added support for firmware release 3 3 and 3 4 Added OSD Logos to profiles Added Firmware to profiles Added Profile Application Status page Changed term Portal to zero client USB device bridging support Added support for profile scheduling Configurable DHCP Timeout options Mar 01 2010 Updated document for release 1 2 e Replaced PCoIPMC with MC e Added support for Internet Explorer Aug 31 2009 Updated document for release 1 1 e Updated Management Console Limitations e Added Migrating to a new Version of the Management Console 4 Sep 1
61. e the current rule configuration active When two rules conflict a warning appears on the Manage AutoConfig screen Leaving rule conflicts unresolved results in unexpected group memberships as the AutoConfig feature randomly selects which rule gets applied to a zero client that satisfies more than one rule After creation you can edit AutoConfig rules by adding and removing specific passwords and IP address ranges and changing the Add devices with no password checkbox Make sure you disable AutoConfig before editing the rules and then re enable it when done a a teradici PColP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Group Management Manage Groups Manage AutoConfig Vi WARNING ENABLING PERSISTENT AUTOCONFIG FEATURE MAY RESULT IN DEVICES BEING RESET WHILE USERS ARE IN SESSION View Profile application Status Manage AutoConfiq F Enable AutoConfig p View AutoConfig 5 a AutoConfig DHCP Option Matchin I Add devices with no password id s On ni Add Password 10 0 4 1 to 10 0 4 127 a Add IP Address Range Choose group Add rule for group Marketing Delete Figure 5 19 Manage AutoConfig Webpage Persistent AutoConfig WARNING ENABLING THIS FEATURE MAY RESULT IN DEVICES BEING RESET WHILE USERS ARE IN SESSION The Manage AutoConfig subcategory shown in Figure 5 19 also lets you enable or disable the Persistent AutoConfig feature By default Persistent A
62. eate a new profile After creating a new profile click the Set Properties link to configure the properties Click on the Session Configuration tab to expand it and then click on Edit Properties to display the Set Properties dialog Click and enable the Set in Profile checkbox for Session Connection Type Select View Connection Server in the Session Connection Type drop down menu Now you will see all the settings for the VMware View connection server Click and enable the Set in Profile checkbox for View Connection Server Address and then type in the server address in the value field TER0812002 Issue 14 95 te rad ICi Teradici PCoIP Management Console User Manual 10 11 12 13 Optionally you can also set the Certification Check Mode Scroll to the bottom of the dialog and click the Save button Depending on the Certification Check Mode and the server configuration a valid certificate must be presented by the zero client Click the Add New button in the Certificate Store tab to upload and assign a certificate file to the profile Note See Knowledge Base 15134 1020 for details on downloading the View Connection Server trusted root certificate Go to the Group Management webpage by clicking the GROUPS tab Click the Edit link for the Default group and select the profile in the drop down menu Once you assign the profile to the Default group click the Apply Profile link to change settings on all devices in the Def
63. ed Add a 2eocuems 10 0 4 38 Ungroupe 10 0 4 39 Ungrouped 10 0 4 42 ng Delete All 10 04 47 Ungroupes Device Password ARARARARAARA AAA 53 D Figure 5 10 Peering a Pair of Devices Note After two devices are linked by the MC the MC updates the zero client device session configuration data if it detects a change in a peered host device s IP address When the MC detects that a host s IP address has changed it looks up the host s peer in the database and tries to write the new IP address into the zero client session settings It keeps trying to update the zero client until it succeeds This feature only works if both endpoints are discoverable by SLP or they advertise themselves to the MC through DNS SRV or the device PColP MC DNS Based Discovery Prefix configuration field is set to the address of the MC managing the device Note This feature is disabled when the Brokered setting is set to Yes See section 5 8 2 Environment Settings for more details Access Device Webpage All PCoIP devices have an embedded web server that provides you with access to device configuration settings and status You can access this web server using a standard web browser The MC provides multiple quick links that access the device s webpage See PCoIP Zero Client and Host Administrator Guide TER1206003 for details TERO812002 Issue 14 55 te rad ICi Teradici PCoIP Management Console User Manual 5 2 8 5
64. ee eee eee eee eee 77 5 5 2 Power Management Status ao orende cc cece ce ce cnc 79 5 5 3 Schedule Remote Power Down cc 80 5 5 4 View Remote Power Down Status l l 0000000000000000 00000000000 oeo rrr cee cee cece cece eee ee eens 82 5 6 UpdatevFirmware 2 22822 2e scat este noe E oe horse sea ha gee noes eee IA 82 5 621 lmport Firmwalens 082 soe tala 83 5 6 2 Update Device Firmware occ 83 51623 MIEW Status cave lias Skat atu eh MIS bl detente haat Sek elon lea OE CS la 85 5 6 4 Delete Firmware from the MC cc 86 5 7 Device Log MONITORING 22228 eon aoc atada osas 86 LADEN TICS A A A Nt SR id lesen yet slate OU US dele ion Sule Sh 87 557 2 Logsing COMtNOISN 22 02 So a Ak end Re Md Blah et SEED ee le es SA Ee ae 87 Bi 7 SeSTALUS nenas oe SA IAS aA dette Oia Saath 88 DS Manage Settings 2 0 46606 327 co ld oi 88 5 8 1 Database Management lt 2 och 5030 du oe ts a ae een eae a ee RAR oe 89 5 8 2 Environment Settings occ 89 5 9 3 Manage Device Naming s 2 h 02 5 5s tek ii SIG io tai hue Sak cal cs 90 5 8 4 Web Interface Session Timeout _ 2 02 22 eee eee eee ee eee eee eee cece e eee eee 90 5 9 Site Status nro atrae da it oN do ae ae ence i ides on 90 510 Online Help Z acantilados 92 6 Getting Started aa os a dd a O Sant 93 6 1 Start the Management Console occ 93 6 2 Discover DEVICES tati a A A ls adoos dd 93 6 3 Adding Devices to a Groupi a a a E r T UALER OE 93 6 4 Peering Devices sihr rrd a A id ete 94 6 5 Conf
65. eradici PCoIP Management Console User Manual you can discover devices using this feature and configure the PColP MC DNS Based Discovery Prefix setting of each device so the devices contact the MC each time they boot Figure 2 8 shows the Management Console Device Management webpage with the Device Discovery feature expanded e When the IP address of a device is known and the device has not been discovered enter the address in the from IP field and then select Discover Devices e When a device is on a specific subnet but its IP address is not known you can command the MC to discover the devices in a range of IP addresses using both the from IP and optional to IP fields After you specify the address range select Discover Devices Note This process can take a few minutes to complete depending on the number of addresses searched A status bar appears while the tool discovers devices e When the FQDN of a device is known and the device is not discovered enter the FQDN in the FQDN field and select Discover Devices a a teradici PColP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Device Management Device Discovery optional Legend Discover by IP from IP 10 Jo 4 1 Discover Devices optional fio p La 254 Update All to IP Discover by FQDN FQDN scover Device Text 192 168 65 100 Ungrouped 192 168 55 149 Ungrouped Clear 192 168 65 139 Field 192 168 65 143 IP Address y 192 168
66. ess data type String code 1 and description MC Address and then click OK io Oo ND TERO812002 Issue 14 20 te rad ICi Teradici PCoIP Management Console User Manual 10 11 12 13 14 15 Option Type Ax Class PColP Endpoint Figure 2 6 Add a DHCP Option Type Dialog Box Click OK to save and close the dialog Expand the tree for the DHCP server and expand the tree for the Scope to which you want to add options Right click Scope Options and then choose Configure Options Click the Advanced tab and then select the PCoIP Endpoint Vendor class Enable the checkbox for the MC Address and then enter a valid MC IP address in the Data entry field Click OK to save TERO812002 Issue 14 21 te rad ICi Teradici PColP Management Console User Manual General Advanced Vendor class PCOIP Endpoint y User class Default User Class y Avallable Options Description MA 001 MC Address MC Address 002 MC AutoConfig Group MC AutoConfig Group A 002 MO ButaCanfin Rahawinr MC Ar nCorfin Rahavior Data entry String value f192 168 65 111 Figure 2 7 DHCP Scope Options Dialog Box Optionally you can add MC AutoConfig Group and MC AutoConfig Behavior options in the PCoIP Endpoint vendor class Add the options in the Predefined Options and Values dialog using the following values e MC AutoConfig Group Enter the name MC AutoConfig Group data type String cod
67. figuration Figure 4 2 Manage MC VM Console Network Settings 4 4 1 View Network Configuration The View network configuration option lets you view the current network configuration settings of the MC 4 4 2 Configure IP Address The Configure IP address option lets you select e DHCP e Static IP addressing If you choose static IP addressing you must configure the MC IP address and subnet mask The gateway address broadcast address and domain are optional and can be left blank After you update the IP address settings the MC restarts the network interface using the new settings 4 4 3 Configure DNS The Configure DNS option lets you configure the Domain Name Server s and search domain s used by the MC The MC queries the DNS Server s to determine if the MC DNS SRV record and connection broker DNS SRV record are present The status of these records appears in the site status on the Home webpage See section 5 9 Site Status for details Note When the MC is configured to use DHCP the DNS settings configured here may be overwritten by the settings configured in the DHCP server TERO812002 Issue 14 40 te rad ICi Teradici PCoIP Management Console User Manual 4 5 Database Management The MC maintains a database containing information on the discovered PCoIP devices configuration data such as device name and other information such as firmware images that can be downloaded to PColP devices The MC VM console supports c
68. gineering Return to Previous Page Description Engineering Profile Last Updated 2013 11 29 16 51 29 PST Expand Categories With Set Values Collapse All indicates that the property requires a device restart after being changed Network Configuration Discovery Configuration Session Configuration Encryption Configuration Family Property Name Value Description Enable Controls whether AES 128 GCM encryption is available to secure a PColP Teral AES 128 GCM True session At least one encryption scheme must be enabled Encryption ALL Session Negotiation Maximum When this property controls the required security level for PColP session Security Level Compatibility negotiation Tera AESZ50OOM THe Sepekan e Encryption Edit Properties Bandwidth Configuration Language Configuration OSD Configuration Image Configuration Display Configuration Time Configuration Security Configuration Audio Permissions Figure 5 22 Profile Management Set Properties Webpage Each group of devices managed by the MC can have a profile assigned to it The concepts associated with an MC profile are explained in section 2 3 1 Groups and Profiles TER0812002 Issue 14 73 te rad ICi Teradici PCoIP Management Console User Manual To define individual profile settings expand the profile property category The Encryption Configuration category is expanded in the previous figure When a category is expanded you can access the Edit Propert
69. he zero clients you or your users should manually power on the devices to respond to the MC again TERO812002 Issue 14 81 te rad ICi Teradici PColP Management Console User Manual 5 5 4 View Remote Power Down Status The View Remote Power Down Status subcategory shown in Figure 5 32 provides status information that shows if devices have been powered down The status categories include e success The device was successfully powered down by MC e failed error The device failed for a reason other than listed next e failed offline The device could not be reached for power down e failed no hardware support The device did not have hardware support e failed no firmware support The device did not have firmware support e failed in session The device was in session and the Power Down in Session Devices checkbox was turned off teradici PCoIP Management Console DEVICES GROUPS PROFILES i UPDATE SETTINGS LOGOUT HELP O Power Management 1 Set Device State View Remote Power Down Status gt ii View All target groups y All statuses El Aime E gy Set Remote Power ose es p T Taoro Power Down Last Set View Remote Power Down Status 10 0 4 46 Marketing success 2013 12 02 17 15 45 PST Zero Client Figure 5 32 View Remote Power Down Status Webpage 5 6 Update Firmware The Update Firmware webpage shown in Figure 5 33 lets you update the firmware running on PCoIP devices The Update Firmware web
70. he PColP MC s vmx file Click Open and then Next Select the destination type VMware Infrastructure virtual machine Enter the address user name and password of either the VMware vCenter or the VMware ESX host Click Next Edit the virtual machine name optional and then click Next Review the options and then click Next Click Finish to begin the conversion Once complete start the VM through VMware vSphere client or your preferred mechanism See section 3 2 Contents of the Management Console Package to learn about the contents of the MC virtual machine 3 4 Installing the Management Console Using VMware Player 1 TERO812002 Download the VMware Player application The MC is distributed as a VMware virtual machine VM contained in a zip file The VM is run using VMware Player VMware ssue 14 33 te rad ICi Teradici PColP Management Console User Manual 3 5 Player is an application that you can download from http www vmware com download player Followthe directions provided by VMware to download and install this application on the MC host machine 2 Extract the contents of the file PColP_MC_relA B C_vDEF zip into a folder on the MC host machine The release number A B C and build 1D DEF are encoded in the filename 3 To start the MC open the folder from step 2 Double click the file PColP_MC_relA B C_vDEF vmx to launch VMware Player and have it load the MC VM You can also start the MC from wit
71. he active MC database from a previously stored archive Note that the archive must already reside within the MC VM before you restore the database You should use this command with the Upload command on the Database Management webpage to restore the MC database from an archive located outside ofthe MC VM possibly on the MC host machine See section 5 8 1 Database Management for information on uploading a backup file to the MC VM from a host PC Note Section 3 6 2 What Information Is Imported describes the specific information that is and is not imported into the MC by the Restore Database command Delete Database The Delete database archive command lets you delete a database archive from the MC VM Change Time Zone The MC retrieves the current time from the host machine The host machine provides this time in Coordinated Universal Time UTC form Because the host does not provide time zone information you must configure the time zone To configure the time zone 1 Select the Change timezone option on the MC VM console 2 Select a geographic area that determines the time zone For example select America New York if located in the same time zone as New York City Note You can use the MC without configuring the time zone If you do not configure the timezone the time that appears at the top of the MC VM console will be incorrect and the timestamps that appear on various screens in the MC web interface will also be incorrect
72. he database before you change the setting to Yes Manage Device Naming The device labels used as default device names in the PCoIP MC configuration setting lets you name newly discovered devices with their labels By default this setting is disabled and devices are named as Discovered YYMMDD XXXX where XXXX is a unique value Figure 5 40 shows the confirmation dialog that appears once the setting is enabled This setting configures how the PColP MC creates default device names If you continue the following will happen 1 Labels on devices will become the default device name in the PCoIP MC 2 If no device label is available the default device name will be Discovered YYMMDD XXXX where XXXX is a unique value Choose OK to continue or Cancel for no change Cancel Figure 5 40 Manage Device Naming Dialog Web Interface Session Timeout Select an inactivity session timeout period for the web UI from the Web Interface Session Timeout drop down list If no activity occurs during this timeout period the MC session times out and the user is returned to the login page When the timeout is set to Disabled the web UI will not time out The timeout options are e 15 Minutes 1 Hour e 2 Hours e Disabled Site Status The right side of the Home webpage displays summary information on the PCoIP devices discovered by the MC TERO812002 Issue 14 90 te rad ICi Teradici PCoIP Management Console User Manual ter
73. he furnishing of this document does not give you any license to these patents trademarks copyrights or other intellectual property Visit http www teradici com about teradici pat php for more information 2000 2014 Teradici Corporation All rights reserved Teradici PC over IP and PCoIP are trademarks of Teradici Corporation and may be registered in the United States and or other countries Any other trademarks or registered trademarks mentioned in this release are the intellectual property of their respective owners TERO812002 Issue 14 2 te rad ICi Teradici PColP Management Console User Manual Revision History Version pate peseripton O O 14 May 09 2014 Updated document for release 1 10 1 e Added support for firmware release 4 5 0 For details see section 2 4 Management Console and Firmware Version Compatibility and also PCoIP Zero Client and Host Administrator Guide TER1206003 Updated browser versions that the MC web user interface supports e Firefox 23 or later e Internet Explorer 8 and 9 e Internet Explorer 11 in compatibility view Added note to Certificates in a Profile on page 75 to explain how all certificates in a device s certificate store are replaced by any certificates that are added to a profile when the profile is applied 13 Jan 08 2014 Updated document for release 1 10 0 e Added support for firmware release 4 2 0 e Updated section 2 4 Management Console and Firmware
74. he meaning e lt value gt The parameter is specified in the device and equal to lt value gt e Empty string The parameter is not configured in the device Some fields such as the Connection Management System CMS address are set to this when the device is not configured to use a CMS e Not supported Certain device parameters only apply to specific devices or device models This value appears for device parameters that are not supported by a device e Not valid for current session configuration The parameter is not specified in the profile because the currently selected session connection type does not support this parameter Refresh Device Settings Stored in Management Console The information shown in the Device Value column is a copy of the data stored in the device The MC tracks the last time it updated its internal copy ofthe device data The Last Updated field on the Device Details webpage displays this timestamp To force the MC to refresh its internal copy of the device values click the Update link Write Profile Settings to Device The Reapply Profile link lets you write the device profile settings to the device This can be useful in situations when you want to write the profile settings to a single device in a group Open Device Profile The View Profile link opens the Profile Management webpage for the profile associated with this device You can use this link to quickly access and or modify the profile settings Ac
75. hin VMware Player Select File gt Open a Virtual Machine and then navigate to the PColP_MC_relA B C_vDEF vmx file Click Open Once VMware Player has launched the MC at least once you can restart the MC from within VMware Player s startup screen by double clicking on the PCoIP MC entry in the list of recently opened VMs Running the Management Console Before running the MC make sure the MC host machine and PColP devices are connected to the same network The MC supports both DHCP and static IP addressing After starting the Management Console you can display the MC VM console window using one of the following methods e From your vSphere client right click the MC VM in inventory and then select Open Console e Ifyou are using VMware Player the MC VM console appears automatically As the VM boots a series of standard Linux boot messages display before the top level menu appears The URL web interface address for the Management Console displays in the MC VM console as shown in Figure 3 1 TERO812002 Issue 14 34 te rad ICi Teradici PCoIP Management Console User Manual 3 6 3 6 1 2 TWMC110 on 10 0 152 71 i 5 xj File View YM a wl gt 6 8 Ble OB Teradici PCoIP Ma PCoIP MC status Dec 02 2013 11 09 03 PST Version 1 10 0 rc_pcoipmc_1_10 3386 Build date Nov 15 2013 17 00 28 UTC The web interface is available at http 10 0 152 158 Refresh status Set web interface password Change hostnam
76. i teradici HOME DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O PCoIP Management Console Device Management Device Discovery optional Legend HOSTS deselect Discovered 131130 17 Discovered 131202 101 Discovered 131130 16 Discovered 131130 19 Discovered 131130 20 Discovered 131130 21 Discovered 131202 79 Discovered 131203 123 g s N ERO CLIENTS deselect y Al Discovered 131130 15 Discovered 131202 91 Discovered 131130 14 Discovered 131202 100 Discovered 131202 102 Discovered 131202 103 Discovered 131202 104 Discovered 131202 105 Discovered 131202 106 Discovered 131202 107 Update All Field Name x Processor Family All Devices Peerings All Devices hd Groups All Devices hi Status Discovered 131202 108 Discovered 131202 109 Discovered 131202 110 All Devices y Destination Group Discovered 131202 111 Choose y Discovered 131202 112 Discovered 131202 113 Discovered 131202 114 Discovered 131202 115 Discovered 131202 116 Discovered 131202 117 Discovered 131202 118 Discovered 131202 119 Device Password Ad 0 Hosts AGG a zeocuems Delete All MUTLUECELECECUC LULU Ge Figure 5 7 Device Management Webpage 5 2 1 Device Discovery Optional See Manual Device Discovery on page 24 for details about the optional Device Discovery feature 5 2 2 Legend The device management Legend shown in Figu
77. ies link Click this link to open a dialog box that specifies the category property settings Figure 5 23 shows the Encryption Configuration Settings dialog box There are five columns in the configuration settings dialog box e Set in Profile Each checkbox in this column determines if a setting is included in the profile Profile application skips the settings that are not included in the profile and does not change the device settings e Device Family This column shows the device family type to which each property setting applies Figure 5 23 shows one encryption property for all devices two for Teral1 device family and two for Tera2 device family Setting Teral property values has no effect on the Tera2 devices and vice versa e Property Name This column shows the name of the property e Value The fields in this column determine the value of each profile setting e Description This column provides a description of the property Set Properties Setin Device Profile Family Controls whether AES 128 GCM encryption is available to secure a M Teral Enable AES 128 GCM Encryption True False PCoIP session A least one encryption scheme must be enabled Property Name Value Description Enable Salsa20 256 Round12 Encryption Controls whether Salsa20 256 Round12 encryption is available to secure a PColP session A least one encryption scheme must be enabled FT Teral True False Session Negotiation Security Maximum Compatibil
78. iguring Zero Clients for VMware View o oooccccccccccccccccccccccoccncncncnc once 95 6 6 Familiarizing Yourself with the MC ccoo conc 96 Glossary Of DefmMitiohS a e dd e s de 98 TERO812002 Issue 14 8 te rad ICi Teradici PCoIP Management Console User Manual 1 1 Introduction The Teradici PCoIP Management Console MC lets you centrally manage a PCoIP deployment The MC is packaged as a VMware virtual machine VM and runs on VMware Player VMware Workstation and VMware ESX server A web browser is used to access and control the MC The MC lets you e Access and update the configuration of your PCoIP devices e Apply the same configuration data to groups of devices e Update device firmware e Reset devices e Control the power state of host devices e Remotely power down zero clients e View status information e Manage the monitoring of device event logs e Automatically configure newly discovered devices with a profile optionally with firmware and OSD logo based on device password IP address and DHCP option values About this Document This document describes how to install and set up the MC It also describes the features of the tool For more details about the individual PCoIP device configuration fields see PCoIP Zero Client and Host Administrator Guide TER1206003 This document is arranged into the following sections e Section 2 Overview provides a description of the components found in a PCo
79. ile In this example configuration settings defined in the Development Profile are written to the devices in the R amp D and Engineering groups R amp D Group A OA Development Profile Engineering Group AAA gt AN Figure 2 2 Management Console Groups and Profiles Sales Profile Note some important rules regarding groups and profiles Each group has only one profile associated with it The same profile can be associated with multiple groups All configuration settings in a profile are written to all devices in a group when the profile is applied to the group A profile can contain values for every configuration parameter but this is not required You can define a profile that contains a subset of the configuration parameters If the firmware on a device is updated when a profile is applied the profile settings are written to the device after the new firmware is activated Profiles contain settings that let users specify if a device s firmware is updated based on the version of the firmware running on the device TER0812002 Issue 14 15 te rad ICi Teradici PCoIP Management Console User Manual 2 3 2 2 3 3 e When profile settings are written to devices the settings might not take effect immediately Some settings are activated after a device is reset Profile settings that require a reset are preceded by the symbol within the MC Profile Set Properties and Device Details webp
80. ine Help TERO812002 Issue 14 48 teradici Teradici PCoIP Management Console User Manual teradici DEVICES GROUPS Manage Devices Manage Groups es Manage Profiles 5 2 Device Management PColP Management Console PROFILES POWER UPDATE SETTINGS Site Status LOGOUT O Manage Power PCoIP Devices Zero Clients Update Firmware Hosts Sessions Tera2 28 online 0 offline Tera1 24 online 0 offline Tera2 6 online 0 offline Tera1 2 online 0 offline 27 active Monitor Device Logs DNS SRV Records Update DNS SRV Records Management Console w2k8 wdm terase local Connection Broker Manage Settings No record found Management Console Health Disk Usage Extended Logging Figure 5 6 Home Webpage The Device Management webpage shown in Figure 5 7 lets you e Discover devices manually e Query devices and update the database e Display a subset of devices based on various filter criteria e Configure the group each device belongs to e Link host and zero client devices e Open a web browser connected to device s webpage e View summary information about a device e Configure the name of each device Good 2 19 GB 61 free 1 38 GB used Disabled e View device details device configuration settings profile settings e Delete a device from the MC database TERO812002 Issue 14 49 Teradici PCoIP Management Console User Manual teradic
81. ing information link the devices in the MC See section 5 2 6 Linking Devices for further details e Adashed line indicates the device is peered with another device but the other device is not drawn on the active screen This may happen in deployments with large numbers of devices The bold non bold state of the device field name indicates whether the device is currently in a session If a session is active between a host and zero client the device field name appears in bold characters The green red color of the device field name indicates whether the device is currently online If a device s last known state was online the device field name in green characters appears Otherwise the device field name appears in red characters TERO812002 Issue 14 51 te rad ICi Teradici PColP Management Console User Manual 5 2 3 5 2 4 The following device symbols indicate whether devices are peered e Peered devices are represented by the ae symbol e Unpeered host devices are represented by the LA symbol e Unpeered zero client devices are represented by the LS symbol Querying Devices and Update Database The MC database contains a snapshot of each device s configuration settings The MC automatically queries each device once an hour and updates its internal database If you want to force the tool to refresh its internal copy of the device settings you can use the Update box on the upper right hand side of the Device Man
82. ing the zero client TERO812002 Issue 14 12 te rad ICi Teradici PCoIP Management Console User Manual 2 1 2 2 1 3 DNS Server Figure 2 1 shows a DNS server with the MC DNS SRV record This component is optional but highly recommended The MC must discover the PCoIP host and zero client devices and the MC DNS SRV record facilitates automatic device discovery You can also install a connection broker DNS SRV record on the DNS server PColP devices use this record to notify the connection broker of their existence When a PCoIP device boots it reads these records which contain the addresses of the MC and or connection broker After reading the records the device sends messages to the MC and or connection broker notifying them of the device s existence This ensures the MC and or connection broker is aware of the devices in the deployment as they are powered on The MC DNS SRV record is not required when one of the following conditions is true e PColP DHCP Vendor Class Options are configured in the DHCP server See Configuring DHCP Vendor Class Options on the DHCP Server on page 19 for details on configuring these options e All PCoIP devices in a deployment reside on the same network subnet as the MC In this situation the MC can find the devices using SLP discovery All devices have the Enable SLP Discovery configuration setting set to True e The PCoIP MC DNS Based Discovery Prefix setting for all devices is set to the hos
83. ion VMware Player requires approximately 250 MB Windows or 200 MB Linux of free disk space e The MC server machine CPU requirements differ based on the number of PCoIP devices managed If the MC manages fewer than 1000 devices the server machine CPU should be a 2 GHz or faster Intel Pentium 4 or better processor If the MC manages 1000 or more devices the server machine CPU should be an Intel Core 2 Duo Processor or better e The MC virtual machine is configured to use 640 MB of RAM For best performance the server machine should have at least 1 GB of RAM to avoid excessive swapping e The MC server machine must have 4 GB of available disk space to accommodate the virtual machine s disk image 3 2 Contents of the Management Console Package The zip file contains the following files e Teradici_End_User_License_Agreement pdf Teradici end user license file e PColP_MC_relA B C_vDEF vmx Teradici PColP Management Console VMware configuration file for the virtual machine that hosts the Management Console e PColP_MC_relA B C_vDEF vmdk Teradici PColP Management Console VMware virtual disk file containing the virtual machine s hard drive The size of this file increases as the MC is used The maximum size of the file is 4 GB TERO812002 Issue 14 32 te rad ICi Teradici PCoIP Management Console User Manual pcoipmc_cacert p7b and pcoipmc_cacert pem PColP Management Console CA root certificate in Internet Explorer and Mozilla F
84. irefox formats Refer to CA_root_certificate_ installation txt for instructions on how to use these certificates to eliminate browser certificate security warnings when accessing the web UI CA_root_certificate_installation txt Contains directions on how to install the PCoIP Management Console root certificate into Internet Explorer and Mozilla Firefox These instructions are also available in sections 5 1 1 Installing the MC Certificate in Internet Explorer and 5 1 2 Installing the MC Certificate in Firefox README txt File describing the contents of the zip file TERO812002_Issue_X PColP_Management_Console_User_Manual pdf Teradici PCoIP Management Console User Manual where X is the current issue number TERO904003_Issue_X PCoIP_MC_Release_Notes pdf Teradici PColP Management Console Release Notes where X is the current issue number 3 3 Installing the Management Console into Your Existing VMware ESXi Server To install the MC into your ESXi server 1 Au PWD N 10 11 Download and install the free VMware vCenter Converter client from http www vmware com products converter You must use this standalone tool to import the MC VM into a VMware ESXi host Failure to do so can result in ESXi host crashes high CPU usage and poor MC performance Click the Convert Machine button to launch the Conversion wizard Select source type VMware Workstation or other VMware virtual machine Use the Browse button to locate t
85. is grayed out in the Update Firmware webpage this indicates that the firmware file is associated with one or more profiles see Figure 5 33 for an example Before you can delete the firmware you must first remove it from each profile with which it is associated 1 From the Profile Management webpage see Figure 5 21 click the Set Properties link for the profile that is associated with the firmware you want to remove Click the symbol next to Profile Firmware to expand this property Click the Delete link next to the firmware file to remove it from the profile and then confirm the deletion Check the Delete link in the Update Firmware webpage If it remains grayed out the firmware is still associated with another profile Repeat the above procedure to remove the firmware from each profile that includes it In the Update Firmware webpage click the Delete link next to the firmware file you want to remove from the MC and then confirm the deletion 5 7 Device Log Monitoring The Device Log Monitoring webpage shown in Figure 5 37 lets you collect logs over time from a selection of PCoIP devices The Device Log Monitoring webpage lets you TERO812002 Choose devices to be monitored Start and stop log monitoring of the chosen devices Download a tar gz archive of collected logs View status of log monitoring View individual device logs Issue 14 86 te rad ICi Teradici PCoIP Management Console User Manual 5 7
86. is the same as the old version of the MC The the PCoIP host and zero best option is to assign a static IP address to the MC client devices may lose If the MC IP address is assigned by a DHCP server and the contact with the MC deployment installed a MC DNS SRV record the PCoIP devices eventually re establish contact with the new version of the MC The devices are out of contact with the MC for up to n seconds where n is equal to the value of the Time To Live field included in the MC DNS SRV record You can force the devices to contact the new MC by resetting the devices You can also import the database of the old version of the MC This makes the MC aware of the PCoIP devices in the deployment What Information Is Imported When a database is imported into the MC the following information is populated e Device information for all devices device details profile group and peering information e Previously imported firmware images e Profiles e Groups If the imported database was created by an instance of the MC running release 1 1 x or higher the following additional information is populated Databases created by release 1 0 x of the MC do not export these settings e MC web interface password e MCnetwork configuration settings e MC hostname The MC time zone settings are not imported Note When migrating to a new version of the MC you are responsible for reconfiguring the settings that were not imported Database Migr
87. ity y When this property controls the required security level for PCoIP ALL Level Maximum Compatibility Y session negotiation i Controls whether AES 128 GCM encryption is available to secure a Tera2 Enable AES 128 GCM Encryption True False PColP session At least one encryption scheme must be enabled a Controls whether AES 256 GCM encryption is available to secure a Tera2 Enable AES 256 GCM Encryption e True False PColP session A least one encryption scheme must be enabled Save Cancel indicates that the property requires a device restart after being changed Figure 5 23 Encryption Configuration Settings Dialog Box OSD Logo in a Profile To upload a logo for the OSD into a profile 1 Prepare an image file that is a 24bpp bitmap that does not exceed 256 pixels by 64 pixels 2 Choose Profile OSD Logo and then Set OSD Logo 3 Click Browse to locate your image file 4 Click Upload to import the file to the MC The logo is then applied to the devices groups with that profile TERO812002 Issue 14 74 te rad ICi Teradici PCoIP Management Console User Manual Add OSD Logo The OSD logo must be a 24bpp bitmap that does not exceed 256 pixels by 64 pixels Any other images will be displayed incorrectly or not at all Filename No file selected Upload Cancel Figure 5 24 Add OSD Logo Property Firmware in a Profile You can assign a firmware file in a profile along with upgrade criteria that
88. l a hit is found at which point the device completes the DNS based discovery The algorithm may take several minutes to find the correct FQDN address of the MC this depends on the number of levels in the domain name hierarchy and the MC load In detail the algorithm works as follows 1 The device uses domain name variations based on the DHCP options 15 string For each FQDN possibility the device attempts to transmit a status message to the MC at the FQDN TERO812002 Issue 14 23 te rad ICi Teradici PColP Management Console User Manual 2 Ifthe transmission times out the device creates the next FQDN variation by proceeding one level up the domain hierarchy The last domain name attempted has a single dot in the string 3 After exhausting the FQDN possibilities based on the DHCP options 15 string the device waits for five minutes and then uses hostname variations based on the DHCP options 12 string 4 After failing to contact a MC using the DHCP options 12 string the device waits for five minutes and then cycles back to using DHCP options 15 5 The device repeats this process until a MC is contacted Example In the following example the DHCP options 15 returns sales europe companyname com DHCP options 12 returns hostmachinel sales europe companyname com Note that the DHCP server may return no value for either option The MC configured the PColP MC DNS Based Discovery Prefix setting in the device to equal pcoip_mcl
89. lse Subject Users issued By 8021x WIN 80AOGYIG8I3 CA ix E Expiration Date 06 25 2013 802 1X Delete Contains Private Key True Add New Figure 5 26 Profile Management Certificate Store Import a Profile On the Profile Management webpage see Figure 5 21 click Import to create a new profile by importing a profile from a file You must then locate the file in the file system Figure 5 27 shows the Import Profile dialog TERO812002 Issue 14 76 te rad ICi Teradici PCoIP Management Console User Manual 5 4 7 5 5 5 5 1 Import Profile Profile File prt No file selected OK Cancel Figure 5 27 Import Profile Dialog If the imported profile contains a firmware file the import process adds a new firmware file to the Update Devices webpage Export a Profile Click Export to export a selected profile into a file You must then confirm the download to start the export process Note You may find it useful to export a profile and share it with other MCs if multiple instances of MCs are deployed Power Management The Power Management webpage lets you e Send reset commands to PCoIP host and zero client devices e Send power off commands hard S5 and soft S5 to host PCs workstations e Schedule reset and power off commands to be sent in the future e Display the current power state of host PCs workstations e Display status information on the last or next scheduled reset and
90. mmary Device Information and View Device Log on page 60 describe two different ways of doing this Download new firmware to a device See section 5 6 Update Firmware Send reset commands to a device and then view power management status information See section 5 5 Power Management TERO812002 Issue 14 96 te rad ICI Teradici PCoIP Management Console User Manual 12 Back up the MC database and then download it from the MC VM to an external server See sections 4 5 1 Back Up Database and 5 8 1 Database Management 13 Upload a backed up copy ofthe MC database to the MC VM and then restore the active database from the uploaded file See sections 4 5 2 Restore Database and 5 8 1 Database Management TERO812002 Issue 14 97 teradici Teradici PCoIP Management Console User Manual Glossary of Definitions AWI Administrative Web Interface CA Certificate Authorities CMI Connection Management Interface Inter face provided by the zero client or host that is used to communicate with an external connection management server CMS Connection Management Server An external management entity 3rd party that manages and controls the zero cli ent host through the CMI interface DDC Display Data Channel DHCP Dynamic Host Configuration Protocol DNS Domain Name System DNS SRV Domain Name System Service Record EDID Extended Display Identification Data FQDN Fully Qualified Domain Name GPU
91. mpties the MC s storage of any previously collected logs and starts the log monitoring process You cannot change the selection of devices being monitored and the event log filter mode until log monitoring is stopped An attempt to collect logs is made every 300 seconds Click the Download Collected Logs button to format the logs collected into individual txt files per device archive the logs into tar gz format and present them as a downloadable file TERO812002 Issue 14 87 te rad ICi Teradici PCoIP Management Console User Manual When log monitoring is no longer needed click Stop to end the log monitoring service and enable the device tree and event log filter mode controls The logs collected from the last time the Start button was clicked remain available for download until you click Start again 5 7 3 Status Localized date time stamps appear when log monitoring was started and stopped Log monitoring in the MC has a finite storage limit which appears as Free Log Space This amount is shown as a percentage where 100 is empty and 0 is full When Free Log Space becomes full the oldest log data are overwritten with new log data It is a good idea to check this display periodically 5 8 Manage Settings The Settings webpage shown in Figure 5 38 lets you e Upload and download MC database archive files e Configure MC environment settings e Manage device naming e Setan inactivity session timeout option for the web Ul
92. mulation setting for Tera2 host cards Profiles gt Display Configuration 1 10 0 3 5 1 current 3 5 1 4 2 0 Added the following features e An inactivity timeout period for the web Ul can be configured from the Settings webpage A warning displays during login if another user is currently logged in Firmware patch releases can be uploaded within a profile The MC supports firmware combined files only pcoip extension The all file type is no longer supported 1 9 1 3 5 1 current 3 5 1 4 1 2 Added the ability to Configure preferred resolution override Enable accept any peer Configure connection server auto connect mode option Enable with retry on error Configure display suspend timeout TER0812002 Issue 14 27 te rad ICi Teradici PCoIP Management Console User Manual MC Version Compatible with Fully Configures FW Versions FW Versions 0 19 current 0 19 4 1 0 Added the ability to Configure Simple Certificate Enrollment Protocol SCEP Configure zero client power down timeout Disable Connection Management Interface CMI Enable display cloning Enable 802 1X support for legacy switches Configure OneSign mode proximity reader beep control option Use existing proximity card beep mode Choose the Portuguese Brazilian ABNT and Slovak QWERTY and QWERTZ keyboard layouts Enable host hot plug delay Configure PCoIP Connection Manager Session Connection Type Configure custom session Server Name Indica
93. nable disable SNMP server Enable disable host driver function Configure session encryption modes Choose the Korean keyboard layout 1 1 20 0 19 current 0 19 2 2 Added the ability to Configure View Connection Server address Configure View Connection Server port Enable disable View Connection Server SSL Enable disable View Connection Server Auto Connect Configure device bandwidth floor a gt TERO812002 Issue 14 31 te rad ICI Teradici PCoIP Management Console User Manual 3 Installation and Setup This section describes how to install and set up the MC It also describes how to migrate from an old version of the MC to a new version 3 1 Management Console Host System Requirements The MC server machine must meet the requirements of the virtualization environment in which the MC VM will run e The MC server machine must meet the requirements of the VMware Player 5 Fora VMware Player installation see the VMware Player documentation http www vmware com pdf desktop vmware_player50 pdf for the most up to date requirements The current requirements are e 64 bit x86 CPU with LAHF SAHF support in long mode e Processor speed 1 3 GHz or faster e Memory 1GB minimum 2 GB recommended You must have enough memory to run the host operating system the virtual machine and applications on the host and guest operating systems e Hard disk At least 1 GB of free disk space for each guest operating system For installat
94. o AutoConfig rules Table 5 1 Example AutoConfig Rules EN Device Password Cdn3 IP Range Cdn2 Group A Add device with no password DHCP Option Matching OFF PASSWORD lt Empty gt Group B x Add device with no password DHCP Option Matching ON 192 168 50 1 192 168 50 254 Table 5 2 Example AutoConfig Rule Application Note AutoConfig is enabled so condition 1 is always true TERO812002 Issue 14 66 te rad ICi Teradici PCoIP Management Console User Manual Zero Client DHCP Vendor Options Group A Group B AutoConfig Rule Rule Result Password MC Cdn Cdn Cdn Cdn AutoConfig AutoConfig 3 Behavior 2 192 168 60 10 PASSWORD False Added to Group A 192 168 50 10 PASSWORD False Added to Group A 192 168 60 20 True Not added to any group 192 168 6030 PASSWORD True False True False False False True a i 2 True True True True True False True B fl False Not added to any group B 192 168 50 30 Group B False False True Not added to any group Note When the MC AutoConfig Group is empty the MC AutoConfig Behavior is ignored When the MC AutoConfig Group is not empty the MC looks for the group with the identical name and checks if the DHCP Option Matching is switched on AutoConfig fails if the group does not exist or the group s DHCP Option Matching is switched off Do not configure the MC AutoConfig Group option if you want to use the IP address matching False To create an
95. o a o dadas 42 4 7 Restart Management Console Daemon ccoo 42 4 8 Halt Virtual Machine 1 2 0 0 ccc cece cece cee ee cee cece cece nce c eee ceceeceeceececeuceeceeseces 43 S Web tercera nue nenes Due are reno EL no USES EE SS 44 5 1 Accessing the Management Console Web User Interface 1 2 0 eee cece ce cece eee eee eeeeees 44 5 1 1 Installing the MC Certificate in Internet Explorer 22 0 0 2000202 e eee eee eee eee ee eee 45 5 1 2 Installing the MC Certificate in Firefox 2 0 002 e eee eee ee 45 5 1 3 Logging into the MC Web User Interface _ 2 22 22222 e eee 46 5 1 4 Accepting the Teradici End User License Agreement 02 022222 e eee eee eee eee eee ee 47 5 1 5 Using the MC Home Page 22 2c cece cece ee cee ee eee eee eee eee cece cece orooro 48 5 2 Device Management 22 ce cee eee ee cee ee cee eee cece cece ee eeeeeeeeees 49 5 2 1 Device Discovery Optional 0 00 0002 e eee eee ee eee eee ee eee eee eee 50 A i Ak grt U ee A E SEE ly Ae 50 5 2 3 Querying Devices and Update Database _ 22 2222s 52 522 Filtering Devices IA A NR da arco dan he A laa 52 5 2 5 Configuring a Device Group 222 on ce Aes tee ir ici ts 53 52 67 LinkingDevices 82 fr oo neat aS te ed o ie Re tee tlt hil e re Se 54 5 2 7 Access Device Webpage _ 0 0 2 eee eee eee ee ce ee eee eee ee ee eee eee eee ee eeee 55 532 8 Deleting Devices c225 00 oe cs oe celled See aoe tec ech on Se ee eee
96. o send the command to After scheduling the command s click the View Status link on the left side of the screen to view the status of the command s Power Management Status Click the View Status link on the Power Management webpage to view status information on commands sent to PCoIP devices as well as pending commands that have not yet been sent to PCoIP devices This webpage also displays the current power state of host PCs workstations Figure 5 30 shows an example of the Power Management Status webpage TERO812002 Issue 14 79 te rad ICi Teradici PCoIP Management Console User Manual teradici PColP Management Console HOME DEVICES GROUPS PROFILES UPDATE SETTINGS LOGOUT HELP O Power Management 1 Set Device State Host PC Workstation Power States 2 View Status gy Set Remote Power Refresh oO Down View Remote Power Fate Name and Group iP agaress EC Discovered 113013 16 Ungrouped 192 168 65 208 power on Discovered 120213 79 Ungrouped 10 0 4 23 power on Discovered 113013 19 Ungrouped 192 168 65 230 power on Discovered 113013 21 Ungrouped 192 168 65 139 power on Discovered 120313 123 Ungrouped 10 0 4 240 power on Discovered 113013 17 Ungrouped 192 168 65 124 power on Discovered 113013 20 Ungrouped 192 168 65 100 power on Host Card in Marketing 10 0 4 95 power on Device State Commands Cancel Selected Commands Scheduled PCoIP Processor Resets Select Name and Group Type IP Addres
97. ommands that let you back up and restore this database You should use this feature when you upgrade the MC Before you install the new version of the MC 1 Back up the MC database 2 Export the database to an external PC 3 Install the new version of the MC 4 Import the backed up database Select the Manage database option shown in Figure 4 1 to access these commands Figure 4 3 shows the MC Manage database options 2 TWMC110 on 10 0 152 71 o xj File view YM ae wl gt 6 0 A Ble OB You may backup the database onto the VM filesystem or restore from a database backup Use the web UI to upload and download database archives Restore database from archive Delete database archive Return to main menu Figure 4 3 Manage MC VM Console Database 4 5 1 Back Up Database The Backup database to archive command lets you take a snapshot of the current database contents and store it in an archive The archive resides within the MC VM TERO812002 Issue 14 41 te rad ICi Teradici PCoIP Management Console User Manual 4 5 2 4 5 3 4 6 4 7 You should use this command with the Download database command on the Database Management webpage to back up and store the contents of the database somewhere outside ofthe MC VM See section 5 8 1 Database Management for details on downloading a backup file to the host PC from the MC VM Restore Database The Restore database from archive command lets you update t
98. on dialog box 2 Click the View Device Log link in the Summary Device window Device Details Access Device Details on page 57 describes how to access the Device Details webpage Figure 5 13 shows the Device Details webpage for a zero client The Device Details webpage lets you e Display device configuration settings and status e Refresh the MC device configuration settings by querying the device e Write the current profile settings to the device e Open the device s profile e Open a web browser connected to device s webpage e Open a web browser connected to device s peer webpage e View the device s event log TERO812002 Issue 14 58 te rad ICi Teradici PCoIP Management Console User Manual a a teradici PColP Management Console j DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Device Management Device Details Backto Device List Zero Client pcoip portal 0030040df2a6 in Default Online Last Updated 2013 11 29 15 17 51 PST Update IP Address 192 168 65 149 In Session With Host MAC Address 00 30 04 0D F2 A6 Peer IP Address Unique ID 00 30 04 0D F2 A6 FW Version 4 2 0 1c1 Label pcoip portal 0030040df2a6 Processor Family Tera2 Processor Revision ID TERA2321 rev 0 0 Processor Description Dual Display Zero Client Assigned Profile Not set Log File View Device Log Assignment Status Unapplied FQDN pcoip portal 0030040df2a6 terase local Expand All Collapse All indicates that the property requires
99. onsidered offline when the last attempt to rediscover the device failed Rediscovery attempts are performed when TERO812002 Issue 14 91 te rad ICi Teradici PColP Management Console User Manual 5 10 e You click Update on the Device Details webpage e Once an hour if the device is online e Once every 15 minutes if the device if offline e After a firmware update if the deployment has a MC DNS SRV record If the record does not exist the device is rediscovered by one of the other mechanisms listed here e After a profile is applied or the application fails Note The MC considers sessions to be active only when the host PC workstation is powered on in the SO state and a session is active between the host and zero client If the host PC workstation is in a low power state S3 S4 or S5 the session is considered inactive Note Site status information is updated when you reload the Home webpage The MC checks the DNS SRV records every five minutes or when you click the Update DNS SRV Records button on the Home webpage Online Help MC webpages include a HELP link in the upper right hand corner When you click this link a help screen appears as shown in Figure 5 42 This webpage has two links that provide access to the following information e View Help File Opens a copy of this document e Online Support Opens a new browser window at the Teradici MC support website To access this site go to http www teradici com
100. ows Server 2003 Ifyou use a different type of server modify the steps accordingly To add the PCoIP DHCP vender class options to the DHCP server in Windows Server 2003 Enter the DHCP service configuration on the DHCP Server console Right click the DHCP server in the tree and then choose Define Vendor Classes Click Add to add a new DHCP Vendor Class Enter PCoIP Endpoint in the Display name field Enter PCoIP Endpoint in the ASCII column as the Vendor ID uP wn pe TERO812002 Issue 14 19 te rad ICi Teradici PCoIP Management Console User Manual Note For Cisco VXC 2111 and VXC 2211 PCoIP devices with firmware version 4 0 0 or higher use VXC2111 and VXC2211 respectively as the Vendor ID loj xj Fie Action View Help es mE ai ala S E verme AA 2x E IPv6 Microsoft vendor specific option Microsoft Windows 98 Microsoft vendor specific option Edit Microsoft Options Microsoft vendor specific option arm New Class 2 x Display name PCoIP Endpoint Description PCoIP Endpoint ASCII 50 43 6F 49 50 20 45 6E PCoIP En 64 70 6F 69 6E 74 dpoint Figure 2 5 Add a New DHCP Vendor Class Configuration Click OK to save and close the dialog Right click the DHCP server in the tree and then choose Set Predefined Options Select PCoIP Endpoint as the Option class and then click Add Enter the name MC Addr
101. page lets you e Upload new firmware images to the MC VM e Schedule firmware updates for one or more PCoIP devices e View the status of scheduled firmware updates e Delete firmware from the MC Note the Delete link for a firmware file is not active i e is grayed out whenever the firmware is associated with a profile TERO812002 Issue 14 82 te rad ICi Teradici PColP Management Console User Manual 5 6 1 5 6 2 a a teradici PCoIP Management Console DEVICES GROUPS PROFILES POWER SETTINGS LOGOUT HELP O Update Firmware FF import Firmware Imported Firmware Files Update Devices An imported firmware file can be deleted from the Management Console when there are no devices scheduled to be updated with the 2 View Status firmware file Refresh Device Devices A ame a 4 2 0 102 2013 11 29 ALL Tera2 9 2 0 102 ena 10 47 03 fw_combined_20131127 pcoip 0 tes sudate Terat 4 2 0 102 PST evices Figure 5 33 Update Firmware Webpage Import Firmware Click the Import Firmware link to transfer a firmware release file from the host machine to the MC VM When prompted locate the file containing the firmware release on the host machine file system and assign a description to the firmware release Note Only firmware files containing both Tera1 and Tera2 firmware pcoip files can be imported The MC supports storing a maximum of 10 firmware images Delete old firmware releases if this limit is reached and yo
102. power off commands for each PCoIP device e Schedule remote power down for zero client devices e Display status information on the device that received the remote power down Sending Reset and Power off Commands Click the Set Device State link on the Power Management webpage to schedule reset and power off commands to be sent to PCoIP devices The webpage shown in Figure 5 28 appears TERO812002 Issue 14 77 te rad ICi Teradici PCoIP Management Console User Manual a a teradici PColP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT Hep Power Management Set Device State Device State Change Command 2 View Status Command to issue py Set Remote Power C Down send PCoIP processor reset command to Zero Client s and host s View Remote send soft power off command to host PC s Workstation s Power Down Status send hard power off command to host PC s Morkstation s Select Devices Device state changes can only be applied to grouped devices Group All Grouped Devices y View Devices to Change Figure 5 28 Send Device State Change Command Webpage In the Set Device State webpage reset commands can be sent to both host and zero client devices while power off commands can only be sent to host devices To power off zero client devices see the Set Remote Power Down webpage see section 5 5 3 Schedule Remote Power Down Reset Commands e APCoIP zero client resets imme
103. pplied in the future Click in the Apply Profile at Date Time field to display a graphical date time picker Figure 5 17 shows the date time picker To determine when the profile was written to devices in the group watch the Group Management webpage until the number of Scheduled updates is 0 At this point the MC has completed all attempts to write the profile to the devices in the group If a device was offline when the MC tried to write the profile the status is marked as Failed To see the View Profile Application status with the filter set to this group click View Details Apply Profile Are you sure you want to update all the devices in group Marketing with the settings in Basic This profile contains properties that require a device reboot for a change to take effect Choose reboot behavior Automatically after applying profile C Manually by user control Apply Profile at Date Time 29 1 1 2013 15 52 Cancel Figure 5 16 Apply Profile Reboot Behavior Options TER0812002 Issue 14 63 teradici Teradici PCoIP Management Console User Manual Apply Profile Are you sure you want to update all the devices in group Marketing with the settings in Basic This profile contains properties that require a device reboot for a change to take effect Choose reboot behavior Automatically after applying profile Manually by user control Apply Profile at Date Time 29 f29 17 2013 15 52 _ 3 15 52 OK
104. ra2 ID TERA2321 rev 0 0 IP address 192 168 65 149 Peered to MAC 00 30 04 0E 33 89 Peered to IP 192 168 65 232 Click to view Details l is Device View Device Lo Figure 5 12 Edit Device Name Using Summary Device Information Dialog Box Note The device must be part ofa group before you can configure the name Note The device name only supports English characters Access Device Details The MC maintains additional device details not shown on the Device Management page To access these details for an individual device 1 Click the device to display the Summary Device Information dialog box 2 Click the Click to view Details link See section 5 2 9 Summary Device Information for details on Device Details webpage features Delete Device from Management Console Database To delete a PCoIP device from the MC database TERO812002 Issue 14 57 te rad ICi Teradici PCoIP Management Console User Manual 5 2 11 1 Click the device to display the Summary Device Information dialog box 2 Click the Delete this Device link in the Summary Device window Note Information maintained on the device by the MC is deleted This includes the device name group peering information and other information View Device Event Log PCoIP devices maintain a persistent event log containing messages that may be useful in diagnosing problems To view a device s event log 1 Click the device to display the Summary Device Informati
105. rad ICi Teradici PCoIP Management Console User Manual 4 DNS Manager iof xj Fie Action View Help e 9 AmXE ab lH m E DNS 385 ge Service Location SRV 0 100 3268 sterssdcO1 t 11 30 2013 8 00 00 AM E STERSSDCO1 El 3 Forward Lookup Zones Eo Service Laration SD EIOPA ctarcaden t 11 29 2013 10 00 00 AM E a _msdcs terase local g _kerberos LOS Record Type x Ya 11 30 2013 8 00 00 AM E El terase local E kerberos er 11 29 2013 10 00 00 AM E msdes Select a resource record type a t _kpasswd Route TEOSA IRT te 11 30 2013 8 00 00 AM H Route Through RT a ls E _kpassud Service Location SRY te 11 29 2013 10 00 00 AM a ae _Idap Signature SIG te 11 29 2013 10 00 00 AM Epa dap Text TXT te 11 30 2013 8 00 00 AM 2 DomainDnsZones ip tool Well Known Services WKS k tati E ForestDnsZones pcoip too 1 25 7 Dire Stade E Reverse Lookup Zones E _VLMCS Ir 5 19 2011 3 00 00 PM Conditional Forwarders Description Service SRY record Allows administrators to use several servers for a single DNS domain to easily move a TCP IP service from one host to another host with administration and to designate some service provider hosts as primary servers For a service and other hosts as backups DNS clients that use a SRY type query ask for a specific TCP IP service and protocol mapped to a specific DNS domain and receive
106. re 5 8 describes the meaning of special symbols and line colors that appear on the Device Management page To open the Legend box select the symbol next to the Legend text TERO812002 Issue 14 50 teradici Teradici PColP Management Console User Manual Legend BOLD TEXT TEXT ae Links Devices peered by PCOIP MC Peering found in devices not maintained by PCoIP MC Peering found in Zero Client host accepts any connections not maintained by PCoIP MC Device in session Device online Device offline Peering off screen or filtered Devices Host Click to Login Zero Client Click to Login Peered Click to Login Figure 5 8 Device Management Legend Box The MC may drawa line between host and zero client devices The line indicates that the two devices are linked Host and zero client devices are considered linked if a PCoIP session was or still is active between the devices The color of the line is important e Agreen line indicates the two devices are peered by the MC This means the MC database contains information about the device peering e Ablue or orange line indicates the MC found peering information in the device configuration settings read from the devices The blue line indicates the host and zero client are peered directly with each other The orange line indicates the host device is configured to accept connections from any zero client To have the MC maintain this peer
107. rope companyname com or companyname com e The PCoIP devices must enable DHCP to get the domain name and hostname to get DHCP options 15 and 12 respectively e The DHCP server must support either DHCP options 12 hostname 15 domain name or both See RFC 2132 for details on the DHCP options If the DHCP server only supports DHCP options 12 the hostname string must contain the domain name e PCoIP devices managed by a specific MC must have the PCoIP MC DNS Based Discovery Prefix setting equal to the MC s hostname prefix e g if the MC s FQDN is pcoip_ mci europe companyname com then the field must equal pcoip_mc1 Algorithm Each time a PCoIP device boots it executes the MC DNS based discovery algorithm if the PColP MC DNS Based Discovery Prefix setting is non blank The algorithm uses the setting and the domain name hierarchy to search for a MC The PCoIP device gets the domain name string from the DHCP server using DHCP options 15 Since some DHCP servers may not have DHCP options 15 implemented the device also gets the hostname using DHCP options 12 assumed to include the domain name Since the device and MC may not be on the same domain but must be within the same hierarchy the device creates many FQDN variations using the results from DHCP options 12 and 15 With each FQDN variation the hostname prefix remains constant while the domain hierarchy level changes The device sequentially attempts each FQDN possibility unti
108. roup B DHCP Option Matching OFF x lt Empty gt Group C DHCP Option Matching ON x lt Empty gt Table 5 4 Example AutoConfig Rule Application Note AutoConfig is enabled so condition 1 is always true Zero DHCP Vendor Options Group A Group B Group C Persistent Client Rule Rule Rule AutoConfig Result Current MC MC Cdn Cdn Cdn Cdn Cdn Cdn Group AutoConfig AutoConfig 2 3 2 3 2 3 Group Behavior Group A False True True False True False Profile not applied TERO812002 Issue 14 69 te rad ICi Teradici PCoIP Management Console User Manual Zero DHCP Vendor Options Persistent Client AutoConfig Current MC MC Group AutoConfig AutoConfig Group Behavior Group B Group B profile applied Result Group B Group B Profile not applied Group B Group C Profile not applied Group B Group C Moved to Group C and Group C profile applied Group B Group C Profile not applied 5 3 5 View AutoConfig Status The View AutoConfig Status subcategory shown in Figure 5 20 lets administrators view status information retry AutoConfig to failed devices and apply AutoConfig to devices that were discovered while AutoConfig was disabled a a teradici PCoIP Management Console DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT HELP O Group Management Manage Groups AutoConfig Status gt View Profile Application Status Summary Successfully Added to Group 2 AutoConfig Failed 0 Retry
109. roup option and the MC AutoConfig Behavior option is not set to 2 See Configuring DHCP Vendor Class Options on the DHCP Server on page 19 for details When a zero client is discovered e wn Y The device is listed in the AutoConfig status table with a status of Not Started The zero client IP address and password are compared against all AutoConfig rules If a match is found the zero client is added to that group If the group s profile contains a firmware rule the firmware is applied if it passes the criteria and the device is rebooted The rest of the profile s properties are now applied to the device After applying the profiles OSD logo and properties the zero client is rebooted See Configuring DHCP Vendor Class Options on the DHCP Server on page 19 for more details on configuring AutoConfig TERO812002 Issue 14 26 te rad ICI Teradici PCoIP Management Console User Manual 2 4 Management Console and Firmware Version Compatibility Table 2 1 Management Console and Firmware Version Compatibility MC Version Compatible with Fully Configures FW Versions FW Versions 1 10 1 3 5 1 current 3 5 1 4 5 0 Added the following features e Enable disable new Auto Detect session connection type for Tera2 zero clients Profiles gt Session Configuration Enable disable new Low Bandwidth Text Codec mode for TERA2321 zero clients Profiles gt Image Configuration Enable disable new Enable Accelerated Monitor E
110. s Reset Status E Zero Client in Marketing A 10 0 4 46 Reset issued at 2013 12 02 16 56 33 PST E Host Card in Marketing Host 10 0 4 95 Reset issued at 2013 12 02 16 56 33 PST Scheduled Host Power State Change Commands Select Name and Group IP Address Reset Type Shutdown Status r Host Card in 10 0 495 power off without OS Shutdown issued at Marketing involvement 2013 12 02 17 18 08 PST Cancel Selected Commands Figure 5 30 Power Management Status Webpage In addition to providing status information you can cancel commands scheduled to be sent in the future from this webpage 5 5 3 Schedule Remote Power Down Click the Set Remote Power Down link on the Power Management webpage to schedule remote power down commands to be sent to zero client devices When you click this link the webpage shown in Figure 5 31 appears TER0812002 Issue 14 80 te rad ICi Teradici PCoIP Management Console User Manual teradici PCoIP Management Console b DEVICES GROUPS PROFILES POWER UPDATE SETTINGS LOGOUT Hep Power Management Set Device State Set Remote Power Down Remote Power Down only applies to a subset of Zero Clients that support the feature View Status py Set Remote Power Black total devices in group Down Green devices with hardware snd firmware support for remote power down View Remote Power Red devices without support for remote power down Down Status ee ee s E 2 Total s M w F s E
111. stem press Ctrl Alt e Ifyou are using the VMware Player the bottom of the window describes how to interact with the VM and return to the host operating system 2 TWMC110 on 10 0 152 71 5 x File View M s 0 6 0 Ble OB Teradici PCoIP Ma RCGUPSHE status Dec 02 201g 0903 RST version 1 10 0 rc_pcoipmc_1_10 3386 Build date Nov 15 2013 17 00 28 UTC The web interface is available at http 10 0 152 158 PCoIP MC daemon status running Refresh status Set web interface password Change hostname Manage networking Manage database Change timezone Restart PCoIP MC daemon Halt virtual machine Refresh the displayed PCoIP MC status Figure 4 1 Management Console VM Console 4 1 Refresh Status The Refresh status option lets you refresh the information that appears in the MC VM console window TERO812002 Issue 14 38 te rad ICi Teradici PColP Management Console User Manual 4 2 4 3 4 4 Set Web Interface Password The MC web interface is protected by a password When a browser connects to the MC web interface you are prompted to enter a password To configure this password select the Set web interface password option from the MC VM console Change Hostname The default hostname of the MC is pcoip mc The MC registers this hostname with the DNS server if a server is present on the network You can update this field using the Change hostname option shown in Figure 4 1 If a deplo
112. t The PColP Management Console CA root certificate is now added the Windows Trusted Root Certification Authorities certificate store Restart Internet Explorer so that it rescans the Windows certificate store 5 1 2 Installing the MC Certificate in Firefox wu PWN From the Firefox Tools menu select Options Click the Advanced icon at the top of the window From the Certificates tab click the View Certificates button From the Authorities tab click the Import button From the Select File dialog select pcoipmc_cacert pem and then click Open TERO812002 Issue 14 45 te rad ICi Teradici PColP Management Console User Manual 6 When the Downloading Certificate dialog appears check the option labeled Trust this CA to identify web sites and then click OK The PColP Management Console CA root certificate appears in the list on the Authorities tab Note In Firefox you can also disable the certificate warnings by adding an exemption for the MC To do this click Understand the Risks on the This Connection is Untrusted warning page and follow the directions given to add an exemption 5 1 3 Logging into the MC Web User Interface After adding the security exception in Firefox or installing the certificate in either browser the web browser connects to the MC You must enter a password as shown in Figure 5 3 The default password is blank See section 4 2 Set Web Interface Password for details on modifying the password a a
113. teradici PCoIP Management Console You have successfully logged out Enter password to login again Password Login Figure 5 3 Web Interface Login If another user is already logged in a warning message informs you providing the IP address from which the user is logged in and the length of time the user has been inactive An example is shown in Figure 5 4 TERO812002 Issue 14 46 te rad ICi Teradici PCoIP Management Console User Manual a a teradici PCoIP Management Console Enter password to login Password Login Warning Asession already exists for a user at 192 168 63 29 This session has been inactive for 2 hours 50 minutes 17 seconds If you continue with your login that user s session will be terminated Figure 5 4 Login Warning Message 5 1 4 Accepting the Teradici End User License Agreement When you first log in to the MC a prompt appears to accept the Teradici End User License Agreement shown in Figure 5 5 You must complete this process once For subsequent logins to the MC there is no prompt to accept this agreement You can view the license agreement by clicking the License Agreement link near the bottom of the MC webpages The Teradici End User License Agreement document is also included in the MC zip file TERO812002 Issue 14 47 te rad ICi Teradici PCoIP Management Console User Manual License Agreement You must agree to continue TERADICI END USER LICENSE AGREEMENT BY
114. tion SNI Enable Differentiated Services Code Point DSCP Enable transport congestion notification TERO812002 Issue 14 28 te rad ICi Teradici PCoIP Management Console User Manual MC Version Compatible with Fully Configures FW Versions FW Versions 1 8 0 0 19 current 0 19 4 0 1 Added the ability to e Configure certification check mode in View Connection Server mode Enable certification check mode lockout in View Connection Server mode Clear trusted View Connection Server address cache Configure session negotiation security level Configure SNMP community name Configure Imprivata OneSign appliance verification Configure Imprivata OneSign desktop name mode Enable proximity reader beep Configure session lost timeout Enable session disconnect hotkey Configure display topology Enable monitor emulation on video port 3 and 4 Enable Wake on USB Enable Wake on LAN Enable power on after power loss Enable AES 256 1 7 1 0 19 current 0 19 3 5 1 Added the ability to e Enable session login overlay Preparing Desktop e Choose the Turkish F keyboard layout TER0812002 Issue 14 29 te rad ICi Teradici PCoIP Management Console User Manual MC Version Compatible with Fully Configures FW Versions FW Versions 1 7 0 0 19 current 0 19 3 5 0 Added the ability to Configure Imprivata OneSign authentication servers Configure Self Help Link on VMware View login dialogs Configure session connection
115. tional HOSTS deselect Discovered 131130 17 Discovered 131202 101 Discovered 131130 16 Discovered 131130 19 Discovered 131130 20 Discovered 131130 21 Discovered 131202 79 Discovered 131203 123 Linking Devices To link a host and zero client POWER UPDATE SETTINGS ZERO CLIENTS deselect AB ae RRBRRRERREAREARARARALAASA Discovered 131130 15 Discovered 131202 91 Discovered 131130 14 Discovered 131202 100 Discovered 131202 102 Discovered 131202 103 Discovered 131202 104 Discovered 131202 105 Discovered 131202 106 Discovered 131202 107 Discovered 131202 108 Discovered 131202 109 Discovered 131202 110 Discovered 131202 111 Discovered 131202 112 Discovered 131202 113 Discovered 131202 114 Discovered 131202 115 Discovered 131202 116 Discovered 131202 117 Discovered 131202 118 Discovered 131202 119 Figure 5 9 Adding Devices to a Group Note The devices must belong to a group before you can link them PCoIP Management Console LOGOUT Hep Legend Update Devices Field Name Y Processor Family All Devices y Peerings All Devices E Groups All Devices nd Status All Devices y Destination Group Marketing y Device Password ee Delete Devices 1 Hold the Ctrl key and select the host and zero client devices to be linked 2 Click the Link Devices button that appears below the Device Discovery command After two devices are linked a green lin
116. tname prefix of the MC You can only access this setting through the MC You cannot access it through the device AWI or zero client OSD interface PColP Management Console DNS Based Discovery Prefix on page 23 describes how PCoIP devices use the PCoIP MC DNS Based Discovery Prefix setting to contact the MC It also describes the system requirements to use this option If none of the previous conditions are true include a DNS server in your system and install the MC DNS SRV record See Installing a DNS Service Record on the DNS Server on page 17 for details on installing this record DHCP Server A DHCP server with the PColP DHCP Vendor Class options shown in Figure 2 1 is also an optional component that is highly recommended Like MC DNS SRV records DHCP options facilitate automatic device discovery You can use these options in place of a DNS SRV record When a PCoIP device boots it sends DHCP option 60 containing a PCoIP Vendor ID and requests DHCP option 43 which contains the address of the MC After receiving the address the device sends messages to the MC advertising its existence The PCoIP DHCP Vendor Class options are not required when one of the following conditions is true e The MC DNS SRV record is installed in the DNS server See Installing a DNS Service Record on the DNS Server on page 17 for details on installing this record TERO812002 Issue 14 13 te rad ICi Teradici PColP Management Console User Manual
117. to begin using it This process is performed using the MC VM console See section 4 5 2 Restore Database for information on howto restore the MC database Downloading a Database Click the Download link to transfer a database archive from the MC VM to the host PC running the web browser When you click this link you must select the destination directory to download the archive to Database archives can be created using the MC VM console backup database command See section 4 5 1 Back Up Database for information on backing up the MC database 5 8 2 Environment Settings Set the Brokered configuration setting shown in Figure 5 38 to e Yes If the deployment is using a connection broker to manage host and zero client peerings e No If the deployment uses the MC to manage the host and zero client peerings TERO812002 Issue 14 89 te rad ICi Teradici PCoIP Management Console User Manual 5 8 3 5 8 4 5 9 Note The Link devices button on the Device Management page is disabled when this setting is set to Yes This prevents the MC from manipulating device peering information In a brokered environment the device peering information is maintained by the connection broker Note When the Brokered configuration setting is changed from No to Yes the MC deletes peering information from its database If you later change the setting to No you must link the host and zero clients again When re enabling the old peerings back up t
118. u need to import additional firmware releases Update Device Firmware Click the Update Devices link next to an imported firmware release to specify the devices to update and the time the update takes place This lets you schedule firmware updates to take place at night Figure 5 34 shows the Update Devices webpage This webpage displays e The firmware version and the device family type to download shown under the Selected Firmware Version text e Atable with summary information about the firmware versions running on the Current Devices managed by the MC Use the Version Number and Group Name drop down menus to update specific groups of devices and or devices loaded with specific versions of firmware TERO812002 Issue 14 83 te rad ICi Teradici PColP Management Console User Manual a a teradici PCoIP Management Console DEVICES GROUPS PROFILES POWER SETTINGS LOGOUT HELP O Update Firmware TF Import Firmware Selected Firmware Version 2 Update Devices Filename fw_combined_20131127 pcoip 2 View Status Device Family ALL Version File Description Firmware 4 2 0 Current Devices 0 0 0 D 41 2 0 4 2 0 1c1 0 4 2 0 1c2 D 4 0 2 1 Total 1 1 4 3 1 0 9 Select Devices to Update Firmware updates can only be applied to grouped devices Device Family Any E Version Number Any bal Group All Grouped Devices y View Devices to Update Figure 5 34 Initial Update Devices Webpage Click the View Devices to Update
119. utoConfig is disabled You can enable it for each group by clicking the checkbox When Persistent AutoConfig is enabled devices that qualify to be in the group periodically get the group s profile applied if one or more settings are different Conditions 1 2 and 3 must be true for Persistent AutoConfig to work The MC checks these conditions every hour to determine the action of Persistent AutoConfig e Condition 1 e The AutoConfig feature is enabled TERO812002 Issue 14 68 te rad ICI Teradici PCoIP Management Console User Manual e Condition 2 e The Persistent AutoConfig feature is enabled e Condition 3 e The MC AutoConfig Group option is empty and the zero client is already in the same group OR e The DHCP Option Matching is on the MC AutoConfig Group option is set to the identical group the MC AutoConfig Behavior option is set to 0 and the zero client is in the same group OR e The DHCP Option Matching is on the MC AutoConfig Group option is set to the identical group the MC AutoConfig Behavior option is set to 1 and the zero client is in any group Note Passwords and IP addresses are not compared during the Persistent AutoConfig process The following examples show how AutoConfig rules are applied The MC is configured with AutoConfig enabled and has three AutoConfig rules Table 5 3 Example AutoConfig Rules Group IP Range Cdn3 Persistent AutoConfig Cdn2 Group A DHCP Option Matching OFF lt Empty gt G
120. vices e Apply the same configuration settings to groups of devices e Update device firmware e Reset devices e Control the power state of host devices that support power management e Power off zero client devices e View status information e Manage the monitoring of device event logs e Automatically configure newly discovered zero clients with a profile optionally with firmware and OSD logo based on device password IP address and DHCP option values The MC is packaged as a VMware virtual machine VM and runs on VMware Player This lets you install and run the MC on any host machine that can run VMware Player You can also install and run the MC on any VMware ESX server See section 3 3 Installing the Management Console into Your Existing VMware ESXi Server for details A web browser is used to access and control the MC The MC must be connected to the same network to which the PColP devices are connected This lets the tool communicate with the PCoIP devices Connection Broker A connection broker is an optional component that lets you manage user access to computing resources Note that this component is not shown in Figure 2 1 In a PCoIP deployment a connection broker is used to assign connections between PCoIP host and zero client devices Deployments having the following requirement must install a connection broker e Hosts are dynamically assigned to zero clients based on the login credentials of the person us
121. x configuration setting the final automated device discovery option available is SLP discovery This device discovery method imposes a restriction that limits its usefulness To use this feature all PColP devices and the MC must reside on the same network subnet If a deployment cannot support any of the previous device discovery options you can use the MC to configure devices The MC supports a manual discovery feature that lets the MC find devices Note If you use this approach note that if a device has DHCP enabled the MC loses contact with a device if its IP address changes Should this occur you must perform another manual discovery search to find devices that were assigned new IP addresses See Manual Device Discovery on page 24 for more details Installing a DNS Service Record on the DNS Server Before you can install the DNS service record e The deployment must have a DNS server in the network e Two DNS records must be installed on the DNS server e AnArecord name record for the MC e ASRV record service record Note The following steps are an example of how to install a DNS SRV record to a DNS server in Windows Server 2003 If you use a different type of server modify the steps accordingly To add the MC DNS SRV record to DNS server in Windows Server 2003 1 Enter DNS service configuration on domain controller 2 Navigate to the local domain and then select the _tcp entry folder TERO812002 Issue 14 17 te
122. yment installs more than one copy of the MC make sure each instance of the hostname is set to a unique value If the deployment does not install a MC DNS SRV record you should configure the PCoIP MC DNS Based Discovery Prefix field of each PColP device to equal the hostname prefix of the MC See PColP Management Console DNS Based Discovery Prefix on page 23 for additional details on this field and the system requirements associated with using it To configure this field configure the PColP MC DNS Based Discovery Prefix setting in the profiles and apply the profiles to the devices in the deployment Manage Networking The MC communicates with a web browser through a network connection You must assign it a unique IP address By default the MC uses DHCP to acquire an IP address You can modify the MC network settings to use a static IP address if a DHCP server does not exist on your network or you want to assign a static IP address To modify the MC network settings select the Manage networking option shown in Figure 4 1 The network options shown in Figure 4 2 appear TERO812002 Issue 14 39 te rad ICi Teradici PCoIP Management Console User Manual farwcuiooioose olx File View VM a 0 pb 6 0 Ble OB Teradici PCoIP Mar ment Console Manage networking The PCoIP MC can use DHCP or static addressing View network configuration Configure IP address Configure DNS Return to main menu View the current network con

Teradici PCoIP® Management Console User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

Teradici PCoIP&reg; Management Console User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

Teradici PCoIP® Management Console User Manual