Page History

Wiki MarkupNote:    Next revision cycle, start building everything into
$HOME/\[app\]-\[version#\] and creating a symlink to $HOME/\[app\] so that there is
no question about what the current, in use, directory is.

Note: When downloading software to install in these instructions, unless
otherwise indicated, always download the tomcat tarball, and avoid binary
installers.  Binary installers tend to make inaccurate assumptions about what
libraries you have installed on your system, as well as other problems.

...

1. 1. Store the software in a convenient temporary directory on the system receiving the install, such as /tmp/alfresco or /root/alfresco.
2. If this system is currently in use as an Alfresco server, suspend any services directly dependent upon Alfresco (such as Thalia IME), and then suspend Alfresco itself.
   1. Suspend any services directly dependent upon Alfresco, such as Thalia IME. This is highly dependent upon what that service is.
   2. Suspend Alfresco.

      Code Block
      cd $ALF_HOME ./alfresco.sh stop

   3. Scan the process list to see when the Alfresco processes finish shutting down and terminate.  Repeat until no alfresco processes are left.

      Code Block
      ps aux | grep alfresco

   4. This may take some time to do.  If it takes longer then 5 minutes, kill the process directly.

      Code Block
      kill -9 [process number]

   5. Back up the current repository, and copy the backup to a backup storage server.
3. Prepare the home directories.  If this system had previous installations of Alfresco, move the previous repository stores and database to a backup location. Then create the home directories. Note: All of the ISDA/IPS users are installed on ISDA/IPS servers by default, even if they only need 2 of them.

   Code Block

   cd /home groupadd -r logs useradd -g logs -d /home/logs -m -r -s /bin/bash logs groupadd -r www useradd -g www -G logs -d /home/www -m -r -s /bin/bash www groupadd -r repos useradd -g repos -G logs -d /home/repos -m -r -s /bin/bash repos groupadd -r db useradd -g db -G logs -d /home/db -m -r -s /bin/bash db mkdir /home/repos/alfresco-[new version] mkdir /home/repos/alf_data ln -s /home/repos/alfresco-[new version] /home/repos/alfresco

   ##Put the Alfresco home script into place, and source it.

   Code Block
   cat > /etc/profile.d/alf_home.sh export ALF_HOME=/home/repos/alfresco export ALF_DATA=/home/repos/alf_data export ALF_EXT=$ALF_HOME/tomcat/shared/classes/alfresco/extension ^C chmod a+rx,a-w /etc/profile.d/alf_home.sh source /etc/profile.d/alf_home.sh

   1. If this is going to be a clustered machine, create the cluster directories.

      Code Block
      mkdir /home/repos/alf_data/cluster-A mkdir /home/repos/alf_data/cluster-B mkdir /home/repos/alf_data/cluster-[repeat for each stack in cluster mkdir /home/repos/alf_data/replication

4. Unpack the software into the correct directory.

   Code Block
   cd $ALF_HOME tar -xzvf /root/alfresco-enterprise-tomcat-[new version].tar.gz

   • If this is going to be a WCM server, unpack the WCM component.

     Code Block
     tar -xzvf /root/alfresco-enterprise-wcm-2.0.1.tar.gz

5. Copy the alfresco.sh file from the ISDA software repository to the new Alfresco home directory.

   Code Block
   scp [krb-id]@[software-repository]:alfresco.sh $ALF_HOME

6. If this is not a server ops machine, copy the sudoers file from Trogdor:/opt/software-repository-tmp/common-init into /etc.
7. Unpack the Alfresco war file.

   Code Block
   cd $ALF_HOME/tomcat/webapps mkdir alfresco cd alfresco $JAVA_HOME/bin/jar -xvf ../alfresco.war

8. Copy the license to the license directory.

   Code Block
   cp /root/enterprise-network-unlimited.lic \ $ALF_HOME/tomcat/shared/classes/alfresco/extension/license

9. Set up the dir.root location by adding it to the custom-repository.properties file.

   Code Block
   dir.root=/home/repos/alf_data

10. Setup MySQL database to be used by this system, if this is a new install. If this is an upgrade, backup the database with mysqldump.
    1. Login to MySQL server as root and connect to the MySQL database
    2. If this is a new install, create a new database and setup a user.
       1. Create the database.

          Code Block
          create database [name of database]

       2. Grant permissions to user.

          Code Block
          grant all on alfresco.* to 'username'@'localhost' identified by 'password' with grant option; grant all on alfresco.* to 'username'@'localhost.localdomain' identified by 'password' with grant option;

...