Migrating from PCoIP Management Console 1¶
Follow the steps outlined here to migrate your PCoIP Management Console 1 to PCoIP Management Console version 2 or later. This section only applies to PCoIP endpoints.
Caution: PCoIP Management Console properties
Not all properties from PCoIP Management Console 1 have been migrated to the current release of PCoIP Management Console. For further details, see PCoIP Management Console 1 Profile Properties Renamed or Not Migrated
Step 1: Install and configure this version of PCoIP Management Console¶
Management Console formats
These instructions are for configurations using the OVA format of this release of Managment Console. Different formats (AMI, RPM) will require similar steps.
To install and configure the current OVA version of PCoIP Management Console:
- To install PCoIP Management Console using vSphere Client:
- To log in to virtual machine console from vSphere Client:
- Changing the PCoIP Management Console Virtual Machine Default User Password
- Changing the Default Network Configuration.
- Managing Licenses Online (optional).
-
If you are using an auto discovery method, update your DHCP or DNS server with the new PCoIP Management Console information:
- Configuring DHCP Options (for DHCP discovery)
- Adding the DNS SRV Record (for DNS discovery)
- Adding a DNS TXT Record (for DNS discovery)
- Changing the PCoIP Management Console Web Interface Default Password.
Teradici recommends that you disable the web UI admin user and create a new PCoIP Management Console administrative user. - From the PCoIP Management Console web UI, upload the desired 5.0 or later firmware file for your endpoints.
At least one 5.0 or later firmware image must be uploaded before a profile can be created.
Step 2: Import profiles, create groups, and assign profiles to the groups¶
To import profiles, create and assign profiles to groups:
-
Log in to your PCoIP Management Console 1 web UI and make a note of the names of the profiles you want to import.
Note
Profile names are case- and white space sensitive.
-
Ensure that you can connect to your PCoIP Management Console 1 SSH server from your PCoIP Management Console virtual machine. To test:
- From the newly installed PCoIP Management Console virtual machine command line, type
ssh teradici@<MC 1 IP address>
. - Enter your PCoIP Management Console 1 virtual machine password.
- Type exit to close the session and return to PCoIP Management Console.
- From the newly installed PCoIP Management Console virtual machine command line, type
-
Import profiles into this PCoIP Management Console.
-
From the PCoIP Management Console web UI, refresh the PROFILE page and check that your profiles have been moved over.
Note: Importing process creates tab for endpoints
The profile import process will create a tab for Tera2 Dual and Quad Zero Clients and Remote Workstation Cards. If you are only migrating one type of enpoint (quad or dual), it is recommended that you delete the tab for the other type to avoid accidentally configuring the wrong profile type. For example, if you are only migrating dual zero clients and you set properties in the QUAD tab, the profile will not be applied.
-
Select each profile and click EDIT to check that the profile settings are correct. For example, if your PCoIP Management Console 1 profile contained a certificate file, this file should also be present in your new PCoIP Management Console profile.
Note: OSD logo is never imported
The OSD logo is never imported. While you are in edit mode, you can manually add this logo to your PCoIP Management Console profile or modify the profile as desired. For details about other profile properties that are not migrated or that have been renamed by the profile import process, see PCoIP Management Console 1 Profile Properties Renamed or Not Migrated.
-
From the PCoIP Management Console 1 web UI, make a note of the groups that contain the endpoints you want to migrate and then create the groups from the new ENDPOINTS page on the new PCoIP Management Console using the same group names.
-
Associate the correct profile with each group in turn.
Step 3: Migrate each group of PCoIP Management Console 1 endpoints to this version of PCoIP Management Console¶
If you have a large deployment, Teradici recommends that you migrate your endpoints on a group-by-group basis, checking that the endpoints in each group have successfully migrated to the new PCoIP Management Console, before proceeding with the next group.
To migrate each group of endpoints:
- Create and enable an auto configuration rule.
- From PCoIP Management Console 1, upgrade Tera2 PCoIP endpoints to firmware 5.0 or later.
- If you are not using DHCP options or DNS service record discovery, perform a manual discovery from the new PCoIP Management Console to discover the endpoints.
- Refresh the new PCoIP Management Console ENDPOINTS page and check that the endpoints have been discovered and placed in the correct group with the correct associated profile.