Adding subdomains

You can add subdomains to your site only if your service provider enables your site to host subdomains.

• Note: If enabled, you will find the Subdomain option listed in the System Menu at left.

The number of subdomains you can add is set by your service provider. You can choose to be the owner of a subdomain or alternatively delegate authority to a user of the site.

• Important: If you want to delegate authority to a user, you must first create a user for the site.    

To add a subdomain:

1. In the shortcuts area of the Home page, click Subdomains (Web Server section). The Subdomain window opens.

2. In the Subdomain submenu, click Add Sub Domain. The Add Subdomain form opens.

3. Enter the name of the subdomain in the Name field.

4. Note: To create a subdomain sales for the domain, www.mysite.com, enter only sales in the Name field and not sales.mysite.com.

4. In the Owner field, click the arrow to select an owner for the subdomain.

5. Note: You can choose to be the owner of the subdomain or alternatively delegate authority to a user of the site.

5. In the Full Directory field, enter the complete path to the subdomain directory that will contain content for the subdomain.

6. Important: The subdomain directory must be specified as a complete path, /var/<subdomain folder name>, where <subdomain folder name> is the name of the folder that contains the Web content for the subdomain. Do not enter only <subdomain folder name> as the subdomain directory. This will result in an error.

7. The subdomain directory, once defined, cannot be changed.

6. In the CGI Support select an appropriate CGI option. Options include:

• None - No support for CGI scripts

• Only in ScriptAlias - CGI scripts will be placed in a folder within the local file system instead of being located under the subdomain directory.

For example if the cgi scripts are aliased to /usr/Web/cgi-bin/, instead of the default /cgi-bin/, then a request for http://myscript/cgi-bin/search will run the script from /usr/Web/cgi-bin/search instead of /cgi-bin/search.

• In the CGI-BIN directory - CGI scripts will be placed in the default CGI-BIN directory outside the subdomain directory.

CGI scripts will be placed in the /cgi-bin/ directory.

7. In the CGI Script Extensions field, enter the required CGI script extension.

8. Note: The value in this field depends on the type of CGI support enabled for the subdomain in step 6.
   
   Default values are set for the following CGI Support options:
   
   None - None. No script support.
   Only in ScriptAlias - ALL (any script placed in the ScriptAlias directory will be executed)
   
   If you choose In the CGI-BIN directory, you can specify the scripts that should be executed, for example, php, pl etc.

8. Click Add SubDomain.

If the subdomain has been successfully created, it will be added to the list of existing subdomains. An appropriate message is displayed above the list of subdomains.

If the process fails, or succeeds with attendant warnings, click the Details link to view related information.