Page History

Thalia admin runbook

...

Things to do when setting up a new cluster:

• get the dns entry for subdomain
• get a Wild card certs
• Don't forget install the alfresco license
• have ops set up F5

...

Things to do when setting up thalia:

Setting up the Thalia UI and IME Servers:

A. Install ImageMagic on the server that will be running the Thalia UI and IME

...

:

• go to www.imagemagick.org and get the source distribution:ImageMagick-6.3.2-9.tar.gz
• unzip and unstar ImageMagick-6.3.2.tar.gz and cd to ImageMagic-6.3.2 directory
• by default, the base installation directory is /usr/local. binary files go in /usr/local/bin and library files go in /usr/local/lib. If you want to specify an installation prefix other than /usr/local, youcan do it by specify the --prefix=PATH in step 4
• ./configure (specify the path here if necessary. Please note that the binary files should be in the system path)
• make install
• for more info, please refer to the Install-unix.txt in the package
• after installation, you should be able to type "convert" command and get the help page.

B. Install lazlo servlet on the server that will be running the Thalia UI and IME:

• Get the 4.0.2 version going to http://www.openlaszlo.org/archive. Choose the Servlet for 4.0.2.
• Can be installed via tomcat manager
• LPS_HOME must be set as an environment variable, so that the compiler can run. LPS_HOME should be set to the directory where the servlet was installed, e.g. /home/apache-5.5.23/webapps/openlaszlo-4.0.2-servlet
• For some reason, the compiler script (a file called lzc) is not executable when installed. It needs to be made executable by going into$LPS_HOME/WEB-INF/lps/server/bin and chmod 755 lzc.

C. create directory structure and change the owner to www:

/home/www/thalia/conf

/home/www/thalia/log

/home/www/thalia/bulkimage

/home/www/thalia/tmp     

D.  put thaliausers.xml in /home/www/thalia/conf. This file should contain info about system super users.  The file should have the format:

<user-list>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<user><name>colodzin</name>&nbsp;&nbsp;
<domain>ADMIN</domain>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<isAdmin>true</isAdmin>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</user>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<user><name>amb</name>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<domain>ADMIN</domain>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<isAdmin>true</isAdmin>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</user>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<user><name>dongq</name>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<domain>ADMIN</domain>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<isAdmin>true</isAdmin>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</user>&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<user><name>iannuzzo</name>&nbsp;&nbsp;
<domain>ADMIN</domain>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<isAdmin>true</isAdmin>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</user>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<user><name>dracus</name>&nbsp;&nbsp;&nbsp;&nbsp;
<domain>ADMIN</domain>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<isAdmin>true</isAdmin>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</user>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</user-list>&nbsp;
The system super users can self-register in any domain by going to https://\[domain\].thalia.mit.edu/resttest.jsp and click on the super user self reg button.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
C. Customize the Alfresco 

E. upload the thalia war file onto the UI and IME server.

Customize the Alfresco Server:

1.      Stop Alfresco server

...

10.  Run the BuildThaliaDomain.jar library to create the domains. The file is under /home/qing/dist on isda-thalia1, 2, and 5.  The syntax is $JAVA_HOME/bin/java \-classpath ./lib \-jar BuildThaliaDomain.jar \[alfresco repository location\] \[admin passwd\] \[DOMAIN NAME\]
For example, to create the TEST domain on isda-thalia6 do:
$JAVA_HOME/bin/java \-classpath ./lib \-jar BuildThaliaDomain.jar [http://mv.ezproxy.com.ezproxyberklee.flo.org/alfresco] adminpass TEST
Please be aware that the jar file was compiled using java6, so if the JAVA_HOME points to a location older than java6, it will not work.

You can run the jar file from any server to manage any domain in any alfresco repository. You just need to specify the alfresco repository address as the first argument. This utility also has a web interface.

D. create directory structure:

/home/www/thalia/conf

/home/www/thalia/log

/home/www/thalia/bulkimage

/home/www/thalia/tmp     
E. upload the thalia war file onto the UI and IME server.

F. set the domain specific metadata mapping

11. set the domain specific metadata mapping

On both IME and Alfresco Server:

• run cronjob to rollover the log. The config file is /etc/roll-log.conf
      /home/root/roll-log >> /loc/logs/roll-log.log 2>&1 &
• run cronjob to clean up temporary files. The config file is /etc/cleansefiles.conf
      /home/root/cleansefiles.py >> /loc/logs/rmoldfiles.log 2>&1 & 

  F: run cronjob to clean up the log, tmp, and bulkimage directories.  3. How to create a new super user:

Edit thaliausers.xml mentioned in step B step D of setting up thalia. Restart the ime. The new super user needs to self register to be a domain admin in a domain. Please refer to step B step D also.