Looking Up Site Information

The Parallels Pro Control Panel file system maintains site information by assigning each domain a number and a corresponding top-level UNIX user through which it identifies the site's following basic information.

• The domain's root directory
• The name of the domain on which the site resides
• The user name of the Site Administrator

Each site on your server is known to the file system as site<n> (called the site handle). The top-level UNIX user is known as admin<n>, where n is a number matching the site number.

The top-level UNIX user is the user handle to the site. Process lists will not show Site Administrator names, but instead show top-level UNIX user names.

Note: Using the ps command will not show which process belongs to which domain. Use the sitelookup command after ps, to map a UNIX user to a site and view information about the sites on your server.

Syntax

/usr/local/bin/sitelookup [-a] [-w <wp_user>] [-s <site_handle>] \
[-d <domain>] [-u <site_admin>] \
[domain, wp_user, site_handle, site_root, site_admin]

where:

• -a returns information for all domains.
• -w returns site information for the site identified by the top level UNIX user <wp_user> you specify.
• -s returns site information for the site identified by the site handle <site_handle> you specify.
• -d returns site information for the site identified by the domain name <domain> you specify.
• -u returns site information for the site identified by the user name of the domain's Site Administrator <site_admin> you specify.

The command returns the following information:

• site_root - the domain's root directory.
• domain - the name of the domain on which the site resides.
• wp user - the top level UNIX user.
• site admin - the user name of the Site Administrator.
• site handle - the file system's name for the site.

The following section lists some examples of this syntax.

Example 1

The command:

sitelookup -w admin1 domain,site_handle

returns the following information associated with the top level UNIX user admin1:

• domain name
• file system's name of the site

For example:

example.com,site1

Example 2

The command:

sitelookup -s site25 site_root

returns the name of the root directory of the site with the site handle site25.

For example:

/home/virtual/example1.example.com

Example 3

The command:

sitelookup -a

returns the following for all the sites you manage.

• domain name
• top-level UNIX user
• site handle
• site root directory
• name of the Site Administrator

For example:

example1.example.com,admin1,site1,
 /home/virtual/example1.example.com,Pawan

example2.example.com,admin2,site2,
 /home/virtual/example2.example.com,Dave