Cet article présente les étapes de l’installation du système Comarch ERP Enterprise sur le serveur avec le système d’exploitation CentOS Linux 7 et le moteur de la base de données PostgreSQL.
Configurations requises
Le guide d’installation suivant concerne :
- Système d’exploitation : Linux CentOS 7
- Moteur de base de données : PostgreSQL 9.2.24
Avant l’installation, il faut vérifier :
- si l’utilisateur postgres (utilisateur par défaut du moteur PostgreSQL) possède la possibilité de connexion au système à l’aide de la commande : su postgres
- le port sur lequel s’exécute le serveur SQL, il sera utilisé dans la partie suivante du guide. Par défaut, c’est le port : 5432
- l’espace libre sur le disque dur. Les fichiers d’installation et le système installé ont besoin au total 30 Go de mémoire libre sur disque
- l’accès disponible à l’utilisateur root ou un autre qui possède les autorisations sudo
- les exigences spécifiées par CentOS Linux et PostreSQL et les mises à jour obligatoires du logiciel installées
Conventions
Il est indispensable d’assurer une structure de répertoires uniforme, particulièrement au cas où plusieurs systèmes sont hébergés sur un seul serveur.
Répertoires et package d’installation
Veuillez créer des répertoires d’installation suivants via les commandes :
- mkdir /opt/comarch
- mkdir /opt/comarch/CUS610 – répertoire où le système sera installé
- mkdir /opt/comarch/CIS610PB – répertoire avec le package d’installation
Ensuite, extrayez le package d’installation du système CEE dans l’emplacement /opt/comarch/CIS610PB. Le package contient des fichiers système, des scripts et d’autres fichiers requis pendant l’installation.
Installation JDK
Comarch ERP Enterprise se base sur le langage de programmation Java et requiert Java Development Kit (JDK) comme l’environnement de démarrage.
Version JDK requise pour la version du système Comarch ERP Enterprise :
| Version du système Comarch ERP Enterprise | Version JDK |
| 6.1 | 11 |
La procédure d’installation de JDK décrite ci-dessous est obligatoire seulement à la première installation ou le changement de version de JDK.
Procédure : installation de Java JDK
Le package actuel de JDK en version 11 est disponible à télécharger à partir de https://adoptopenjdk.net/. Après son téléchargement, veuillez effectuer des pas suivants :
- Situer le package téléchargé sur serveur
- Créer un répertoire mkdir /opt/comarch/java/
- Extraire le package téléchargé *.tar.gz sur serveur dans l’emplacement créé (/opt/comarch/java/)
Installation de Comarch ERP Enterprise
Vous trouverez dans le package d’installation de Comarch ERP Enterprise une archive avec des fichiers Comarch ERP Enterprise et des scripts nécessaires pour le moteur de la base de données PostgreSQL.
Création des bases de données
La création des bases consiste à exécuter les scripts du répertoire d’installation. Pour cela, connectez-vous en tant qu’utilisateur postgres :
su – postgres
Ensuite, passez au dossier où se trouvent des scripts de création des bases de données :
cd /opt/comarch/CIS610PB/install/scripts/linux/postgres/tools/
Dans ce dossier, exécutez le script crtdbenv.sh avec les paramètres :
Le script va créer une base vide sur le serveur SQL. Veuillez utiliser ce script et créer trois bases différentes :
- base de configuration
- base du référentiel
- base de production OLTP
Les commandes ci-dessous lancent les scripts qui créent les bases mentionnées au préalable :
./crtdbenv.sh -a -n CUSCF -p 5432
./crtdbenv.sh -a -n CUS610RP -p 5432
./crtdbenv.sh -a -n CUS61000 -p 5432
Après cette opération, connectez-vous à nouveau en tant qu’opérateur root à l’aide de la commande :
su root
Extraction du répertoire système
Le fichier semiramis.zip se trouve dans l’emplacement /opt/comarch/CIS610PB/. Il comporte le répertoire principal du système. Il devrait être extrait dans le répertoire système de destination, à savoir /opt/comarch/CUS610/
Notice permettant d’extraire le package dans l’emplacement approprié :
unzip /opt/comarch/CIS600PB/semiramis.zip -d /opt/comarch/CUS610
Pour extraire le package ZIP, vous pouvez utiliser n’importe quel outil. La notice mentionnée utilise l’outil Unzip. Il peut s’avérer nécessaire d’installer cet outil dans le système à l’aide de la commande suivante :
yum install unzip -y
Après avoir extrait le package, le répertoire CUS610 devrait contenir le dossier semiramis.
Patch
Le patch permet de démarrer le système sur les fichiers substitués ou avec des fichiers supplémentaires sans interférer dans la structure de répertoires d’origine.
Les patchs peuvent être mis dans le répertoire /opt/comarch/CUS610/semiramis/patch/. Les packages chargés doivent avoir la même structure de répertoires que les répertoires dans le dossier semiramis.
Ensuite, copiez à partir du dossier où les fichiers d’installation sont stockés tout le répertoire com qui comporte les fichiers de correctif. Il devrait être mis dans l’emplacement /opt/comarch/CUS610/semiramis/patch/cisag/. La commande cp ci-dessous effectue la copie :
cp -r /opt/comarch/CIS610PB/com/ /opt/comarch/CUS610/semiramis/patch/cisag/
Le correctif copié dans cette étape sera utilisé lors du remplissage de la base de données dans l’étape Remplissage des bases de données.
Connexion à la base de configuration
Dans cette étape, la connexion à la base de configuration est établie. Pour cela, le script crtconnprop.sh est exécuté. Il prend successivement les arguments :
- nom du système
- emplacement du répertoire d’installation databases
- ID pour le moteur PostgreSQL = 9
- JDBC ID pour le moteur PostgreSQL = 13
- adresse réseau du serveur SQL
- nom de la base de configuration
/opt/comarch/CIS610PB/install/scripts/linux/crtconnprop.sh CUS610 /opt/comarch/CIS610PB /install/databases 9 13 jdbc:postgresql://localhost:5432 CUSCF
Importation de la licence système et enregistrement des informations dans la base de données de configuration
La licence logicielle est indispensable pour installer le système.
Avant de procéder à l’installation ci-dessous, veuillez copier sur serveur le fichier de licence du système CEE, à titre d’exemple vers l’emplacement /opt/comarch/CIS610PB/.
Pour importer le certificat et enregistrer les informations dans la base de données de configuration, le script cfgsys.sh est exécuté. Il prend les arguments suivants :
- emplacement du système
- emplacement du répertoire JDK
- emplacement du fichier de licence
- nom du fichier de licence
- mot de passe de la licence
- nom du fichier .jar correspondant au moteur de la base de données PostgreSQL = postgresql-9.4.1212.jar
/opt/comarch/CIS610PB/install/scripts/linux/cfgsys.sh /opt/comarch/CUS610 /opt/comarch/java/jdk-11.0.7+10 /opt/comarch/CIS610PB/ 400-CUS610-01-CUS610.lic passwrd postgresql-9.4.1212.jar
Vérification du fichier connection.properties
Le fichier connection.properties se trouve dans l’emplacement /opt/comarch/CIS610PB/install/databases/.
Avant l’étape suivante, veuillez modifier son contenu car il servira à remplir les bases de données vides avec les objets et données de base. Le fichier se compose des entrées à structure suivante :
<nom_de_la_base_de_données>.<paramètre>:<valeur>
À la fin du fichier connection.properties après le mot databases : toutes les bases sont mentionnées pour lesquelles la configuration sera utilisée à remplir les bases de données dans l’étape suivante.
Paramètres :
- source – désigne le nom de la base de données de référence du répertoire database
- ContentType – type de base (Base : 1 – de configuration, 2- du référentiel, 3 – OLTP, 4 – OLAP)
- Type – ID pour le moteur de la base de données (PostgreSQL = 9)
- Driver – JDBC ID pour le moteur de la base de données (PostgreSQL = 13)
- DriverAccessPath – emplacement réseau du serveur SQL
Contenu exemplaire du fichier rempli pour l’installation :
CUSCF.source:CONFIGURATION_CIS600PBCF
CUSCF.ContentType:1
CUSCF.Type:9
CUSCF.Driver:13
CUSCF.DriverAccessPath:jdbc:postgresql://localhost:5432/CUSCF
CUS61000.source:OLTP_CIS600PB02
CUS61000.ContentType:3
CUS61000.Type:9
CUS61000.Driver:13
CUS61000.DriverAccessPath:jdbc:postgresql://localhost:5432/CUS61000
CUS610RP.source:REPOSITORY_CIS600PBRP
CUS610RP.ContentType:2
CUS610RP.Type:9
CUS610RP.Driver:13
CUS610RP.DriverAccessPath:jdbc:postgresql://localhost:5432/CUS610RP
databases:CUS610RP, CUS61000, CUSCF
Remplissage des bases de données
Après l’exécution de la commande ci-dessous, les bases de données mentionnées dans le fichier connection.properties seront remplies avec la structure, les objets et les données de base.
Le patch qui modifie la classe ImportSystem y sera utilisé.
/opt/comarch/java/jdk-11.0.7+10/bin/java -cp /opt/comarch/CUS610/semiramis/classes:/opt/comarch/CUS610/semiramis/lib/postgresql-42.2.6.jar:/opt/comarch/CUS610/semiramis/patch/classes:/opt/comarch/CUS610/semiramis/lib/cisag-se.jar com.cisag.sys.kernel.sql.ImportSystem -d:/opt/comarch/CIS610PB/install/databases
Script de démarrage du serveur des applications
Chaque système CEE doit avoir au moins un serveur des applications (SAS). Par défaut, c’est : MESSAGESERVER.
Afin de démarrer ce serveur, il est nécessaire d’avoir le script qui exécute l’instance du système.
Pour cela, il faut :
Créer un répertoire pour le serveur des applications (SAS) :
mkdir /opt/comarch/EGERIASUPPORT/semirmis/servers/MESSAGESERVER
Créer un fichier strass-MESSAGESERVER.sh :
vi /opt/comarch/CUS610/semiramis/servers/MESSAGESERVER/strass-MESSAGESERVER.sh
Remplir le fichier avec le contenu ci-dessous. Les paramètres doivent être adaptés au système installé :
- SAS – nom du serveur des applications
- SYSTEM – nom du système
- SYSTEM_DIR – répertoire où se trouve le système CEE
- JDK – indication du répertoire de JDK
export SAS=”MESSAGESERVER”
export SYSTEM=”CUS610″
export SYSTEM_DIR=”/opt/comarch/${SYSTEM}”
export JDK=”${SYSTEM_DIR}/jdk”
export SEMIRAMIS_START=”rlwrap semiramis.sh -toolUser:ADMINISTRATOR ${SAS}”
#export SEMIRAMIS_REMOTE_JCONSOLE=20010
if [ “x${SEMIRAMIS_LOCAL}” != “x” ]; then
“${SEMIRAMIS_START}”
exit 0
fi
export SEMIRAMIS_LOCAL=”${SYSTEM_DIR}/semiramis”
cd “${SEMIRAMIS_LOCAL}/servers/${SAS}”
#echo “\”${SEMIRAMIS_LOCAL}/bin/unix/env.sh\” \”${JDK}\” \”${SEMIRAMIS_LOCAL}\””
“${SEMIRAMIS_LOCAL}/bin/unix/env.sh” “${JDK}” “${SEMIRAMIS_LOCAL}”
Fin de la modification et enregistrement dans l’éditeur Vim :
:x
Lien et autorisations pour JDK
Veuillez exécuter les commandes suivantes qui visent à créer des liens système à JDK et à attribuer la possibilité de lancer le script de démarrage :
ln -s /opt/comarch/java/jdk-11.0.7+10 /opt/comarch/CUS610/jdk
chmod 755 /opt/comarch/CUS610/semiramis/servers/MESSAGESERVER/strass-MESSAGESERVER.sh
chmod 755 /opt/comarch/CUS610/semiramis/bin/unix/*.sh
Démarrage du serveur des applications de Comarch ERP Enterprise
Pour démarrer le serveur des applications pour la première fois, veuillez effectuer des opérations suivantes :
Aller au répertoire du serveur des applications :
cd /opt/comarch/EGERIASUPPORT/semiramis/servers/MESSAGESERVER
Exécuter le script pour démarrer SAS :
./strsas-MESSAGESERVER.sh
Création des informations sur la base de données
Pour que le système puisse utiliser correctement les bases de données déclarées dans le système, veuillez exécuter les commandes qui créent les informations sur les bases de données.
Après le démarrage correct du serveur des applications, le message suivant est affiché : ADMINISTRATOR@MESSEAGESERVER>
Ici, veuillez émettre les commandes dans le shell du serveur des applications.
Pour créer les informations sur les bases (de configuration, du référentiel, OLTP), il faut exécuter les commandes ci-dessous individuellement dans l’ordre recommandé suivant :
crtdbinf -configuration
crtdbinf -repsitory
crtdbinf -oltp
Changement d’adresse URL SAS
Par défaut, SAS est enregistré à l’adresse URL https://localhost. Pour changer cette adresse, veuillez effectuer les étapes suivantes :
Démarrer SAS MESSAGESERVER (s’il n’est pas démarré)
Pour accéder au serveur des applications de Comarch ERP Enterprise démarré via un navigateur Internet en tapant l’adresse URL, il est recommandé d’avoir la connexion HTTPS. Vu cela, le certificat est requis. L’adresse exemplaire c’est : https://CEE.votreentreprise.pl
La commande ci-dessous pour le serveur des applications va changer l’adresse URL de (https://localhost) en adresse demandée sous laquelle SAS est disponible :
chgsas -sas:MESSAGESERVER -baseURL:https://CEE.votreentreprise.pl
Pour valider l’avertissement, appuyez sur la touche [y] au clavier
SYS-3046 Modification du serveur des applications « LOCALHOST » du système « CUS610 ».
Des avertissements suivants ont apparu :
Avertissement : SYS-3511 Le nom de l’hôte de l’adresse URL initiale n’est pas identique à la valeur « Issued for » du certificat. Le certificat du serveur des applications Comarch ERP Enterprise doit être généré pour la nouvelle fois pour que les clients puissent reconnaitre ce serveur et se connecter sur lui. Sans nouveau certificat, les clients ne vont pas vérifier l’identité du serveur et refuseront de se connecter. Veuillez valider ces avertissements : y=yes , n=no , a=all
La commande suivante génère un nouveau certificat du serveur pour l’adresse URL définie pour SAS :
crtsascert -sas:MESSAGESERVER -issuer:COMARCH
L’utilisation de la commande ci-dessous définira le répertoire du serveur de fichiers SAS :
chgsas -sas:MESSAGESERVER -fileServerDirectory:/opt/comarch/CUS610/semiramis
La commande restart va redémarrer SAS MESSAGESERVER du système Comarch ERP Enterprise.
Dorénavant, le serveur WWW du serveur des applications acceptera les connexions à l’adresse URL https://CEE.votreentreprise.pl en s’appuyant sur le certificat du serveur nouvellement délivré.
Connexion à Comarch ERP Enterprise
La première connexion au système via le navigateur est réalisée en tapant le nom d’utilisateur et le mot de passe.
Nom d’utilisateur : ADMINISTRATOR
Mot de passe : 1234567
Il est recommandé que la connexion de tous les utilisateurs s’effectue via les certificats individuels délivrés.
L’utilisateur devrait installer le certificat .PFX sur son ordinateur personnel. Après l’installation du certificat, l’utilisateur pourra obtenir l’accès au site https://CEE.votreentreprise.pl. Durant l’authentification, une fenêtre avec une demande d’indiquer le certificat installé est affichée. Le certificat indiqué est mémorisé par le navigateur dans la cadre de la session de navigateur.
La connexion sur un autre utilisateur en utilisant un autre certificat peut se produire après le nouveau démarrage du navigateur ou en mode privé.
Démarrage du serveur des applications comme service
Ci-dessous, nous présentons la façon la plus simple permettant de démarrer le serveur des applications avec le démarrage du système d’exploitation. Pour cela, on utilise l’outil Crontab et il faut :
- Taper la commande dans le shell système : crontab -e
- Ajouter une ligne
@reboot sleep 80 && /opt/comarch/CUS610/semiramis/servers/MESSAGESERVER/strass-MESSAGESERVER.sh
- Enregistrer et terminer la modification via la commande :
:wq
Désinstallation de Comarch ERP Enterprise
Pour désinstaller le système Comarch ERP Enterprise, veuillez effectuer les étapes suivantes :
Quitter tous les serveurs qui peuvent accéder à la base de données
Appeler le script supprimant les objets (rôles, bases) liés au système CEE indiqué sur le moteur de la base de données
/opt/comarch/CIS610PB/install/scripts/linux/postgres/tools/dltdbenv.sh -a -n CUS610
Le script ci-dessus prend les paramètres suivants :
- -a – tout supprimer
- -n <nom_du_système> – nom du système
Supprimer les fichiers enregistrés dans le répertoire /opt/comarch/CUS610
En conséquence, le système Comarch ERP Enterprise est désinstallé.