| 4 | ---------------------------------------------------------------------------------------------------------------- |
| 5 | |
| 6 | <<Setup>> |
| 7 | |
| 8 | First let's talk about the setup: |
| 9 | To perform this test I've installed a complete new Tomcat environment which probably will give the best results. |
| 10 | The performance test can really suck ressources on your machine, so it's better to test Geonetwork on a modern PC |
| 11 | instead of some old machine. I used a machine with the following components: |
| 12 | |
| 13 | Processor: Intel Q9450 2,66 Ghz |
| 14 | Ram: 4GB 800 Mhz |
| 15 | Drive: 7500 RPM SATA2 |
| 16 | |
| 17 | OS: Windows Vista (You could use a Linux Distribution, of course!) |
| 18 | Software: |
| 19 | - Geonetwork 2.4.1 |
| 20 | - Apache Tomcat 6 (Tomcat is one of the flag ships in Web Application Serving. Tomcat 5.5 would do it, too) |
| 21 | - JRE 6 (or another Java Runtime Environment, but it's essential to have a JRE!) |
| 22 | - Eclipse Galileo (or Notepad++ for editing) |
| 23 | - Putty (to check the activity of the server) |
| 24 | - MySQL Server 5.1 (to have a nice free Database) |
| 25 | |
| 26 | Additionally you could set up ant in relation with Tomcat to automate the installation a bit more. |
| 27 | |
| 28 | ---------------------------------------------------------------------------------------------------------------- |
| 29 | |
| 30 | <<Tomcat Configuration>> |
| 31 | |
| 32 | There are two possibilities you could configure Tomcat: |
| 33 | 1.) Let everything in one directory. This has the advantage you don't have to maintain many directories, but it |
| 34 | also has the disadvantage installing a newer Tomcat version would result in a lost config-file and you have to |
| 35 | configure your whole settings again or you copy the config file and merge it with maybe new functions in the new |
| 36 | config file. However, that would be some extra work. |
| 37 | |
| 38 | 2.) Separate Tomcat in a HOME and BASIC directory. The HOME directory contains all binaries and engine parts of |
| 39 | Tomcat, the BASIC directory contains the individual configuration instances and web applications. For this you have |
| 40 | to define two environment variables CATALINA_HOME and CATALINA_BASIC with the specific directories as their values. |
| 41 | |
| 42 | I've chosen for number one, because Tomcat 6 would do it for a long time, but if you're one of the persons who likes |
| 43 | cutting edge technology prototypes, you can choose for number two of course. |
| 44 | After this you have to add the different paths of geonetwork webapps to the Tomcat server configuration. This can be |
| 45 | done by adding different context paths to the server.xml under $CATALINA_HOME/conf (Linux) or $CATALINA_HOME\conf |
| 46 | (Windows). Please mark these little differences for the future, even though Tomcat would handle the intention of |
| 47 | writing a path correctly. |
| 48 | It can also be done since Tomcat 5.5 by creating the files "geonetwork.xml", "intermap.xml" and "geoserver.xml" in |
| 49 | $CATALINA_HOME/conf/Catalina/localhost and add the following content: |
| 50 | **************************************************************************************** |
| 51 | <Context docBase="path/to/geodir/$WEBAPP" |
| 52 | privileged="true" antiResourceLocking="false" antiJARLocking="false"> |
| 53 | </Context> |
| 54 | **************************************************************************************** |
| 55 | where $WEBAPP is "geonetwork", "intermap" or "geoserver" |
| 56 | |
| 57 | ---------------------------------------------------------------------------------------------------------------- |
| 58 | |
| 59 | <<MySQL Configuration>> |
| 60 | |
| 61 | To configure MySQL you have to choose a username and a password. I left the default username "root" and chose a |
| 62 | password "admin". Remember these values, you have to put it in the config.xml of path/to/geonetwork/web/geonetwork |
| 63 | /WEB-INF. For this you have to look for: |
| 64 | |
| 65 | <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
| 66 | <!-- mysql --> |
| 67 | <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
| 68 | |
| 69 | <resource enabled="true"> |
| 70 | <name>main-db</name> |
| 71 | <provider>jeeves.resources.dbms.DbmsPool</provider> |
| 72 | <config> |
| 73 | <user>root</user> |
| 74 | <password>admin</password> |
| 75 | <driver>com.mysql.jdbc.Driver</driver> |
| 76 | <url>jdbc:mysql://localhost:3306/geonetwork?useUnicode=true&characterEncoding=utf-8&mysqlEncoding=utf8</url> |
| 77 | <poolSize>10</poolSize> |
| 78 | <reconnectTime>3600</reconnectTime> |
| 79 | </config> |
| 80 | </resource> |
| 81 | |
| 82 | After this it would be good to start gast.sh (Linux) or gast.bat (Windows) under path/to/geonetwork/bin, go to |
| 83 | "Setup" (under the point "Database"), click "Setup" and confirm all values of your current geonetwork schema in |
| 84 | your database get lost (if you want that!) and your database configuration is done. |
| 85 | |
| 86 | ---------------------------------------------------------------------------------------------------------------- |
| 87 | |
| 88 | <<Functionality Test>> |
| 89 | |
| 90 | The first test was the availability and function correctness of geonetwork running under Tomcat that is required |
| 91 | for the Performance test. |
| 92 | |
| 93 | I've got the following result: |
| 94 | - The Geonetwork site appeares in the browser |
| 95 | - The MySQL database is filled with the values of the geonetwork configuration |
| 96 | - The Administration Login works as expected |
| 97 | |
| 98 | - The Intermap layer doesn't work (Exception 'li1 is undefined') |
| 99 | |
| 100 | |
| 101 | |
| 102 | |
| 103 | |