Ensim® Pro for Windows 4.0.0 Hotfix 9 Release notes

Introduction

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

Topics include:

Hotfix information

Hotfix file information

This hotfix contains the following files:

Resolved issues

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

Prerequisites

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

·         Ensim Pro for Windows 4.0.0 - hotfix 1, 2, 3, 4, 5, 6, 7, 8

Time requirements and customer impact

It takes less than 15 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. Disable the EnsimProvisionEngine services 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
  3. Disable Internet Information Server by logging in the server as server administrator and performing the following steps:
        a. Click Start > Programs > Administrative Tools, then click Internet Services Manager.

        b.
    In the Internet Information Services window, click the name of the server.
        c.
    Right-click Default Web Site, then click Stop 

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\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.
  3. Back up the existing EnsimBackendLib.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 EnsimBackendLib.dll from the temporary directory to the current directory.
  5. 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.
  6. Change to the directory <install_dir>\cp\admin\bin. Copy the new EnsimBackendLib.dll from the temporary directory to the current directory.
  7. Change to the directory <install_dir>\cp\admin\bin\services\WebHosting.
  8. 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.
  9. Copy the new WebHosting.dll from the temporary directory to the current directory.
  10. Change to the directory <install_dir>\cp\admin\bin\serviceComponents\msde.
  11. Back up the existing MSDEBackend.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
  12. Copy the new MSDEBackend.dll from the temporary directory to the current directory.
  13. If you are facing issue mentioned in PR 50302, then you will need to do the following.
        a. Open the registry editor. 
        b. In the editor window expand HKEY_LOCAL_MACHINE > SOFTWARE > Ensim > WEBppliance 
        c. Right click WEBppliance, point to new and click string value. 
        d. Rename the string value to CommandTimeOut 
        e. Double click CommandTimeOut, specify the timeout period in seconds in the value data textbox and click ok. 
            Note: Default timeout is 30 seconds. Timeout 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:

a.      Log in to the server as server administrator.

b.      Click Start > Programs > Administrative Tools, then click Internet Services Manager.

c.      In the Internet Information Services window, click the name of the server. 

d.      Right-click Default Web Site, then click Start.

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. Open Start > Program > Administrative Tools > Component Services
    Navigate to : Computers > My Computer > COM+ Application > EnsimProvisionEngine. 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 EnsimBackendLib.dll file from the backup location to the directory <install_dir>\cp\admin\siteadmin\serviceComponents\filemanager\FMWeb\bin.
  6. Restore the EnsimBackendLib.dll from the backup location to the directory <install_dir>\cp\admin\bin.
  7. Restore the WebHosting.dll file from the backup location to the directory <install_dir>\cp\admin\bin\services\WebHosting.
  8. Restore the MSDEBackend.dll file from the backup location to the directory <install_dir>\cp\admin\bin\serviceComponents\msde.
  9. Open a command window and run the command iisreset /start.

The hotfix rollback is complete.


Ensim Corporation
1366 Borregas Avenue
Sunnyvale, California 94089
http://dog.ensim.com/processes/Templates/www.ensim.com