Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

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.

...

  1. download

...

  1. the

...

  1. latest

...

  1. Alfresco

...

  1. Enterprise

...

  1. edition

...

  1. software

...

  1. from

...

  1. http://customers.alfresco.com

...

  1. ;

...

  1. Login

...

  1. using

...

  1. provided

...

  1. Alfresco

...

  1. username

...

  1. and

...

  1. password.

...

  1.   The

...

  1. software

...

  1. is

...

  1. in:

...

  1. Code Block

...

  1. 
    [Company Home] - [Downloads] - [{Version} Releases] - [{Minor Version}]
    

...

    • The files needed are:
      Code Block
      
      alfresco-enterprise-tomcat-[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
      

...

    1. Store the software in a convenient temporary directory on the system receiving the install, such as /tmp/alfresco

...

    1. or

...

    1. /root/alfresco.

...

  1. If

...

  1. this

...

  1. system

...

  1. is

...

  1. currently

...

  1. in

...

  1. use

...

  1. as

...

  1. an

...

  1. Alfresco

...

  1. server,

...

  1. suspend

...

  1. any

...

  1. services

...

  1. directly

...

  1. dependent

...

  1. upon

...

  1. Alfresco

...

  1. (such

...

  1. as

...

  1. Thalia

...

  1. IME),

...

  1. and

...

  1. then

...

  1. suspend

...

  1. Alfresco

...

  1. itself.

...

    1. Suspend

...

    1. any

...

    1. services

...

    1. directly

...

    1. dependent

...

    1. upon

...

    1. Alfresco,

...

    1. such

...

    1. as

...

    1. Thalia

...

    1. IME.

...

    1. This

...

    1. is

...

    1. highly

...

    1. dependent

...

    1. upon

...

    1. what

...

    1. that

...

    1. service

...

    1. is.

...

    1. Suspend

...

    1. Alfresco.

...

    1. Code Block

...

    1. 
      cd $ALF_HOME
      ./alfresco.sh stop
      

...

    1. 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
      

...

    1. This may take some time to do.  If it takes longer then 5 minutes, kill the process directly.
      Code Block
      
      kill -9 [process number]
      

...

    1. Back up the current repository, and copy the backup to a backup storage server.
  1. 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
    

...

  1. ##Put

...

  1. the

...

  1. Alfresco

...

  1. home

...

  1. script

...

  1. into

...

  1. place,

...

  1. and

...

  1. source

...

  1. it.

...

  1. Code Block

...

  1. 
    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
      

...

  1. 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
      

...

  1. Copy the alfresco.sh

...

  1. file

...

  1. from

...

  1. the

...

  1. ISDA

...

  1. software

...

  1. repository

...

  1. to

...

  1. the

...

  1. new

...

  1. Alfresco

...

  1. home

...

  1. directory.

...

  1. Code Block

...

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

...

  1. If this is not a server ops machine, copy the sudoers file from Trogdor:/opt/software-repository-tmp/common-init

...

  1. into

...

  1. /etc.

...

  1. Unpack

...

  1. the

...

  1. Alfresco

...

  1. war

...

  1. file.

...

  1. Code Block

...

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

...

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

...

  1. Set up the dir.root

...

  1. location

...

  1. by

...

  1. adding

...

  1. it

...

  1. to

...

  1. the

...

  1. custom-repository.properties

...

  1. file.

...

  1. Code Block

...

  1. 
    dir.root=/home/repos/alf_data
    

...

  1. 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]
        

...

      1. 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;
        

...

      • Replace the database,

...

      • password

...

      • and

...

      • user

...

      • names

...

      • as

...

      • needed,

...

      • to

...

      • match

...

      • the

...

      • alfresco

...

      • server.

...

      • Select

...

      • a

...

      • password

...

      • that

...

      • will

...

      • be

...

      • secure.

...

  1. If

...

  1. this

...

  1. is

...

  1. going

...

  1. to

...

  1. be

...

  1. the

...

  1. second

...

  1. indepenant

...

  1. instance

...

  1. of

...

  1. Alfresco

...

  1. on

...

  1. a

...

  1. server,

...

  1. then

...

  1. edit

...

  1. the

...

  1. files:

...

  1. Code Block

...

  1. 
    $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.

...

  1. If

...

  1. this

...

  1. is

...

  1. going

...

  1. to

...

  1. be

...

  1. a

...

  1. WCM

...

  1. system,

...

  1. move

...

  1. the

...

  1. wcm-bootstrap-context.xml

...

  1. file

...

  1. into

...

  1. the

...

  1. extensions

...

  1. directory,

...

  1. and

...

  1. configure

...

  1. virtualization

...

  1. and

...

  1. TinyMCE.

...

    1. Move

...

    1. the

...

    1. bootstrap

...

    1. file

...

    1. for

...

    1. WCM.

...

    1. Code Block

...

    1. 
      cd $ALF_HOME
      mv wcm-bootstrap-context.xml tomcat/shared/classes/alfresco/extension
      

...

    1. 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
      

...

  1. #* Edit alfresco.virtserver.domain

...

  1. to

...

  1. have

...

  1. the

...

  1. IP

...

  1. address

...

  1. of

...

  1. the

...

  1. server

...

  1. receiving

...

  1. the

...

  1. Alfresco

...

  1. software:

...

  1. Code Block

...

  1. 
    alfresco.virtserver.domain=18-92-1-223.ip.alfrescodemo.net
    

...

  1. If this is going to be a clustered system, more or alter the following files to make a cluster configuration.
    1. Move the following files in $ALF_HOME/tomcat/share/classes/alfresco/extension

...

    1. Code Block

...

    1. 
      cp replicating-content-services-context.xml.sample  replicating-content-services-context.xml
      cp ehcache-custom.xml.sample.cluster ehcache-custom.xml
      

...

    1. Select an ID for the cluster ID, and alter the following properties in the custom-repository.properties

...

    1. file.

...

    1. Code Block

...

    1. 
      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