SiteSearch Administrator Tools Installation


  1. J2SDK 1.3.1

  2. Jakarta-tomcat 3.2.1

  3. Cocoon 1.8.2

  4. Log4J 1.0.4

  5. Soap 2.2

  6. JavaMail 1.2

  7. MySQL 3.23.35

  8. JDBC driver mm.mysql-2.0.2-bin.jar


  1. Download and install J2SDK 1.3.1 from

  2. Download and install Jakarta-tomcat 3.2.1 from

  3. Download and install Cocoon 1.8.2 from

  4. Change $TOMCAT_HOME/lib/parser.jar to $TOMCAT_HOME/lib/zparser.jar and $TOMCAT_HOME/lib/jaxp.jar to $TOMCAT_HOME/lib/zjaxp.jar before you restart Jakarta-tomcat to test Cocoon installation.

  5. Download and install Log4J 1.0.4 from

  6. Download and install Soap 2.3 from

  7. Download and install JavaMail 1.2

  8. Download and install MySQL 3.23.35 from

  9. Download JDBC driver mm.mysql-2.0.2-bin.jar from

  10. Copy log4j.jar to $TOMCAT_HOME/lib.

  11. Copy soap.jar to $TOMCAT_HOME/lib and copy soap.war to $TOMCAT_HOME/webapps.

  12. Copy mail.jar to $TOMCAT_HOME/lib

  13. Copy activation.jar to $TOMCAT_HOME/lib.

  14. Copy mm.mysql-2.0.2-bin.jar to $TOMCAT_HOME/lib

  15. Copy ssa_classes.jar to $TOMCAT_HOME/lib

  16. Edit $TOMCAT_HOME/conf/server.xml. Add new context path points to your $INIFILE_ROOT (See "Ini File Directory Structure Setup" section for more details).

    <Context path="/export/home/pcharoen/AdminTools/ROOT"




    reloadable="true" >


  17. Extract ssa_webapp.tar to $TOMCAT_HOME/webapps

  18. Edit $TOMCAT_HOME/webapps/ssa/WEB-INF/iconfig.xml. Modify parameters following your configuration (see iconfig.dtd for details).

  19. Edit $TOMCAT_HOME/webapps/ssa/WEB-INF/log4jconfig.xml (see log4j.dtd for details). The value of "File" parameters are the log file name in full path for information log file and debug log file.

    <appender name="AFile" class="org.apache.log4j.RollingFileAppender">

    <param name="File" value="/export/home/pcharoen/AdminTools/logs/ssi.log">


    <appender name="ADebugFile" class="org.apache.log4j.RollingFileAppender">

    <param name="File" value="/export/home/pcharoen/AdminTools/logs/ssi_debug.log">


  20. Start MySQL server and create database using setup_ssadb.sql. Change directory to $TOMCAT_HOME/webapps/ssa and run following commands.

    bash-2.03$ mysqladmin create ssadb

    bach-2.03$ mysql ssadb < setup_ssadb.sql

  21. Setup ini file directory structure. See details in "Ini File Directory Structure Setup" section.

  22. Start jakarta-tomcat server.

  23. Deploy AlertEmailServer Web Service.


  1. Create directory to store symbolic link to your SiteSearch configuration files.

    bash-2.03$ mkdir $INIFILE_ROOT

  2. Create symbolic links point to your SiteSearch configuration files for each environment.

    bach-2.03$ cd $INIFILE_ROOT

    bach-2.03$ ln –s $YOUR_SITESEARCH $ALIAS

    Ex: ln –s /usr/sitesearch/dev2/SS4_1_1 SS4_1_1

    ln –s /usr/sitesearch/dev1/SS4_1_2a SS4_1_2a

    ln –s /usr/sitesearch/dev2/SS4_2_0a SS4_2_0a



  3. Create symbolic links point to your AdminTools log files.

    bach-2.03$ ln –s $YOUR_ADMINTOOLS_LOGS $LOGS

    Ex: ln –s /export/home/pcharoen/AdminTools/logs logs

  4. Make sure that your iconfig.xml - <home> points to $INIFILE_ROOT.


  1. Browse SiteSearch Administrator Tools index page at http://$HOST_NAME:$PORT_NO/ssa

  2. Login system using user-id "admin" password "admin" then click "Tools" on tool bar menu.

  3. Add new servers. Click Edit Server à New. Add new server and enter information for production server, staging server, and developer servers.

  1. Edit user group. Click Edit User Group à Edit (Administrator Group) à Edit Server Privileges. Click check box in front of "Server Name" you want to access. Click "Default" check box on the server you want to be a default server. Click "Save" when you are done. Click "New Privileges". Select "Folder Name" and give permissions to read, write, and create on this folder. You can also set other properties for the folder such as sort field, order by (ascending/descending), file's extension filter, and page size. Click "Save" when you are done. See details in following field descriptions.

  1. Add new user and assign a group to user.

  1. Logout and Login as new user.