Importing Profiles from PCoIP Management Console 1

PCoIP Management Console provides a profile import script that enables you to import your PCoIP Management Console 1 profiles into newer releases of PCoIP Management Console

Before You Import Your Profiles

Before beginning, ensure the following prerequisites are in place:

  • For PCoIP Zero Clients and PCoIP Remote Workstation Cards, ensure you have uploaded the firmware version used in your profiles, otherwise migrated profiles will be assigned the latest firmware version that exists in PCoIP Management Console.

  • The import script requires the following firmware conditions be met, or the migration script will abort and provide an error message.

Firmware applied in PCoIP Management Console 1 profile being migrated Firmware required to be preloaded to PCoIP Management Console 3 or later for migration script to run successfully
No firmware applied to MC1 profile Client and Remote Workstation Card
Client only Client
Remote Workstation Card only Remote Workstation Card
Client and Remote Workstation Card Client and Remote Workstation Card
  • You know your PCoIP Management Console 1 user password (that is, the password for the teradici administrative user) if it was changed. The default password is 4400Dominion.

  • You know the PCoIP Management Console 1 profile name(s).

    Note: PCoIP Management Console 1

    Profile names are case and white space sensitive.

  • Both PCoIP Management Console 1 virtual appliance and the new PCoIP Management Console virtual appliance reside on the same network.

  • PCoIP Management Console virtual appliance is able to open an SSH tunnel to the PCoIP Management Console 1 virtual appliance over port 22.
    To test if the virtual appliance is able to open an SSH tunnel:

    • From your PCoIP Management Console VM console, type ssh teradici@< PCoIP Management Console 1 IP address or domain name >.

    • Enter your PCoIP Management Console 1 VM password.

    • Type exit to close the session and return to your PCoIP Management Console.

  • On PCoIP Management Console 1.x, you perform the following steps:

    1. With root privileges, modify /etc/postgresql/9.1/main/postgresql.conf by replacing the line
      listen_addresses = 'localhost' with listen_addresses = '*'.

      !!! tip "Commented lines" Note that any code preceded by the # symbol is a comment. The functioning line of code in this step is located at the bottom of the file.

    2. With root privileges, modify /etc/postgresql/9.1/main/pg_hba.conf by appending a new line host all all 0.0.0.0/0 md5 and saving the file.

    3. Reboot MC1 and make sure the changes were saved.

  • On PCoIP Management Console 3.x or newer releases, you perform the following step:

    1.Run the command sudo iptables -I INPUT 1 -p tcp -m state --state NEW --dport 5432 -j ACCEPT

Importing Individual PCoIP Management Console 1 Profiles

To import profiles to PCoIP Management Console release 2 or later, run the migration script shown next for each profile that you want to import:

  1. Log in to your new PCoIP Management Console VM console. See Logging in to the VM Console on page 1.

  2. Change to the migration_script directory:
    cd /opt/teradici/database/legacy/migration_script

  3. Run the script (one or more times) to migrate one profile at a time using one of the following commands:

    • If you have not changed the PCoIP Management Console 1 user password:
      ./migrate_mc1_profile.sh -a <MC 1 address> -p <"profile name">

    • If you have changed the PCoIP Management Console 1 user password:
      ./migrate_mc1_profile.sh -a <MC 1 address> -p <"profile name"> -l <MC 1 user password>

    where <"profile name"> is the exact PCoIP Management Console 1 profile name enclosed in double quotes (for example, "My Profile").

    Important: In PCoIP Management Console 1

    Profile names are case and white space sensitive.

  4. Load (or reload) the newPCoIP Management Console PROFILE page to see the migrated profiles. See Managing Profiles.

Troubleshooting the Profile Import Script

The profile import script is case and white space sensitive because PCoIP Management Console 1 profile names are case and white space sensitive. If the script is unable to find your 1.10.x profile, try copying the exact profile name from PCoIP Management Console 1.

To copy the exact profile name from PCoIP Management Console 1:

  1. In the PCoIP Management Console 1 PROFILES page, click the profile’s Edit link.

  2. In the Edit Profile dialog, select the entire content of the Name field and copy it.

  3. When you run the script, paste this name enclosed in double quotes as the < profile name > in the migration script instructions.

Migrated Profile Naming Rules

Migrated profiles are named according to the following rules:

  • If there is no profile in the new PCoIP Management Console with the PCoIP Management Console 1 profile name, then the migrated profile is called the same name as was used in PCoIP Management Console 1.

  • If there is a profile in the new PCoIP Management Console with the PCoIP Management Console 1 profile, then the migrated profile is called the PCoIP Management Console 1 name with imported appended to it. If that name is already taken, then the script appends #, where # is an integer that starts counting up from one until it finds a name that is not taken.

For example, if the new PCoIP Management Console does not have a 'My Profile' profile, importing this profile four times from PCoIP Management Console 1 would result in the following PCoIP Management Console profile names.

Migrated Profile Naming Example

# of Times Migrated PCoIP Management Console 1 Profile Name PCoIP Management Console Profile Name
1 My Profile My Profile
2 My Profile My Profile_imported
3 My Profile My Profile_imported 1
4 My Profile My Profile_imported 2

Sort the DESCRIPTION column to show the last created profile

If you are unsure what name the migrated profile is called, sort the profile table’s DESCRIPTION column by the last created description. The most recently created profile will be at the top. See Displaying Profile Information.

Profile Properties Renamed in PCoIP Management Console or Not Migrated

The list of PCoIP Management Console 1 profile properties that have been renamed in PCoIP Management Console, or are not migrated when you import a PCoIP Management Console 1 profile to PCoIP Management Console, are in PCoIP Management Console 1 Profile Properties Renamed or Not Migrated.