man Pages(1m): Maintenance Commands

httpd.intro(1M)

NAME | DESCRIPTION | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

httpd.intro- Introduction to the man pages of the Sun^TM WebServer^TM command-line utilities. The man pages offer detailed instructions and examples on options and subcommands for each utility.

DESCRIPTION

The command-line utilities are available to administer Sun WebServer.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhtman
Interface Stability	Evolving

FILES

The following files are used by the command-line utilities:

site_path/conf/access.conf

A web site's Access Control Lists (ACLs) configuration file.

/etc/http/access.conf

The server administration ACLs configuration file.

site_path/conf/access.conf

A web site's ACLs configuration file.

/etc/http/access.conf

Defines the realms used to define users and groups for server administration.

site_path/conf/content.conf

Defines the content variants, encoding types, and directory preferences for a web site.

/etc/http/httpd-instances.httpd.conf

Tracks all Sun WebServer instances. When htserver creates a new server instance, an entry is added to this file.

site_path/conf/site_name.httpd.conf

Contains the web site servlet engine configuration if the servlet engine is not shared.

/etc/http/instance_name.httpd.conf

The server instance configuration file. When hthost adds a new site, it creates an entry in httpd.conf to define the site_path and web site configuration file.

site_path/conf/site_name.site.conf

The web site configuration file.

/etc/http/httpd.conf

Contains the server instance servlet engine configuration if all web sites share the servlet engine.

site_path/conf/map.conf

Creates an alias to a path on the file system or a redirection to a remote URL from a Uniform Resource Identifier (URI) on the host.

site_path/conf/realms.conf

Defines realms of user and group information used by access control lists on a Sun WebServer web site.

site_path/conf/servlets.properties

Defines each servlet that can be loaded by a web site.

SEE ALSO

access.conf(4), content.conf(4), httpd.conf(4), httpd.cgi.logs(4), httpd.event.logs(4), httpd-instances.conf(4), httpd.request.logs(4), httpd.servlet.logs(4), httpd.site.conf(4), map.conf(4), realms.conf(4), servlets.properties(4)

NOTES

htaccess

Adds or deletes ACLs for resources on a web site. An ACL applies to any token that can be a URI on that site, whether that URI is a directory, file, servlet, CGI, or alias to another resource.

htcontent

Create or deletes information about the content of resources on a web site. For directories, you can set whether they are avaliable to browse and specify the format for directory listings. For files, you can set preferences for HTTP 1.1 content negotiation. Preferences include character set, language, compression encoding, and media type.

hthost

Associates a web site (or virtual host) with system resources, such as the server instance that hosts the site, a configuration directory, a configuration file, and a host name. Activates or shuts down web sites on a running server instance.

htmap

Adds and deletes aliases from one URI to another resource on a web site. Redirects a token to nonfile resources such as servlets, CGI scripts, or Sun WebServer Administration Console.

htpasswd

Changes passwords for users in HTPASSWD realms. It is provided as a tool that can be incorporated in CGI or other scripts to automate password maintenance. User must be created using htrealm. Once a user is created, any system user can run htpasswd to update passwords (as long as the realm administrator name and password are specified).

htrealm

Creates, deletes, and lists realm definitions for use with ACLs. It can also be used to manage users and groups in HTPASSWD realms.

htserver

Creates and maintains Sun WebServer server instances. Each server instance is a process associated with a configuration file, and each one hosts one or more web sites. htserver can start, stop, and restart server instances. It can also enable or disable server instances.

htservlet

Configures the behavior of a servlet engine. Defines and modifies servlet engine runtime, security, and logging properties; adds or removes entries in the servlets.properties file, and loads, reloads, or unloads servlets in running servlet engines.

httpd

Server instances can be started or stopped by using the htserver utility, through the Sun WebServer Administration Console, or executing this script. It is recommended that you use htserver or the Sun WebServer Administration Console.

If the command is run by root user, then the user name and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

SunOS 5.7  Last Revised 2 Sep 1997

NAME | DESCRIPTION | ATTRIBUTES | FILES | SEE ALSO | NOTES

htaccess(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htaccess - Allows manipulation of Sun^TM WebServer^TM access control lists (ACLs) configuration.

SYNOPSIS

htaccess add [ -a] [-g group_name| -I Internet_host| -u username] -h hostname -i instance [-m method] [-r realm_name] [ -s scheme_name] -U URI_name [- y| -n] [-z admin[-p]]
htaccess check [ -a] [-g group_name| -I Internet_host| -u user_name] -h hostname -i instance [-m method] -U URI_name [-z admin[-p]]
htaccess delete [ -a] [-g group_name| -I Internet_host| -u user_name] -h hostname -i instance [-m method] -r realm_name -s scheme_name -U URI_name [ -y| -n] [-z admin[-p]]
htaccess help
htaccess list -h hostname -i instance -U URI_name [-z admin[-p]]
htaccess version

DESCRIPTION

htaccess adds or deletes access control lists (ACLs) for resources on a web site. An ACL applies to any token that can be a Uniform Resource Identifier (URI) on that site, whether that URI is a directory, file, servlet, CGI, or alias to another resource.

ACLs can restrict access by the host name or IP address of a client, or by authenticated user or group name. Users are authenticated against a named realm (see htrealm(1m)), which defines whether passwords are stored in a Sun WebServer specific file (HTPASSWD), the operating system (UNIXSYS), in the Solaris^TM for ISPs^TM environment, an LDAP directory of ISP subscribers (ISP), or in the Management Console for Solaris for ISPs (ISPADMIN).

The list subcommand can be used to list the current ACLs on a URI.

The check subcommand can be used to check whether a user name and password can access a URI.

OPTIONS

Subcommands

The following subcommands are supported:

add

Adds a new ACL or permission to an existing ACL.

check

Checks if the specified access is allowed.

delete

Deletes an ACL or permission to an existing ACL.

help

Displays help on usage.

list

Lists all ACLs and their permissions for a given URL or specified host.

version

Displays the version of htaccess.

Options

The following options are supported:

-a

Specifies that the user or group is the administrator. Valid with the add and delete subcommands.

-g group_name

Specifies the group in the realms to which the permissions apply. A group is a group of users defined in the realm. Use the wild card \* to indicate that the permission applies to any group_name. Valid with the add, delete, and check subcommands.

-h hostname

Specifies the name of the virtual host containing the ACL. Valid with all subcommands.

-I Internet_host

Specifies the IP or domain to which the permissions apply. Internet_host can be a fully qualified or partial domain name. If the domain name is partial, the permission applies to all hosts whose fully qualified names end with the domain. It can also be a fully qualified or partial IP address. If the IP address is partial, the permission applies to all hosts whose IP address begins with the Internet_host. Use the wild card \* to indicate that the permission applies to any Internet_host. Valid with the add, delete, and check subcommands.

-i instance

Specifies the name of the httpd instance. Valid with all subcommands.

-m method_names

Specifies the HTTP method name to which the permissions apply. The method_names directive is a list of ALL, DELETE, GET, POST, and PUT. Select ALL to permit all HTTP methods. Separate multiple methods with a space. The default is ALL. Valid with the add, delete, and check subcommands.

-n

Denies access permission to the named user, group, or host. Valid with the add and delete subcommands.

-p

Turns off prompting of password such that passwords are taken in from stdin and scripts may pipe (|) passwords. Valid with all subcommands.

-r realm_name

Specifies the realm name. Valid with the add subcommand.

-s scheme_name

Specifies authentication scheme. Valid with the add subcommand.

BASIC

The server expects user name and password information in base64 encoded text.

MD5

The server expects user name and a message digest of the password. The server must get the password in base64 encoded text locally, create a message digest, and compare it to the digest sent by the client. Valid only with htpasswd.

NONE

The server does not expect any authentication.

-U URI_name

Specifies URI name protected by the ACL. Valid with all subcommands.

-u user_name

Specifies the user name to which the permission applies. A user is any user with a user name for which Sun WebServer retrieves the password from the realm name specified in the ACL. Use the wild card \* to indicate that the permission applies to any user. Valid with the add, check, and delete subcommands.

-v

Specifies the verbose mode. Valid with all subcommands.

-y

Allows the named user, group, or host to access the URI. Valid with the add and delete subcommands.

-z admin_name

Specifies the name of the administrator. Valid with the add, check, and delete subcommands.

EXAMPLES

---

Example 1




To protect the URL http://www.A.com/project/ on the server instance "sws_server" using an HTPASSWD realm "Project" with user "user1":

# htrealm add -i sws_server -h www.A.com -r Project \\ 
-s HTPASSWD -d realms/Project

# htrealm add -i sws_server -h www.A.com -r Project -u user1
Setting password for the user user1.
Password:
Confirm Password:

# htaccess add -i sws_server -h www.A.com -U "/project" \\  
 -r Project -s BASIC -m GET -u '*' -y

---

---

Example 2




To delegate access control management to the user webmaster in the realm WebUsers:

# htaccess add -i sws_server -h www.A.com -U / -r WebUsers -s MD5 -a \\ 
 -u webmaster

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by this utility:

site_path/conf/access.conf

A web site's access control lists configuration file.

/etc/http/access.conf

The server administration access control lists configuration file.

site_path/conf/realms.conf

Defines the realms used to define users for web site access control lists.

/etc/http/realms.conf

Defines the realms used to define users for server administration.

SEE ALSO

access.conf(4), htrealm(1m), realms.conf(4)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

htcontent(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htcontent - Administers HTTP/1.1 meta-data associated with resources in a document tree.

SYNOPSIS

htcontent add -h hostname -i instance -n uri [-p] [-u administrator] [-O directory_options| -P preference_options| -V variant_options]
htcontent delete -h hostname -i instance -n uri [-p] [-u administrator] [-O directory_options| -P preference_options| -V variant_options]
htcontent help
htcontent list -h hostname -i instance -n uri [-p] -u administrator [-O directory_options| -P preference_options| -V variant_options]
htcontent version

DESCRIPTION

htcontent creates or deletes information about the content of resources on a web site.

For directories, you can set whether they can be browsed and also sets the format for directory listings. You can also create a list of default file names to search for in the directory.

For files, you can set preferences for HTTP 1.1 content negotiation. Preferences include character set, language, compression encoding, and media type.

You can set variant information for a Uniform Resource Identifier (URI). If a URI has a set of associated file variants, the server will select the most appropriate variant based on the client's preferences and the preference settings on each file variant.

See the Examples section for more detail.

OPTIONS

Subcommands

The following subcommands are supported:

add

Adds directories, options, preferences, or variants for a URI.

delete

Deletes directories, options, preferences, or variants for a given URI.

help

Displays help on usage.

list

Lists the configured directories, options, preferences, or variants for a URI.

version

Displays the version of htcontent.

Options

The following options are supported:

-h hostname

Specifies the virtual host name. Required with all subcommands.

-i instance

Specifies the name of the httpd instance. Required with all subcommands.

-n uri

Specifies the URI. Required with the all subcommands.

-O directory_options

Specifies options for directory listings and default files on directory options. Valid with all subcommands. This option requires a comma-separated list of parameters to specify directory settings. Lists should be specified in order of preference. The following are the valid directory options:

a all

Indicates delete all preference or variants information. Valid with the delete subcommand.

d [[=listing_type]]

Sets the method for displaying the contents of a directory when there is no file matching one of the default file names. Valid with the add and delete subcommands. The listing_type directive can be one of the following:

fancy

Displays each directory as a hyperlink with the file size, the last modified time, and an icon next to each entry to indicate the file type.

off

Displays no directory contents.

simple

Displays directory entries as plain text hyperlinks.

f [[= file]]

Specifies the file associated with the variant information (-V) or a list of default file names in a directory (-O). Use a colon (:) to separate items in a list. File names must be relative to the URI. Valid with the add and delete subcommands.

-P preference_options

Sets the server's content negotiation preferences for the specified URI. Valid with all subcommands. This option requires a comma-separated list of parameters to specify preference settings. Lists should be specified in order of preference. The following are the valid preference options:

a all

Indicates delete all preference or variants information. Valid with the delete subcommand.

c [[= charset]]

Specifies the character set of the data. A character set refers to a method used with one or more tables to convert a sequence of octets into a sequence of characters. The default charset for variants is ISO-8859-1. Valid with the add and delete subcommands.

e [[= encoding]]

Specifies the preferred encodings or the encoding type of a variant. Encoding refers only to methods of compression. For example, gzip or compress reveals which methods have been used to encode the file. For preferences, separate multiple encodings with a colon (:). Valid with the add and delete subcommands.

l [[= lang]]

Specifies the preferred languages of a variant. Languages are specified in the standard two-letter format. For preferences, separate multiple languages with a colon (:). Valid with the add and delete subcommands.

t [[= media_type]]

Specifies the preferred types of media of a variant. Media type is in standard MIME type format. For preferences, separate multiple media types with a colon (:). Valid with the add and delete subcommands.

-p

Disables password prompting. Passwords will be read from stdin. Valid with the add and delete subcommands.

-u administrator

Specifies a user name in the web site's administration realm (serverAdmin by default), or in the realm specified by the ACL from the URI. Required with all subcommands.

-V variant_options

Specifies variant suboptions. Valid with all subcommands. This option requires a comma-separated list of parameters to specify variant settings. Lists should be specified in order of preference. The following are the valid variant options:

a all

Indicates delete all preference or variants information. Valid with the delete subcommand.

c [[= charset]]

Specifies the character set of the data. A character set refers to a method used with one or more tables to convert a sequence of octets into a sequence of characters. The default charset for variants is ISO-8859-1. Valid with the add subcommand.

e [[= encoding]]

Specifies the preferred encodings or the encoding type of a variant. Encoding refers only to methods of compression. For example, gzip or compress reveals which methods have been used to encode the file. For preferences, separate multiple encodings with a colon (:). Valid with the add subcommand.

f [[= file]]

Specifies the file associated with the variant information (-V) or a list of default file names in a directory (-O). Use a colon (:) to separate items in a list. File names must be relative to the URI. Valid with the add and delete subcommands.

l [[= lang]]

Specifies the preferred languages of a variant. Languages are specified in the standard two-letter format. For preferences, separate multiple languages with a colon (:). Valid with the add subcommand.

t [[= media_type]]

Specifies the preferred types of media of a variant. Media type is in standard MIME type format. For preferences, separate multiple media types with a colon (:). Valid with the add subcommand.

EXAMPLES

---

Example 1




This example displays a page named home.html in English, French, or German based on the client's preference. There are three files: home.en.html, home.fr.html, and home.de.html.

# htcontent add -i sws_server -h www.A.com -n home.html \\  
   -u admin -V f=home.en.html,l=en
 Enter Password for admin:

# htcontent add -i sws_server -h www.A.com -n home.html \\  
   -u admin -V f=home.fr.html,l=fr
 Enter Password for admin:

# htcontent add -i sws_server -h www.A.com -n home.html \\  
   -u admin -V f=home.de.html,l=de
 Enter Password for admin:

---

---

Example 2




To view the variants associated with a URI, use htcontent list. After Example 1, you could verify the content settings:

# htcontent list -i sws_server -h www.A.com -n home.html \\ 
  -u admin -V
Enter Password for admin: 
  home.de.html   lang = de
  home.fr.html   lang = fr
  home.en.html   lang = en

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by this utility:

site_path/conf/content.conf

Defines the content variants, encoding types, and directory preferences for a web site.

SEE ALSO

content.conf(4)

NOTES

If the command is run by root user, then the user name and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

hthost(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

hthost- Create, delete, and manage web sites on Sun^TM WebServer^TM httpd instances.

SYNOPSIS

hthost add [-f site_config_file] [-g groupname] -h hostname -i instance [-p ] -s site_path [-u username] -z admin
hthost delete -i instance -h hostname [-p ] -z admin
hthost disable -i instance -h hostname [-p ] -z admin
hthost enable -i instance -h hostname [-p ] -z admin
hthost help
hthost list [-i instance-h hostname] [-p ] -z admin
hthost version

DESCRIPTION

hthost is used primarily to add and delete web sites. The add subcommand associates a web site (or virtual host) with system resources, such as the server instance that hosts the site, a configuration directory, a configuration file, and a host name.

The enable and disable subcommands are used to activate or shut down web sites on a running server instance. The enabled or disabled state is saved so that if the server instance is restarted, enabled sites are automatically reactivated.

Once a web site has been created on a server instance, you must edit its configuration file to further customize the site; see httpd.site.conf(4).

OPTIONS

Subcommands

The first argument to hthost must be one of the following subcommands:

add

Adds a web site configuration for a host name to a server instance. The add subcommand creates a site path for configuration directories, creates a configuration file, and grants administrative rights to the given user name and optional group. The initial state of the site is enabled.

delete

Deletes a web site configuration from a server instance. References to the site in the configuration files for the server instance are deleted, and the site is no longer available through httpd. The site's directories and files remain in place.

disable

Disables a web site. The server instance that serves the site will not respond to requests for disabled sites.

enable

Enables a web site, making it available through the server instance.

help

Displays usage information for the command.

list

Lists the sites supported by a server or properties of a specific site. If only an instance name is supplied, a list of all web sites on that server displays. If an instance name and a hostname are supplied, then details about the web site for the host name are displayed.

version

Displays the version of the hthost command.

Subcommand Options

The following options are supported.

-f site_config_file

Specifies the location of the site configuration file relative to the site_path specified by -s. By default, site configuration is stored in the site_path/conf directory. Valid only with the add subcommand.

[[-g group_name]]

Specifies a group in the server administration realm that has ownership rights on the new site. Valid only with the add subcommand.

-h hostname

Specifies the host name of the site to which a subcommand applies. The host name is a token used to identify the site; no name service lookups are performed, for example, to expand a host name to a fully qualified domain name. Any form of the host name may be used for the add subcommand, but other commands must use the same form used when the site was added. Valid with all subcommands.

-i instance

Specifies the server instance which hosts the web site. The instance name is defined uniquely for each server when it is created. Valid with all subcommands.

-s site_path

Specifies the absolute path to the web site's directory tree. The site_path contains all configuration, access control, realm, and content directories and files for the site. Valid only with the add subcommand.

-u username

Specifies a user in the server administration realm that has ownership rights on the new site. Valid only with the add subcommand.

EXAMPLES

---

Example 1




A server administrator named serverAdmin1 creates a site named www.A.com. The site will have an administrator named user1 and have all configuration files and public documents in /opt/WWW/A.com/.

In order for hthost to successfully create a directory for the new site, you must have write permission to the directory under which the site configuration files will reside.

# hthost add -i sws_server -h www.A.com -u user1 \\  
  -s /opt/WWW/A.com -f conf/A.com.httpd.conf -z serverAdmin1
Enter Password for serverAdmin1:

Creating site directory: 
 /opt/WWW/A.com
Creating site configuration: 
 /opt/WWW/A.com/conf/A.com.httpd.conf

# ls /opt/WWW/A.com
cgi-bin/       public/
conf/          servlets/

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by this utility:

site_path/conf/site_name.site.conf

The web site configuration file.

/etc/http/instance_name.httpd.conf

The server instance configuration file. When hthost adds a new site, it creates an entry in httpd.conf to defined the site_path and web site configuration file.

SEE ALSO

httpd.site.conf(4), httpd.conf(4)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

htmap(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htmap- Manages maps at the site level.

SYNOPSIS

htmap add [-c class] -i instance -f from -h hostname -t to [-z admin[-p]]
htmap delete -i instance -f from -h hostname [-z admin[-p]]
htmap help
htmap list -i instance [-f from] -h hostname [-z admin[-p]]
htmap version

DESCRIPTION

The htmap command adds, deletes, and lists aliases from one Uniform Resource Identifier (URI) to another resource on a web site. By default it creates a reference from a URI token to a file or directory on disk.

htmap administers maps to establish an alias to another resource, make a resource outside of the doc_root accessible to a client, or partition the name space into various classes of resources such as CGI, imagemap, or servlet.

OPTIONS

The following subcommands are supported:

add

Adds a new map.

delete

Deletes an existing map.

help

Displays help on usage.

list

Lists all maps.

version

Displays the version of htmap command.

The following options are supported:

-c class

Specifies the class file for the map. Values can be one of the following (if no -c is specified, then the class defaults to NULL):

ADMIN

Treats the alias as a URL to access the Sun WebServer Administration Console and the administration server.

CGI

Treats the aliased file or directory as a CGI resource (all files located here will be treated as executable scripts).

IMAP

Treats the alias as an imagemap resource.

NULL

Treats the aliased directory in no special way.

REMOTE

Treats the alias as a new URL, either on the local host or on another network location.

SERVLET

Treats the aliased resource_target as a servlet or a chain of servlets.

STATS

Treats the alias as an interface to server statistics.

-f from

Indicates the URI token the web server will map. Any URI that begins with this token will be redirected to the resource defined by the map class and the -t to destination.

-h hostname

Specifies the virtual host.

-i instance

Specifies the name of the httpd instance. Valid with all subcommands.

-t to

Defines the path name or URL to the actual resource. Valid with the add subcommand.

EXAMPLES

---

Example 1




To create a URL http://www.A.com/swshelp/ that references a directory outside of the www.A.com document root:

# htmap add -i sws_server -h www.A.com -f /swshelp/ \\ 
   -t /usr/http/admin_server/public/admin/help/en/

---

---

Example 2




To create a URL http://www.A.com/siteadmin/ that starts the Sun WebServer Administration Console for administration of the web site:

# htmap add -i sws_server -h www.A.com -f /siteadmin/ \\ 
  -t /sws-administration -c ADMIN

---

---

Example 3




This example shows how to create an alias that accesses a servlet without using the standard servlet token (/servlet/ by default). To redirect http://www.A.com/calendar/ to a servlet chain that invokes a servlet named login then a servlet named calendar:

# htmap -i sws_server -h www.A.com -f /calendar/ \\ 
  -t login,calendar -c SERVLET 

Note that login and calendar must be in the servlets path and have definitions in servlets.properties.

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by the command-line utilities:

site_path/conf/map.conf

Creates an alias to a path on the file system or a redirection to a remote URL from a URI on the host..

SEE ALSO

map.conf(4)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

htpasswd(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htpasswd- Administers passwords for the users in HTPASSWD realms.

SYNOPSIS

htpasswd help
htpasswd version
htpasswd [-i instance_name] [-h hostname] [-p] -r realm_name -u user_name [-z admin_name]

DESCRIPTION

htpasswd is a utility used only to change passwords for users in HTPASSWD realms. It is provided as a tool that can be incorporated in CGI or other scripts to automate password maintenance.

Users must be created using htrealm(1m). Once users are created, any system user can run htpasswd to update passwords (as long as the realm administrator name and password are specified).

OPTIONS

The following options are supported:

-i instance

Specifies the name of the server instance. Valid with all subcommands.

-h hostname

Specifies the name of the virtual host containing the realm. Valid with all subcommands.

-p

Turns off password prompting (for scripts). Valid with all subcommands.

-r realm_name

Specifies the realm name. Valid with all subcommands.

-u user_name

Specifies a user name whose password is to be set so that the user can have permission to modify realm data. Separate multiple user names with a white space. Valid with all subcommands.

-v

Displays verbose status messages.

-z admin_name

Specifies the name of the administrator of the server, web site, or realm. If users omit this option, users will be prompted for the current password and then the new password. This allows users to change the passwords themselves. Valid with all subcommands.

EXAMPLES

---

Example 1




Any user can change passwords in an HTPASSWD realm if they have the user name and password of the realm administrator. If realmadmin is the realm administrator name, a user (or CGI script) can change the password for user1:

% htpasswd -i sws_server -h www.A.com -r Project \\ 
  -u user1 -z realmadmin
 Enter Password for realmadmin:
 Setting pasword for the user user1.
 Password:
 Confirm password:

---

---

Example 2




The user user1 in the WebUsers realm changes his own password:

 % htpasswd -h www.A.com -i sws_server -r WebUsers -u user1
                                Password for user user1: ***
                                Changing password for the user user1
                                New Password: *****
                                Confirm Password: *****

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by the command-line utilities:

site_path/conf/realms.conf

Defines realms of user and group information used by access control lists on a Sun WebServer web site.

SEE ALSO

realms.conf(4), htrealm(1m)

NOTES

In order to access the global HTPASSWD realms (/etc/http/realms/conf), omit the -i and -h flags.

This command is installed with setuid to adm to permit end users invoking the command to have write access to the Sun WebServer configuration after performing necessary checks.

Superusers do not need to specify the -z flag, and are allowed to access any command-line utility without authentication.

If the command is run by root user, then the user name and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

The server will check whether a user has been designated the realm administrator, site administrator, or server administrator (in this order), where the later two are defined as those principans who have access to the pseudo-URI ("/sws-administration")at the site-level and global access control configuration (/etc/http/access.conf).

A server administrator has access to site administration and is able to manage site realms, ACLs, and content. However, site administrators can override this setting by delegating administrators in the administrator blocks in realms, ACLs, and content configuration.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

htrealm(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htrealm- Manages realms, users, and groups used to configure Access Control Lists on a Sun^TM WebServer^TM web site.

SYNOPSIS

htrealm add [-A] [-d data_dir] [-g groupname] [-h hostname-i instance] [-m individuals] [-p] -r realmname -s[[UNIXSYS]| [HTPASSWD]] [-u userid] -v [-z admin_name]
htrealm delete [[-A]| [-m individuals]] [-g groupname] [-h hostname-i instance] [-p] -r realmname -u userid -v [-z admin_name]
htrealm help
htrealm list [[-A]| [-u userid]| -g groupname| -r realmname] [-h hostname-i instance] [-p] -v [-z admin_name]
htrealm version

DESCRIPTION

Realms in Sun WebServer define sets of protection spaces or authentication domains consisting of user names, groups, and passwords. Access controls based on password authentication use a realm to determine how to authenticate users. For example, a person may have a user name and password for a UNIX® system account and a different set of credentials for Sun WebServer administration. The realm used to protect a resource on a web site would determine which password the person would need.

Realms are also differentiated based on how they are used. You can define two realms, for example, that both use UNIX user names and passwords. One realm could be named "admins" and another "subscribers." Both use the same set of valid UNIX system users, but in practice you might only use "admins" with access control lists (ACLs) that are restricted to a small set of users. When prompted to enter a password for the "admins" realm or the "subscribers" realm, the user knows which password to enter and whether the user has access to the data (that is, the user knows the purpose for authenticating). If "admins" and "subscribers" were HTPASSWD realms, they will have different ACLS and user names.

Most browsers display the realm name in the prompt when a user name and password are required, so the realm name should indicate to users the purpose for password protection and which user name and password to use.

The htrealm command can be used to create, delete, and list realm definitions for use with ACLs. It can also be used to manage users and groups in HTPASSWD realms. HTPASSWD realms are Sun WebServer specific in that their data is stored in user and group files with Sun WebServer configuration.

Realms in the global /etc/http/ directory are independent of any web site. These realm definitions are used only for server administration; the user names and passwords are used to log into the Sun WebServer Administration Console or to execute commands such as htserver. Only one such realm may be in use at any given time. The server administration realm must be defined in /etc/http/realms.conf and used to protect the /sws-administration URI in /etc/http/access.conf.

OPTIONS

Subcommands

The following subcommands are supported:

add

Adds a given realm, user, group, or memeber.

delete

Deletes a given realm, user, group, or member.

help

Displays help on usage.

list

Lists all realms, users, groups, or memebers.

version

Displays the version of htrealm.

Options

The following options are supported:

-A

Indicates that the user or group specified with the -u or -g flags has administrative privileges of the ACL. The administrators must already be valid principals within the realm. Valid with all subcommands (but used most frequently to add, delete, or list realm administrators).

-d data_dir

Specifies a directory relative to the site path where the users and groups files for an HTPASSWD realm are stored. data_dir is required and valid only if -s is HTPASSWD, or if you're running on Solaris for ISPs, ISPADMIN. The default is site_path/conf/realms/realmname. Valid with the add subcommand.

-g groupname

Specifies a set of users with permission to access the resources in the realm. Separate multiple group names with white space. Valid with all subcommands.

-h hostname

Specifies the name of the virtual host containing the realm. Valid with all subcommands.

-i instance

Specifies the name of the server instance. Valid with all subcommands.

-m individuals

Specifies the individual members of the group. This is a comma-separated list. Valid with the add and delete subcommands.

-p

Turns off the prompting for the password such that passwords are taken in from stdin and scripts may pipe (|) passwords. Valid with all subcommands.

-r realmname

Specifies the realm name. White spaces must be inside double quotes. Valid with all subcommands.

-s source_name

Specifies the source of the realm (UNIXSYS or HTPASSWD). Valid with the add subcommand.

HTPASSWD

Indicates that the user or group information is retrieved using the Sun WebServer users/group file format, and that user and group information will be maintained in the data directory named by realm_dir. The htrealm(1m) utility is used to create, delete, and list users and groups and modify passwords using htpasswd.

ISP

Indicates that the realm information is stored in the Solaris^TM for ISPs shared directory service. Changes to user and group information cannot be made through Sun WebServer.

ISPADMIN

Indicates that the principals are Administrators in the Solaris^TM for ISPs^TM Management Console. The -d flag takes the ISP-component ID and version (for example, "SUNWfinger-1.0").

UNIXSYS

Indicates that the operating system user and group definitions will be used to authenticate users in the realm. Changes to user and group information cannot be made through Sun WebServer.

-u userid

Specifies the realm user with permission to modify realm data. Separate multiple user names with white space. Valid with all subcommands.

-v

Displays verbose status messages. Valid with all subcommands.

-z admin_name

Specifies the name of the realm administrator. Valid with all subcommands.

EXAMPLES

---

Example 1




To create a site-specific realm called Subscribers on the web site www.A.com, you create at least one user and one realm administrator:

# htrealm add -i sws_server -h www.A.com -r Subscribers \\ 
  -s HTPASSWD

# htrealm add -i sws_server -h www.A.com -r Subscribers \\ 
  -u user1
Setting password for the user user1.
Password:
Confirm Password:

# htrealm add -i sws_server -h www.A.com -r Subscribers \\ 
  -u user1 -A

---

---

Example 2




A nonroot user can add a realm if a valid user name and password from the serverAdmin realm are supplied:

% htrealm add -i sws_server -h www.A.com -r System \\ 
  -s UNIXSYS -z admin
Enter Password for admin:

% htrealm list -i sws_server -h www.A.com -z admin
Enter Password for admin:
siteAdmin       HTPASSWD        -
System          UNIXSYS         -

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by the command-line utilities:

site_path/conf/access.conf

A web site's ACLs configuration file.

/etc/http/access.conf

The server administration ACLs configuration file.

site_path/conf/access.conf

A web site's ACLs configuration file.

/etc/http/access.conf

Defines the realms used to define users for server administration.

site_path/conf/realms.conf

Defines realms of user and group information used by access control lists on a Sun WebServer web site.

site_path/conf/realms/HTPASSWD_realm_name/users

Lists the users in the HTPASSWD realm.

Entries in this file have the form username:password.

site_path/conf/realms/HTPASSWD_realm_name/groups

Lists the groups in the HTPASSWD realm.

Entries in this file have the following form:

group <group_name> {
	member1
	member2
	member3
}

SEE ALSO

realms.conf(4), htaccess(1m), access.conf(4), htpasswd(1m)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

htserver(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htserver- Create, delete, and manage Sun^TM WebServer^TM httpd instances.

SYNOPSIS

htserver add instance [ conf_file]
htserver delete instance [ instance...]
htserver disable [[-a][instance...]]
htserver enable [[-a][instance...]]
htserver help command
htserver list [[-a][instance...]]
htserver query [[-a][instance...]]
htserver restart [[-a][instance...]]
htserver start [[-a][instance...]]
htserver stop [[-a][instance...]]
htserver update instance [ conf_file]

DESCRIPTION

The htserver command creates and maintains Sun WebServer server instances. Each server instance is a process associated with a configuration file, and each one hosts one or more web sites.

htserver can start, stop, and restart server instances. It can also enable or disable server instances. Each "enabled" server instance will be started when the machine reboots or when htserver start is run with no instance specified.

The list and query subcommands can be used to get information about what servers are running or enabled and what configuration files each instance uses.

Once a server instance is created, use hthost(1m) to add web sites. To modify the configuration, either use the Sun WebServer Administration Console (http://host:2380/admin/admin.html), or edit the server configuration file (see httpd.conf(4)).

The server instance named admin is the administration server. This server instance is created when Sun WebServer is installed and listens to port 2380 on all IP addresses. The admin server instance is used to access the Sun WebServer Administration Console.

OPTIONS

Subcommands

The first argument to htserver must be one of the following subcommands:

add

Creates a reference to a new server instance so that it can be managed. An entry is added to the server list in httpd-instances.conf(4).

delete

Deletes a server instance from httpd-instances.conf. This removes the server instance from Sun WebServer management, but does not delete the data or configuration files for the server or any of its sites.

disable

Disables a server instance. Disabled instances can only be started by running htserver start instance_name, and explicitly specifying the instance name. Disable does not stop a running server instance.

enable

Enables a server instance. Enabled instances will be started when the machine reboots or whenever htserver start is run with no instance named.

help

Displays usage information for this command.

list

Lists server instances and status information for all servers or each named instance.

query

Displays detailed status and statistical information about a named server instance.

restart

Restarts named server instances or all of the currently running server instances.

start

Starts named server instances or all enabled server instances with the configuration files listed in httpd-instances.conf.

stop

Stops named server instances or all running server instances.

update

Updates a named instance with the named configuration file.

Subcommand Options

The following options are supported:

-a

Indicates that the command applies to the Sun WebServer Administration server. The Sun WebServer Administration server is a special server instance that allows remote administration of servers and sites through the Sun WebServer Administration Console.

-v

Runs the command in verbose mode with more descriptive messages output to the screen.

OPERANDS

The following operands are supported:

conf_file

Specifies the name of a configuration file to use for a server instance. This operand is required as the last argument for the add and update subcommands.

instance

Specifies a server by its instance name. Instance names are maintained in the /etc/http/httpd-instances.conf file. A single instance name is required with the add, update, delete, and query subcommands. Other subcommands take an optional instance name or list of instance names.

EXAMPLES

---

Example 1




To list all server instances (nonroot users must use --z and provide a user name and password from the serverAdmin realm):

# htserver list -z admin
Enter Password for admin: 

Instance : sws_server
        Enabled : No
        pid : -
        Config file : //etc/http/sws_server.httpd.conf

Instance : aws
        Enabled : Yes
        pid : 4018
        Config file :  /var/opt/SUNWixamc/awsconf/aws.conf

Instance : SUNWixmon
        Enabled : Yes
        pid : 4020
        Config file : /opt/SUNWixmon/sws/SUNWixmon.httpd.conf

Instance : admin
        Enabled : No
        pid : -
        Config file : //usr/http/admin_server/conf/admin.httpd.conf

To create a new server named Large_Sites with default values for the configuration file (/etc/http/Large_Sites.httpd.conf), server root directory (/var/http/Large_Sites), and site directory (/var/http/Large_Sites/websites/):

# htserver add Large_Sites
Creating server configuration file:
 /etc/http/Large_Sites.httpd.conf 
Creating server root directory:
/var/http/Large_Sites
Creating site directory: 
/var/http/Large_Sites/websites/default_site
Creating site configuration: 
/var/http/test_server/Large_Sites/websites/default_site/conf/default_site.site.conf

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by this utility:

/etc/http/instance_name.httpd.conf

The server instance configuration file.

/etc/http/httpd-instances.conf

Tracks all Sun WebServer instances. When htserver creates a new instance, an entry is added to this file.

SEE ALSO

httpd.conf(4), httpd-instances.conf(4), hthost(1m)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

htservlet(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htservlet- Configures the behavior of a servlet engine.

SYNOPSIS

htservlet add [-a init_args] [-b codebase] -c classname -h hostname -i instance -n servlet_name [-p] [-s] -u username [-v]
htservlet delete -h hostname -i instance -n servlet_name [-p] -u username [-v]
htservlet disable -g option [-h hostname] -i instance [-p] -u username [-v]
htservlet enable -g option [-h hostname] -i instance [-p] -u username [-v]
htservlet help
htservlet list -h hostname -i instance [-v]
htservlet load -h hostname -i instance -n servlet_name [-p] -u username [-v]
htservlet log [-f prefix] [-h hostname] -i instance [-m max_num_files] [-p] [-t cycle_time] -u username [-v] [-z file_size]
htservlet reload [-a init_args] -h hostname -i instance -n servlet_name [-p] -u username [-v]
htservlet query -h hostname -i instance [-v]
htservlet security [-h hostname] -i instance [-o permission] [-p] [-r resource] -u username [-v]
htservlet settings [-d servlet_path] [-h hostname] -i instance [-j server_classpath] [-P properties_file] [-p] -u username [-v]
htservlet unload -h hostname -i instance -n servlet_name [-p] -u username [-v]
htservlet version

DESCRIPTION

A servlet engine can be defined on any Sun WebServer server instance or any individual web site. The servlet engine runs a Java^TM virtual machine that loads and executes servlets defined in its servlets.properties file.

The htservlet command defines and modifies servlet engine run time, security, and logging properties; adds or removes entries in the servlets.properties file; and loads or unloads servlets in running servlet engines.

When -h hostname is omitted, the subcommand applies to the shared servlet engine (server-wide setting).

OPTIONS

Subcommands

The following subcommands are supported:

---

Note -

You must restart the server in order for the changes made to the configuration files to take effect.

---

add

Adds a servlet to the servlets.properties file. Adding a servlet does not imply that the servlet is automatically loaded.

delete

Deletes a servlet from the servlet engine and writes changes to the servlets.properties file.

disable

Disables an option on the servlet engine and writes changes to the configuration file.

enable

Enables an option on the servlet engine and writes changes to the configuration file.

help

Displays help on usage.

list

Lists all loaded servlets on the server.

load

Loads a servlet from the servlets.properties file on a running server.

log

Configures the log location and cycling parameters and writes changes to the configuration file.

query

Returns current servlet engine settings on a running server.

reload

Reloads a servlet on a running server.

security

Configures the security settings for the servlet engine and writes changes to the configuration file.

settings

Specifies the settings on the servlet engine and writes changes to the configuration file.

unload

Unloads a servlet from the running web server.

version

Displays the version of htservlet.

Options

The following options are supported:

-a init_args

Specifies the optional initial arguments passed to the servlet. Used in the format name=value [[, name=value...]]. Valid with the add and reload subcommands.

-b codebase

Specifies the URL of the servlet's code base. This URL can be pointing to a directory or a jar file. Used only for remote servlets. Valid with the add subcommand.

-c classname

Specifies the name of the servlet main class file. Valid with the add subcommand.

-d servlet_path

Specifies the directories and jar files for the servlet engine on the local machine. This is a colon-separated list. This option can only prepend the path specified to the original path in the file. Valid with the settings subcommand.

-f prefix

The path name and the file prefix for servlet log files. As new log files are created, they use this prefix and a number suffix. Valid with the log subcommand.

-g option

Specifies a servlet engine option to enable or disable. Valid options are:

chain

Enables or disables servlet chaining. Servlet chains are a sequence of servlets executed in the specified order to fulfill one single servlet request.

jvm

Enables or disables the server to enable a jvm. This is a server-wide setting.

log

Enables or disables servlet error logging.

remote

Enables or disables loading servlets from remote sites in this servlet engine.

se

Enables or disables the servlet engine for server process or web site.

share

Allows all sites on the server to share a single servlet engine. This is a server-wide setting. If this option is disabled, each site is allowed to create its own servlet engine instance.

-h hostname

Specifies the name of the virtual host. Valid with all subcommands.

-i instance

The name of the server instance. Valid with all subcommands.

-j server_classpath

Specifies the class path for the jvm which may include the location of classes.zip file of JDK, JSDK, and the servlet engine. This is a colon separated list (for example, usr/lib/java/ [[:/usr/java/lib...]]). This command only prepends to the existing path. It is a server-level setting. Valid with the settings subcommand.

---

Note -

Do not put the servlets directories in the server classpath.

---

-m max_num_files

Specifies the maximum number of log files. When the log suffix exceeds this number, the next log file is created overwrites the first log file. The default number is 7 files. Valid with the log subcommand.

-n servlet_name

Specifies the name of the servlet. Valid with the add, delete, load, reload, and unload subcommands.

-o permission

Specifies the access settings used in conjunction with the -r option. Valid with the security subcommand.

all

Allows local and remote servlets to access resources.

local

Allows access only to resources on the same host.

none

Allows no access.

remote

Allows access only to resources on servlets with a code base.

-P properties_file

Specifies the full path to the properties file for the servlet engine. Valid with the settings subcommand.

-p

Disables password prompting, and password is piped ("|") to the command. Valid with the add, delete, disable, enable, load, log, reload, unload, security, and settings subcommands.

-r resource

Specifies the resource settings used in conjunction with the -o option for access control. Valid with the security subcommand.

file

Sets access permissions for file resources such as read/write a file on local disk.

link

Sets access permissions for links to dynamic libraries.

network

Sets access permissions for network resources.

security

Sets access permissions for security resources such as classLoaders.

system

Sets access permissions for system resources such as System.Exec ().

-s

Indicates that the servlet will be loaded at startup. Valid with the add subcommand.

-t cycle_time

The log cycle time measured in minutes. When the log cycle time exceeds this number, a new log file is created with an incremented suffix. The default time is 1440 minutes (1 day). Valid with the log subcommand.

-u username

Specifies user name. Valid with the add, delete, disable, enable, load, log, reload, unload, security, and settings subcommands.

-v

Specifies verbose mode for more detailed messages. Valid with all subcommands.

-z file_size

Specifies the maximum log file size measured in bytes. When the log file size exceeds this number of bytes, a new log file is created with an incremented suffix. The default file size is 1048576 bytes (1 MB). Valid with the log subcommand.

EXAMPLES

---

Example 1




To enable servlets on a server:

# htservlet enable -g jvm -i sws_server -u admin

---

---

Example 2




To load a declared servlets on a server:

# htservlet load -i sws_server -h www.A.com -n foo -u http

---

---

Example 3




To add servlets to be loaded at startup:

# htservlet add -i sws_server -h www.A.com -n foo \\
-c FooServlet -b http://x.eng/ -a counter=1 -s \\
-u http

---

---

Example 4




To add a servlet declaration (in verbose mode):

# htservlet add -i sws_server -h www.A.com -n foo \\
-c FooServlet -b http://x.eng/ -a counter=1 -v \\
-u http

---

---

Example 5




To set the server classpath:

# htservlet settings -i sws_server -j /usr/jdk/lib/classes/zip:. \\
-u http

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhtsvl
Interface Stability	Evolving

FILES

The following files are used by this utility:

site_path/conf/site_name.httpd.conf

Contains the web site servlet engine configuration if the servlet engine is not shared.

/etc/http/httpd.conf

Contains the server instance servlet engine configuration if all web sites share the servlet engine.

site_path/conf/servlets.properties

Defines each servlet that can be loaded by a web site.

SEE ALSO

httpd.conf(4), httpd.site.conf(4), servlets.properties(4)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

httpd(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES

NAME

/etc/init.d/httpd- Starts and stops servers.

SYNOPSIS

httpd help
httpd start
httpd stop

DESCRIPTION

Server instances can be started or stopped by using the htserver utility, through the Sun WebServer Administration Console, or by executing this script. It is recommended that you use htserver or the Sun WebServer Administration Console.

OPTIONS

The following subcommands are supported:

help

Displays help on usage.

start

Starts all "enabled" servers in httpd-instances.conf.

stop

Stops all servers.

-

-

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

SEE ALSO

htserver(1m)

NOTES

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES