added install faq

doc/FAQ.txt

+Zope Installation Frequently Asked Questions
+--------------------------------------------
+
+  Starting/Accessing your Zope installation
+
+    1. After installing Zope, I go to the URL in my web browser
+       but I get a "404 Not Found" or "Server Error" message
+
+       This message is coming from your web server, not Zope.
+       It usually means that your web server is misconfigured.
+       Ensure that the PCGI info file generated by the installation
+       procedure exists in a cgi-enabled directory, and that your
+       web server has any required aliases or configuration options
+       set to enable it to find this file and run it as a cgi program.
+
+       Look in the error log for your web server for details of the error.
+
+
+    2. I have installed Zope, and when I go to the URL in my web
+       browser, I get a password prompt. Although I type in the correct
+       username and password, I keep getting prompted. What is going on?
+
+       Zope manages access control internally, but it relies on your
+       web server software to relay any authentication information in
+       web requests. Some web servers automatically filter this information
+       out of requests passed to cgi programs. If you keep getting password
+       prompts that never accept your password, this means that your web
+       server is not properly configured to pass authentication info on to
+       Zope. See the file WEBVSERVER.txt for information on correctly
+       configuring your web server to pass authentication information.
+
+
+    3. I have installed Zope, and when I go to the URL in my web
+       browser, I get a screen that says "Temporarily Unavailable".
+
+       Try the URL again - if you still get "Temporarily Unavailable",
+       this means that your PCGI resource file was unable to start
+       the Zope process. This usually means either an error in the
+       PCGI resource file, or a problem with your Zope installation
+       such as incorrect permissions on certain directories.
+
+       You should always run the install script (as root!!) to ensure
+       that a correct PCGI resource file is generated. If you have changed
+       this file by hand, ensure that all of the pathnames in the file
+       are valid and that there are no typos.
+
+       The install script should also ensure correct ownership and permissions
+       on files and directories in your Zope installation. The var
+       subdirectory of your installation and everything therein MUST be 
+       writable by the user which runs cgi scripts on your web server 
+       (usually nobody if you are using PCGI, usually your userid if you
+       are using ZopeHTTPServer)
+       
+       If you have ensured that the PCGI info file is correct and that all
+       permissions are correct, you can look in the /var/tmp directory of
+       your machine for files with names like "pcgi.110407". If PCGI fails
+       to start the Zope process, it will attempt to write a file
+       named pcgi.HHMMSS to /var/tmp containing information which may be
+       useful in determining the error.
+
+       On Windows NT platforms, check the event log under "Application Log"
+       for error information.
+
+       Additionally, if you receive a "Temporarily Unavailable", look at 
+       the document source for an HTML comment with error information.
+       
+
+    4. When I go to a URL for an application that isn't running, it
+       takes quite a while to startup.  Why is that?
+
+       The *PCGI wrapper*, which is the executable run as a CGI script
+       on every request, has quite a bit of thinking to do.  First, it
+       has to see if the app is already running.  If not, it has to see 
+       if any other PCGI wrappers have already started the app.  It is
+       this latter part where some of the delay presents itself.
+
+       Next, the application itself has to get into memory and then get 
+       the database loaded.  Depending on database file size, this might
+       take a while. Packing your Zope database at regular intervals
+       can reduce startup time.
+
+
+    5. I have Zope with Aqueduct Oracle installed, and cant get
+       running. Why?
+
+       If you have Aqueduct Oracle installed, you need to ensure that
+       the environment variable "ORACLE_HOME" is in the environment of
+       the running application. You can do this by adding a line to 
+       your PCGI resource file such as: ORACLE_HOME=/usr/bin/oracle
+
+       Any NAME=VALUE pairs appended to the PCGI resource file will
+       be added to the environment of the process when it is started
+       by PCGI.
+
+
+
+  Managing the Zope process
+
+
+    1. How do I find the application server in my process listing?
+
+       Under Unix, the Zope application will be running as a
+       process entry starting with 'pricipia-p'.  The process ID is
+       recorded in 'var/Main.pid'.
+
+
+    2. If I have more than one Zope process running on the same
+       machine, how do I tell them apart in "ps" listings?
+
+       Currently, all running Zope processes will show up in ps
+       listings as something like "principia -p". The actual
+       Zope executable is in the bin subdirectory of your 
+       installation. You can rename the executable to something more
+       useful in ps listings if you wish. YOU MUST, however edit your
+       PCGI resource file to ensure that the SOFTWARE_EXE line points
+       to the new name of your executable.
+
+
+    3. What files are used by the object database?
+
+       The state of the application is stored in files in the 'var'
+       subdirectory inside the installation.  There are several files
+       that are used:
+
+         o Data.bbb -- Primary database file
+
+         o Data.bbb.index -- File created on shutdown to speed startup
+           for large databases
+
+         o Data.trans -- Used to store information in unsaved sessions
+           and unapproved work in draft folders
+
+         o Data.trans.index -- File created on shutdown to speed
+           startup for large transaction databases
+
+       Other files in the 'var' directory are associated with each
+       process and are only temporary.       
+
+
+    4. Is it OK to use 'kill' to shutdown the process?
+
+       It is best to shutdown the process using the Shutdown button in
+       the Control Panel. Alternatively, the URL:
+       'Control_Panel/manage_shutdown'
+       will, with a suitable username and password, shutdown the
+       application. If you need a non-interactive way to shutdown your
+       application, e.g. from a script, then write a program that sends
+       a web request to that URL with the appropriate username and
+       password.
+
+       If you must, you can shutdown the application by killing it.
+       This can have negative side effects and is not supported.
+
+
+  General
+
+
+    1. My browser is giving a message of 'Sorry, an error occurred.'
+       How do I find out the error?
+
+       Step number one in these scenarios is to view the HTML source of 
+       the frame containing the error. In general, the *traceback* of
+       the error message is enclosed in an HTML comment. This
+       traceback explains the error message.
+
+       Occassionally you won't see the error message. Rather, the HTML 
+       source will contain the last good HTML returned by the request
+       before the error occurred. This is due to caching by the
+       browser. Clear your cache and view the HTML source again.
+
+