Installazione di ODT Reportman

---

Queste istruzioni per l'installazione sono state verificate su Ubuntu Precise (12.04) e Ubuntu Trusty (14.04) con il downgrade ad Apache 2.2

Librerie (Package)

Queste librerie sono un prerequisito per ODT Report Manager:

apt-get -y install libxml-simple-perl
cpan XML::Simple::Sorted
cpan IPC::Run::SafeHandles
cpan Text::Balanced

Perlbrew

A causa di ODF::lPod incompatibilità con la versione di Perl 5.14, usato da MasonSQL in alcune implementazioni, il Perlbrew deve essere installato per utilizzare una nuova versione di Perl.
Vedere la MasonSQL Configurazione Matrice.

Per installare Perlbrew, con tutte le librerie necessarie, eseguire lo script perlbrew-deploy.sh come utente root:

sudo /opt/masonsql/utility/perlbrew-deploy.sh

Libreoffice

# Si procede con privilegi di root.
sudo su -

# Installare ultima System.LibreOffice (5.0 o superiore).

# Ubuntu Precise (12.04)
apt-get install python-software-properties
# Ubuntu Trusty (14.04)
# apt-get install software-properties-common

sudo add-apt-repository ppa:libreoffice/ppa
sudo apt-get update
apt-get install openjdk-9-jre libreoffice-writer
# Se si utilizzano anche i file ODS
apt-get install libreoffice-calc
# Installare pdftk.
apt-get install pdftk

Demone Unoconv

Unoconv può essere utilizzato da ODT Report Manager per convertire i file .odt nel formato .pdf.
La variabile d'ambiente OdtConvEngine va configurata con "OdtConvEngine" in alternativa a "libreoffice".

# Si procede con privilegi di root.
sudo su -
# Installare l'ultima versione di Unoconv.
cd /tmp
apt-get install git
git clone https://github.com/dagwieers/unoconv
cd unoconv/
make install
cd ../
rm -rf unoconv/

# Ubuntu Trusty (14.04) - Dovete usare python3
sed -i~ 's/^#!\/usr\/bin\/env python$/#!\/usr\/bin\/env python3/' /usr/bin/unoconv

# Installare e avviare il demone Unoconv.
ln -s /opt/masonsql/etc/unoconvd /etc/init.d/unoconvd
update-rc.d  unoconvd defaults
service unoconvd start

Tabelle

Le query per la creazione delle tabelle ODT sono nella file di /opt/masonsql/utility/sql/odt_report_tables.mql.

Prima di applicare le query il nome del proprietario postgres devono essere modificate per il nuovo nome del proprietario my_db_owner_name.

Configurazione

ODT Report Manager utilizza un paio di variabili di configurazione di Apache.
Di seguito è riportato un esempio di configurazione nel file /opt/my_app_name/etc/apache2.my_app_name-devel.my_domain_name.conf:

# Percorso del file di configurazione di Apache
PerlSetVar ConfigPath /opt/my_app_name/etc/apache2.my_app_name-devel.my_domain_name.conf

# Directory temporanea
PerlSetVar TmpDir   /opt/my_app_name/tmp

# Configurazione motore di report di default:
# Rep = vecchio Report Manager
# Odt = new relazione di revisione stampata in formato odt
# Pdf = new ODT rapporto stampato in formato pdf
PerlSetVar DefaultReportEngine "pdf"
# L'accesso di ODT Reportman a DB
PerlSetVar ReportDBIconnect "dbi:Pg:dbname=my_db_name;user=report;password=MyReportPassword"

# Archivio per modelli
PerlSetVar InputFilesArchive "/opt/my_app_name/archive"

L'InputFilesArchive viene utilizzato da Files Component. La componente memorizza i file nelle sotto-directory che devono essere creati:

cd /opt/my_app_name/archive
mkdir public
chown www-data:www-data public
mkdir odt_reports
chown root:www-data odt_reports
chmod 775 odt_reports

Senza autorizzazioni di accesso corrette per il file di configurazione di Apache dell'applicazione ODT Report Manager restituisce un errore. Esempio di permessi impostati correttamente:

-rw-r----- 1 root www-data 10182 Aug 19 12:13  /opt/my_app_name/etc/apache2.labs.leader.it.conf

Per applicare le modifiche, il file di configurazione di Apache deve essere ricaricato:

/etc/init.d/apache2 reload

Funzioni e permessi

Esempio di configurazione dei permessi del ODT Reportman: