Setting the resource selection policy
You can manage the resource selection policies for each Unify service using BindingPolicy.exe.
To run BindingPolicy.exe:
Log in to the CP server as domain administrator.
If you have more than one CP server, you can run BindingPolicy.exe on any one CP server.
Open a command window and go to the <cp_install_dir>\bin directory, where <cp_install_dir> is the name of the directory on your CP server where the files are installed. If the default settings were used during the platform installation, the path is C:\Program Files\Ensim\Ensim Unify\cp\bin.
Run BindingPolicy.exe with the following parameters:
BindingPolicy.exe /username:<service_provider_user_name> /password:<service_provider_user_name> <parameter>
where:
<service_provider_user_name> is the user name for logging in to the service provider control panel. For example, admin@example.net
<service_provider_user_name> is the password for logging in to the service provider control panel. For example, abc123
<parameter> is one of the parameters listed below.
/?: Displays the help for BindingPolicy.exe
/listservices: Lists all the Unify services available on the setup, their corresponding service IDs and the name of the resource selection policy set for each service.
Usage:
BindingPolicy.exe /username:admin@example.net /password:abc123 /listservices
Output:
Domain Name System 3.0.0: [1] Default
Windows Web Hosting 3.1.0: [2] Default
/listpolicies: Lists all the resource selection policies registered on your setup. It displays the internal and external name of each policy.
BindingPolicy.exe /username:admin@example.net /password:abc123 /listpolicies
Ensim.ResourceManager2.FirstFitBindingPolicy: First Fit Policy
Ensim.ResourceManager2.RoundRobinBindingPolicy: Round Robin Policy
Ensim.ResourceManager2.LeastSoldKeyQuotaBindingPolicy: Least Sold Key Quota Policy
/listproperties:<policy_int_name>: Lists all the properties (if any) that can be set for the specified resource selection policy, where <policy_int_name> is the internal name of the policy. You can retrieve the internal name of the policy by using the /listpolicies parameter mentioned above.
BindingPolicy.exe /username:admin@example.net /password:abc123 /listproperties:Ensim.ResourceManager2.LeastSoldKeyQuotaBindingPolicy
KeyQuotaType (QuotaType(integer)) Mandatory The quota type used to find the least sold value.
/listquotatypes:<service_id>: Lists the IDs and names of all the quota types associated with the specified Unify service, where <service_id> is the ID (identifier) of the service. You can retrieve the service's ID by using the /listservices parameter mentioned above.
BindingPolicy.exe /username:admin@example.net /password:abc123 /listquotatypes:1
Microsoft DNS
2 Number of DNS Zones ()
1 Number of Installations ()
DNS Log
3 Number of Installations ()
/getpolicy:<service_id>: Displays the name of the resource selection policy and its properties associated with the specified service, where <service_id> is the ID (identifier) of the service. You can retrieve the service's ID by using the /listservices parameter mentioned above.
BindingPolicy.exe /username:admin@example.net /password:abc123 /getpolicy:1
Policy: Ensim.ResourceManager2.LeastSoldKeyQuotaBindingPolicy "Least Sold Key Quota Policy"
KeyQuotaType: 2
/setpolicy:<service_id> <policy_int_name> <policy_property1_name>=<value> <policy_property2_name>=<value> …. : Sets the resource selection policy for the specified service, where:
<service_id> is the ID (identifier) of the service. You can retrieve the service's ID by using the /listservices parameter mentioned above.
<policy_int_name> is the internal name of the policy. You can retrieve the internal name of the policy by using the /listpolicies parameter mentioned above.
<policy_property_name> is the name of a property associated with the policy. You can view a list of all the properties associated with a policy by using the /listproperties parameter mentioned above.
<value> is the value that you want to set for its corresponding <policy_property_name>.
BindingPolicy.exe /username:admin@example.net /password:abc123 /setpolicy:1 Ensim.ResourceManager2.LeastSoldKeyQuotaBindingPolicy KeyQuotaType=2
/getdefaultpolicy: Displays the information about the default resource selection policy.
BindingPolicy.exe /username:admin@example.net /password:abc123 /getdefaultpolicy
Policy: Ensim.ResourceManager2.FirstFitBindingPolicy "First Fit Policy"
/setdefaultpolicy <policy_int_name> <policy_property1_name>=<value> <policy_property2_name>=<value> …. : Sets the default resource selection policy, where:
This /setdefaultpolicy parameter is useful when you want to set the same policy along with its property values to more than one service. Instead of setting the policy and its property values for each service, you can define the policy and its property values as the default policy, and then set the policy for all these services as Default. Later, you can also use the /setdefaultpolicy parameter to change the property values of the policy or change the entire policy and this change will be applied to all those services for which you have set the policy as Default.
BindingPolicy.exe /username:admin@example.net /password:abc123 /setdefaultpolicy Ensim.ResourceManager2.LeastSoldKeyQuotaBindingPolicy KeyQuotaType=2