In questa guida vedremo i passaggi per installare DocWay 4.50 su macchine Red Had based (CentOS, Alma, Rocky, ecc). DocWay 4.50 necessita di alcune accortense per poter funzionare:

• Replicaset MongoDB 4.2 o successivo (o compatibile) [min 3 nodi]
• Elasticsearch 7.10.2 (o compatibile)
• spazio storage per gli allegati accessibile da ogni applicazione

Per l'installazione dei repository faremo riferimento alla documentazione ufficiale indicando dove necessario eventuali punti sui quali fare attenzione oppure suggerimenti.

Per l'installazione di MongoDB visitare la pagina ufficiale

Aggiornata alla versione 5.0

Inserire il repository yum

/etc/yum.repos.d/mongodb-org-5.0.repo

[mongodb-org-5.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/5.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc

Aggiornare i repository e installare i pacchetti

dnf repolist
dnf install -y mongodb-org

er l'installazione di MongoDB visitare la pagina ufficiale

Aggiornata alla versione 4.4

Installare e abilitare il repository ufficiale di Percona

dnf install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
percona-release enable psmdb-44 release

Installare i software necessari

dnf install percona-server-mongodb

La procedura va replicata su tutti i server Database; per la configurazione del replicaset si rimanda alla guida ufficiale

Per l'installazione di Opendistro for elasticseach seguiremo la pagina ufficiale che prevede l'installazione di un pacchetto rpm.

Per l'installazione di OpenSearch seguiremo la pagina ufficiale che prevede l'utilizzo dell'archivio tar autoconsistente.

Le cose importanti da modificare sono:

opensearch.yml

cluster.name: docway
node.name: node1
bootstrap.memory_lock: true
network.host: 0.0.0.0
discovery.seed_hosts: ["168.119.174.23", "168.119.173.217"]
cluster.initial_master_nodes: ["node1", "node2", "node3"]
node.master: true
node.data: true
node.ingest: true

Impostare le variabili d'ambiente

/etc/sysctl.conf

vm.max_map_count: 262144
fs.file-max: 65536

e fare il reload

sysctl -p

Per avviare il servizio con systemd è possibile usare il file

/etc/systemd/system/opensearch.service

[Unit]
Description=opensearch
Wants=network-online.target
After=network-online.target
 
[Service]
RuntimeDirectory=opensearch
PrivateTmp=true
 
WorkingDirectory=/opt/opensearch
 
User=opensearch
Group=opensearch
 
ExecStart=/opt/opensearch/bin/opensearch -p /opt/opensearch/opensearch.pid -q
 
StandardOutput=journal
StandardError=inherit
 
# Specifies the maximum file descriptor number that can be opened by this process
LimitNOFILE=65536
 
# Specifies the memory lock settings
LimitMEMLOCK=infinity
 
# Specifies the maximum number of processes
LimitNPROC=4096
 
# Specifies the maximum size of virtual memory
LimitAS=infinity
 
# Specifies the maximum file size
LimitFSIZE=infinity
 
# Disable timeout logic and wait until process is stopped
TimeoutStopSec=0
 
# SIGTERM signal is used to stop the Java process
KillSignal=SIGTERM
 
# Send the signal only to the JVM rather than its control group
KillMode=process
 
# Java process is never killed
SendSIGKILL=no
 
# When a JVM receives a SIGTERM signal it exits with code 143
SuccessExitStatus=143
 
[Install]
WantedBy=multi-user.target

In questa versione di DocWay gli allegati vengono salvati direttamente su filesystem e quindi sorge la necessità di avere uno spazio di archiviazione accessibile da tutte le macchine che devono trattare gli allegati (DocWay4, MSA, FCS, ecc).

Nei casi in cui le applicazioni risiedono su server diversi è necessario utilizzare un filesystem condiviso (possibilmente ridondato es: glusterFS).

Per l'installazione di tomcat utilizziamo l'archivio tar autoconsistente.

TODO

TODO

TODO