Ensim^® Pro for Windows 10.0.0 Hotfix 5 Release notes

Hotfix information

• Service:Ensim Pro for Windows - 10.0.0
• Hotfix no:5
• Hotfix date:09-August-2006

Download: ftp://ftp.ensim.com/download/pro/windows/10.0.0/hotfix/5/EPW-10.0.0-Hotfix-5.zip
md5sum : 388a2fc23f6eecfeb91c7d9650210444

Resolved Issues

This hotfix resolves the following issue:

• Selecting mail encoding other than "Unicode(UTF-8)" like JIS code (ISO-2022-JP) on control panel.

       Normal: Control Panel does not provide facility to select desired mail encoding.

      Resolution: Control Panel provides facility to select desired mail encoding at ISP level.

Prerequisites

Before installing this hotfix, ensure that your Ensim Pro 10.0.0 for Windows system has the following:

• Ensim Pro for Windows 10.0.0 - hotfix 1, 2, 3, 4

Time requirements and customer impact

It takes a few minutes to apply the hotfix. During this time, new customers cannot be provisioned, and Ensim Pro control panel is unavailable. 

Installing the hotfix

This section explains how to install the hotfix.

Pre-installation instructions

Before installing the hotfix, you need to disable server applications. This section describes the pre-installation instructions.

1. Ensure that you have installed all hotfixes mentioned in the prerequisites section unless they are marked as optional.
2. Open a command window and run the command iisreset /stop.
3. Disable the EnsimProvisionEngine service by logging in to server as server administrator and performing the following steps:
       a. Click Start > Programs > Administrative Tools, then click Component Services.
       b. In the left navigation bar, expand Console Root > Component Services > Computers > My Computer >
            COM+ Applications.
       c. Right-click EnsimProvisionEngine, then select Shut down.

The pre-installation procedure is complete.

Installation instructions

After performing the steps in the pre-installation section, complete the following steps to install the hotfix.

1. Unzip the hotfix zip file to a temporary directory.
2. Change to the directory <install_dir>\pe\install where <install_dir> refers to the path where Ensim Pro is installed. For example, if Ensim Pro is installed in C:\Program Files\Ensim\WEBppliance, then go to C:\Program Files\Ensim\WEBppliance\pe\install directory.
3. Back up the existing EnsimLib.dll file to a location other than the existing directory.
   Important: Do not rename the file and keep it in the current directory.
4. Copy the new EnsimLib.dll from the temporary directory to the current directory.
5. Open a new command window.
6. Change to the directory <windows>\assembly\GAC\EnsimLib\2.1.0.0__a0478cffa08d992f where <windows> refers to the path where windows is installed. For example, if windows is installed on c:, then switch to c:\windows\assembly\GAC\EnsimLib\2.1.0.0__a0478cffa08d992f directory.
7. Delete EnsimLib.dll file present at that location
8. Close the command window before starting the next step.
9. Click Start > Settings > Control Panel > Administrative Tools > Microsoft .NET Framework 1.1 Configuration > Assembly Cache, then click the Add an Assembly to the Assembly Cache link.
10. Navigate to temporary directory, select EnsimLib.dll in the dialog box, then click Open.
11. Close the Microsoft .NET Framework 1.1 Configuration window
12. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed.
13. Back up the existing EnsimInterfaces.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
14. Copy the new EnsimInterfaces.dll from the temporary directory to the current directory.
15. Change to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed. 
16. Copy the new EnsimInterfaces.dll from the temporary directory to the current directory.
17. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
18. Copy the new EnsimInterfaces.dll from the temporary directory to the current directory.
19. Change to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed. 
20. Back up the existing Ensim.ProvEngine.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
21. Copy the new Ensim.ProvEngine.dll from the temporary directory to the current directory.
22. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
23. Back up the existing cp.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
24. Copy the new cp.dll from the temporary directory to the current directory.
25. Change to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed. 
26. Back up the existing EnsimLicensing.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
27. Copy the new EnsimLicensing.dll from the temporary directory to the current directory.
28. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
29. Copy the new EnsimLicensing.dll from the temporary directory to the current directory.
30. Change to the directory <install_dir>\cp\admin\bin\services\WebHosting where <install_dir> refers to the path where Ensim Pro is installed. 
31. Back up the existing WebHosting.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
32. Copy the new WebHosting.dll from the temporary directory to the current directory.
33. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
34. Back up the existing Ensim.PEConnection.WWP.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
35. Copy the new Ensim.PEConnection.WWP.dll from the temporary directory to the current directory.
36. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
37. Back up the existing wwpcli.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
38. Copy the new wwpcli.dll from the temporary directory to the current directory.
39. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
40. Copy SetConfig.exe from the temporary directory to the current directory.
41. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
42. Copy SetConfig.exe.config from the temporary directory to the current directory.

Post-installation instructions

After installing the hotfix as described in the preceding section, perform the following step to complete the hotfix installation.  

1. Open a command window and run the command iisreset /start.

The hotfix installation is complete.

CLI usage

The hotfix provides a new CLI, "SetConfig.exe", to set encoding type for sending emails. This CLI can be invoked using ISP credentials only.

Syntax:

SetConfig.exe -t setconfig -f <location_of_XML_file> -u <ISP_username> -p <ISP_password>

Or

SetConfig.exe -t setconfig -s <XML_data_as_a_string> -u <ISP_username> -p <ISP_password>

XML File/XML Data as String format:

<?xml version="1.0" encoding="utf-8" ?>

<Config>

<property name="EncodingType">utf-8</property>

</Config>

Removing the hotfix

You can remove (or roll back) the installed hotfix by restoring the backed up DLL files    

To roll back the hotfix installation:

1. Login to the server as administrator.
2. Open a command window and run the command iisreset /stop.
3. Stop the EnsimProvisionEngine COM+ component:
       a. Click Start > Programs > Administrative Tools, then click Component Services.
       b. In the left navigation bar, expand Console Root > Component Services > Computers > My Computer >
            COM+ Applications.
       c. Right-click EnsimProvisionEngine, then select Shut down.
4. Restore the EnsimLib.dll file from the backup location to the directory <install_dir>\pe\install where <install_dir> refers to the path where Ensim Pro is installed. For example, if Ensim Pro is installed in C:\Program Files\Ensim\WEBppliance, then switch to C:\Program Files\Ensim\WEBppliance\pe\install directory.
5. Open a new command window.
6. Change to the directory <windows>\assembly\GAC\EnsimLib\2.1.0.0__a0478cffa08d992f
7. Delete EnsimLib.dll file present at that location
8. Close the command window opened in step 6 before starting the next step.
9. Click Start > Settings > Control Panel > Administrative Tools > Microsoft .NET Framework 1.1 Configuration > Assembly Cache, then click the Add an Assembly to the Assembly Cache link 
10. Navigate to backup location, select EnsimLib.dll in the dialog box, then click Open.
11. Close the Microsoft .NET Framework 1.1 Configuration window.
12. Open a command window and run the command iisreset /start.
13. Restore the EnsimInterfaces.dll file from the backup location to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed.
14. Restore the EnsimInterfaces.dll file from the backup location to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed.
15. Restore the EnsimInterfaces.dll file from the backup location to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed.
16. Restore the Ensim.ProvEngine.dll file from the backup location to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed.
17. Restore the cp.dll file from the backup location to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed.
18. Restore the EnsimLicensing.dll file from the backup location to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed.
19. Restore the EnsimLicensing.dll file from the backup location to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed.
20. Restore the WebHosting.dll file from the backup location to the directory <install_dir>\cp\admin\bin\services\WebHosting where <install_dir> refers to the path where Ensim Pro is installed.
21. Restore the Ensim.PEConnection.WWP.dll file from the backup location to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed.
22. Restore the wwpcli.dll file from the backup location to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed.
23. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
24. Remove  SetConfig.exe and SetConfig.exe.config from the current directory.

The hotfix rollback is complete.