Skip to content

Downgrading Endpoints to an Older Firmware

From PCoIP Management Console, you can apply a profile to a group of endpoints running firmware 20.01 or higher to remotely downgrade firmware to an older version. Alternatively, you can downgrade the firmware on an individual endpoint using the endpoint’s AWI.

Important: Perform a firmware upload twice when downgrading firmware to 4.8.x on a Tera2 PCoIP Zero Client

For PCoIP Zero Clients, you will need to perform a firmware upload twice. This is because the current firmware installed in the endpoint also contains a recovery image that exists in a different location in flash memory from the firmware image. When you upload a new firmware file to the endpoint, the recovery image is left untouched to guarantee that if the firmware upload fails, a bootable image to boot from still exists. It is therefore necessary to perform another full upload to ensure that the recovery image is completely removed. When using PCoIP Management Console to perform a downgrade to an older firmware, the second firmware upload will need to be completed using PCoIP Management Console 1. Alternatively, you can upload the firmware twice from the PCoIP Zero Client AWI. For more details about recovery mode, please see PCoIP Zero Client Firmware Administrators' Guide . This does not apply to Remote Workstation Cards.

Downgrading Endpoint Firmware Using a PCoIP Management Console Profile

Before you begin, be sure you assign the firmware for the endpoints you wish to downgrade to a group. See Organizing Endpoints into Groups to find out more.

Downloading the Firmware

All access subscribers can obtain the latest firmware by navigating to the Teradici Support Center and selecting your endpoint type from the PCoIP Products section. PCoIP Zero Client users will be able to access the download button for your required version of firmware. Remote Workstation Cards users will have an additional Remote Workstation Card button to select before the firmware download is displayed.

Uploading the Firmware to the PCoIP Management Console

To upload the firmware to the PCoIP Management Console:

  1. Download the older firmware file for PCoIP Zero Clients, and if required the older firmware file for Remote Workstation Cards, and extract the package contents.

  2. From PCoIP Management Console, click SETTINGS > SOFTWARE to display the SOFTWARE MANAGEMENT window.

  3. Click Add Software/Firmware.

  4. Click Select file, select the combined firmware .pcoip file that you extracted previously, and then click Open and Upload to upload the file to the PCoIP Management Console.

Associating a Profile with a Group

To associate a profile with a group:

  1. In the PCoIP Management Console top menu, click PROFILE and then NEW PROFILE.

  2. Enter a name and description for the older firmware profile.

  3. Click the + tab, select the appropriate profile option and click ADD.
    Options are:

    • TERA2: CLIENT [DUAL] - (latest firmware)

    • TERA2: CLIENT [QUAD] - (latest firmware)

    • TERA2: HOST [DUAL] - (latest firmware)

    • TERA2: HOST [QUAD] - (latest firmware)

  4. In the SOFTWARE section, select the firmware file from the Firmware Version drop-down list, and then click SAVE.

  5. From the ENDPOINTS page, select the group containing the endpoint(s) you want to downgrade.

  6. Click PROFILE and then select CHANGE.

  7. In the drop-down list, select the profile you just created, and then click OK.

  8. Select the I understand message and click OK again.

Applying the Profile Immediately

You can apply the profile immediately to either a group of endpoints or an individual endpoint.

To apply the group or individual profile immediately:

  1. In the PCoIP Management Console top menu, click ENDPOINTS and select the desired group or endpoint.

  2. Click PROFILE and then select APPLY.

  3. Enable the I understand message and then click APPLY.

  4. From the DASHBOARD, check Endpoint Updates in Progress in the CURRENT ACTIVITY section for information about the update.

Note: Synchronize firmware image after applying profile

After the profile applies, the selected PCoIP Zero Clients will automatically restart and upload the latest firmware image. The Remote Workstation Cards will need to be restarted manually before it uploads the latest firmware image. After the restart, the endpoints will either no longer appear in the ENDPOINTS table or they may appear as offline. The PCoIP Management Console will not be able to manage them. To synchronize the recovery image (applicable to PCoIP Zero Clients only) in flash memory, perform the update again from PCoIP Management Console 1 using the UPDATE > Update Devices > Update Firmware feature. For details, see the PCoIP Management Console 1.x User Manual.

Creating a Schedule to Apply the Profile (Enterprise)

You can also create a schedule to apply the profile at a specific date and time.

To create a schedule to apply the profile:

  1. In the PCoIP Management Console top menu, click SCHEDULE.

  2. Ensure that the All Schedules setting is toggled to ON.

  3. Select NEW SCHEDULE.

  4. Configure the parameters as follows:

    • Type: Select Apply Profile.

    • Name: Enter a name for the schedule.

    • Description: Enter a description for the schedule.

    • Enabled: Toggle to ON.

    • Groups: Click ADD, select the group containing the endpoints you want to downgrade, and then click ADD.

    • Start Time: Click the time zone widget and select the desired date, then click the clock widget below the calendar and select the desired time.

    Note: Change the default time zone

    By default, the PCoIP Management Console time zone is Coordinated Universal Time (UTC). If you are in a different time zone, you can display the PCoIP Management Console web interface in your own time zone to facilitate creating schedules. See Config_local_time.md.

    • Ensure that Run Once is selected.
  5. Click SAVE at the top of the page.

  6. From the DASHBOARD, check UPCOMING SCHEDULES to see schedule information. When the schedule runs, you can view its progress by checking Endpoint Updates in Progress in the CURRENT ACTIVITY section.