Employee Portal V1 Remote Deployment Guide
by DaJFKs

Contents of Deployment CD (all files except for the README will be packed(compressed) as one file)
   - EmployeePortal-1.0.tar.gz
      - JBoss Application Server 4.0.5 (jboss-4.0.5.GA.zip)
      - MySQL 5 Database (mysql-5.0.37-solaris10-sparc.tar.gz)
      - Employee Portal Web Archive (in JBoss' deploy directory as EmployeePortal.war)
      - Database schemas creation script (installdb.sql)
   - Step-by-step instructions (README.txt)
   - Requirements Documents

Server System Requirements
   - Solaris 10 Operating System
   - Java Development Kit (JDK 1.5)
   - Java Runtime Environment (JRE 1.5)
   - root access
   - GZIP (for extracting EmployeePortal-1.0.tar.gz)
   - UnZip (for extracting JBoss)
   - MySQL 5 Database (stored on CD)
   - JBoss Application Server 4.0.5 (stored on CD)

Step-by-step Installation Instructions
1. Log on the deployment server as root and copy/upload EmployeePortal-1.0.tar.gz to the "/" directory.
2. Use your favorite shell and execute these commands to extract the files:
   - shell> cd ~
   - shell> gunzip < EmployeePortal-1.0.tar.gz | tar xvf -
   - shell> unzip jboss-4.0.5.GA.zip
   - shell> gunzip < mysql-5.0.37-solaris10-sparc.tar.gz | tar xvf -
   - shell> rm jboss-4.0.5.GA.zip
   - shell> rm mysql-5.0.37-solaris10-sparc.tar.gz
3. Setup MySQL
   - shell> groupadd mysql
   - shell> useradd -g mysql mysql
   - shell> ln -s mysql-5.0.37-solaris10-sparc mysql
   - shell> cd mysql
   - shell> chown -R mysql .
   - shell> chgrp -R mysql .
   - shell> scripts/mysql_install_db
   - shell> chown -R root .
   - shell> chown -R mysql data
*Notes: Refer to http://dev.mysql.com/doc/refman/5.0/en/installing-binary.html for explanation of these commands.
4. Start MySQL server
   - shell> bin/mysqld_safe --user=root &
Be sure to include the ampersand (&) after the command for the mysql server daemon to run in the background.
If everything has gone correctly, then a similar message to the following will appear: Starting mysqld daemon with databases from /mysql-5.0.37-solaris-i386/data
Press [enter] to return to the shell prompt.
5. Create the database schemas for the Employee Portal; from your shell, type in these commands:
   - shell> bin/mysql
   - mysql> source ~/installdb.sql;
   - mysql> quit;
6. Start JBoss
   - shell> cd ~
   - shell> tcsh
   - tcsh> cd ~/jboss-4.0.5.GA/bin
   - tcsh> chmod a+x run.sh
   - tcsh> ./run.sh &
Use tcsh shell to start JBoss server. Start the server by executing run.sh with the ampersand (&) at the end.
Press [enter] to return to the shell prompt.
7. Access the Employee Portal through an Internet Explorer 6.0 or Firefox 1.5 web browser: http://<hostname>:8080/EmployeePortal/EmployeePortal.html
8. Deployment Complete.


To shut down JBoss and MySQL
1. To shutdown JBoss
   - shell> cd ~/jboss-4.0.5.GA/bin
   - shell> chmod a+x shutdown.sh
   - shell> ./shutdown.sh -S
2. To shutdown mysql
   - shell> cd ~/mysql/bin
   - shell> ./mysqladmin --user=root shutdown