Strumenti Utente

Strumenti Sito

Ti trovi qui: home » documentazione_3di_riservata » manuali_sysadmin » inst_bonita7
Traccia:
documentazione_3di_riservata:manuali_sysadmin:inst_bonita7

Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

Link a questa pagina di confronto

documentazione_3di_riservata:manuali_sysadmin:inst_bonita7 [2021/07/21 12:43] – [Installazione Completa] alex.adamidocumentazione_3di_riservata:manuali_sysadmin:inst_bonita7 [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
Linea 1: Linea 1:
-====== Installazione Bonita 7 ====== 
-====Bundle pronto all'uso==== 
-//Un bundle della versione corretta lo puoi trovare in: // 
  
-<code> smb://storage.bo.priv/RESOURCES/Bonita/7.1.4/ </code> 
- 
- 
-====Installazione Completa==== 
- 
-Utilizzeremo il bundle di Bonita 7 + tomcat 7 e database PostgreSql 9.6 o inferiori. La guida ufficiale è consultabile [[http://documentation.bonitasoft.com/tomcat-bundle-2 | qui]] 
- 
-Dopo aver scaricato e scompattato il bundle in una cartella temporanea spostiamo l'intera struttura in /opt/ 
- 
-Successivamente creiamo un simlink alla cartella appena spostata chiamandolo bonita7 
- 
-[[https://www.digitalocean.com/community/tutorials/how-to-install-and-use-postgresql-on-centos-8 | Qui]] possiamo trovare una guida sull'installazione di PostgreSql per macchine CentOS/AlmaLinux 
- 
-===PostgreSql=== 
- 
-Se procedi con un installazione nuova dopo aver installato ed inizializzato il database modifica il file /var/lib/pgsql/data/pg_hba.conf come segue per attivare l'autenticazione al database: 
-<code> 
-# TYPE  DATABASE        USER            ADDRESS                 METHOD 
- 
-# "local" is for Unix domain socket connections only 
-local   all             all                                     peer 
-# IPv4 local connections: 
-host    all             all             127.0.0.1/32            md5 
-# IPv6 local connections: 
-host    all             all             ::1/128                 md5 
- 
-</code> 
-Configurare il database per usare UTF-8. 
- 
-Editare postgresql.conf e settare un non-zero value per max_prepared_transactions. 
-<WRAP center round info 70%> 
-NB: The default value, 0, disables prepared transactions, which is not recommended for Bonita BPM Engine. The value should be at least as large as the value set for max_connections (default is typically 100). See the PostgreSQL documentation for details. 
-</WRAP> 
- 
-====Inizializzazione e setup==== 
-Dopo aver installato PostgreSql e PostgreSql-server procediamo con l'inizializzazione e setup con il seguente comando: 
- 
-<code> 
-postgresql-setup --initdb 
-</code> 
- 
-Dovremo ricevere il seguente output: 
-<code> 
-* Initializing database in '/var/lib/pgsql/data' 
-* Initialized, logs are in /var/lib/pgsql/initdb_postgresql.log 
-</code> 
- 
-Ora abilitiamo e facciamo partire il servizio Postgresql con systemctl 
-<code> 
-systemctl enable --now postgresql 
-</code> 
- 
-====Creazione utente e db==== 
-Dopo aver fatto login come utente postgres con il comando: <code>su - postgres</code> Lanciamo il seguente comando: <code>psql</code> Dopodiché aggiungiamo l'utente bonita e creiamo i due database necessari al corretto funzionamento; 
- 
-<code> 
-postgres=# CREATE USER bonita WITH PASSWORD 'bonita'; 
-postgres=# CREATE DATABASE bonita7 WITH ENCODING 'UTF8' OWNER bonita; 
-postgres=# CREATE DATABASE bonita7_bd WITH ENCODING 'UTF8' OWNER bonita; 
-postgres=# \q 
-</code> 
- 
- 
-==== Scegli il database==== 
-Nella cartella bin editare il file setenv.sh e settare come segue: 
- 
-<code> 
-... 
-# Define the RDMBS vendor use by Bonita Engine to store data 
-DB_OPTS="-Dsysprop.bonita.db.vendor=postgres" 
- 
-# Define the RDMBS vendor use by Bonita Engine to store Business Data 
-# If you use different DB engines by tenants, please update directly bonita-tenant-community-custom.properties 
-BDM_DB_OPTS="-Dsysprop.bonita.bdm.db.vendor=postgres" 
-... 
-</code> 
-====Driver JDBC==== 
-Scarichiamo i Driver JDBC per postgres [[https://jdbc.postgresql.org/download.html#current | qui]] e mettiamoli nella cartella /opt/bonita7/lib/bonita . 
-====Configurazione Data Source==== 
-Editare il file /conf/bitronix-resources.properties e una volta commentate le righe che fanno riferimento al db H2 configurare correttamente quelle relative a postgres. 
-Esempio: 
-<code> 
-... 
-# PostgreSQL example  
-resource.ds1.uniqueName=jdbc/bonitaDSXA 
-resource.ds1.minPoolSize=1 
-resource.ds1.maxPoolSize=50 
- 
-resource.ds1.className=org.postgresql.xa.PGXADataSource 
-resource.ds1.driverProperties.user=bonita 
-resource.ds1.driverProperties.password=bonita 
-resource.ds1.driverProperties.serverName=localhost 
-resource.ds1.driverProperties.portNumber=5432 
-resource.ds1.driverProperties.databaseName=bonita7 
-resource.ds1.testQuery=SELECT 1 
-... 
-# PostgreSQL example  
-resource.ds2.uniqueName=jdbc/BusinessDataDSXA 
-resource.ds2.minPoolSize=0 
-resource.ds2.maxPoolSize=5 
- 
-resource.ds2.className=org.postgresql.xa.PGXADataSource 
-resource.ds2.driverProperties.user=bonita 
-resource.ds2.driverProperties.password=bonita 
-resource.ds2.driverProperties.serverName=localhost 
-resource.ds2.driverProperties.portNumber=5432 
-resource.ds2.driverProperties.databaseName=bonita7_bd 
-resource.ds2.testQuery=SELECT 1 
-... 
-</code> 
-Editare il file conf/Catalina/localhost/bonita.xml e agire come prima, avendo cura di commentare le risorse già presenti come segue: 
-<code> 
-<!-- ##################################################### --> 
-<!-- Configure Datasource for Bonita BPM standard database --> 
-<!-- ##################################################### --> 
-... 
-<!-- 
-    <!-- H2 Example --> 
-    <Resource name="bonitaSequenceManagerDS"   
-              auth="Container"   
-              type="javax.sql.DataSource"  
-              maxActive="17"   
-              minIdle="5"   
-              maxWait="10000"   
-              initialSize="3"  
-              validationQuery="SELECT 1" 
-              validationInterval="30000" 
-              removeAbandoned="true"  
-              logAbandoned="true"  
-              username="sa"  
-              password="" 
-              driverClassName="org.h2.Driver"  
-              url="jdbc:h2:tcp://localhost:9091/bonita_journal.db;MVCC=TRUE;DB_CLOSE_ON_EXIT=TRUE;IGNORECASE=TRUE;"/> 
---> 
-... 
-<!-- ##################################################### --> 
-<!-- Configure Business Data Datasource --> 
-<!-- ##################################################### --> 
-... 
-<!-- 
-<Resource name="NotManagedBizDataDS" 
-              auth="Container" 
-              type="javax.sql.DataSource" 
-              maxActive="17" 
-              minIdle="5" 
-              maxWait="10000" 
-              initialSize="3" 
-              validationQuery="SELECT 1" 
-              validationInterval="30000" 
-              removeAbandoned="true" 
-              logAbandoned="true" 
-              username="sa" 
-              password="" 
-              driverClassName="org.h2.Driver" 
-              url="jdbc:h2:tcp://localhost:9091/business_data.db;MVCC=TRUE;DB_CLOSE_ON_EXIT=TRUE;IGNORECASE=TRUE;"/> 
---> 
-</code> 
- 
-Esempio: 
-<code> 
-<!-- ##################################################### --> 
-<!-- Configure Datasource for Bonita BPM standard database --> 
-<!-- ##################################################### --> 
-... 
-<!-- Postgresql Example --> 
-    <Resource name="bonitaSequenceManagerDS" 
-              auth="Container" 
-              type="javax.sql.DataSource" 
-              maxActive="17" 
-              minIdle="5" 
-              maxWait="10000" 
-              initialSize="3" 
-              validationQuery="SELECT 1" 
-              validationInterval="30000" 
-              removeAbandoned="true" 
-              logAbandoned="true" 
-              username="bonita" 
-              password="bonita" 
-              driverClassName="org.postgresql.Driver" 
-              url="jdbc:postgresql://localhost:5432/bonita7"/> 
-... 
-               
-<!-- ##################################################### --> 
-<!-- Configure Business Data Datasource --> 
-<!-- ##################################################### --> 
-... 
-<!-- Postgresql Example --> 
-    <Resource name="NotManagedBizDataDS" 
-              auth="Container" 
-              type="javax.sql.DataSource" 
-              maxActive="17" 
-              minIdle="5" 
-              maxWait="10000" 
-              initialSize="3" 
-              validationQuery="SELECT 1" 
-              validationInterval="30000" 
-              removeAbandoned="true" 
-              logAbandoned="true" 
-              username="bonita" 
-              password="bonita" 
-              driverClassName="org.postgresql.Driver" 
-              url="jdbc:postgresql://localhost:5432/bonita7_bd"/> 
-... 
-</code> 
- 
- 
-Rimuoviamo il listener h2 (così che h2 non venga lanciato in automatico), commentando la linea del listener h2 nel file: /opt/bonita7/conf/server.xml 
-<code> 
-  <!-- Listener className="org.bonitasoft.tomcat.H2Listener" tcpPort="9091" baseDir="${catalina.home}/bonita/engine-server/work/platform" start="true" /--> 
-</code> 
- 
-E cambiamo anche le porte di default scendendo di 1000 (es. 8080 diventerà 7080). 
- 
-<WRAP center round info 80%> 
-In caso di importazioni corpose bisogna settare la property di timeout correttamente in conf/bitronix-config.properties 
-<code sh> 
-bitronix.tm.timer.defaultTransactionTimeout=180 
-</code> 
-</WRAP> 
- 
-Nel file setenv(bat|sh) possiamo inserire i valori corretti di sorgenti e risorse(es: Ram destinata al tomcat) <NB:Esempio per LINUX> 
- 
-<code bash> 
-#!/bin/sh 
- 
-# Set some JVM system properties required by Bonita BPM 
- 
-# Bonita home folder (configuration files, temporary folder...) location 
-BONITA_HOME="-Dbonita.home=${CATALINA_HOME}/bonita" 
- 
-# Define the RDMBS vendor use by Bonita Engine to store data 
-DB_OPTS="-Dsysprop.bonita.db.vendor=postgres" 
- 
-# Define the RDMBS vendor use by Bonita Engine to store Business Data 
-# If you use different DB engines by tenants, please update directly bonita-tenant-community-custom.properties 
-BDM_DB_OPTS="-Dsysprop.bonita.bdm.db.vendor=postgres" 
- 
-# Bitronix (JTA service added to Tomcat and required by Bonita Engine for transaction management) 
-BTM_OPTS="-Dbtm.root=${CATALINA_HOME} -Dbitronix.tm.configuration=${CATALINA_HOME}/conf/bitronix-config.properties" 
- 
-# Optionnal JAAS configuration. Usually used when delgating authentication to LDAP / Active Directory server 
-#SECURITY_OPTS="-Djava.security.auth.login.config=${CATALINA_HOME}/conf/jaas-standard.cfg" 
- 
-# Pass the JVM system properties to Tomcat JVM using CATALINA_OPTS variable 
-CATALINA_OPTS="${CATALINA_OPTS} ${BONITA_HOME} ${DB_OPTS} ${BDM_DB_OPTS} ${BTM_OPTS} -Dfile.encoding=UTF-8 -Xshare:auto -Xms1536m -Xmx1536m -XX:MaxPermSize=256m -XX:+HeapDumpOnOutOfMemoryError" 
-export CATALINA_OPTS 
- 
-# Only set CATALINA_PID if not already set (check for empty value) by startup script (usually done by /etc/init.d/tomcat7 but not by startup.sh nor catalina.sh) 
-if [ -z ${CATALINA_PID+x} ]; then 
-        CATALINA_PID=${CATALINA_BASE}/catalina.pid; 
-        export CATALINA_PID; 
-fi 
- 
- 
-</code> 
-<WRAP center round info 80%> 
-Una volta avviata l'applicazione bisogna collegarsi con l'utente install\install e creare un utente administrator, i gruppi ed i ruoli necessari. 
-</WRAP> 
- 
-In caso si volesse partire con un db pulito già pronto (in caso di problemi con l'installazione) questa è la procedura partendo dai  file di dump che sono scaricabili da: <code>smb://storage.bo.priv/RESOURCES/Bonita/bonita7_dump/</code> 
- 
- 
- 
-  - Drop database come utente postgres; 
-  - Creazione database vuoto come utente postgres; 
-  - cat bonita7.sql |psql -U bonita -d bonita7 -h 10.17.61.242; 
-  - cat bonita7_bd.sql |psql -U bonita -d bonita7_vd -h 10.17.61.242; 
- 
-==== Windows ==== 
-In caso di installazione in produzione sarebbe il caso di installare un tomcat7 pulito e gestirlo come servizio. 
-Ho eseguito dei test di installazione in una macchina windows e sono riuscito a far partire correttamente bonita 7 su postgreSQL con le seguenti properties: 
-<code> 
--Dcatalina.home=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7 
--Dcatalina.base=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7 
--Djava.endorsed.dirs=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7\endorsed 
--Djava.io.tmpdir=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7\temp 
--Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager 
--Djava.util.logging.config.file=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7\conf\logging.properties 
--Dbonita.home=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7\bonita 
--Dsysprop.bonita.db.vendor=postgres 
--Dsysprop.bonita.bdm.db.vendor=postgres 
--Dbtm.root=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7 
--Dbitronix.tm.configuration=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7\conf\bitronix-config.properties 
--Djava.security.auth.login.config=E:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7Bonita7\conf\jaas-standard.cfg 
--Dfile.encoding=UTF-8 
--Xshare:auto 
-</code> 
- 
-Installare il Tomcat7 0.55 come servizio (nel caso di installazione su server dove la porta 8080 risulti già in uso utilizzare ad esempio la porta 9080) 
-Dopo aver scaricato il bundle di deploy in Tomcat7 modificare il file conf/server.xml ad hoc e di seguito i file sopra indicati. 
-Ricordarsi di inserire le variabili all'interno dell'eseguibile tomcat7w.exe del Tomcat 7 appena installato. 
/data/attic/documentazione_3di_riservata/manuali_sysadmin/inst_bonita7.1626864209.txt.gz · Ultima modifica: 2021/07/21 12:43 da alex.adami