Web Hosting Resource Manager::AddServers

  • Article

This procedure adds IIS Web Servers to the Resource Manager IIS Web Server resource pool.

Arguments

Input argument Required Description

<servers>/<server>

Yes

One or more server nodes defining a IIS Web Server resource:

  1. <serverName>: The name of the server

  2. <megabytes>: The amount of storage capacity in megabytes

  3. <maxWebSites>: The maximum number of Web sites that can be hosted on this sever.

  4. <shared>: indicates that the server will be either a shared or dedicated resource. 0 = dedicated and 1 = shared

<preferredDomainController>

Yes

<servers>/<server>

No

One or more server nodes defining a IIS Web Server resource. The following additional elements are supported as optional elements:

  1. <container>: A starting Lightweight Directory Access Protocol (LDAP) container to look for the server in. The procedure performs an LDAP search to resolve the <server>/<serverName> to the Active Directory directory service computer object. You can improve the performance of this search by specifying a default container (e.g. LDAP://CN=Computers,DC=fabrikam,DC=Com).

  2. <serverClassName>: User defined value indicating which server class resource group the server should be added to. If not provided, the server is added to the DefaultIISWebServerClass, which is defined when the RM is initialized.

  3. <warningPercentage>: Percentage that represents the allocation level at which to raise a warning notification for the operator. Default is 80.

Remarks

Access Level

Public.

Provisioning Steps

  1. Find the server(s) in Active Directory.

  2. Create new resource instance(s) representing the server(s).

  3. Add capacity data to the servers.

  4. Map the resource to a group (serverClass).

Security

  1. Impersonate Caller.

  2. Caller Tested for domain admin permissions.

    1. Domain admins

Sample Code

Example XML Request

<request> 
  <procedure> 
 
    <execute namespace="Web Hosting Resource Manager" procedure="AddServers" impersonate="1"> 
 
      <executeData> 
 
        <servers> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB01</serverName> 
 
            <maxWebSites>200</maxWebSites> 
 
            <megabytes>1000</megabytes> 
 
            <serverClassName>IISWebServerBasic</serverClassName> 
 
            <shared>0</shared> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>Web02</serverName> 
 
            <maxWebSites>200</maxWebSites> 
 
            <megabytes>1000</megabytes> 
 
            <serverClassName>IISWebServerBasic</serverClassName> 
 
            <shared>0</shared> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>Web03</serverName> 
 
            <maxWebSites>400</maxWebSites> 
 
            <megabytes>10000</megabytes> 
 
            <serverClassName>IISWebServerProfessional</serverClassName> 
 
            <shared>1</shared> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>Web04</serverName> 
 
            <maxWebSites>600</maxWebSites> 
 
            <megabytes>20000</megabytes> 
 
            <serverClassName>IISWebServerPremium</serverClassName> 
 
            <shared>1</shared> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>Web05</serverName> 
 
            <maxWebSites>600</maxWebSites> 
 
            <megabytes>20000</megabytes> 
 
            <serverClassName>IISWebServerPremium</serverClassName> 
 
            <shared>1</shared> 
 
          </server> 
 
        </servers> 
 
        <preferredDomainController>AD01-wh.fabrikam.com</preferredDomainController> 
 
      </executeData> 
 
      <after source="executeData" destination="data" mode="merge" /> 
 
    </execute> 
 
  </procedure> 
 
</request>

Example XML Response

No example XML response.

Applies To

Web Hosting Resource Manager Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Web Hosting Resource Manager::ModifyServers
Web Hosting Resource Manager::RemoveServers
Web Hosting Resource Manager::QueryAllServers