Simple Installation

Requirements

• MySQL 4.1 or greater - http://dev.mysql.com
• Java 1.4.2 or greater - http://java.sun.com
• Tomcat 5 or greater - http://tomcat.apache.org
• Ant 1.6 or greater - http://ant.apache.org

Steps

1. Install all of the required applications listed above.
2. Download the war file: ROOT.war and deploy the file to Tomcat (use the Tomcat manager, or copy the file to the Tomcat 'webapps' directory and start or restart tomcat, which will expand the file into a new directory). The deployment target (the path to the new directory) will be referred to as $TAPOR_HOME hereafter.
3. Add user 'make-ant-easier' with password '$rR32_e%^qw~1pE' to mysql using the following statement:

   GRANT ALL ON *.* TO 'make-ant-easier'@'%'
   IDENTIFIED BY '$rR32_e%^qw~1pE' WITH GRANT OPTION;
   GRANT ALL ON *.* TO 'make-ant-easier'@'localhost' 
   IDENTIFIED BY '$rR32_e%^qw~1pE' WITH GRANT OPTION;
   GRANT ALL ON *.* TO 'make-ant-easier'@'localhost.localdomain' 
   IDENTIFIED BY '$rR32_e%^qw~1pE' WITH GRANT OPTION;
      

4. Run the ant build by invoking the following in a shell session (command prompt in Windows):

   ant -f $TAPOR_HOME/build-hibernate.xml create-tapor-database
   ant -f $TAPOR_HOME/build-hibernate.xml create-taporNews-database
   ant -f $TAPOR_HOME/build-hibernate.xml schema
   ant -f $TAPOR_HOME/build-hibernate.xml restore
   

5. Shutdown tomcat (shutdown.sh or shutdown.bat in the tomcat bin folder).
6. Download the files below to the directory from which Tomcat will be started. For example, in case Tomcat is started from /usr/local/Tomcat/bin, then these files should be copied to this directory:
   • OJB.properties
   • OJB-logging.properties

7. Edit the $TAPOR_HOME/sitemap.xmap. Two changes are needed:
   1. User Management - This change configures the portal to use a flat file to store user information, rather than an ldap server. If you wish to use an LDAP server, use the Advanced Install instructions.

      Find the following snippet

      <!--
      <map:match pattern="sunrise-authuser">
        <map:generate src="resources/sunrise-user.xml"/>
        <map:transform src="styles/authenticate.xsl">
         <map:parameter name="use-request-parameters" value="true"/>
      
        </map:transform>
        <map:serialize type="xml"/>
      </map:match>
      -->
           
      <map:match pattern="sunrise-authuser">
        <map:generate  src="cocoon:/ldapUsers"/>
        <map:transform src="styles/authenticate.xsl">
      
         <map:parameter name="use-request-parameters" value="true"/>
        </map:transform>
        <map:serialize type="xml"/>
      </map:match>
           

      Uncomment the first map:match statement and comment out the second, so that the result looks as follows:

      <map:match pattern="sunrise-authuser">
      
        <map:generate src="resources/sunrise-user.xml"/>
        <map:transform src="styles/authenticate.xsl">
         <map:parameter name="use-request-parameters" value="true"/>
        </map:transform>
        <map:serialize type="xml"/>
      </map:match>
      
           
      <!-- map:match pattern="sunrise-authuser">
        <map:generate  src="cocoon:/ldapUsers"/>
        <map:transform src="styles/authenticate.xsl">
         <map:parameter name="use-request-parameters" value="true"/>
        </map:transform>
        <map:serialize type="xml"/>
      
      </map:match -->
      

   2. Host Settings - Update your host settings. These are the lines you'll change:

      <siteRoot>localhost:8080</siteRoot>
      <host>localhost:8080</host>
      

      There are two general scenarios that dictate how you'll change the host settings:

      • Local Installation - If you are running the portal locally (you will only browse the portal using a web browser on the computer on which you install the portal) then you can most likely leave the setttings. You may have to change the port from 8080 if you've changed the port number on which your Tomcat server listens.
      • Network Accessible - If you will be allowing other computers to connect to the portal, other than the computer on which the portal is installed, then you will have to change the entry to include the dns name of the server (the name that a user would type into the browser to access your site). You may also have to change the port from 8080 if you've changed the port number on which your Tomcat server listens. For example,

        <siteRoot>openskysolutions.ca</siteRoot>
        <host>openskysolutions.ca</host>
        

        Note: this last example assumes the portal is listening on port 80, the default port, in which case the port number needn't be specified.
        
        Another example, if you are say using a router and only wish to serve to other computers in your local domain. In this case you specify the IP address of the computer on which you install the portal:

        <siteRoot>192.168.1.5:8080</siteRoot>
        <host>192.168.1.5:8080</host>
        

8. Start tomcat.