Ensim^® Pro for Windows 10.2.0 Hotfix 6 Release notes

Introduction

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

Topics include:

• Hotfix information 
• Hotfix file information
• Resolved Issues
• Know Issue and Workaround
• Prerequisites 
• Time requirements and customer impact
• Installing the hotfix
• Removing the hotfix
  

Hotfix information

• Hotfix no: 6
• Hotfix date:  May 22, 2007
• Applies to: Ensim Pro for Windows - 10.2.0

Hotfix file information

This hotfix contains the following files:

• cp.dll (MD5 sum:3401967a86c6198dc91ab3ada414e5b6, Version -2.1.0.0 )
• Ensim.Client.dll (MD5 sum:7eef566eccb85e0a70d1f493bee7f531, Version -1.0.2698.35435 )
• wwpcli.dll (MD5 sum:674763f86956e5109342d4b1b6abd74d, Version - 1.0.2698.35442)
• Ensim.ProvEngine.dll (MD5 sum:d2c41991445457d5bc28f1bdfaee344e, Version - 2.1.0.0)
• ResourceManager.dll (MD5 sum:35438b29b3602da7586c3a517d012779, Version -1.0.0.0 )
• WebHostingFrontend.dlll (MD5 sum:b72a10af72a3bbea50e8f8251b14d33d, Version -2.0.2698.35453 )
• W3svcFrontend.dll (MD5 sum:c1e74e412faefe89874e8dba2d6591a6, Version - 2.0.2698.35452 )
• MSSQLBackend.dll (MD5 sum:a0333283f3ad60899166b8e1566dd37a, Version - 1.0.2698.35450 )

Resolved Issues

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

• Quota Thresholds(1085410)
• CLI requirement for increasing/decreasing values(1085409)
• Deleting MSSQL database through cli doesn't remove it from the database list in GUI(1085914)
• Configuration Error when changing iis log type.(59441)

Know Issue and Workaround

• Issue
  Inability of decreasing "Disk Space" quota value from unlimited to specific value if "Total Database size of Microsoft SQL Server 2005 Databases" quota is other than unlimited or zero
  
• Workaround
  Set both the quota's i.e. "Disk Space" and  "Total Database size of Microsoft SQL Server 2005 Databases" to Unlimited and then set the "Disk Space" quota to desired value and "Total Database size of Microsoft SQL Server 2005 Databases" to original value. 

Prerequisites

Time requirements and customer impact

It takes 15 to 20 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>\cli where <install_dir> refers to the path where Ensim Pro is installed.
3. Back up the existing wwpcli.dll and Ensim.Client.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 wwpcli.dll and Ensim.Client.dll from the temporary directory to the current directory.
5. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed.
6. Back up Existing cp.dll and ResourceManager.dll file to a location other than the existing directory
7. Copy the new cp.dll, ResourceManager.dll   and Ensim.Client.dll from the temporary directory to the current directory.
8. Change to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed. 
9. 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.
10. Copy the new Ensim.ProvEngine.dll and ResourceManager.dll from the temporary directory to the current directory.    
11. Change to the directory <install_dir>\cp\admin\bin\services\WebHosting where <install_dir> refers to the path where Ensim Pro is installed.
12. Back up the existing WebHostingFrontend.dll file to a location other than the existing directory.
13. Copy the new WebHostingFrontend.dll from the temporary directory to the current directory.
14. Change to the directory <install_dir>\cp\admin\bin\serviceComponents\w3svc where <install_dir> refers to the path where Ensim Pro is installed.
15. Back up the existing W3svcFrontend.dll file to a location other than the existing directory.
16. Copy the new W3svcFrontend.dll from the temporary directory to the current directory.
17. Change to the directory <install_dir>\cp\admin\bin\serviceComponents\mssql where <install_dir> refers to the path where Ensim Pro is installed.
18. Back up the existing MSSQLBackend.dll file to a location other than the existing directory.
19. Copy the new MSSQLBackend.dll 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 functionality using, "setconfig", to set quota usage threshold and the existing CLI "UpdateObj.exe" for reseller, is modified to update reseller quotas.

Set quota usage threshold command

Syntax:

• When the arguments are passed in the form of an XML file

        setconfig.exe -t setconfig –f <location of xml file> -u <parent_username> -p <parent _password>

• When the arguments are passed in the form of a string containing XML data

        setconfig.exe -t setconfig –s <XML_data_as_a_string> -u <parent_username> -p <parent_password>

Arguments

The parameters to be passed in the XML file for setting quota usage threshold are given below

<?xml version="1.0" encoding="utf-8" ?>
<config> 
<property name="QuotaUsageThreshold">85</property> <!-- The percent Quota usage value to be set-->
</config>

Updating the information of a reseller

Syntax:

• When the arguments are passed in the form of an XML file:

        UpdateObj.exe -t reseller -f <location_of_XML_file> -u <parent_username> -p <parent_password>

• When the arguments are passed in the form of a string containing XML data:

        UpdateObj.exe -t reseller -s <XML_data_as_a_string> -u <parent_username> -p <parent_password>

Arguments:

The parameters to be passed in the XML file for updating the information of a reseller are given below

<?xml version="1.0" encoding="utf-8" ?> 
<reseller> 
<generalinfo> 
<property name="DisplayName">My Reseller</property> 
<property name="ContactName">Reseller</property> 
<property name="ShortName">MyReseller.com</property> 
<property name="ContactPhone">12345678</property> 
<property name="ContactEmail">abc@example.com</property> 
</generalinfo> 
<admin> 
<property name="DisplayName">Administrator</property> 
<property name="UserName">admin@MyReseller.com</property> 
<property name="Password">password123</property> 
<property name="Email">xyz@example.org</property> 
</admin> 
<service add="2">  

  <!-- For setting quota: Set add flag to "2", If you want to set the value of a quota as unlimited then the value of that quota should be set to "-1". If you want to remove quota then the value of that quota should be set to "0". If value is specified other than "-1" and "0", quota is set to the value specified -->

<!-- For increasing quota: Set add flag to "1", If you want to set the value of a quota as unlimited then the value of that quota should be set to "-1". If value is specified other than "-1", quota is increased by the value specified -->  

<!-- For decreasing quota: Set add flag to "0", If you want to remove quota then the value of that quota should be set to "-1".If value is specified other than "-1", quota is decreased by the value specified -->

<property quota="Disk Space">-1</property> 
<property quota="Number of Installations of mysql">-1</property> 
<property quota="Number of Installations of w3svc">-1</property> 
<property quota="Number of Installations of webalizer">-1</property> 
<property quota="Bandwidth">-1</property> 
<property quota="Number of Installations of Power Tools">-1</property> 
<property quota="Number of Installations of frontpage">-1</property> 
<property quota="# of Access DSNs">50</property> 
<property quota="Number of Installations of msftpsvc">-1</property> 
<property quota="Number of Installations of php">100</property> 
<property quota="# of SubDomains">100</property> 
<property quota="# of DNS Zones">50</property> 
<property quota="Number of Installations of perl">1</property> 
<property quota="# of SQL DSNs">0</property> 
<property quota="Number of Users">-1</property> 
<property quota="Number of Installations of odbc">0</property> 
<property quota="Number of Installations of Coldfusion">0</property> 
<property quota="Number of Installations of filemanager">0</property> 
<property quota="Instances of DNS">50</property>
<property quota="Total Database size of Microsoft SQL Server 2005 Databases">-1</property> 
<property quota="# of Microsoft SQL Server 2005 Databases">100</property> 
<property quota="Number of Installations of Microsoft SQL Server 2005">50</property>

</service> 
</reseller> 

    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 cp.dll , Ensim.Client.dll and ResourceManager.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.
5. Restore the Ensim.Client.dll and 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. 
6. Restore the Ensim.ProvEngine.dll and ResourceManager.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.
7.  Restore the WebHostingFrontend.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.
8. Restore the W3svcFrontend.dll file from the backup location to the directory <install_dir>\cp\admin\bin\serviceComponents\w3svc  where <install_dir> refers to the path where Ensim Pro is installed.
9. Restore the MSSQLBackend.dll file from the backup location to the directory <install_dir>\cp\admin\bin\serviceComponents\mssql  where <install_dir> refers to the path where Ensim Pro is installed. 
10. Open a command window and run the command iisreset /start.