- 5, rue Soutrane - 06560 Valbonne Sophia-Antipolis E-mail : contact@nqicorp.com - Web : http://www.nqicorp.com
NQI Orchestra 3.3 - Guide d'installation Linux.................................................................... 3 Installation Linux - Prérequis Bases de données............................................................... 3 Installation Linux - Etapes................................................................................ 4 Installation Linux - Gestion des licences..................................................................... 6 Installation Linux - Arrêt et Démarrage...................................................................... 7 Installation Linux - Résumé des composants installés.......................................................... 7
NQI ORCHESTRA 3.3 - GUIDE D'INSTALLATION LINUX Sommaire NQI Orchestra - Guide d'installation Linux Ce document recense l'ensemble des opérations liées à l'installation de NQI Orchestra sous Linux. Il s'adresse à un public averti et familier des environnements Linux. Installation Linux - Prérequis Bases de données Installation Linux - Etapes Installation Linux - Gestion des licences Installation Linux - Arrêt et Démarrage Installation Linux - Résumé des composants installés INSTALLATION LINUX - PRÉREQUIS BASES DE DONNÉES NQI Orchestra peut être installé avec une base de données open source, PostgreSQL, ou avec une des deux bases de données propriétaires suivantes : Oracle et Microsoft SQL Server. Rappel : l'installation et l'administration des bases de données sont à la charge du client. PostgreSQL Lorsque l'option PostgreSQL est choisie, on devra s'assurer des points suivants : Oracle Le serveur de base de données est déjà installé et démarré. La version de PostgreSQL est 8.4 ou 9.1 Une base de données dédiée à Orchestra a été créée au format UTF8. Ex : nqidb Lorsque l'option Oracle est choisie, assurez vous des points suivants : la version d'oracle est 10g ou 11g la base de données est déjà installée et démarrée un utilisateur nqi (le nom peut être différent) est créé, avec les rôles CONNECT, RESOURCE et le privilège CREATE VIEW. Microsoft SQL Server Lorsque l'option Microsoft SQL Server est choisie, assurez vous des points suivants (les noms de la base de données, de l'utilisateur et de la connexion peuvent être différents de 'nqi'): la version de SQL Server 2005 SP3 ou 2008 SP2 la base de données est déjà installée et démarrée, avec l'option authentification de type «SQL Server et Windows». une base nommée nqidb est créée, avec l'option «Valeur par défaut ANSI NULL» à True. un utilisateur nqi est créé dans la base nqidb, avec le droit db_owner une connexion nqi est créée avec comme base de données par défaut nqidb et accès à celle-ci via l'utilisateur nqi. 3
Fixer le port d'écoute SQL Server permet d'installer plusieurs instances de bases de données par serveur. Chaque instance est identifiée par un nom spécifique. Pour établir une connexion avec une instance nommée de SQL Server, vous pouvez soit spécifier le numéro de port de l'instance nommée, soit spécifier le nom d'instance comme propriété d'url JDBC ou propriété datasource. Microsoft recommande de fixer le port d'écoute pour des raisons de performance. C'est de cette manière que NQI Orchestra se connecte à MS SQL Server (Source: http://msdn.microsoft.com/fr-fr/library/ms378428.aspx ) Le numéro de port de l'instance nommée est la plupart du temps différent de 1433. Pour trouver ou modifier le port d'une instance nommée: Microsoft SQL Server 2005 --> Configuration Tools --> SQL Server Configuration Manager Sous SQL Server Configuration Manager, aller dans SQL Server 2005 Network Configuration-->Protocols for <Mon Instance> Si ce n'est pas déjà le cas, activer l'option VIA en double cliquant dessus Ouvrir la partie TCP/IP, onglet Adresses IP, Section IPAll Le port utilisé par l'instance est précisé par la propriété "Port TCP dynamique". Il est possible de le modifier. C'est ce port qu'il faut entrer lors de l'installation d'orchestra. Il doit impérativement être différent de 0. (0 correspond à une allocation dynamique de port au démarrage de SQL Server) (Source: http://social.msdn.microsoft.com/forums/en-us/sqlreportingservices/thread/bd5bb6c2-a4d9-4071-b2e6-a6c83970b212 ) INSTALLATION LINUX - ETAPES Ce chapitre décrit le paramétrage de l'installation ainsi que l'exécution de l'installation. Les propriétés marquées concernent l'installation d'nqi Orchestra avec l'option gestion documentaire uniquement. Introduction Le kit d'installation se présente sous la forme d'une archive à décompresser dans un répertoire temporaire. Les paramètres d'installation doivent être configurés dans le fichier install.properties. La suite de ce chapitre décrit chaque paramètre de l'installation. Paramètres d'installation obligatoires install.directory Le répertoire où sera installé l'application. Il est nécessaire de rentrer le chemin complet (ex: /home/nqi/orchestra). Le chemin du répertoire d'installation ne doit pas comporter d'espace. Ce répertoire sera supprimé puis recréé à l'installation. Veillez à ne pas y placer de données si ce répertoire est créé avant l'installation ou à en faire une copie. starting.user L'utilisateur système qui sera utilisé pour lancer le processus. C'est aussi l'utilisateur qui sera propriétaire du répertoire et des fichiers de l'application. default.language Langue par défaut des utilisateurs de l'application. Les valeurs possibles pour cette propriété sont : fr en with.alfresco 4
Cette propriété spécifie si l'installation comprend la gestion documentaire ou non.les valeurs possibles pour cette propriété sont : DATABASE true (avec gestion documentaire) false (sans gestion documentaire) Serveur de base de données utilisé. Les valeurs possibles pour cette propriété sont: db.host mssql oracle postgres Le nom ou adresse IP de la machine où est installé le serveur de base de données (localhost si la base de données est installée sur le même serveur que l'application NQI Orchestra) db.port Le port d'écoute de la base de données. Ci-dessous les ports d'écoute standards pour les bases supportées par Orchestra : db.instance Oracle : 1521 PostgreSQL : 5432 MS SQL Server : 1433 Le nom de la base ou de l'instance (pour Oracle) sur laquelle seront stockées les données de l'application. db.user L'utilisateur (défini en base) utilisé pour se connecter à la base de données. db.password Le mot de passe de cet utilisateur. disable.initdb Cette propriété spécifie si la base doit être initialisée (création des tables et des données) ou non. Les valeurs pour cette propriété sont: true (n'initialise pas la base, recommandé dans le cas d'une migration d'un autre serveur par exemple) false (initialise la base, recommandé dans tous les autres cas) alfresco.db.instance Le nom de la base ou de l'instance (pour Oracle) sur laquelle seront stockées les données de la gestion documentaire. alfresco.db.user L'utilisateur (défini en base) utilisé pour se connecter à la base de données de la gestion documentaire. alfresco.db.password Si l'option Gestion documentaire a été choisie. Le mot de passe de l'utilisateur utilisé pour se connecter à la base de données de la gestion documentaire. cpms.hostname Le nom ou l'adresse IP de la machine sur laquelle est installée l'application. Le nom du serveur ne doit pas contenir cpms. cpms.http.port Le port http utilisé par l'application. 5
Attention: L'utilisation d'un port inférieur à 1024 implique de démarrer l'application en tant que root. (voir starting.user). smtp.host Adresse du serveur SMTP qui sera utilisé par l'application pour envoyer des emails aux utilisateurs. smtp.port Port d'écoute du serveur SMTP qui sera utilisé par l'application pour envoyer des emails aux utilisateurs. Le port d'écoute standard des serveurs SMTP est le 25. Paramètres d'installation optionnels cpms.access.url URL d'accès à l'application. Cette URL servira de base pour construire les liens html contenus dans les mails envoyés par l'application. Par défaut, cette url est construite à partir des propriétés cpms.hostname et cpms.http.port et vaut http://{cpms.hostname}:{cpms.http.port}/cpms Cette URL peut être modifiée après installation dans le fichier <cpms.install.dir>/cpms/applications/config/specificconfig/workflow/workflow-config.xml. Ports utilisés par Jboss Les ports présentés sont les ports utilisés par défaut par Jboss. Il est possible de changer ces ports si certains sont déjà utilisés (Ex: Installation d'une deuxième instance NQI Orchestra pour le test). Cette opération peut également se faire manuellement après installation (cf Guide d'exploitation) Par défaut le port http utilisé est le port identifié par le paramètre cpms.http.port. Pour modifier les ports, décommenter la ligne correspondante et spécifiez le nouveau port (Ex : 11098 au lieu de 1098) Sous Linux seul l'utilisateur root peut ouvrir des ports inférieurs à 1024. Le démarrage de l'application sur le port 80 implique donc que starting.user soit root. Lancement de l'installation Une fois les paramètres d'installation renseignés, il suffit d'exécuter la commande suivante dans le répertoire créé lors de la décompression de l'archive :./install.sh install.properties INSTALLATION LINUX - GESTION DES LICENCES L'installation de NQI Orchestra ne comporte pas de licences. Il convient d'installer la licence fournie par NQI avant de démarrer l'application. Licence NQI Orchestra La licence NQI Orchestra décrit : la société à laquelle le droit de licence est accordé les différents composants logiciels auxquels vous avez accès avec les limitations éventuelles la durée de validité de votre utilisation du logiciel. La licence de NQI Orchestra est à installer dans le répertoire <install.directory>\orchestra\applications\config\specificconfig\license. 6
Autres licences NQI Orchestra utilise pour son fonctionnement un certain nombre de librairies de type «open source», dont les licences sont chacunes décrites dans le répertoire <install.directory> INSTALLATION LINUX - ARRÊT ET DÉMARRAGE Démarrage de l'application Le démarrage de l'application se fait en exécutant le script <install.directory>/orchestra/bin/start.sh. Il est possible que le système demande un mot de passe. C'est le mot de passe de l'utilisateur L'accès à l'application se fait par l'url : http://serveur:port/cpms serveur : nom ou adresse IP du serveur port : port défini lors de l'installation (80, 8080,...) Nom d'utilisateur / mot de passe de l'administrateur NQI Orchestra : admin/admin Arrêt de l'application L'arrêt de l'application se fait en exécutant le script <install.directory>/orchestra/bin/stop.sh. Là aussi le système peut demander le mot de passe de <starting.user>. Service système <starting.user> qui est attendu ici. Le script <install.directory>/orchestra/bin/orchestra-service.sh peut être défini comme cible d'un service chargé de démarrer/arrêter automatiquement l'application au démarrage/arrêt du système. <install.directory>/orchestra/bin/orchestra-service.sh start démarre l'application <install.directory>/orchestra/bin/orchestra-service.sh stop arrête l'application Il appartient au client de définir ce service en fonction de la distribution Linux utilisée. INSTALLATION LINUX - RÉSUMÉ DES COMPOSANTS INSTALLÉS Arborescence des répertoires Les différents répertoires situés sous le répertoire d'installation sont : Répertoire courant : contient les licences des différents composants opensource utilisés par NQI Orchestra orchestra/applications/config : contient les différents fichiers de configuration de NQI Orchestra orchestra/applications/config/specificconfig : contient les différents fichiers de configuration spécifique du client orchestra/applications/cpms.ear : fichier de type «J2EE Enterprise Archive» contenant la partie exécutable de l'application orchestra/attachements : répertoire d'exécution de l'application. C'est dans ce répertoire que seront stockés les documents attachés à l'application (sur les projets, les tâches,...). orchestra/bin : répertoire contenant les scripts permettant un démarrage manuel du service de l'application. orchestra/intro : contient une page html qui permet d'accéder à l'application à partir du raccourci NQI Orchestra du menu Démarrer java : contient la machine virtuelle java jboss : contient le serveur d'application Jboss 7