[Zope-Checkins] SVN: Zope/trunk/doc/ The FAQs are of low value

Andreas Jung andreas at andreas-jung.com
Fri Feb 20 10:45:55 EST 2009


Log message for revision 96836:
  The FAQs are of low value
  

Changed:
  D   Zope/trunk/doc/FAQ.txt
  A   Zope/trunk/doc/obsolete/FAQ.txt

-=-
Deleted: Zope/trunk/doc/FAQ.txt
===================================================================
--- Zope/trunk/doc/FAQ.txt	2009-02-20 15:45:12 UTC (rev 96835)
+++ Zope/trunk/doc/FAQ.txt	2009-02-20 15:45:55 UTC (rev 96836)
@@ -1,210 +0,0 @@
-Zope Installation Frequently Asked Questions
---------------------------------------------
-
-  Installing Zope
-
-    1. On certain Unix platforms (usually Solaris) I get a "checksum 
-       error" untarring the Zope distribution. Whats the deal?
-
-       Zope is built and distributed using GNU tar. Some vendor-supplied
-       tar implementations have problems with long path names as they 
-       appear in GNU tar created files. This is a problem that occurs in 
-       a number of software distributions created using GNU tar, not just 
-       Zope. We suggest that you install a GNU tar on your system to 
-       avoid this problem (not just with Zope, but with other software 
-       distributions as well).
-
-    2. I am trying to build Zope on my BSD based system, but I
-       keep getting "symbol not found" errors and the build
-       scripts stop. What do I do?
-
-       On some BSD based systems (BSDI, BSD/OS), you need to edit
-       the Makefile.pre.in files in your Zope installation to add
-       -rdynamic to the LDSHARED makefile variable. On some systems
-       it may also be necessary to change the file named 'do.py'
-       located in the 'inst' directory of your Zope installation,
-       changing the line: do('make')  to: do('make -k').
-
-    3. I am having trouble building Zope on my OpenBSD system.  I get
-       some weird compilation errors.
-
-       Make sure you unpack Zope using GNU tar; you will not get any
-       error messages with OpenBSD's standard tar, but your installation
-       will be subtly broken due to problems with long path names.
-
-    4. I am having trouble building Zope on a libc 5 Linux machine.
-    
-       Zope requires Python be built with glibc 2.x (libc 6) on Linux.
-
-    5. I am trying to install Zope on a Windows NT/2000 machine, but
-       I keep getting a dialog saying "corrupt installation detected".
-       Is something wrong with the distribution file?
-
-       No, to install Windows NT / 2000 you should be logged in with 
-       "Administrator" privileges on the machine. If you are seeing
-       the "corrupt installation detected" dialog, you probably don't
-       have the required administrator privileges (your guess is as
-       good as ours as to why you get that particular error message).
-
-
-  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
-
-       Is the URL really correct? Are you running Zope behind another
-       web server?  If so, this message is coming from your web server, 
-       not Zope.  It usually means that your web server is misconfigured.
-
-       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?
-
-       Are you running another web server in front of Zope?
-       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 doc/WEBVSERVER.txt file 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 "Connection refused" error.
-
-       Probably this means that Zope has failed to start.  You should try 
-       to start Zope in the foreground and look for error messages.
-
-       You can do this by giving the command "./bin/zopectl fg" in your
-       Zope instance. If there are errors, the last error shown should
-       explain what went wrong.
-
-    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 application 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 forgotten the only password used to access the site or
-       I have modified the security settings in such a way that even
-       I can't get access.  How do I fix it?
-
-       Assuming you have write access to the directory where Zope is
-       installed, you can create a temporary "emergency user" using
-       the 'zpasswd.py' script::
-
-           python bin/zpasswd.py access
-
-       Follow the prompts to enter a user name and password.
-       'zpasswd.py' will write the file named 'access'.  Zope will
-       look for this file the next time it starts.  After restarting,
-       browse to Zope's management interface and use the name and
-       password you entered.
-
-       As the emergency user, you are allowed to create user folders
-       and user accounts as well as adjust security settings but you
-       are not allowed to create objects like folders. This is a
-       safety precaution.
-
-       See more details in the file SECURITY.TXT.
-
-  Managing the Zope process
-
-    1. How do I find the application server in my process listing?
-
-       When running Zope, there will be a .pid file in var/Z2.pid
-       which contains two process IDs.
-
-    2. If I have more than one Zope process running on the same
-       machine, how do I tell them apart in "ps" listings?
-
-       When running under ZServer, the Zope processes will show up in
-       the listings with 'run.py'.  (You may need to do a long listing
-       to see it.)  Look for the pids listed in var/Z2.pid. 
-
-    3. Is it OK to use 'kill' to shut down the process?
-
-       If you started zope with the command "zopectl start", the command
-       "zopectl stop" will shut down Zope.
-
-       You can also shut down 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 shut down the application by killing it.
-       The respective var/Z2.pid file will have the pids.
-
-
-  Upgrading from Earlier Versions of Zope
-
-    1. How can I upgrade to the latest Zope 2 version?
-
-       The usual procedure when installing a new version of Zope is:
-
-       - Create a new environment (see doc/INSTALL.txt).
-
-       - Include your application code in the environment.
-
-       - Copy your database files, (often var/Data.fs) from your old
-         environment into your new environment's var/ directory.
-         Only do this while the old database files are not in use.
- 
-       - Update etc/zope.conf with any changes you made in your
-         old environment.
-
-       - Start the new application process. (Be sure the old process
-         is not running.)
-
-    2. CMF doesn't work!
-
-        Check that you have a recent stable version of CMF.
-        CMF is available at http://www.zope.org/Products/CMF/
-
-    3. Plone doesn't work!
-
-        All Plone versions require a certain Zope version.
-        Check the Plone release informations on http://www.plone.org
-
-
-  General
-
-    1. My browser is giving a message, 'Sorry, an error occurred.'
-       How do I find out what the real error is?
-
-       Step number one in these scenarios is to check the error log
-       on your server. The standard error page should provide you with a 
-       link directly to the log entry for that error.
-
-       If something has gone wrong with the standard error page itself, 
-       or if you are using a modified error page, this link may be 
-       missing. If this happens, you can visit /event_log/manage_main and 
-       browse the recent errors.
-
-       In general, error_log will show the *traceback* for errors.
-       This traceback explains the error message. 
-
-       Occasionally you won't see any 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.
-
-    2. I'm using Python 2.x and I'm having a problem ...
-
-       The correct version of Python should always be automatically detected
-       and used when you configure and install Zope. In general, you 
-       should let the configure script do its job and don't try to 
-       force an unsupported version of Python!
-
-

Copied: Zope/trunk/doc/obsolete/FAQ.txt (from rev 96821, Zope/trunk/doc/FAQ.txt)
===================================================================
--- Zope/trunk/doc/obsolete/FAQ.txt	                        (rev 0)
+++ Zope/trunk/doc/obsolete/FAQ.txt	2009-02-20 15:45:55 UTC (rev 96836)
@@ -0,0 +1,210 @@
+Zope Installation Frequently Asked Questions
+--------------------------------------------
+
+  Installing Zope
+
+    1. On certain Unix platforms (usually Solaris) I get a "checksum 
+       error" untarring the Zope distribution. Whats the deal?
+
+       Zope is built and distributed using GNU tar. Some vendor-supplied
+       tar implementations have problems with long path names as they 
+       appear in GNU tar created files. This is a problem that occurs in 
+       a number of software distributions created using GNU tar, not just 
+       Zope. We suggest that you install a GNU tar on your system to 
+       avoid this problem (not just with Zope, but with other software 
+       distributions as well).
+
+    2. I am trying to build Zope on my BSD based system, but I
+       keep getting "symbol not found" errors and the build
+       scripts stop. What do I do?
+
+       On some BSD based systems (BSDI, BSD/OS), you need to edit
+       the Makefile.pre.in files in your Zope installation to add
+       -rdynamic to the LDSHARED makefile variable. On some systems
+       it may also be necessary to change the file named 'do.py'
+       located in the 'inst' directory of your Zope installation,
+       changing the line: do('make')  to: do('make -k').
+
+    3. I am having trouble building Zope on my OpenBSD system.  I get
+       some weird compilation errors.
+
+       Make sure you unpack Zope using GNU tar; you will not get any
+       error messages with OpenBSD's standard tar, but your installation
+       will be subtly broken due to problems with long path names.
+
+    4. I am having trouble building Zope on a libc 5 Linux machine.
+    
+       Zope requires Python be built with glibc 2.x (libc 6) on Linux.
+
+    5. I am trying to install Zope on a Windows NT/2000 machine, but
+       I keep getting a dialog saying "corrupt installation detected".
+       Is something wrong with the distribution file?
+
+       No, to install Windows NT / 2000 you should be logged in with 
+       "Administrator" privileges on the machine. If you are seeing
+       the "corrupt installation detected" dialog, you probably don't
+       have the required administrator privileges (your guess is as
+       good as ours as to why you get that particular error message).
+
+
+  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
+
+       Is the URL really correct? Are you running Zope behind another
+       web server?  If so, this message is coming from your web server, 
+       not Zope.  It usually means that your web server is misconfigured.
+
+       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?
+
+       Are you running another web server in front of Zope?
+       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 doc/WEBVSERVER.txt file 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 "Connection refused" error.
+
+       Probably this means that Zope has failed to start.  You should try 
+       to start Zope in the foreground and look for error messages.
+
+       You can do this by giving the command "./bin/zopectl fg" in your
+       Zope instance. If there are errors, the last error shown should
+       explain what went wrong.
+
+    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 application 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 forgotten the only password used to access the site or
+       I have modified the security settings in such a way that even
+       I can't get access.  How do I fix it?
+
+       Assuming you have write access to the directory where Zope is
+       installed, you can create a temporary "emergency user" using
+       the 'zpasswd.py' script::
+
+           python bin/zpasswd.py access
+
+       Follow the prompts to enter a user name and password.
+       'zpasswd.py' will write the file named 'access'.  Zope will
+       look for this file the next time it starts.  After restarting,
+       browse to Zope's management interface and use the name and
+       password you entered.
+
+       As the emergency user, you are allowed to create user folders
+       and user accounts as well as adjust security settings but you
+       are not allowed to create objects like folders. This is a
+       safety precaution.
+
+       See more details in the file SECURITY.TXT.
+
+  Managing the Zope process
+
+    1. How do I find the application server in my process listing?
+
+       When running Zope, there will be a .pid file in var/Z2.pid
+       which contains two process IDs.
+
+    2. If I have more than one Zope process running on the same
+       machine, how do I tell them apart in "ps" listings?
+
+       When running under ZServer, the Zope processes will show up in
+       the listings with 'run.py'.  (You may need to do a long listing
+       to see it.)  Look for the pids listed in var/Z2.pid. 
+
+    3. Is it OK to use 'kill' to shut down the process?
+
+       If you started zope with the command "zopectl start", the command
+       "zopectl stop" will shut down Zope.
+
+       You can also shut down 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 shut down the application by killing it.
+       The respective var/Z2.pid file will have the pids.
+
+
+  Upgrading from Earlier Versions of Zope
+
+    1. How can I upgrade to the latest Zope 2 version?
+
+       The usual procedure when installing a new version of Zope is:
+
+       - Create a new environment (see doc/INSTALL.txt).
+
+       - Include your application code in the environment.
+
+       - Copy your database files, (often var/Data.fs) from your old
+         environment into your new environment's var/ directory.
+         Only do this while the old database files are not in use.
+ 
+       - Update etc/zope.conf with any changes you made in your
+         old environment.
+
+       - Start the new application process. (Be sure the old process
+         is not running.)
+
+    2. CMF doesn't work!
+
+        Check that you have a recent stable version of CMF.
+        CMF is available at http://www.zope.org/Products/CMF/
+
+    3. Plone doesn't work!
+
+        All Plone versions require a certain Zope version.
+        Check the Plone release informations on http://www.plone.org
+
+
+  General
+
+    1. My browser is giving a message, 'Sorry, an error occurred.'
+       How do I find out what the real error is?
+
+       Step number one in these scenarios is to check the error log
+       on your server. The standard error page should provide you with a 
+       link directly to the log entry for that error.
+
+       If something has gone wrong with the standard error page itself, 
+       or if you are using a modified error page, this link may be 
+       missing. If this happens, you can visit /event_log/manage_main and 
+       browse the recent errors.
+
+       In general, error_log will show the *traceback* for errors.
+       This traceback explains the error message. 
+
+       Occasionally you won't see any 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.
+
+    2. I'm using Python 2.x and I'm having a problem ...
+
+       The correct version of Python should always be automatically detected
+       and used when you configure and install Zope. In general, you 
+       should let the configure script do its job and don't try to 
+       force an unsupported version of Python!
+
+



More information about the Zope-Checkins mailing list