Upgrading the Thin Web Client Services

The following steps describe how to upgrade to a newer version of the CygNet Thin Web Client services.

Upgrade CygNet Thin Web Client

Perform the following steps to upgrade your TWC services to the latest release.

1. Update the CygNet host to the latest version and install any patches. See the CygNet v9.8 Upgrade Procedure for upgrade instructions.
2. Download and install the required Canvas patch that matches the version you are running from the CygNet Download Site (login required)  site.
3. Download the TWC Services Installer from the CygNet Download Site (login required)  site.
4. CygNet services can remain running. Close Canvas if it is running.
5. Run TWC.Installer.SetUp.exe as an administrator.
6. Terms and Conditions
   1. Click license terms to view the Weatherford Terms and Conditions.
   2. Click I agree to the license terms and conditions.
   3. Click Install to launch the CygNet Thin Web Client Setup Wizard.

   CygNet Thin Web Client Installer

7. CygNet Thin Web Client Setup Wizard 
   1. Wait for the installer to gather requirements. Click Next to start the setup wizard.

   CygNet Thin Web Client Setup Wizard

8. Upgrade Options

The CygNet Thin Web Client Setup program offers two upgrade options:

• Start a fresh installation — The Installer will delete all previously compiled applications and source files by removing the entire working folder (TWC.PublishingService.WorkingFolder), and then perform an upgrade to all TWC service files.
• Keep TWC installation as it was — The Installer retains knowledge of which applications were previously published and any Canvas source files used to create the published applications, and updates the system to a state similar to the state prior to the upgrade, only with the newer TWC server files. This upgrade option indicates to the publishing server that an upgrade has been performed and that a Soft publish must be executed before proceeding. This is the default upgrade option.

Republish All Applications After an Upgrade

The Publishing service will detect when a TWC system has been upgraded, but previously published applications have not been republished. After completing an upgrade (either after a fresh install or keeping TWC as it was), you must republish all previously published applications (using Soft publish on the Server page). If you don't republish all previously published applications, any subsequent publishing attempt will fail, and you will see the following Publishing Exception error in the Error details on the Publishing status page:

The Publishing service is in a migrating state. Please initiate the migration process (run Soft publish on Server page).

1. Start a Fresh TWC Installation
   1. Select Start a fresh installation if you want to delete all previously compiled applications and TWC source files and start fresh.
   2. Click Next.

Start a Fresh Installation

-OR-

2. Keep TWC Installation As It Was (Default option)
   1. Select Keep TWC installation as it was if you want to keep the previously published applications and source files.
   2. Click Next.

Keep TWC Installation as it was

9. Ready to Upgrade
1. You are now ready to upgrade the CygNet Thin Web Client.
   Click Install to copy TWC files, update, validate, register components, and start the TWC services.

Ready to Install

2. You will see a message indicating that the TWC services are using files that need to be updated. The Installer will stop and restart the TWC services as part of the upgrade.
   Click OK. The Installer will copy TWC files, install, validate, register components, and restart the TWC services.

Update Files

10. Setup Wizard Completed
    1. The CygNet Thin Web Client Setup Wizard is completed. Click Finish.

    CygNet Thin Web Client Setup Wizard Completed

11. Installation Successfully Completed
    1. The CygNet Thin Web Client Installation is completed. Click Close.

    CygNet Thin Web Client Installer Completed

12. Use Canvas to Republish Applications
    1. Once the CygNet Thin Web Client services are updated, start Canvas and go to the Web Settings in the Backstage view.
    2. Use the Server page to:
       • publish multiple applications together in a single action after a server upgrade. See Multiple applications publishing.
       • republish previously published applications after a server upgrade. See Soft applications publishing.
    3. Access your applications in your favorite web browser.

Update the Collected-Packages.zip File

The Publishing Service requires a Collected-Packages.zip file, containing various software packages, which are used to compile an application during the publishing process. One of the included software packages may vary based on the client’s computer’s configuration. If your server configuration changes, for example, after an upgrade, you may need a different package version to be able to publish applications.

If you see a package error in the Details section on the Publishing status page similar to the following:

Unable to find package Microsoft.NET.ILLink.Tasks with version (>= 8.0.5)

you need to update the Collected-Packages.zip file.

See Updating the Collected-Packages .zip File for information on how to update the Collected-Packages.zip file.

Troubleshooting TWC Upgrade

See information about troubleshooting the TWC installation and upgrade process.