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! + + _______________________________________________ Zope-Checkins maillist - Zope-Checkins@zope.org http://mail.zope.org/mailman/listinfo/zope-checkins