htIntro(1M)

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

NAME

htIntro- introduction to the man pages for 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:

access.conf

Configures a web site's access control lists (ACLs) . Located at site_path/conf/access.conf.

access.conf

Configures the server administration ACLs. Located at /etc/http/access.conf.

content.conf

Defines the content variants, encoding types, and directory preferences for a web site. Located at site_path/conf/content.conf.

httpd-instances.httpd.conf

Tracks all Sun WebServer instances. When htserver creates a new server instance, an entry is added to this file. Located at /etc/http/httpd-instances.httpd.conf.

site_name.site.conf

Contains the web site servlet engine configuration if the servlet engine is not shared. Located at site_path/conf/site_name.site.conf.

instance_name.httpd.conf

Defines the server instance's configuration. When hthost adds a new site, it creates an entry in httpd.conf to define the site_path and web site configuration file. Located at /etc/http/instance_name.httpd.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. Located at site_path/conf/map.conf.

realms.conf

Defines realms of user and group information used by access control lists on a Sun WebServer web site. Located at site_path/conf/realms.conf.

servlets.properties

Defines each servlet that can be loaded by a web site. Located at site_path/conf/servlets.properties.

SEE ALSO

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

NOTES

/usr/bin/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.

/usr/bin/htcontent

Create or deletes information about the content of resources on a web site. For directories, you can set whether they are available 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.

/usr/bin/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.

/usr/bin/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 GUI.

/usr/bin/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).

/usr/bin/htrealm

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

/usr/bin/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.

/usr/bin/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.

/usr/lib/httpd

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

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.1  Last Revised 22 February 1999

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