Ensim^® Pro for Windows 4.0.1 Hotfix 6 Release notes

Introduction

These release notes provide information about Ensim Pro for Windows 4.0.1 hotfix 6 resolved issues, prerequisites, and installation instructions.

Topics include:

• Hotfix information 
• Hotfix file information 
• Resolved issues
• Prerequisites 
• Time requirements and customer impact
• Installing the hotfix
• Verifying the hotfix installation
• Removing the hotfix
  

Hotfix information

• Hotfix no: 6
• Hotfix date: August 4, 2005
• Applies to: Ensim Pro for Windows - 4.0.1

Hotfix file information

This hotfix contains the following files:

• cp.dll (MD5 sum: 69eacc0f9e55dc78386173881f188426, Version - 4.0.1.6)
• EnsimBackendLib.dll (MD5 sum: 2c82dd5624e6dfc062fa13952d94339e, Version - 1.0.2054.28458)
• MSDEBackend.dll (MD5 sum: f32a8728a7110175531dbcc168befcd9, Version - 1.0.2054.28386)
• UpdateConfig.exe (MD5 sum: 43c5e1e936837fe79164f81cd88db088)
• W3svcBackend.dll (MD5 sum: 0bdd9217b818ad9ba93a7559288cbc8b, Version - 2.0.2054.28398)
• w3svcCommon.dll (MD5 sum: 5a3a440d653292c2d0c63206a4026381, Version - 2.0.2054.28381)
• WebHosting.dll (MD5 sum: 41274a20a5988d4ccc4408df63bf5fd7, Version - 2.0.2054.28402) 

Resolved issue

This hotfix resolves the following issues. The numbers in parentheses indicate the Ensim problem report (PR) number.

• (49616 - can not provision sites) - If you are having lots of IP based sites, provision of new IP based site takes lot of time or the action times out and it fails to add new site. 

• (49684 - Ensim Pro hostname change) - After changing the Ensim Pro server host name using the network configuration utility, if you try to convert existing name based site to IP based site or if you try to add/remove service components to any existing site it gives error.

• (50302 - Sites not getting deleted on EPW 4.0.1 after applying hotfix. MSDE timeout) - If you have lots of sites, then while deleting site, MSDE destroy fails with error "Error: MSDE destroy failed: Timeout expired.". This is because default time out period for executing a particular query is 30 seconds. As the number of sites increase, MSDE destroy queries take more than 30 seconds to finish and shows time out error.

• (50243 - Site creation fails) - If you have created a site template, then changed the FQDN of the server and run networkconfiguration utility, add site operation through CLI using this template fails.

Prerequisites

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

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

Time requirements and customer impact

        It takes less than half an hour 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. Disable the EnsimProvisioningEngine services by logging in to server as domain administrator and performing the following steps:
   1. Click Start > Programs > Administrative Tools > then click Component Services.
   2. In the left navigation bar, expand Console Root > Component Services > Computers > My Computer > COM+ Applications 
   3. Right-click EnsimProvisioningEngine, then select Shut down
3. Disable Internet Information Server by logging in the server as domain administrator and performing the following steps:
   1. Click Start > Programs > Administrative Tools, then click Internet Services Manager.
   2. In the Internet Information Services window, click the name of the server.
   3. Right-click Default Web Site, then click Stop

The pre-installation procedure is complete.

    Installation instructions

1. Login to the server as administrator.
2. Unzip the hotfix zip file to a temporary directory.
3. Change to the directory <install_dir>\pe\ProvEngine 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\ProvEngine directory.
4. Back up EnsimBackendLib.dll file to a location other than the existing directory say C:\beforehotfix6\EnsimBackendLib.dll.
5. Copy the new EnsimBackendLib.dll from the temporary directory to the current directory.
6. Back up w3svcCommon.dll file to a location other than the existing directory say C:\beforehotfix6\w3svcCommon.dll.
7. Copy the new w3svcCommon.dll from the temporary directory to the current directory.
8. Change to the directory <install_dir>\cp\admin\siteadmin\serviceComponents\filemanager\FMWeb\bin. Copy the new EnsimBackendLib.dll from the temporary directory to the current directory.
9. Change to the directory <install_dir>\cp\admin\bin. Copy the new EnsimBackendLib.dll from the temporary directory to the current directory.
10. Change to the directory <install_dir>\cp\admin\bin\serviceComponents\w3svc. Copy the new w3svcCommon.dll from the temporary directory to the current directory.
11. Back up W3svcBackend.dll file to a location other than the existing directory say C:\beforehotfix6\W3svcBackend.dll.
12. Copy the new W3svcBackend.dll from the temporary directory to the current directory.
13. Change to the directory <install_dir>\cp\admin\bin. Back up cp.dll file to a location other than the existing directory say C:\beforehotfix6\cp.dll
14. Copy the new cp.dll from the temporary directory to the current directory.
15. Change to the directory <install_dir>\cp\admin\bin\services\WebHosting. Back up WebHosting.dll file to a location other than the existing directory say C:\beforehotfix6\WebHosting.dll
16. Copy the new WebHosting.dll from the temporary directory to the current directory.
17. Change to the directory <install_dir>\cp\admin\bin\serviceComponents\msde. Back up MSDEBackend.dll file to a location other than the existing directory say C:\beforehotfix6\MSDEBackend.dll
18. Copy the new MSDEBackend.dll from the temporary directory to the current directory.
19. Run UpdateConfig.exe provided with this hotfix
20. If you are facing issue mentioned in PR 50302, then you will need to do the following. 
    1. Open the registry editor. 
    2. In the editor window expand HKEY_LOCAL_MACHINE > SOFTWARE > Ensim > WEBppliance 
    3. Right click WEBppliance, point to new and click string value.
    4. Rename the string value to CommandTimeOut
    5. Double click CommandTimeOut, specify the timeout period in seconds in the value data textbox and click ok. 
       Note: Default timeout is 30 seconds. Time out period should be more than 30 seconds. Set this value such that MSDE destroy doesn't timeout.

    Post-installation instructions

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

1. Enable Internet Information Server by performing the following steps on the server:
   1. Log in to the server as domain administrator.
   2. Click Start > Programs > Administrative Tools, then click Internet Services Manager.
   3. In the Internet Information Services window, click the name of the CP server. 
   4. Right-click Default Web Site, then click Start.

The hotfix installation is complete.

Verifying the hotfix installation 

    Before applying the hotfix

1. If you have 100+ IP based sites, then provisioning will take time or the operation will timeout. If operation times out, then this results in a rollback of the site creation.
2. If you have name based site, then run networkconfiguration utility and then try to convert same name site to IP based. Operation completes without error but site is not completely converted.
3. If you have lots of sites with MSDE service, then while deleting site, MSDE destroy fails with error "Error: MSDE destroy failed: Timeout expired."
4. If you have created a site template, then changed the FQDN of the server and run networkconfiguration utility, add site operation through CLI using this template fails.

    After applying the hotfix

1. All the issues mentioned above will be resolved

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 EnsimProvision Engine COM+ component. Open Start > Program > Administrative Tools > Component Services
   Navigate to : Computers > My Computer > COM+ Application > EnsimProvision Engine. Right Click > Shut Down
4. Restore the EnsimBackendLib.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. For example, if Ensim Pro is installed in C:\Program Files\Ensim\WEBppliance, then switch to C:\Program Files\Ensim\WEBppliance\pe\ProvEngine directory.
5. Restore the w3svcCommon.dll file from the backup location to the directory <install_dir>\pe\ProvEngine
6. Restore the EnsimBackendLib.dll file from the backup location to the directory <install_dir>\cp\admin\siteadmin\serviceComponents\filemanager\FMWeb\bin. 
7. Restore the EnsimBackendLib.dll and cp.dll files from the backup location to the directory <install_dir>\cp\admin\bin.
8. Restore the w3svcCommon.dll file from the backup location to the directory <install_dir>\cp\admin\bin\serviceComponents\w3svc.
9. Restore the W3svcBackend.dll file from the backup location to the directory <install_dir>\cp\admin\bin\serviceComponents\w3svc.
10. Restore the WebHosting.dll file from the backup location to the directory <install_dir>\cp\admin\bin\services\WebHosting.
11. Restore the MSDEBackend.dll file from the backup location to the directory <install_dir>\cp\admin\bin\serviceComponents\msde.
12. Open a command window and run the command iisreset /start.

The hotfix rollback is complete.