Article ID: 2966, created on Oct 29, 2007, last review on Apr 17, 2012

  • Applies to:
  • Pro Control Panel Windows

AdditionalInformation

View Knowledge
Knowledge ID 2457
Product : Ensim Pro X for Windows
Version : 10.2.0
Topic : Hotfix

Title
Hotfix 4 : Addresses multiple issues

Summary
Addresses following issues:
1. Need CLI to suspend sites, reseller and/or the sites under him
2. Password update through CLI
3. While updating the site password why we need to use some parameter?(like diskquota, Bandwidth etc..)

Prevention


Details

Ensim® Pro for Windows 10.2.0 Hotfix 4 Release notes

Hotfix information

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

Download: http://download.swsoft.com/ensim/download/pro/windows/10.2.0/hotfix/4/EPW-10.2.0-Hotfix-4.zip
md5sum : 23bdc1657e699732b7afc6c9d838a1fa

Resolved Issues

This hotfix resolves the following issues.

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

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

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

The hotfix rollback is complete.


Attachments


Related Knowledge

Related Links
 
Last ModifiedUsageSatisfiedLast Used
3/30/2007 4:35:59 AM24 10/12/2007 5:17:13 AM

8e19bcddff0cc55cafe80c841132ca59 3ccb419cf98083f3bb45808fba8dbc7c 6311ae17c1ee52b36e68aaf4ad066387

Email subscription for changes to this article
Save as PDF