Wiki Markup |
---|
Note: 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. |
...
# download the latest Alfresco Enterprise edition software from [http://customers.alfresco.com]; Login using provided Alfresco username and password. |
...
The software is in: |
...
{code |
...
} [Company Home] - [Downloads] - [{Version} Releases] - [{Minor Version}] |
...
{code} #* The files needed are: {code} alfresco-enterprise-tomcat-[new version].tar.gz alfresco-enterprise-wcm-[new version].tar.gz is needed for WCM, but not Thalia |
...
{code} #* Also needed is a license from: {code} [Company Home] - [Downloads] - [Limited Downloads] |
...
{code} #* Such as: {code} enterprise-network-developer-unlimited.lic |
...
{code} ## Store the software in a convenient temporary directory on the system receiving the install, such as /tmp/alfresco or /root/alfresco. |
...
# 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. |
...
## Suspend any services directly dependent upon Alfresco, such as Thalia IME. This is highly dependent upon what that service is. |
...
## Suspend Alfresco. |
...
{code |
...
} cd $ALF_HOME ./alfresco.sh stop |
...
{code} ## Scan the process list to see when the Alfresco processes finish shutting down and terminate. Repeat until no alfresco processes are left. {code} ps aux | grep alfresco |
...
{code} ## This may take some time to do. If it takes longer then 5 minutes, kill the process directly. {code} kill -9 [process number] |
...
{code} ## Back up the current repository, and copy the backup to a backup storage server. # 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} 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 {code} |
...
\##Put the Alfresco home script into place, and source it. |
...
{code |
...
} 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 |
...
{code} ## If this is going to be a clustered machine, create the cluster directories. {code} 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 |
...
{code} # Unpack the software into the correct directory. {code} cd $ALF_HOME tar -xzvf /root/alfresco-enterprise-tomcat-[new version].tar.gz |
...
{code} #* If this is going to be a WCM server, unpack the WCM component. {code} tar -xzvf /root/alfresco-enterprise-wcm-2.0.1.tar.gz |
...
{code} # Copy the alfresco.sh file from the ISDA software repository to the new Alfresco home directory. |
...
{code |
...
} scp [krb-id]@[software-repository]:alfresco.sh $ALF_HOME |
...
{code} # If this is not a server ops machine, copy the sudoers file from Trogdor:/opt/software-repository-tmp/common-init into /etc. |
...
# Unpack the Alfresco war file. |
...
{code |
...
} cd $ALF_HOME/tomcat/webapps mkdir alfresco cd alfresco $JAVA_HOME/bin/jar -xvf ../alfresco.war |
...
{code} # Copy the license to the license directory. {code} cp /root/enterprise-network-unlimited.lic \ $ALF_HOME/tomcat/shared/classes/alfresco/extension/license |
...
{code} # Set up the dir.root location by adding it to the custom-repository.properties file. |
...
{code |
...
} dir.root=/home/repos/alf_data |
...
{code} # 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. ## Login to MySQL server as root and connect to the MySQL database ## If this is a new install, create a new database and setup a user. ### Create the database. {code} create database [name of database] |
...
{code} ### Grant permissions to user. {code} 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; |
...
{code} ##* Replace the database, password and user names as needed, to match the alfresco server. Select a password that will be secure. |
...
# If this is going to be the second indepenant instance of Alfresco on a server, then edit the files: |
...
{code |
...
} $ALF_HOME/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/alfresco-shared.propertie $ALF_HOME/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/web-client-config-wcm.xml |
...
{code} #* Alter the option avm.remote.port to have a unique port number, and the ports for RMI and JMX. |
...
# If this is going to be a WCM system, move the wcm-bootstrap-context.xml file into the extensions directory, and configure virtualization and TinyMCE. |
...
## Move the bootstrap file for WCM. |
...
{code |
...
} cd $ALF_HOME mv wcm-bootstrap-context.xml tomcat/shared/classes/alfresco/extension |
...
{code} ## If this is a WCM machine, then edit the virtualization server properties file and change the server address. {code} vi virtual-tomcat/conf/alfresco-virtserver.properties |
...
{code} # \#\* Edit alfresco.virtserver.domain to have the IP address of the server receiving the Alfresco software: |
...
{code |
...
} alfresco.virtserver.domain=18-92-1-223.ip.alfrescodemo.net |
...
{code} # If this is going to be a clustered system, more or alter the following files to make a cluster configuration. ## Move the following files in $ALF_HOME/tomcat/share/classes/alfresco/extension |
...
{code |
...
} cp replicating-content-services-context.xml.sample replicating-content-services-context.xml cp ehcache-custom.xml.sample.cluster ehcache-custom.xml |
...
{code} ## Select an ID for the cluster ID, and alter the following properties in the custom-repository.properties file. |
...
{code |
...
} cluster.id=A dir.root=/home/repos/alf_data # Set to an appropriate local, usually a SAN mount dir.root.replicated=${dir.root}/replication dir.contentstore=${dir.root}/contentstore dir.contentstore.replicated=${dir.root.replicated}/contentstore dir.contentstore.deleted=${dir.root}/contentstore.deleted dir.auditcontentstore=${dir.root}/audit.contentstore dir.indexes = ${dir.root}/lucene-indexes dir.indexes.lock = ${dir.indexes}/locks index.recovery.mode = AUTO index.tracking.cronExpression=0/5 * * * * ? system.bootstrap.config_check.strick = true |
...
{code} \\ 13. See the Alfresco Non-Root Modifications instructions at [https://wikis.mit.edu/confluence/display/ISDA/Alfresco+Non-Root+Modifications] for information on how to make your installation operate as non-root |