Stellar 2 Pilot tomcat Installation and configuration

Setting up the 'S' Webapp

Use the same procedure as for the main tomcat (see tomcat5/index.html for the base tomcat installation and stellar2.html for the normal S webapp installation), but after installation edit site.properties to set it read-only, set preload false. Customize log4j.properties so that it logs to /var/local/stellar-logs/pilot-*.log. Change catalina.sh to set a different CATALINA_TMPDIR and send CATALINA_OUT to a different file (e.g. /var/local/stellar-logs/pilot-tomcat.`/usr/bin/date +%Y%m%dT%H%M)

cd /var/local/
cp -rp main-tomcat-2.2/webapps/S pilot-tomcat-2.2/webapps/S
cp -rp main-tomcat-2.2/common/classes/log4j.properties pilot-tomcat-2.2/common/classes
emacs pilot-tomcat-2.2/webapps/S/WEB-INF/site.properties 
emacs pilot-tomcat-2.2/common/classes/log4j.properties
emacs pilot-tomcat-2.2/bin/catalina.sh

Setting up the 'stellar-images' Webapp

This is its own project in svn at amps/stellar-projects/stellarimages.

Be sure imageMagick is installed at /var/local/bin (or other location, set in web.xml).

Be sure the /var/local/imagestore directory and subdirectories VC.001 VC.002 rvc001 and upload exist. Copy convert.perl to /var/local/imagestore, and make sure the init.d script is in place.

cp stellar-images-impl/src/main/perl/convert.perl /var/local/imagestore/
cp stellar-images-impl/src/main/perl/stellar-images.sh /etc/init.d/stellar-images
ln -s /etc/init.d/stellar-images /etc/rc2.d/S99stellar-images
/etc/init.d/stellar-images
ps -fu root | grep perl

There are many jars which are not in any maven repository, see the README-fa07. Also install jta:

mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta \
    -Dversion=1.0.1B -Dpackaging=jar \
    -Dfile=/var/local/sakai-tomcat-2.2/shared/lib/jta-1.0.1B.jar

Customize stellar-images-webapp/src/main/resources/db.properties and stellar-images-webapp/src/main/webapp/WEB-INF/web.xml Build the package there with mvn package and then do

cp -rp stellar-images-webapp/target/stellar-images-webapp/. /var/local/pilot-tomcat-2.2/webapps/stellar-images-webapp

Remove jars from WEB-INF/lib, see below.

Setting up the 'Gradebook' Webapp

In subversion under svn+ssh://svn.mit.edu/amps/stellar-projects/gradebook/gems/

Customize:

  • stellar-gradebook-webapp/src/main/webapp/WEB-INF/applicationContext.xml to remove standalone operation configuration beans at the bottom of the file, and stellar-gradebook-webapp/src/main/webapp/WEB-INF/web.xml to comment out the filters used in standalone operation. Be sure the stellar-gradebook-webapp/pom.xml file has the stellar.jars property set to "provided".

    Install the sakai gradebook api into maven repository if necessary:

    mvn install:install-file -DgroupId=sakaiproject \
         -DartifactId=sakai-gradebook-service-api -Dversion=2.3.0 -Dpackaging=jar \
     -Dfile=sakai/sakai-gradebook-service-api-2.3.0.jar

    Build and install:

    mvn clean install
    cp -rp stellar-gradebook-webapp/target/stellar-gradebook-webapp/. /var/local/pilot-tomcat-2.2/webapps/stellar-gradebook-webapp

Setting up the 'Opinio' Webapp

Manually prepare the webapp, from the downloaded opinio distribution zip:

mkdir o
cd o
unzip ../opinio6.0.7.zip
mkdir opinio
cd opinio
jar -xvf ../opinio.war
rm WEB-INF/log4j.properties      
mkdir WEB-INF/plugins
cd ..
mv opinio /var/local/pilot-tomcat-2.2/webapps
unzip plugin.zip
mvn install:install-file -DgroupId=com.objectplanet.survey \
   -DartifactId=plugin -Dversion=6.0.7 -Dpackaging=jar -Dfile=lib/opinio.jar
cd /var/local/stellar-svn/amps/stellar-projects/opinio/trunk/src/site/resources/
cp -rp . /var/local/pilot-tomcat-2.2/webapps/opinio/

Compile the plugin.

cd /var/local/stellar-svn/amps/stellar-projects/opinio/trunk
mvn clean install
cp target/stellar-opinio-plugins-1.0-SNAPSHOT.jar  /var/local/pilot-tomcat-2.2/webapps/opinio/WEB-INF/plugins/
cp adminTemplate.jsp /var/local/pilot-tomcat-2.2/webapps/opinio/admin/

You'll need to set the license, by accessing as "admin", details yet to be determined. Set the email server to 'nashira' to allow invitations.

Oracle: need to run opinio/WEB-INF/database/oracle_create.sql to set up the database.

Rename the file: WEB-INF/database.properties to WEB-INF/database_derby.properties and then rename the file WEB-INF/database_oracle.properties to WEB-INF/database.properties

Edit this file (WEB-INF/database.properties). Change the line starting with: objectplanet.persistence.jdbcURL= to use the db url e.g. jdbc:oracle:thin:@enif.mit.edu:1521:stlr20d1 Set user name and password to use when connecting to the database.

Turn on internationalization, see http://www.objectplanet.com/opinio/doc/installation.html#i18n

Libraries

There are duplications and errors in the maven builds which need to be cleaned up.

cd /var/local/pilot-tomcat-2.2/

/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/antlr-2.7.6rc1.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/aopalliance-1.0.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/asm-1.5.3.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/cglib-2.1_3.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/commons-collections-3.1.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/commons-io-1.2.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/dom4j-1.6.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/ehcache-1.1.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/hibernate-3.1.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/jta-1.0.1B.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/spring-beans-2.0.6.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/spring-context-2.0.6.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/spring-core-2.0.6.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/spring-dao-2.0.6.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/spring-hibernate3-2.0.6.jar
/bin/rm webapps/stellar-images-webapp/WEB-INF/lib/spring-jdbc-2.0.6.jar

After this, the jars should be

log4j-1.2.14.jar
ojdbc14.jar
(apache standard libs)
common/lib
CometOsid2Impl-1.0.jar
MITAuthenticationTypes-1.0.jar
MITRepositoryTypes-1.0.jar
MITSearchTypes-1.0.jar
VisualizingCultures-1.0.jar
acegi-security-1.0.3.jar
acegi-security-tiger-1.0.3.jar
activation-1.0.2.jar
antlr-2.7.6rc1.jar
aopalliance-1.0.jar
asm-1.5.3.jar
avalon-framework-4.1.3.jar
cglib-2.1_3.jar
commons-codec-1.3.jar
commons-collections-3.1.jar
commons-dbcp-1.2.2.jar
commons-fileupload-1.1.1.jar
commons-io-1.2.jar
commons-lang-2.3.jar
commons-logging-1.1.jar
commons-pool-1.3.jar
dom4j-1.6.jar
dwr-1.1.1.jar
ehcache-1.1.jar
ehcache-1.2.4.jar
freemarker-2.3.10.jar
hibernate-3.1.jar
id-1.0.jar
itext-1.4.8.jar
jpedal-stellar-1.0a.jar
jstl-1.1.2.jar
jta-1.0.1B.jar
jtidy-4aug2000r7-dev.jar
logkit-1.0.1.jar
lucene-stellar-1.0a.jar
mail-1.3.1.jar
multipartrequest-1.30rc1.jar
mysql-connector-java-3.0.15-ga-bin.jar
ognl-2.6.11.jar
okiOSID-2.0.jar
oro-2.0.7.jar
poi-3.0.1-FINAL.jar
rvcOsid-1.0.jar
sakai-gradebook-service-api-2.3.0.jar
sitemesh-2.3.jar
spring-aop-2.0.6.jar
spring-beans-2.0.6.jar
spring-context-2.0.6.jar
spring-core-2.0.6.jar
spring-dao-2.0.6.jar
spring-hibernate3-2.0.6.jar
spring-jdbc-2.0.6.jar
spring-remoting-2.0.6.jar
spring-support-2.0.6.jar
spring-web-2.0.6.jar
spring-webmvc-2.0.6.jar
standard-1.1.2.jar
stellar-gradebook-api-1.0-SNAPSHOT.jar
stellar-gradebook-impl-1.0-SNAPSHOT.jar
stellar-images-api-1.0-SNAPSHOT.jar
stellar-images-impl-1.0-SNAPSHOT.jar
stellar-two-jar-2.0-SNAPSHOT.jar
struts2-core-2.0.9.jar
struts2-sitemesh-plugin-2.0.9.jar
struts2-spring-plugin-2.0.9.jar
xwork-2.0.4.jar
shared/lib

Webapps

For production, remove:

ROOT
balancer
jsp-examples
servlets-examples
tomcat-docs
webdav

Leaving

S Stellar
opinio Stellar
stellar-images-webapp Stellar
stellar-gradebook-webapp Stellar
pilot-monitor nagios monitor