Ensim^® Pro for Windows 10.2.0 Hotfix 4 Release notes

Introduction

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

Topics include:

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

Hotfix information

• Hotfix no: 4
• Hotfix date: March 8, 2007
• Applies to: Ensim Pro for Windows - 10.2.0

Hotfix file information

This hotfix contains the following files:

• EnsimInterfaces.dll (MD5 sum:8db5c989f50d0f107c62f36dd4560f03, Version - 2.1.0.0)
• Ensim.ProvEngine.dll (MD5 sum:f770d26f0782184c97836dfd6a363b7b, Version - 2.1.0.0)
• cp.dll (MD5 sum:272cfa25c044875e2b0714d433dcadf0, Version - 10.2.0.19)
• Ensim.Client.dll (MD5 sum:685767377f3dde296a70bccc9f61435e, Version - 1.0.2623.25276)
• Ensim.PEConnection.WWP.dll (MD5 sum:9a58e56da9817425767a3c5844eb7cb4, Version - 1.0.2623.25275)
• wwpcli.dll (MD5 sum:34f7935634c970ff114def32ee0658b4, Version - 1.0.2623.25282)
• SuspendObj.exe (MD5 sum:89c52e8ca2222e29b5c7cf75bfee6886, Version - 1.0.2623.25291)
• SuspendObj.exe.config (MD5 sum:c6c114ae7ff9c62bbaeeaefc404d27a7)

Resolved Issues

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

• Need CLI to suspend sites, reseller and/or the sites under him(44280)
• Password update through CLI(58979)
• While updating the site password why we need to use some parameter?(like diskquota, Bandwidth etc..)(59057)
  

Prerequisites

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

• Ensim Pro for Windows 10.2.0 - hotfix 1, 3

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 EnsimInterfaces.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 EnsimInterfaces.dll from the temporary directory to the current directory.
5. Change to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed. 
6. Copy the new EnsimInterfaces.dll from the temporary directory to the current directory.
7. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
8. Copy the new EnsimInterfaces.dll from the temporary directory to the current directory.
9. Change to the directory <install_dir>\pe\ProvEngine where <install_dir> refers to the path where Ensim Pro is installed. 
10. 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.
11. Copy the new Ensim.ProvEngine.dll from the temporary directory to the current directory.
12. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
13. Back up the existing cp.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
14. Copy the new cp.dll from the temporary directory to the current directory.
15. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
16. Back up the existing 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.
17. Copy the new Ensim.Client.dll from the temporary directory to the current directory.
18. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
19. Copy the new Ensim.Client.dll from the temporary directory to the current directory.
20. Change to the directory <install_dir>\cp\admin\bin where <install_dir> refers to the path where Ensim Pro is installed. 
21. Back up the existing Ensim.PEConnection.WWP.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
22. Copy the new Ensim.PEConnection.WWP.dll from the temporary directory to the current directory.
23. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
24. Back up the existing wwpcli.dll file to a location other than the existing directory.
    Important: Do not rename the file and keep it in the current directory.
25. Copy the new wwpcli.dll from the temporary directory to the current directory.
26. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
27. Copy SuspendObj.exe from the temporary directory to the current directory.
28. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
29. Copy SuspendObj.exe.config 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 CLI, "SuspendObj.exe", to suspend resellers or sites and the existing CLI "UpdateObj.exe" for reseller is modified to update reseller admin password.

Suspend Command for reseller

Syntax:

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

        SuspendObj.exe -t suspendreseller -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

        SuspendObj.exe -t suspendreseller -s <XML_data_as_a_string> -u <parent_username> -p <parent_password>

Arguments

The parameters to be passed in the XML file for suspending reseller information are given below.

<?xml version="1.0" encoding="utf-8" ?>
<Suspend> 
<property name="ResellerShortName">MyReseller.com</property><!-- The name of the reseller to suspend-->
<property name="AdministrativeAccess">True</property><!-- Set this to True to enable the reseller to log in to the reseller control panel. Set this to False to prevent the reseller from logging in to the control panel. This setting does not affect the reseller's customers.-->
<property name="ApplySettingsOn">1</property><!-- Set this value to 0,1,2 as explained below:
0 - Only reseller will get affected by the settings below. 
1 - Reseller and reseller's customers (organizations and site users under that reseller) will get affected by the settings below
2 - Reseller's customers (organizations and site users under that reseller) will get affected by the settings below-->
<property name="IsSuspended">True</property><!--Set this to False to enable control panels and services. Set this to True to prevent logging in to the control panels and using services.--> 
</Suspend>

Suspend Command for Site

Syntax:

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

        SuspendObj.exe -t suspendorg –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

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

Arguments

The parameters to be passed in the XML file for suspending site information are given below

<?xml version="1.0" encoding="utf-8" ?>
<Suspend> 
<property name="SiteShortName">mysite.com</property> <!-- The name of the site to suspend-->
<property name="IsSuspended">True</property> <!-- Set this to False to enable control panels and services or True to prevent logging in to control panels or using services.-->
<property name="AdministrativeAccess">False</property> <!-- Set this to True to enable Site admin to log in to control panel or False to prevent logging in to the control panel. -->
</Suspend>

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="1"> <!-- If the add flag is equal to "0", then the quota defined below is decreased by the value specified. If the flag is equal to "1", then the quota is increased by the value specified. --> 
<!-- If you want to set the value of a quota as unlimited, then the value of that quota should be set to "-1" and the add flag set to "1". If a quota has unlimited value, and you want to remove it, then set the value of the quota to "-1" and the add flag to "0".--> 
<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">5</property> 
<property quota="Number of Installations of msftpsvc">-1</property> 
<property quota="Number of Installations of php">4</property> 
<property quota="# of SubDomains">3</property> 
<property quota="# of DNS Zones">2</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">5</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 EnsimInterfaces.dll file from the backup location to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed.
5. Restore the EnsimInterfaces.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.
6. Restore the EnsimInterfaces.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.
7. 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.
8. Restore the cp.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.
9. Restore the Ensim.Client.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.
10. Restore the Ensim.Client.dll file from the backup location to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed.
11. Restore the Ensim.PEConnection.WWP.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.
12. Restore the 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.
13. Change to the directory <install_dir>\cli where <install_dir> refers to the path where Ensim Pro is installed. 
14. Remove SuspendObj.exe and SuspendObj.exe.config from the current directory.
15. Open a command window and run the command iisreset /start.