...
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
...
...
- ;
...
- Login
...
- using
...
- provided
...
- Alfresco
...
- username
...
- and
...
- password.
...
- The
...
- software
...
- is
...
- in:
...
Code Block [Company Home
...
] -
...
[Downloads
...
] -
...
[
...
{Version}
...
Releases
...
] -
...
[
...
{Minor Version}
...
]
...
- The files needed are:
Code Block alfresco-enterprise-tomcat-
- The files needed are:
...
[new version
...
].tar.gz
...
alfresco-enterprise-wcm-
...
[new version].tar.gz
...
is needed for WCM, but not Thalia
...
- Also needed is a license from:
Code Block [Company Home
...
] -
...
[Downloads
...
] -
...
[Limited Downloads
...
]
...
- Such as:
Code Block enterprise-network-developer-unlimited.lic
...
- 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 Block cd $ALF_HOME ./alfresco.sh stop
...
- 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
...
- This may take some time to do. If it takes longer then 5 minutes, kill the process directly.
Code Block kill -9 [process number]
- 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.
##Put the Alfresco home script into place, and source it.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
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
- If this is going to be a clustered machine, create the cluster directories.
Code Block mkdir /home/repos/alf_data/cluster-A
- If this is going to be a clustered machine, create the cluster directories.
...
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
...
- 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
- If this is going to be a WCM server, unpack the WCM component.
...
- 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
- 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 Block cd $ALF_HOME/tomcat/webapps mkdir alfresco cd alfresco $JAVA_HOME/bin/jar -xvf ../alfresco.war
- Copy the license to the license directory.
Code Block cp /root/enterprise-network-unlimited.lic \ $ALF_HOME/tomcat/shared/classes/alfresco/extension/license
...
- Set
...
- up
...
- the
...
- dir.root
...
- location
...
- by
...
- adding
...
- it
...
- to
...
- the
...
- custom-repository.properties
...
- file.
...
Code Block dir.root=/home/
...
repos/alf_data
...
- 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 Block create database [name of database]
- Grant permissions to user.
Code Block grant all on alfresco.
- Create the database.
...
* to 'username'@'localhost' identified by
...
'password' with grant option;
...
grant all on alfresco.
...
* to 'username'@'localhost.localdomain'
...
identified by 'password' with grant option;
...
- 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 Block $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
...
- 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 Block cd $ALF_HOME mv wcm-bootstrap-context.xml tomcat/shared/classes/alfresco/extension
- Move the bootstrap file for WCM.
...
- If this is a WCM machine, then edit the virtualization server properties file and change the server address.
Code Block vi virtual-tomcat/conf/alfresco-virtserver.properties
...
- #* Edit alfresco.virtserver.domain
...
- to
...
- have
...
- the
...
- IP
...
- address
...
- of
...
- the
...
- server
...
- receiving
...
- the
...
- Alfresco
...
- software:
...
Code Block alfresco.virtserver.domain=18-92-1-223.ip.alfrescodemo.net
...
- 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 Block cp replicating-content-services-context.xml.sample
...
replicating-content-services-context.xml
...
cp ehcache-custom.xml.sample.cluster ehcache-custom.xml
...
- Select an ID for the cluster ID, and alter the following properties in the custom-repository.properties
...
- file.
...
Code Block 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
...
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