<commit_before><html>
    <head>
        <TITLE>Installation</TITLE>
    </head>
    <body>

<H2>Installation of OpenCms 6</H2>
This page provides 
information on how to install OpenCms using <A 
href="http://jakarta.apache.org/tomcat/index.html" target=extern>Tomcat</A> and 
<A href="http://www.mysql.com" target=extern>MySql</A>. All installation parts are described as single 
steps. After completing each step you are strongly advised to verify the success. 
<P></P>

        <p>
<P><STRONG>1. Install the Java JDK</STRONG></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Install Java JDK 1.4 or later (from SUN <code><A href="http://java.sun.com/products/j2se/" 
  target=extern 
 >http://java.sun.com/j2se/</A></code>). 
        For details on 
  how to install Java on your operating system, see the documentation that comes 
  with it. </P>
  <P><EM><STRONG>Important</STRONG> :</EM> This version of OpenCms was tested with Java 1.4 and 1.5
  only. Some features regarding file encoding where used that are not available 
  with Java releases before 1.4. </P></BLOCKQUOTE>
<P></P>
        
        <p>
<P><STRONG>2. Install Tomcat</STRONG></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>OpenCms 6 requires a Servlet 2.3 / JSP 1.2 standards compliant container. 
  Tomcat 4 is the reference implementation of this Standard. This release was 
  tested with Tomcat 4.1.x, Tomcat 5.0.x and Tomcat 5.5.x. Older versions of Tomcat (3.x and 
  earlier) do not support this newer standard and are thus not usable for 
  OpenCms 6. Tomcat 4.0 was not tested but may work.</P>
  <P></P>
        
        <p>
        Install Tomcat from
        <code><A 
  href="http://jakarta.apache.org/tomcat/index.html" 
  target=extern>http://jakarta.apache.org/tomcat/index.html</A></code>
        into a folder of your choice. This is the <code>CATALINA_HOME</code> folder. Don't forget to set the environment
        variables <code>CATALINA_HOME</code> and <code>JAVA_HOME</code>.
        </p>
        
        <p>
        Test the installation by running Tomcat in standalone 
  mode and check the examples. Note: Tomcat uses port 8080 in standalone mode. 
        If you wish, you can combine the servlet-engine with a webserver like the Apache Web Server 
        <code><A 
  href="http://httpd.apache.org/" 
  target=extern>http://httpd.apache.org/</A></code>. 
  Please see the documentation available with the webserver on how to combine 
        it with your servlet environment.
        </p>
        <p>
        <b><i>Please note:</i></b> There's an extended OpenCms documentation module available from Alkacon Software GmbH on the 
        opencms.org website that describes how to setup OpenCms with Apache httpd and Tomcat using mod_proxy.
        </p>
        <p>
        <b><i>Please note:</i></b> Older OpenCms Version required an environment setting for the Java file encoding 
        <code>-dfile.encoding=....</code> for OpenCms. This is NOT longer required with OpenCms 6.
        </p>        
</p>

</BLOCKQUOTE>
        <p></p><STRONG>3. Install MySQL</STRONG>
  <P></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Install MySQL from <code><A 
  href="http://www.mysql.com/downloads/index.html" 
  target=extern>http://www.mysql.com/downloads/index.html</A></code>
        (see the MySQL documentation on <code><A 
  href="http://www.mysql.com/documentation/index.html" 
  target=extern>http://www.mysql.com/documentation/index.html</A></code>
        ). On Windows-based systems MySQL has to be installed on the <code>C:\</code> drive
        and should be registered as service using <code>%MYSQL_HOME%/mysql/bin/mysqld -install</code>. </P>
        
        <p>
        Start the MySQL server by running the service (WIN32) or executing 
        <code>%MYSQL_HOME%/mysql/bin/mysqld</code> (UNIX).
        </p>
        
        <p>
        Check that MySQL is running before you continue by starting the MySQL monitor 
        (execute <code>mysql</code> in your MySQL bin folder).
        The database works correctly if a MySQL prompt appears after calling the monitor. 
        Quit the MySQL monitor by typing exit and go to the next step. 
        </p></BLOCKQUOTE>
        
        <p>
<P><STRONG>4. Deploy the opencms.war file</STRONG></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Copy the <code>opencms.war</code> file from the binary distribution ZIP file to <code>CATALINA_HOME/webapps/</code>. 
        Replace <code>CATALINA_HOME</code> with the real path to your Tomcat 
  installation. </P>
  <P>Start (or restart) Tomcat. Tomcat will now deploy the web application 
  OpenCms. </P>        
 
<P></P>
        
        <p><EM><STRONG>Important</STRONG>:</EM>
        OpenCms requires that it's <code>*.war</code> file is unpacked. 
  OpenCms can not be deployed as war file only. Make sure Tomcat does unpack the 
  war file and creates the <CODE>CATALINA_HOME/webapps/opencms/</CODE>
                
            directory, placing the OpenCms files in this directory.
        The default configuration for your Servlet containers / environment 
        could be to not unpack the deployed <code>*.war</code> file. 
        If this is so, you must unpack the opencms.war file manually.
        Use an unzip tool for this, <code>*.war</code> files are just <code>*.zip</code> files with a different extension. The OpenCms 
  setup wizard will display a warning and not allow you to continue if you did 
  not unpack the&nbsp; <CODE>*.war</CODE> file.&nbsp;
        </p></BLOCKQUOTE>
        
        <p>
<P><STRONG>5. Install OpenCms using the Setup-Wizard</STRONG></P>
<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Start the Setup-Wizard by pointing your webbrowser to 
        <code>http://localhost:8080/opencms/setup/</code>. 
  Depending on your configuration, you have to replace <code>localhost</code> with your 
  servername. The port 8080 is only used if you start Tomcat in standalone mode. 
  </P>
        
        <p>
        Follow the instructions of
        the OpenCms Setup-Wizard. 
  It will set up the OpenCms database and import all workplace resources
        into the system. For a normal installations with MySql and Tomcat running on the same server,
        the default settings will fit your needs.
        </p>
        
        <p>
        <b><i>Important:</i></b> Make sure you disable all popup blockers for the server URL
        you installed OpenCms on. Otherwise you will not be able to log in to the OpenCms workplace.
        </p>
        
</BLOCKQUOTE>
        
        <p>
<P><STRONG>6. Now your OpenCms system is ready</STRONG></P>
<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Now your OpenCms system is ready to use. You can login with username: <code>Admin</code> and password: <code><PASSWORD></code>. Please change this password 
        as soon as possible. The login URL of OpenCms in a default configuration is:
        <code>http://localhost:8080/opencms/opencms/system/login/</code> 
        
  </P></BLOCKQUOTE> 
<P></P>
<P><STRONG>7. Security issues</STRONG></P>
<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>Finally after you have installed OpenCms you should have a look at the 
  security settings. </P>
  <P>              First change
        the <code>Admin</code> user password of <commit_msg>Added note for BSD users about setting up new entropy sources<commit_after><html>
    <head>
        <TITLE>Installation</TITLE>
    </head>
    <body>

<H2>Installation of OpenCms 6</H2>
This page provides 
information on how to install OpenCms using <A 
href="http://jakarta.apache.org/tomcat/index.html" target=extern>Tomcat</A> and 
<A href="http://www.mysql.com" target=extern>MySql</A>. All installation parts are described as single 
steps. After completing each step you are strongly advised to verify the success. 
<P></P>

        <p>
<P><STRONG>1. Install the Java JDK</STRONG></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Install Java JDK 1.4 or later (from SUN <code><A href="http://java.sun.com/products/j2se/" 
  target=extern 
 >http://java.sun.com/j2se/</A></code>). 
        For details on 
  how to install Java on your operating system, see the documentation that comes 
  with it. </P>
  <P><EM><STRONG>Important</STRONG> :</EM> This version of OpenCms was tested with Java 1.4 and 1.5
  only. Some features regarding file encoding where used that are not available 
  with Java releases before 1.4. </P></BLOCKQUOTE>
<P></P>
        
        <p>
<P><STRONG>2. Install Tomcat</STRONG></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>OpenCms 6 requires a Servlet 2.3 / JSP 1.2 standards compliant container. 
  Tomcat 4 is the reference implementation of this Standard. This release was 
  tested with Tomcat 4.1.x, Tomcat 5.0.x and Tomcat 5.5.x. Older versions of Tomcat (3.x and 
  earlier) do not support this newer standard and are thus not usable for 
  OpenCms 6. Tomcat 4.0 was not tested but may work.</P>
  <P></P>
        
        <p>
        Install Tomcat from
        <code><A 
  href="http://jakarta.apache.org/tomcat/index.html" 
  target=extern>http://jakarta.apache.org/tomcat/index.html</A></code>
        into a folder of your choice. This is the <code>CATALINA_HOME</code> folder. Don't forget to set the environment
        variables <code>CATALINA_HOME</code> and <code>JAVA_HOME</code>.
        </p>
        
        <p>
        Test the installation by running Tomcat in standalone 
  mode and check the examples. Note: Tomcat uses port 8080 in standalone mode. 
        If you wish, you can combine the servlet-engine with a webserver like the Apache Web Server 
        <code><A 
  href="http://httpd.apache.org/" 
  target=extern>http://httpd.apache.org/</A></code>. 
  Please see the documentation available with the webserver on how to combine 
        it with your servlet environment.
        </p>
        <p>
        <b><i>Please note:</i></b> There's an extended OpenCms documentation module available from Alkacon Software GmbH on the 
        opencms.org website that describes how to setup OpenCms with Apache httpd and Tomcat using mod_proxy.
        </p>
        <p>
        <b><i>Please note:</i></b> Older OpenCms Version required an environment setting for the Java file encoding 
        <code>-dfile.encoding=....</code> for OpenCms. This is NOT longer required with OpenCms 6.
        </p>        
</p>

</BLOCKQUOTE>
        <p></p><STRONG>3. Install MySQL</STRONG>
  <P></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Install MySQL from <code><A 
  href="http://www.mysql.com/downloads/index.html" 
  target=extern>http://www.mysql.com/downloads/index.html</A></code>
        (see the MySQL documentation on <code><A 
  href="http://www.mysql.com/documentation/index.html" 
  target=extern>http://www.mysql.com/documentation/index.html</A></code>
        ). On Windows-based systems MySQL has to be installed on the <code>C:\</code> drive
        and should be registered as service using <code>%MYSQL_HOME%/mysql/bin/mysqld -install</code>. </P>
        
        <p>
        Start the MySQL server by running the service (WIN32) or executing 
        <code>%MYSQL_HOME%/mysql/bin/mysqld</code> (UNIX).
        </p>
        
        <p>
        Check that MySQL is running before you continue by starting the MySQL monitor 
        (execute <code>mysql</code> in your MySQL bin folder).
        The database works correctly if a MySQL prompt appears after calling the monitor. 
        Quit the MySQL monitor by typing exit and go to the next step. 
        </p></BLOCKQUOTE>
        
        <p>
<P><STRONG>4. Deploy the opencms.war file</STRONG></P>

<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Copy the <code>opencms.war</code> file from the binary distribution ZIP file to <code>CATALINA_HOME/webapps/</code>. 
        Replace <code>CATALINA_HOME</code> with the real path to your Tomcat 
  installation. </P>
  <P>Start (or restart) Tomcat. Tomcat will now deploy the web application 
  OpenCms. </P>        
 
<P></P>
        
        <p><EM><STRONG>Important</STRONG>:</EM>
        OpenCms requires that it's <code>*.war</code> file is unpacked. 
  OpenCms can not be deployed as war file only. Make sure Tomcat does unpack the 
  war file and creates the <CODE>CATALINA_HOME/webapps/opencms/</CODE>
                
            directory, placing the OpenCms files in this directory.
        The default configuration for your Servlet containers / environment 
        could be to not unpack the deployed <code>*.war</code> file. 
        If this is so, you must unpack the opencms.war file manually.
        Use an unzip tool for this, <code>*.war</code> files are just <code>*.zip</code> files with a different extension. The OpenCms 
  setup wizard will display a warning and not allow you to continue if you did 
  not unpack the&nbsp; <CODE>*.war</CODE> file.&nbsp;
        </p></BLOCKQUOTE>
        
        <p>
<P><STRONG>5. Install OpenCms using the Setup-Wizard</STRONG></P>
<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Start the Setup-Wizard by pointing your webbrowser to 
        <code>http://localhost:8080/opencms/setup/</code>. 
  Depending on your configuration, you have to replace <code>localhost</code> with your 
  servername. The port 8080 is only used if you start Tomcat in standalone mode. 
  </P>
        
        <p>
        Follow the instructions of
        the OpenCms Setup-Wizard. 
  It will set up the OpenCms database and import all workplace resources
        into the system. For a normal installations with MySql and Tomcat running on the same server,
        the default settings will fit your needs.
        </p>
        
        <p>
        <b><i>Important:</i></b> Make sure you disable all popup blockers for the server URL
        you installed OpenCms on. Otherwise you will not be able to log in to the OpenCms workplace.
        </p>
        <p>
        <i>Note:</i> FreeBSD users need to setup new entropy sources in the O/S using rndcontrol. Otherwise the installation process will hang on
step_8_import_workplace.jsp while the O/S waits for an entropy source. For example, on a machine with a network interface card on IRQs 9, you can execute
        </p>
        <p>
        <code>rndcontrol -s 9<code>
        </p>
        
</BLOCKQUOTE>
        
        <p>
<P><STRONG>6. Now your OpenCms system is ready</STRONG></P>
<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>
        Now your OpenCms system is ready to use. You can login with username: <code>Admin</code> and password: <code><PASSWORD></code>. Please change this password 
        as soon as possible. The login URL of OpenCms in a default configuration is:
        <code>http://localhost:8080/opencms/opencms/system/login/</code> 
        
  </P></BLOCKQUOTE> 
<P></P>
<P><STRONG>7. Security issues</STRONG></P>
<BLOCKQUOTE dir=ltr style="MARGIN-RIGHT: 0px">
  <P>Finally after you have installed OpenCms you should have a look at the 
  security settings. </P>
  <P>              First change
        the <code>Admin</code> user password of 
{'fraction_non_alphanumeric': 0.10926803580832017, 'fraction_numerical': 0.008359662980516061, 'mean_word_length': 2.7173966234401763, 'pattern_counts': {'":': 0, '<': 401, '<?xml version=': 0, '>': 401, 'https://': 0, 'lorem ipsum': 0, 'www.': 10, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1589283', 'n_tokens_mistral': 4905, 'n_tokens_neox': 4582, 'n_words': 1675}