Ensim^® Pro for Windows 4.0.1 Hotfix 10 Release notes

Introduction

These release notes provide information about Ensim Pro for Windows 4.0.1 hotfix 10 new feature added, prerequisites, and installation instructions.

Topics include:

• Hotfix information 
• Hotfix file information 
• New feature added in this hotfix
• Prerequisites 
• Time requirements and customer impact
• Installing the hotfix
• Enabling and disabling new feature
• Removing the hotfix
  

Hotfix information

• Hotfix no: 10
• Hotfix date: October 5, 2005
• Applies to: Ensim Pro for Windows - 4.0.1

Hotfix file information

This hotfix contains the following files:

• EnsimLib.dll (MD5 sum: 402a4a6eb29cc73c9e3532dd1ab79b6b, Version - 2.1.0.0)
• Ensim.ProvEngine.dll (MD5 sum: f3e07a31d7e53f8b1acd84f466fd8881, Version - 2.1.0.0)

New feature added in this hotfix

This section describes the new features added by this hotfix.

• (51468 - Need integration hooks) - After add/delete sites and edit services operation, VBScript custom script will be called if the script is present at a specific location and with specified file name

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, 6, 7, 8, 9

Time requirements and customer impact

It takes less than 10 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 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

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 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.
4. Copy the new Ensim.ProvEngine.dll from the temporary directory to the current directory.
5. Change to the directory <install_dir>\pe\install
6. 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.
7. Copy the new EnsimLib.dll from the temporary directory to the current directory.
8. Open a new command window.
9. 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.
10. Delete EnsimLib.dll file present at that location
11. Close the command window before starting the next step
12. 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.
13. Navigate to temporary directory, select EnsimLib.dll in the dialog box, then click Open.
14. Close the Microsoft .NET Framework 1.1 Configuration window

    Post-installation instructions

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

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

The hotfix installation is complete.

    This section describes the procedures for enabling or disabling new features

        How to use this:

1. While adding a site, once all the actions have been completed (including sending email), we will call <install dir>\customscripts\customaddsite.vbs script with three parameters (<sitedomainname>, <siteadminname>, <siteadminpassword>), where <install_dir> refers to the path where Ensim Pro is installed and <sitedomainname> refers to name of the site, <siteadminname> refers to site administrator's name and <siteadminpassword> refers to site administrator's password.
2. While deleting a site, once all the actions have been completed (including sending email), we will call <install dir>\customscripts\customdeletesite.vbs script with three parameters (<sitedomainname>, <siteadminname>, <siteadminpassword>)
3. While editing services of a site, once all the actions have been completed, we will call <install dir>\customscripts\customeditsite.vbs script with three parameters (<sitedomainname>, <siteadminname>, <siteadminpassword>)

Note:

1. The script will be executed if all the operation in the specific action have been successful.
2. The return code of the script will not have any bearing on the action i.e. even if the script fails, it will not result in failure of the action.
3. The action (add/edit/delete site) will complete immediately and will not wait for the script to complete.
4. The script will be executed in System context. Any message box will not be seen on desktop and will hang the system if they are awaiting user clicks.
5. Location of all scripts will be under: <install_ dir>\customscripts
6. The script will be executed only if it is present at the location mentioned above and with specified name.
7. cscript.exe is in the path.
   

    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 > EnsimProvision Engine. Right Click > Shut Down
4. 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. 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 EnsimLib.dll file from the backup location to the directory <install_dir>\pe\install
6. Open a new command window.
7. Change to the directory <windows>\assembly\GAC\EnsimLib\2.1.0.0__a0478cffa08d992f
8. Delete EnsimLib.dll file present at that location
9. Close the command window opened in step 6 before starting the next step
10. 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 
11. Navigate to backup location, select EnsimLib.dll in the dialog box, then click Open.
12. Close the Microsoft .NET Framework 1.1 Configuration window.
13. Open a command window and run the command iisreset /start.

The hotfix rollback is complete.