Article ID: 2777, created on Oct 29, 2007, last review on Apr 28, 2014

  • Applies to:
  • Pro Control Panel Windows

AdditionalInformation

View Knowledge
Knowledge ID 2130
Product : EnsimPro for Windows 2003
Version : 4.0.1
Topic : Hotfix

Title
Hotfix 10 : Need integration hooks

Summary
New Feature : Addresses the issue "Need integration hooks"

Prevention


Details

Ensim® Pro for Windows 4.0.1 Hotfix 10 Release notes

Hotfix information

  • Product:Ensim Pro for Windows - 4.0.1
  • Hotfix no: 10
  • Hotfix date:October 11, 2005

Download:  http://download.swsoft.com/ensim/download/pro/windows/4.0.1/hotfix/hotfix10/
md5sum : 7a741adccbf21e8f14a9bfefae8df475

New feature added in this hotfix

This section describes the new features added by this hotfix.

  • 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 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 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.

Enabling and disabling new feature

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.

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 > 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.

 


Attachments


Related Knowledge

Related Links
 
Last ModifiedUsageSatisfiedLast Used
10/11/2005 3:31:19 AM41 10/11/2007 5:13:03 AM

8e19bcddff0cc55cafe80c841132ca59 3ccb419cf98083f3bb45808fba8dbc7c 6311ae17c1ee52b36e68aaf4ad066387

Email subscription for changes to this article
Save as PDF