| :: NxtGen Installation Manual :: |
| Minimum Requirements |
- Server Operating System : Linux (tested on Red Hat 9 and Fedora Core 1)
- Router Operating System : FreeBsd (tested on FreeBSD 4.8 and 4.9)
- Processor : Intel Pentium III 1.6MHz (or equivalent)
- Memory : 128MB
|
| Installation |
|
Required Files
|
Place these files in /usr/local/src/
- j2sdk-1_4_2-linux-i586.bin (binary)
- apache-ant-1.6.1.bin.tar.gz (binary)
- mozilla-i686-pc-linux-gnu-1.6-installer.tar.gz (binary)
- javamail-1_3_1.zip (binary)
- jaf-1_0_2.zip (binary)
- james-2.1.3.tar.gz (binary)
- httpd-2.0.48.tar.gz (source)
- jakarta-tomcat-5.0.19.tar.gz (binary)
- postgresql-7.4.1.tar.gz (source)
- jmf-2_1_1e-linux-i586.bin (binary)
- jakarta-tomcat-connectors-jk2-2.0.2-src.tar.gz (source)
- nxtgen-1.0.0.tar.gz
|
|
Environment Variables
|
Edit /etc/profile
- JAVA_HOME=/usr/local/java/java
- JAVA_OPTS=-Xms254m -Xmx512m
- CATALINA_HOME=/usr/local/tomcat
- PATH=$JAVA_HOME/bin:$PATH:$HOME/bin:/sbin:/usr/sbin
- CLASSPATH=$CATALINA_HOME/bin/bootstrap.jar:$JAVA_HOME/lib/tools.jar:$CATALINA_HOME/common/lib/servlet.jar:
/usr/local/pgsql/share/java/postgresql.jar:/usr/local/jaf-1.0.2/activation.jar:/usr/local/javamail-1.3.1/mail.jar
- PGDATA=/usr/local/tomcat/webapps/nxtgen/col
Append this line to the export line
- JAVA_HOME CATALINA_HOME CLASSPATH PGDATA JAVA_OPTS
|
|
Install Java
|
- chmod +x j2sdk-1_4_2-linux-i586.bin
- ./j2sdk-1_4_2-linux-i586.bin
- mkdir /usr/local/java
- mv j2sdk-1.4.2 /usr/local/java
- cd /usr/local/java
- ln -s j2sdk1.4.2 java
|
|
Install Ant
|
- tar xvfz apache-ant-1.6.1.bin.tar.gz
- mkdir /usr/local/ant
- mv apache-ant-1.6.1 /usr/local/ant
- cd /usr/local/ant
- ln -s apache-ant-1.6.1 ant
- ln -s /usr/local/ant/ant/bin/ant /usr/local/bin/ant
|
|
Install Mozilla
|
- tar xvfz mozilla-i686-pc-linux-gnu-1.6-installer.tar.gz
- cd mozilla-installer/
- ./mozilla-installer
- ln -s /usr/local/java/java/jre/plugin/i386/ns610-gcc32/libjavaplugin_oji.so /usr/local/mozilla/plugins
|
|
Install JavaMail
|
- unzip javamail-1_3_1.zip
- mv javamail-1.3.1 /usr/local
- ln -s /usr/local/javamail-1.3.1/mail.jar /usr/local/tomcat/common/lib
|
|
Install JavaBeans Activation Framework
|
- unzip jaf-1_0_2.zip
- mv jaf-1.0.2 /usr/local
- ln -s /usr/local/jaf-1.0.2/activation.jar /usr/local/tomcat/common/lib
|
|
Install JAMES
|
- tar xvfz james-2.1.3.tar.gz
- mv james-2.1.3 /usr/local
|
|
Install Tomcat
|
- tar xvfz jakarta-tomcat-5.0.19.tar.gz
- mv jakarta-tomcat-5.0.19 /usr/local
- cd /usr/local
- ln -s jakarta-tomcat-5.0.19 tomcat
|
|
Install Apache
|
- tar xvfz httpd-2.0.48.tar.gz
- cd httpd-2.0.48
- ./configure --prefix=/usr/local/apache2 --enable-so
- make
- make install
|
|
Install NxtGen
|
- tar xvfz nxtgen-1.0.0.tar.gz
- mv nxtgen /usr/local/tomcat/webapps
|
|
Install Java Media Framework
|
- chmod +x jmf-2_1_1e-linux-i586.bin
- ./jmf-2_1_1e-linux-i586.bin
- ln -s /usr/local/JMF-2.1.1e/lib/jmf.jar /usr/local/java/java/jre/lib/ext
|
|
Copy Java Soundbank
|
Copy soundbank-deluxe.gm to /usr/local/java/java/jre/lib/audio
|
|
Reboot System
|
Restart the machine to make the environment variables functional
|
|
Install PostGreSQL
|
- cd /usr/local/src
- tar xvfz postgresql-7.4.1.tar.gz
- cd postgresql-7.4.1
- ./configure --with-java
- gmake
- gmake install
- ln -s /usr/local/pgsql/share/java/postgresql.jar /usr/local/tomcat/common/lib/postgresql.jar
- adduser admin
- mkdir /usr/local/tomcat/webapps/nxtgen/col
- chown admin /usr/local/tomcat/webapps/nxtgen/col
- su admin
- usr/local/pgsql/bin/initdb -D /usr/local/tomcat/webapps/nxtgen/col
|
|
Install Connector
|
- tar xvfz jakarta-tomcat-connectors-jk2-2.0.2-src.tar.gz
- cd /usr/local/src/jakarta-tomcat-connectors-jk2-2.0.2-src/jk/native2
- chmod +x ./buildconf.sh
- ./buildconf.sh
- ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-java-home=/usr/local/java/java/ --with-tomcat-41=/usr/local/tomcat/ --with-jni
- make
- libtool --finish /usr/local/apache2/modules/
- cd /usr/local/src/jakarta-tomcat-connectors-jk2-2.0.2-src/jk/build/jk2/apache2
- cp mod_jk2.so /usr/locl/apache2/modules
- cp jkjni.so /usr/locl/apache2/modules
|
|
Apache Configuration
|
Edit /usr/local/apache2/conf/http.conf
Edit server admin and specify your email address like this
- ServerAdmin rpbabilonia@up.edu.ph
Edit server name and specify your IPv4 address like this:
or IPv6 like this :
- ServerName [2001:200:800:6001:250:daff:fe61:530f]
Add this line on (DSO) support
- LoadModule jk2_module modules/mod_jk2.so
Create file /usr/local/apache2/conf/workers2.properties with these contents:
- # Define the communication channel
- [channel.socket:192.168.3.41:8009]
- info=Ajp13 forwarding over socket
- tomcatId=192.168.3.41:8009
- # Map the Tomcat NxtGen webapp to the Web server uri space
- [uri:/nxtgen/*]
- info=Map the NxtGen webapp
Note : The worker2.properties file in this example does not work for IPv6 addresses
|
|
Tomcat Configuration
|
Edit /usr/local/tomcat/conf/server.xml:
Set Engine defaultHost to your IP address
- defaultHost="192.168.3.41"
Set Host name to your IP address
Add this line inside the Host block
- <Context path="/nxtgen" docBase="nxtgen/jsp" debug="0" reloadable="true" crossContext="true"/>
|
|
PostGreSQL Configuration
|
Edit /usr/local/tomcat/webapps/nxtgen/col/postgresql.conf and uncomment
- tcpip_socket = true
- port = 5432
Add this line to /usr/local/tomcat/webapps/nxtgen/col/pg_hba.conf to for IPv4 address
- host all all 192.168.3.41 255.255.255.255 trust
or for IPv6 like this :
- host all all 2001:200:800:6001:250:daff:fe61:530f ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff trust
|
|
Configure JAMES
|
Set the domain name server
|
|
Test Apache
|
Start Apache
- /usr/local/apache2/bin/apachetl start
Stop Apache
- /usr/local/apache2/bin/apachetl stop
|
|
Test Tomcat
|
Start Tomcat
- $CATALINA_HOME/bin/startup.sh
Stop Tomcat
- $CATALINA_HOME/bin/shutdown.sh
|
|
Test JAMES
|
Change the mode of Phoenix server to executable
- chmod +x /usr/local/james-2.1.3/bin/phoenix.sh
Start JAMES
- /usr/local/james-2.1.3/bin/phoenix.sh start
Stop JAMES
- usr/local/james-2.1.3/bin/phoenix.sh start
|
|
Test PostGreSQL
|
Switch to admin to run
- su admin
- /usr/local/pgsql/bin/pg_ctl start
Open new console
- su admin
- /usr/local/pgsql/bin/createdb nxtgen
- /usr/local/pgsql/bin/psql nxtgen
Start creating tables
- create table users (
- username varchar (10) not null unique,
- password varchar (10) not null,
- email varchar (50) not null unique,
- firstname varchar (20) not null,
- lastname varchar (20) not null,
- privilege varchar (10) not null,
- date date not null,
- lastlogin date not null,
- usernumber bigserial primary key
- );
- create table groups (
- groupname varchar (100) not null unique,
- groupnumber bigserial primary key
- );
- create table metadata (
- title varchar (100) not null,
- author varchar(200) not null,
- description text not null,
- format varchar (100) not null,
- size decimal (10) not null,
- date date not null,
- filename text not null,
- metanumber bigint primary key
- );
- create table uploads (
- filename text not null,
- uploadid serial primary key,
- binaryfile bytea not null
- );
- create table affiliations (
- userid bigint references users on delete cascade,
- groupid bigint references groups on delete cascade
- );
- create table junctions (
- userid bigint references users on delete cascade,
- groupid bigint references groups on delete cascade,
- metaid bigint references metadata on delete cascade,
- fileid bigint references uploads on delete cascade
- );
Enter initial values
- insert into users values ('admin', 'nxtgen', 'rpbabilonia@up.edu.ph', 'Rey Vincent', 'Babilonia', 'admin', 'january, 26, 2004', 'january, 26, 2004');
- insert into groups values ('General Reference');
|
| IPv6 Deployment (Server) |
Add your IPv6 address on your host list in network configuration
Enable IPv6 support
|
| IPv6 Deployment (Router) |
Edit /etc/rc.conf so that it looks like this:
- gateway_enable="YES"
- defaultrouter="192.168.3.254"
- hostname="rightrouter"
- ifconfig_xl0="inet 192.168.1.1 netmask 255.255.255.0"
- ifconfig_xl1="inet 192.168.41.1 netmask 255.255.255.0"
- ipv6_enable="YES"
- ipv6_gateway_enable="YES"
- ipv6_prefix_xl0="2001:200:800:6001"
- ipv6_ifconfig_xl0="2001:200:800:6001::F prefixlen 64"
- kern_securelevel="NO"
- moused_enable="YES"
- nfs_reserved_port_only="YES"
- sendmail_enable="NO"
- sshd_enable="YES"
- usbd_enable="YES"
- rtadvd_enable="YES"
- rtadvd_interfaces="xl0"
Reboot the system
Route your subnetwork to the next subnetwork (ex. 2001:200:800:5001::)
- route add -inet6 2001:200:800:5001:: fe80::260:8ff:fe1f:7ac5%xl1
|
| Maintenance |
Create back-up
- su admin
- cd /usr/local/pgsql/bin
- pg_dump nxtgen > /usr/local/tomcat/webapps/nxtgen/col/date.psql
Restore backup
- dropdb nxtgen
- psql nxtgen < /usr/local/tomcat/webapps/nxtgen/col/date.psql
|