venerdì 20 settembre 2013

Procedura di aggiornamento di Alfresco Community (Versione Linux).



Prerequisiti:
  • Cartella di installazione: /opt/alfresco-4.x.x
  • DBMS: Postgresql
  • Installazione dal pacchetto binario.
  • Motore per l’indicizzazione dei documenti: SOLR (la procedura non prevede la migrazione degli indici dalla vecchia installazione a qualla nuova ma lareindicizzazione dei documenti quindi per repository abbastanza grandi ci vuole parecchio tempo).
    Passi da seguire per l’aggiornamento:
    1.    Fermare il server Alfresco:

    sh /opt/alfresco-4.x.x/alfresco.sh stop

    2.    Effettuare un backup dell’installazione corrente:

    cp /opt/alfresco-4.x.x /opt/backup_of_alfresco-4.x.x –R

    3.    Disabiltare l’indicizzazione dei documenti nella vecchia installazione:
    Modificare nel file
    /opt/alfresco-4.x.x/tomcat/shared/classes/alfresco-global.properties

    la seguente riga:

    ### Solr indexing ###
    index.subsystem.name=solr
    dir.keystore=${dir.root}/keystore
    solr.port.ssl=8443

    In questa:

    ### Solr indexing ###
    index.subsystem.name=noindex
    dir.keystore=${dir.root}/keystore
    #solr.port.ssl=8443


    4.    Avviare e fermare il server  Alfresco (fra una operazione e l’altra viene inserita una pausa di 5 minuti per essere sicuri che il server parta correttamente):

    sh /opt/alfresco-4.x.x/alfresco.sh start && sleep 300 && sh /opt/alfresco-4.x.x/alfresco.sh stop

    5.    Avviare il DBMS Postgresql:

    sh /opt/alfresco-4.x.x/alfresco.sh start postgresql

    6.    Effettuare il backup del database. La password che viene richiesta durante il processo è quella che è stata data in fase di installazione di Alfresco.
    su postgres
    cd /opt/alfresco-4.x.x/postgresql/bin/
          ./pg_dump -h localhost alfresco > /tmp/alfrescodbdump
    Password:

    exit

    7.    Fermare il DBMS Postgresql:
    sh /opt/alfresco-4.x.x/alfresco.sh stop

    8.    Rinominare o eliminare lo script di avvio del server Alfresco:
    rm /etc/init.d/alfresco
    oppure
    mv /etc/init.d/alfresco_old
    9.    Effettuare un backup dei documenti di log:
    mv /var/log/alfresco /var/log/alfresco.4.x.x && mkdir /var/log/alfresco

    10.  Installare la nuova versione di Alfresco utilizzando la medesima password della vecchia installazione. Quando viene chiesto di attivare Alfresco Share rispondere NO. Seguire l’installazione guidata inserendo i dati richiesti. Al termine disabilitare l’indicizzazione dei dati come visto in precedenza.

    11. Avviare la nuova installazione del DBMS Postgresql:

    /opt/alfresco-4.x.new /alfresco.sh start postgresql

    12. Eliminare il nuovo database e ripristinare il backup effettuato in precedenza:

    $ cd /opt/alfresco-4.x.new/postgresql/bin/
    $ ./dropdb alfresco -h localhost -i
    Database "alfresco" will be permanently
    removed.
    Are you sure? (y/n) y
    Password:
    $ ./createdb -T template0 alfresco -h localhost
    Password:
    $ ./psql alfresco -h localhost < /tmp/alfrescodbdump
    Password:
    (...)
    ALTER TABLE
    ALTER TABLE
    REVOKE
    REVOKE
    GRANT
    GRANT
    $ exit

    13. Fermare il DBMS Postgresql:
    sh /opt/alfresco-4.x.new/alfresco.sh stop

    14. Spostare il repository dei documenti dalla vecchia installazione alla nuova:
    cd /opt/alfresco-4.x.x/alf_data/

    mv contentstore contentstore.deleted /opt/alfresco-4.x.new/alf_data/

    15. Avviare e fermare il server  Alfresco (fra una operazione e l’altra viene inserita una pausa di 5 minuti per essere sicuri che il server parta correttamente):

    sh /opt/alfresco-4.x.new/alfresco.sh start && sleep 300 && sh /opt/alfresco-4.x.new/alfresco.sh stop

    16. Abilitare l’indicizzazione SOLR nel file:

    /opt/alfresco-4.x.new/tomcat/shared/classes/alfresco-global.properties

    Modificando:

    ### Solr indexing ###
    index.subsystem.name=noindex
    dir.keystore=${dir.root}/keystore
    #solr.port.ssl=8443

    In questo:

    ### Solr indexing ###
    index.subsystem.name=solr
    dir.keystore=${dir.root}/keystore
    #solr.port.ssl=8443

    17. A questo punto modificare il file di configurazione secondo le proprie esigenze. Avviare il server di Alfresco e ispezionare il file di log per verificare che non vi siano errori.

    18. Eliminare la vecchia cartella di installazione di Alfresco conservando il backup fatto all’inizio della procedura per sicurezza.