Advanced 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
• OpenLDAP - http://www.openldap.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'@'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 restore-tools-all
           

5. Shutdown tomcat (shutdown.sh or shutdown.bat in the tomcat bin folder).
6. Set up the following LDAP Schema. Refer to your LDAP instructions for help. If you'd rather use a flat file for user management, please use the Simple Portal Install instructions.

   dn: dc=openskysolutions,dc=ca
   objectclass: dcObject
   objectclass: organization
   o: open sky solutions
   dc: openskysolutions
   
   dn: o=openskysolutions,dc=openskysolutions,dc=ca
   objectclass: top
   objectclass: organization
   o: openskysolutions 
   
   dn: ou=tapor,o=openskysolutions,dc=openskysolutions,dc=ca
   objectclass: top
   objectclass: organizationalUnit
   ou: tapor
   
   dn: ou=taporUsers,ou=tapor,o=openskysolutions,dc=openskysolutions,dc=ca
   objectclass: top
   objectclass: organizationalUnit
   ou: taporUsers
   
   dn: cn=anonymous,ou=taporUsers,ou=tapor,o=openskysolutions,dc=openskysolutions,dc=ca
   taporUserId: anonymous
   taporFullName: anonymous
   taporRole: guest
   taporPassword: anonymous
   objectClass: taporUser
   sn: anonymous
   cn: anonymous
   

7. Edit the $TAPOR_HOME/sitemap.xmap. Two changes are needed:
   1. User Management - Update the LDAP settings. Find the following lines and modify appropriately:
      
      

      <ldapinitializer>com.sun.jndi.ldap.LdapCtxFactory</ldapinitializer>
      <ldaphost>locahost</ldaphost>
      <ldapport>389</ldapport>
      
      <ldappassword>PASS</ldappassword>
      <ldapauthentication>simple</ldapauthentication>
      <ldapversion>3</ldapversion>
      <ldapsearchbase>dc=openskysolutions,dc=ca</ldapsearchbase>
      <ldaprootdn>cn=admin,dc=openskysolutions,dc=ca</ldaprootdn>
      
      <ldappath>
        ou=taporUsers,ou=tapor,o=openskysolutions,dc=openskysolutions,dc=ca
      </ldappath>
      

   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
9. Initialize default LDAP accounts. This step initializes your LDAP server with several default portal accounts . Run the import by accessing the following URL:

   http://localhost:8080/userstoldap