OpenCms

Installing OpenCms 6.0

1. Download and unzip opencms_6.0_beta_3.zip
   
   Note:
   The zip file contains 4 files: history.txt, install.html, license.txt and opencms.war
   
   
2. Deploy file opencms.war to your tomcat webapp directory.
   E.g.: C:\Tools\Tomcat 4.1\webapps
   
   
3. In a browser, type:
   
   http://localhost:8080/opencms/setup/index.jsp
   
   
4. Accept the terms of the license agreement and press continue button.
   
   
   
   
5. The setup checks if all required components are installed.
   Press continue button if no error messages are displayed.
   
   
   
   
6. Setup the database.
   
   
   
   

   Setting	Description
   Select Database	Select a database. You can choose the following: MySQL 3.2.x-4.0.x MySQL 4.1.x Oracle Postgres 7.4.x ANSI SQL-92 (Generic) MySQL configuration notes: MySQL limits the size of packets which can be stored in the database. In order to increase the maximum file size for OpenCms, you have to adjust this setting for MySQL. Locate the file mysql.ini (Windows systems) respectively mysql.conf (Unix systems) and add the line set-variable=max_allowed_packet=8M to increase the size e.g. to 8 MB. MySQL 3.2.x versions support packets up to 16 MB, MySQL versions 4.0.x are only limited by the amount of available memory on the server.
   Setup Connection	The Setup Connection is used only during this setup process. The specified user must have database administration permissions in order to create the database and tables. This user information is not stored after the setup is finished. For example: User=root Password=mysecret
   OpenCms Connection	The OpenCms Connection is used when running OpenCms after the installation. For security reasons, the specified user should not have database administration permissions. This user information is stored in the opencms.properties file after the setup. For example: User=root Password=myscecret
   Connection String	Enter the JDBC Connection String to your database. For example: Connection String=jdbc:mysql://localhost:3306/
   Database	Enter the name of the MySQL Database which should be used by OpenCms. For example: Database=opencms

   
   
   
7. The database "opencms" is created. Press continue button.
   
   Note: If for some reason you get error messages you need to drop the database
   (if created) before you start setup (http://localhost:8080/opencms/setup/index.jsp) over again.
   
   
   
   
8. Select modules for installation. Select which modules you want to install and press continue button.
   
   
   
   An overview of all the modules can be found below:
   
   
   • OpenCms 6.0 'templateone' XML content demo (0.9.11)
   • OpenCms 6.0 'templateone' demo content (0.9.8)
   • OpenCms 6.0 'templateone' frontend (0.9.7)
   • OpenCms 6.0 'templateone' modules (0.9.11)
   • OpenCms 6.0 'templateone' online input form (0.9.8)
   • OpenCms 6.0 Cache administration tools (0.9.0)
   • OpenCms 6.0 Compatibility settings for old modules (0.9.1)
   • OpenCms 6.0 Content management administration tools (0.9.5)
   • OpenCms 6.0 Documentation base (2.9.0)
   • OpenCms 6.0 File history administration tools (0.9.0)
   • OpenCms 6.0 Gallery overview administration tools (0.9.0)
   • OpenCms 6.0 HtmlArea WYSIWYG editor plugin (0.9.1)
   • OpenCms 6.0 Link management administration tools (1.0)
   • OpenCms 6.0 Scheduled Jobs Management (0.9.1)
   • OpenCms 6.0 Search index administration tools (0.9.0)
   • OpenCms 6.0 Static export administration tool (0.9.0)
   • OpenCms 6.0 User Management (0.9.1)
   • OpenCms 6.0 Welcome page and release notes (3.9.3)
   • OpenCms Flex cache documentation (2.9.0)
   • OpenCms JSP basic documentation (2.9.0)
   • OpenCms JSP example set 1 (2.9.0)
   • OpenCms JSP example set 2 (2.9.0)
   • OpenCms JSP example set 3 (2.9.0)
   • OpenCms JSP scriptlet documentation (2.9.0)
   • OpenCms JSP taglib documentation (2.9.0)
   • OpenCms JSP template howto (2.9.0)
   • OpenCms Multisite documentation (2.9.0)
   • OpenCms Original JSTL examples (2.9.0)
   • OpenCms Original Tomcat JSP examples (2.9.0)
   • OpenCms Workplace translation howto (2.9.0)
   • OpenCms XML content documentation (2.9.0)
   • OpenCms direct edit examples (2.9.0)
   • OpenCms module management documentation (2.9.0)
   • OpenCms search documentation (2.9.0)
   • OpenCms search examples (2.9.0)
   • OpenCms static export documentation and test data (2.9.0)
   • OpenCms with Apache http 2.0, Tomcat and mod_proxy configuration howto (2.9.0)
   
   Note: For this demo all modules have been selected.
   
   
9. OpenCms settings.
   
   
   
   

   Setting	Description
   Mac Address	Why the ethernet address is needed: OpenCms generates unique keys for all resources based on a 128-bit UUID (Universally Unique IDentifier, aka GUID in the Windows world) algorithm. To initialize this algorithm, the ethernet address of the server is required. However, Java has no way of accessing this information from the server hardware because of the sandbox security model. You can leave this field empty, and a random ethernet address will be generated for your OpenCms server. This means there is a very, very, very slight chance that someone else in the universe might create some duplicate keys. Please note: The ethernet (MAC) address is NOT the IP address of the server. A valid MAC ethernet address looks like this: 4f:a1:f1:c2:36:bf
   URL	The OpenCms site URL: OpenCms is capable of managing multiple sites. However, the OpenCms Workplace must always be accessed through one specific URL. The site URL you enter here will be used both as URL to access the Workplace, and as URL for the default site. In case you want to add other sites, or if you want to use different URLs for default site and Workplace, you must manually edit the opencms.properties file after the installation. For example: http://localhost:8080
   Servername	The server name: This server name will be used for various log messages in OpenCms. This can be handy if you have to compare logfiles from a couple of different servers. For example: OpenCmsServer
   Import	Importing the Workplace is required for an OpenCms installation. Do not change this setting unless you know exactly what you do! This imports all resources for the OpenCms Workplace in the virtual file system (VFS). A scenario where you might not want to import the Workplace is e.g. to connect a second server against an already initialized OpenCms database.

   
   
   
   
   
   
10. The workspace will be imported and will take approx 15 min. After this process is finished, press the continue button.
    
    
    
    
11. Read the browser configuration notes and press finish button.
    
    
    
    
12. The setup wizard will be locked (http://localhost:8080/opencms/setup/index.jsp) and the OpenCms welcome page (http://localhost:8080/opencms/opencms/index.jsp) will be displayed.
    
    Setup wizard will be locked
    
    
    
    Remark: To unlock the setup wizard:
    • Goto C:\Tools\Tomcat 4.1\webapps\opencms\WEB-INF\config
    • Edit file opencms.properties
    • Change wizard.enabled=true
    
    
    The OpenCms welcome page will be displayed
    
    
    
    
13. To access the OpenCms Workplace, type:
    
    http://localhost:8080/opencms/opencms/system/login/
    
    Username=Admin
    Password=admin
    
    
    
    
14. The Workplace is displayed.
    
    
    
    
15. For security reason you MUST change the Admin password:
    
    
    • Select on the toolbar "Preferences".
    • select tab "User Data".
    • Press button "Change Password"
    • Now change the Admin password.
      Current password=admin
      New password=cmssecret
      Confirm password=cmssecret