This article contains the following sections:

• Upgrading the Vidyo Server
• Upgrading the WDE Vidyo Plugin
• Configuring and Upgrading the Adapter

 

Upgrading the Vidyo Server

 

Upgrading to Version 18.4.0.1

1. Follow the steps in the "Upgrading the Vidyo Server Binary and Configuration" section of this article.
   
   
2. Verify the Vidyo Server version as described in the "Verifying the Vidyo Server Version" section of this article.
   
   

Upgrading to Version 18.3.0.2

Application Template and Object (Optional)

1. Import the new Vidyo Server application template 18.3.0.2 VidyoServer_183.apd.
   
   
2. Create a new application object from template 18.3.0.2 (e.g. vidyo-server-183).
   
   
3. Migrate all mandatory options from the old Vidyo Server application object.
   
   

 

Application Binaries and Startup Command

1. Stop the Vidyo Server.
   
   
2. Back up the old Vidyo Server files (from C:\GCTI\vidyo\vidyoserver or /opt/gcti/vidyo/vidyoserver).
   
   
3. Extract the new files into the Vidyo Server directory.
   
   
4. Install Windows service using Service Commander.
   
   
5. Set the service configuration file VidyoServerService.exe.config.
   
   
6. Set the Genesys application object start_stop commands accordingly to the new service name. 
   
   
7. Start the Vidyo Server.

Check whether the log file was created after startup and then verify if the new version of Vidyo Server is in the log file.
 

 

Verifying the Vidyo Server Version

Upon starting the Vidyo Server, the log file indicates the current executing version as:

Application Name : vidyo-server-xxx
Version : 18.4.0.1xx

 

Upgrading the WDE Vidyo Plugin

Before upgrading new files, locate and backup old WDE installation files.

Upgrading to Version 18.4.0.1

1. Upload the latest template and metadata as described in the "Importing the WDE Template and Metadata" section later in this article.
   
   
2. Backup and replace the Workspace Desktop Vidyo Adapter files in the installation or Click Once directory.
   
   
3. Verify the version of the WDE plugin as described in the "Verifying the Version" section later in this article.
    

Upgrading to Version 18.3.0.2

1. Upload the latest template and metadata as described in the "Importing the WDE Template and Metadata" section later in this article.
   
   
2. The new role Vidyo Can Transfer will be in the Genesys configuration.
   
   
   
   
3. Backup and replace the Workspace Desktop Vidyo Adapter files in the installation or Click Once directory.
   
   

 Upgrading to Version 18.2.0.2

1. Upload the latest template and metadata as described in the "Importing the WDE Template and Metadata" later in this article.
   
   
2. The new roles Can Use Self_preview and Can Set Devices will be in the Genesys configuration.
   
   
3. Back up and replace the Workspace Desktop Vidyo Adapter files in the installation or Click Once directory.
   
   

Upgrading to Version 18.1.0.5

1. Upload the latest template and metadata as described in the "Importing the WDE Template and Metadata" later in this article.
   
   
2. The Can Use Vidyo and Can Use Snapshot role under Vidyo tasks section will appear in Agent Roles.
   
   
   
   
3. Newly imported application templates do contain custom settings pre-filled in the interaction-workspace section.
   
   

ClickOnce:

For ClickOnce installations, replace all of the Workspace files and repeat the steps to deploy a new package as noted in the Deploying VidyoEngage for Genesys article.

Local:

For local installations, replace the files in the Workspace execution directory. 

 

Upgrading to Version 17.2.2.0

For ClickOnce installations, replace all of the Workspace files and repeat the steps to deploy a new package as noted in the Deploying VidyoEngage for Genesys article.

For local installations, replace the files in the Workspace execution directory. See the Caution below:

 

Upgrading to Version 17.2.1.0

For ClickOnce installations, replace all of the Workspace files and repeat the steps to deploy a new package as noted in the Deploying VidyoEngage for Genesys article.

For local installations, replace the files in the Workspace execution directory.
 

Upgrading to Version 1.1.2.0+

With VidyoEngage for Genesys version 1.1.2.0+, include all of the Workspace files.

For ClickOnce installations, replace all of the Workspace files and repeat the steps to deploy a new package as noted in the Deploying VidyoEngage for Genesys article.

For local installations, replace the files in the Workspace execution directory.
  

Upgrading to Version 1.0.1.0

With the release of VidyoEngage for Genesys version 1.0.1.0, only the Custom DLL has changed.

For ClickOnce installations, replace the Genesyslab.Desktop.Modules.CustomVidyo.dll file and repeat the steps to deploy a new package as noted in the Deploying VidyoEngage for Genesys article.

For local installations, replace the files in the Workspace execution directory. (See caution for WDE release version check).
 

Upgrading to Version 1.1.0.0

With the release of VidyoEngage for Genesys version 1.1.0.0, the Custom DLL and config file have changed. 

For ClickOnce installations, replace the following files and repeat the steps to deploy a new package as noted in the Deploying VidyoEngage for Genesys article:

• Desktop.Modules.CustomVidyo.dll
• exe.config 

For local installations, replace the following files in the Workspace execution directory:

• Desktop.Modules.CustomVidyo.dll
• exe.config
  
  

Verifying the Version

Upon successful agent login to Workspace, execution of the plugin’s custom module can be verified in the Workspace log file by checking for a trace similar to the following: 

INFO  omVidyo.CustomModule - Workspace version=8.5.xxx.xx, CustomVidyo version=18.4.0.1, Build Date=10/xx/2018

 

Configuring and Upgrading the Adapter

 

Importing the WDE Template and Metadata

1. Locate WorkspacePlug-in_Templates_18.x.x.x_xxxxxx.zip and unzip the templates.
   
   
2. Open the Genesys Administrator and upload the new WDE application templates in Environment -> Application Templates (Tasks: Upload Template):
   • Workspace_Desktop_Edition_SEP85_851_Vidyo1XX.apd
   • Workspace_Desktop_Edition_SEP802_851_Vidyo1XX.apd
   • Workspace_Desktop_Edition_851_Vidyo1XX.apd
   
   
   
   
3. Open the newly uploaded Templates Import application metadata XML files into templates (Import Metadata).
   • Workspace_Desktop_Edition_SEP85_851_Vidyo1XX.xml
   • Workspace_Desktop_Edition_851_Vidyo1XX.xml
   • Workspace_Desktop_Edition_SEP802_851_Vidyo1XX.xml
   
   
   
   

Upgrading the Vidyo Server Binary and Configuration

Application Template and Object (Optional) 

1. Import the new Vidyo Server application template 1x.x.x VidyoServer_1xx.apd.
   
   
2. Check the new options introduced. If there are any, copy them to the existing Vidyo Server object.
   
   
3. Follow the instructions in the Deploying VidyoEngage for Genesys article and Release Notes to set the newly created options correctly.
   
   

 

Application Binaries and Startup Command 

1. Stop the Vidyo Server.
   
   
2. Backup the old Vidyo Server files (from C:\GCTI\vidyo\vidyoserver or /opt/gcti/vidyo/vidyoserver).
   
   
3. Extract the new files into the Vidyo Server directory.
   
   
4. Migrate the old options from VidyoServerService.exe.config.
   This is relevant for Windows only.
   
   
5. Migrate the old options from config-server-user.properties.
   
   
6. Set the startup.bat or startup.sh script and shutdown.bat or shutdown.sh script accordingly to the installation folder and required Java options.
   
   
7. Set the Genesys application object of the Vidyo Server “Server Info” accordingly to the new startup commands.
   
   
8. Set the Genesys application object of the Vidyo Server “Annex” start_stop commands accordingly to the updated setting, if required.
   
   
9. Start the Vidyo Server.
   
   
10. Check if the Vidyo Server is correctly monitored by the Genesys Administrator (i.e., the expected status should be Running).