alfresco

Installation

Prelaminaries

This article provides some tips and hints to install an Alfresco system on openSUSE with following components:

  • OS: openSUSE 10.3
  • Alfresco 2.9B
  • Java 1.6
  • JBoss 4.2.2 GA
  • MySQL

All steps are done as user root.

  1. Install openSUSE with Java, MySQL, OpenOffice and ImageMagick
  2. Check and/or correct the JAVA_HOME environment setting
    # echo $JAVA_HOME
    /usr/lib/jvm/java
    # $JAVA_HOME/bin/java -version
    java version "1.6.0_05"
    Java(TM) SE Runtime Environment (build 1.6.0_05-b13)
    Java HotSpot(TM) Client VM (build 10.0-b19, mixed mode)
  3. Just to have some files and a glance in Alfrescos way to do it I've installed a out-of-the-box Alfresco system to /usr/share/alfresco. I used the file AlfrescoCommunity-2.9.0B-Linux-x86-Install.
  4. Setup MySQL as a demon (with YaST - Runlevel Editor or the chkconfig command)
  5. Setup MySQL Databases using the scripts served by Alfresco. Relating to step 3. you'll find these files in /usr/share/alfresco/extras/databases/mysql
    # cd /usr/share/alfresco/extras/databases/mysql
    # mysql -u root -p < db_setup.sql
  6. Install JBoss. My JBoss home directory is /usr/share/jboss-4.2.2.GA but thats no matter. This destination folder is called JBOSS_HOME from now on.
  7. Install the MySQL JDBC connector for JBoss (it's provided by MySQL)
    • get the driver from MySQL
    • extract it and copy the contained .jar file to JBOSS_HOME/server/default/lib
  8. Deploy Alfresco
    • get alfresco-community-war-2.9.0B from Alfresco download area
    • extract it and thereafter extract the contained alfresco.war as a folder called JBOSS_HOME/server/default/deploy/alfresco.war.
  9. Refer to
  10. Create/manage start/stop scripts for JBoss and OOo in /usr/share/alfresco (the default scripts delivered by Alfresco dont work because of a hard link to openoffice and a nonresolved variable @@ALFRESCO@@ - it took me days to research in the internet what kind of syntax that is… obviously it is a special Alfresco thing that should be replaced by the install routine but it didn't)
    • create a script start_oo.sh in /usr/share/alfresco with
      #!/bin/sh
      # ---------------------------------------------------------------------------
      # Start script for the OpenOffice transform service
      # ---------------------------------------------------------------------------
       
      echo "Starting OpenOffice service..."
       
      soffice "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" "-env:UserInstallation=file:///usr/share/alfresco/oouser" -nologo -headless -nofirststartwizard &
    • create a script alfresco.sh in /usr/share/alfresco with
      #!/bin/sh
      # Start or stop Alfresco server
      # Set the following to where Tomcat is installed
      #
      if [ "$1" = "start" ]; then
        /usr/share/jboss-4.2.2.GA/bin/jboss_init_suse.sh start
        /usr/share/alfresco/start_oo.sh
      elif [ "$1" = "stop" ]; then
        /usr/share/jboss-4.2.2.GA/bin/jboss_init_suse.sh stop
        killall soffice.bin
      fi
  • modify the script jboss_init_suse.sh in /usr/share/jboss-4.2.2.GA/bin/ with
    #!/bin/sh
    #
    # JBoss Control Script
    #
    # To use this script
    # run it as root - it will switch to the specified user
    # It loses all console output - use the log.
    #
    # Here is a little (and extremely primitive)
    # startup/shutdown script for SuSE systems. It assumes
    # that JBoss lives in /usr/local/jboss, it's run by user
    # 'jboss' and JDK binaries are in /usr/local/jdk/bin. All
    # this can be changed in the script itself.
    #
    # Either amend this script for your requirements
    # or just ensure that the following variables are set correctly
    # before calling the script.
    #
    ### BEGIN INIT INFO
    # Provides: jboss
    # Default-Start: 3 5
    # Default-Stop: 0 1 2 6
    # Description: Start the JBoss application server.
    ### END INIT INFO
     
    #define where jboss is - this is the directory containing directories log, bin, conf etc
    JBOSS_HOME=${JBOSS_HOME:-"/usr/share/jboss-4.2.2.GA"}
     
    #make java is on your path
    JAVAPTH=${JAVAPTH:-"/usr/lib/jvm/java/bin"}
     
    #define the classpath for the shutdown class
    JBOSSCP=${JBOSSCP:-"$JBOSS_HOME/bin/shutdown.jar:$JBOSS_HOME/client/jnet.jar"}
     
    #define the script to use to start jboss
    JBOSSSH=${JBOSSSH:-"$JBOSS_HOME/bin/run.sh -b 0.0.0.0 -c default"}
     
    # Shell functions sourced from /etc/rc.status:
    #      rc_check         check and set local and overall rc status
    #      rc_status        check and set local and overall rc status
    #      rc_status -v     ditto but be verbose in local rc status
    #      rc_status -v -r  ditto and clear the local rc status
    #      rc_failed        set local and overall rc status to failed
    #      rc_reset         clear local rc status (overall remains)
    #      rc_exit          exit appropriate to overall rc status
    . /etc/rc.status
     
    # First reset status of this service
    rc_reset
     
    # Return values acc. to LSB for all commands but status:
    # 0 - success
    # 1 - misc error
    # 2 - invalid or excess args
    # 3 - unimplemented feature (e.g. reload)
    # 4 - insufficient privilege
    # 5 - program not installed
    # 6 - program not configured
    #
    # Note that starting an already running service, stopping
    # or restarting a not-running service as well as the restart
    # with force-reload (in case signalling is not supported) are
    # considered a success.
     
    if [ -n "$JBOSS_CONSOLE" -a ! -d "$JBOSS_CONSOLE" ]; then
      # ensure the file exists
      touch $JBOSS_CONSOLE
    fi
     
    if [ -n "$JBOSS_CONSOLE" -a ! -f "$JBOSS_CONSOLE" ]; then
      echo "WARNING: location for saving console log invalid: $JBOSS_CONSOLE"
      echo "WARNING: ignoring it and using /dev/null"
      JBOSS_CONSOLE="/dev/null"
    fi
     
    #define what will be done with the console log
    JBOSS_CONSOLE=${JBOSS_CONSOLE:-"/var/log/jboss.log"}
     
    #define the user under which jboss will run, or use RUNASIS to run as the current user
    JBOSSUS=${JBOSSUS:-"RUNASIS"}
     
    CMD_START="cd $JBOSS_HOME/bin; $JBOSSSH"
    CMD_STOP="java -classpath $JBOSSCP org.jboss.Shutdown --shutdown"
     
    if [ "$JBOSSUS" = "RUNASIS" ]; then
      SUBIT=""
    else
      SUBIT="su - $JBOSSUS -c "
    fi
     
    if [ -z "`echo $PATH | grep $JAVAPTH`" ]; then
      export PATH=$PATH:$JAVAPTH
    fi
     
    if [ ! -d "$JBOSS_HOME" ]; then
      echo JBOSS_HOME does not exist as a valid directory : $JBOSS_HOME
      exit 1
    fi
     
    case "$1" in
    start)
        echo -n "Starting JBoss application server: "
        cd $JBOSS_HOME/bin
        if [ -z "$SUBIT" ]; then
            eval $CMD_START >${JBOSS_CONSOLE} 2>&1 &
        else
            $SUBIT "$CMD_START >${JBOSS_CONSOLE} 2>&1 &"
        fi
     
        # Remember status and be verbose
        rc_status -v
        ;;
    stop)
        echo -n "Shutting down JBoss application server: "
        if [ -z "$SUBIT" ]; then
            $CMD_STOP
        else
            $SUBIT "$CMD_STOP"
        fi
     
        # Remember status and be verbose
        rc_status -v
        ;;
    restart)
        $0 stop
        $0 start
     
        # Remember status and be quiet
        rc_status
        ;;
    *)
        echo "usage: $0 (start|stop|restart|help)"
    esac

—- FIXME For a production environment there should:

  • an init script instead of manual start and stop procedure
  • run the system in runlevel 3 (text console only)
  • run the system under user account instead of root
  • be printed all messages on the console (currently I tail -f /var/log/jboss.log)
  • alternatively have a ServiceControl to start/stop/Status etc. the system as well as displaying the messages
  • alternatively use Eclipse with JBoss Tools as Service Monitor and also as an easy way to check/change the config files.

Andreas Hartmann 16.05.2008 15:43

You could leave a comment if you were logged in.
forum/alfresco/installation.txt · Last modified: 2019/03/30 12:59 (external edit)


All trademarks and registered trademarks used are the property of their respective owners.
 

Recent changes RSS feed Driven by DokuWiki