How to install a software patch in NuGenesis LMS for defect CRI-2011 ("Illegal characters in path") - WKB118661

OBJECTIVE or GOAL

Install a software patch for defect CRI-2011, known as the "Illegal characters in path" issue. This issue prevents users from opening some documents in NuGenesis LMS. The software patch allows users to open these documents in LMS.

ENVIRONMENT

• NuGenesis LMS 9.0, 9.0.1, and 9.0.2

PROCEDURE

1. Download the appropriate patch version from Waters. The 9.0.2 patch applies to NuGenesis LMS 9.0.2. The 9.0.1 patch applies to LMS 9.0 and 9.0.1.
2. Copy the patched version of ZipLibrary.dll to all machines with the NuGenesis LMS client.
3. Stop the LMS client software if it is running. If it is a Citrix machine, ensure that all users are logged out of Citrix before proceeding and that there are no eln.exe processes running.
4. Browse to the NuGenesis LMS client installation folder.
   • Example: Drive:\Program Files (x86)\Waters\NuGenesis LMS
5. Rename Drive:\Program Files (x86)\Waters\NuGenesis LMS\ZipLibrary.dll to ZipLibrary.dll.901 or ZipLibrary.dll.902, as appropriate.
6. Copy the patched version of ZipLibrary.dll into the client installation folder.
7. Start a PowerShell console session with Administrator rights.
8. Enter the following commands in PowerShell to register the patched version of ZipLibrary.dll in the GAC:
   • [System.Reflection.Assembly]::Load("System.EnterpriseServices, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
   • $publish = New-Object System.EnterpriseServices.Internal.Publish
   • $publish.GacInstall("Drive:\Program Files (x86)\Waters\NuGenesis LMS\ZipLibrary.dll")
9. Start the NuGenesis LMS client and open one of the affected documents. The document should now open in LMS.

ADDITIONAL INFORMATION