Troubleshooting Open CMS Installation
From TroubleshootingWiki
| Official Page |
| Project Documentation |
| Download |
|
Not all installations go flawlessly. In this section, we will look at the most common installation problems and see how to fix them. Additionally, the OpenCms website particularly the developers' mailing-list archives is a good resource for troubleshooting information.
Contents |
[edit] Crashes During Module Installation
Occasionally, some browsers will hang (stop responding) during the lengthy module installation process. If this occurs, do not close the browser. Wait for twenty minutes (ample time for the process to complete) and then see if the browser will respond. You can often find out whether the installation is complete by checking the server's resources.
If Java and MySQL are consuming significant CPU and memory resources, then the installation is still in progress.
Often the browser will regain consciousness after the install completes. You may need to hit the Reload button if the Continue button does not become active, but usually that is not required.
If the browser will not respond, you may have to restart the browser and try again (from the beginning of the web-based installation).
[edit] Restarting Tomcat versus Reloading OpenCms
Tomcat includes an application for reloading individual servlets without restarting Tomcat. However, it is unclear whether all of the OpenCms classes are garbage‑collected. Many users have reported on the opencms-dev list that simply reloading the OpenCms servlet causes strange errors, so it is always best to restart Tomcat rather than reload the individual servlet.
[edit] MySQL User/Password Changes
If you change the username or password for the MySQL database user that OpenCms uses, you will need to edit the following file:
$CATALINA_HOME/webapps/opencms/WEB-INF/config/opencms.properties
Change the value for the pool.default.user and pool.default.password variables, and restart Tomcat after saving your changes.
[edit] Finding More Installation Help
For more help on installation issues, try the OpenCms developers' mailing list and archives available at: http://www.opencms.org/opencms/en/development/mailinglist.html
[edit] Additional Reference
- For instructions in Accelerating Template Development in OpenCMS 7, click here.
- For instructions on Installing OpenCMS, click here
- For instructions on Developing Templates in OpenCMS 7, click here
- For instructions on Customizing OpenCms Site, click here
- For instructions on Building OpenCMS 7, click here
- For instructions on Installing Open Source CMS, click [http://www.installationwiki.org/Installing_Open_Source_CMS here
[edit] Source
The source of this content is Chapter 2: Installing OpenCms of Managing and Customizing OpenCms 6 Websites by Matt Butcher (Packt Publishing, 2006).
Categories: Open Source | PHP | Java
