Princeton University Standard Web Server Package

Your web server installation is complete.

The following is a short guide to getting started.

If you will be doing your own installation, you should read this. If you have hired a consultant to build your web site you will want them to read this information so they will know how to install your site for you.

You will want to replace this page with the first page of your application.

Getting Started

Your web server was created using a netid of pmc. To access the files on the server, log in to pmc.princeton.edu with this netid. Several files and directories have been created in your account (see InitialDoc/Files for a description).

When you login, enter one of the following:

If you don't know what shell you use, enter "echo $SHELL" to find out.
This will give you a set of aliases for some useful commands. A complete description of these aliases can be found in InitialDoc/Aliases.

The aliases are needed because the commands must be started with appropriate options for the configuration file location. This approach seemed easier than requiring you to remember to add the configuration options whenever you ran a command. To see the generated aliases enter 'alias'.

General Apache Info

Documentation on the care and feeding of your web service can be found in InitialDoc/Apache. This document will provide the information you need to make changes in the apache configuration.

To provide security, apache is run as your netid (pmc). This means you can remove group and other access on your files and directories to keep them secure from other users on the server. The site is delivered with the files set to 700 to take advantage of this.

To start or stop your apache server go to the user control panel. This will give you the status of your server and provides point and click access for starting or stopping. If there is nothing listed under the apache heading, then the server is not running.

MySql Database Server

Documentation on the care and feeding of your mysql database service can be found in InitialDoc/MySql. This document will provide the information you need to make changes in to the mysql configuration.

To provide security, MySql server is run as your netid (pmc). This means you can remove group and other access on the database files and directories to keep them secure from other users on the server. The site is delivered with the files set to 700 to take advantage of this but as you create new databases you may need to change their mode.

To start or stop your mysql database server go to the user control panel. This will give you the status of your server and provides point and click access for starting or stopping. If there is nothing listed under the mysqld heading, then the server is not running.

The configuration file used by your mysqld and the various mysql commands is found in ~/my.cnf You may make any configuration changes you need here.

The mysqld server is defined with a set of users and access privileges so that automated services can perform backup and phpMyAdmin can be functional. Please follow the rules described in the InitialDoc/MySql when making changes to these users.

A cron entry has been created to do nightly backups of your mysql databases. A more complete description of the backup processing can be found in InitialDoc/MySql.

Web Site Statistics

awstats provides a web based interface for getting statistics on your web server. See InitialDoc/Awstats for a complete description.

Samples Directory

oitexamples is a set of examples for doing standard things. There is a directory of cgi scripts, a directory of php scripts, and a directory showing how to do .htaccess files using ldap and pam. You will see nothing in the Authentication directory web listing but following one the following links to will cause you to be prompted for authentication information: