2015
L information contenue dans ce document peut changer sans préavis et ne représente aucun engagement de la part du vendeur ou de ses représentants. Ce document ne peut être reproduit ou diffusé en partie ou en totalité et ce, d aucune façon, sans la permission écrite de Korem inc, 330 rue Saint-Vallier Est, bureau 240, Québec (Québec) G1K 9C5. 2015 Korem. Tous droits réservés. Korem Mapping Studio est une marque déposée de Korem inc. Visitez notre site Internet à www.korem.com, ou contactez-nous à : KOREM - Québec 330, rue Saint-Vallier Est, bureau 240 Québec (Québec) G1K 9C5 Téléphone : 1 418 647-1555 Télécopieur : 1 418 647-1666 Sans frais : 1 888 440-1MAP (1627) - Amérique du Nord KOREM - Denver 7000 East Belleview Avenue, Suite 260 Greenwood Village, Colorado 80111 Téléphone : 1 720 200-4488 Télécopieur : 1 720 200-4323 Sans frais : 1 877 692-0306 - Amérique du Nord Note : Ce logiciel utilise la version 4.8.2 de MapXtreme Java. MapInfo Professional et MapXtreme sont des marques déposées de Pitney Bowes Software aux États-Unis. Les marques de commerce Java et Java-based ainsi que leurs logos sont des marques de commerce ou des marques déposées d Oracle inc, aux États-Unis, et dans d autres pays. Ce produit utilise des logiciels développés par Apache Software Foundation (http://www.apache.org). Tous les produits nommés dans ce document peuvent être des marques déposées de leur propriétaire respectif et seront reconnus ainsi par la présente. Toute inscription de «marque de commerce» ou de «marque déposée» associée au nom d un produit dans le présent document est utilisée à titre rédactionnel uniquement, au bénéfice du propriétaire de cette marque et sans intention d enfreindre les droits d auteur. Vos commentaires et suggestions sont appréciés.
Table des matières 1. À propos de Korem Mapping Studio... 1 1.1 Description du produit... 1 1.2 Logiciels requis... 1 1.3 Matériel requis... 2 2. Installer Korem Mapping Studio... 3 2.1 Programme d installation... 3 2.2 Démarrer la console de gestion KMS... 17 3. Maintenance... 18 3.1 Activation de KMS... 18 3.2 Installation d une mise à jour... 18 4. Désinstaller KMS... 20 Annexe A - Configuration manuelle de KMS... 24 i
1. À propos de Korem Mapping Studio 1.1 Description du produit Korem Mapping Studio (KMS) est un logiciel qui permet aux entreprises et organisations de facilement coordonner et gérer la diffusion et le partage de leur information géographique à l interne et avec le grand public. KMS est entièrement indépendant de toute plateforme et peut être installé sur n importe quel environnement (Windows, Linux, Sun, ou autre). Il requiert essentiellement un serveur d application compatible avec la machine virtuelle Java JDK 1.7.0_25. KMS 2015 a été testé et certifié pour les environnements suivants : Systèmes d opération (pour le serveur KMS) : Windows Server 2008 x64 Windows Server 2012 x64 Ubuntu x64 (v14.04 LTS) Bases de données (pour la base de données administrative de KMS) : PostgreSQL 9.3 avec l extension PostGIS 2.0 (en remplacement de HSQL) Oracle 11g (ou 10g Enterprise) SQL Server 2012 Navigateurs Web (pour l utilisateur) : Internet Explorer 8 à 11 Firefox 33 Chrome 38 Safari 7.0 (cartes en impartition seulement). 1.2 Logiciels requis Les logiciels requis sont les suivants: L application Web KMS elle-même, pour publier et visualiser des documents de travail MapInfo sur Internet ou sur votre intranet; Un serveur d application compatible Java 7; Le serveur d application que vous choisissez d installer dépend de votre environnement de serveur Web. KMS 2015 inclut la version 7.0.29 du serveur d application Apache-Tomcat; Une machine virtuelle Java d Oracle (JDK 32 bits ou 64 bits) pour l interprétation du code Java. Pour de meilleurs résultats, il est fortement recommandé d installer la machine virtuelle Java JDK version 1.7.0_25. 1
1.3 Matériel requis Pour l application Web Korem Mapping Studio Configuration minimale requise : Un kit de développement Java 1.7.0_25 (64-bit); 2 Go RAM minimum sur le serveur d application; Un serveur Web compatible Java JDK 1.7.0_25; 500 Mo d espace disque libre pour installer l application; Un processeur double cœurs de 2 GHz; Une connexion réseau TCP/IP à l intranet ou à l Internet. Configuration recommandée : Un kit de développement Java 1.7.0_25 (64-bit); 4 Go RAM minimum sur le serveur; Un serveur Web compatible Java JDK 1.7.0_25; 25 Go d espace disque libre pour installer l application; Un processeur quadruple cœurs à 2 GHz ou mieux; Une connexion réseau TCP/IP à l intranet ou à l Internet; Une base de données PostgreSQL 9.3 (avec l extension PostGIS 2.0), Oracle 11g ou SQL Server 2012. Pour le serveur d application Le serveur d application doit être configuré pour utiliser le JDK 1.7.0_25 (64-bit) et doit au moins supporter le fonctionnement d une machine virtuelle Java 7. Si vous choisissez de ne pas utiliser Apache-Tomcat comme serveur d application, vous devrez configurer manuellement votre serveur d application pour exécuter l application KMS. Pour ce faire, voyez l annexe correspondante de ce guide ou consultez le site de Apache Tomcat à http://tomcat.apache.org/. 2
2. Installer Korem Mapping Studio Note : Si vous souhaitez procéder à une migration de KMS, veuillez contacter l équipe de support de Korem à support@korem.com avant de procéder à l installation. 2.1 Programme d installation Le programme d installation de l application effectue les opérations suivantes : Permet à l usager de spécifier la machine virtuelle Java à utiliser; Crée un répertoire d installation si ce dernier n existe pas déjà; Configure la base de données PostgreSQL, Oracle 1 ou SQL Server 2 ; Copie les fichiers dans le répertoire d installation. Avant de commencer l installation, assurez-vous de fermer tous les programmes Windows. De plus, si vous souhaitez utiliser les ports d un service Tomcat déjà existant (pour une version antérieure de KMS par exemple), vous devez arrêter ce service au préalable, autrement, le nouveau service Tomcat ne démarrera pas automatiquement après l installation. Pendant que le programme d installation s initialise, il faut patienter environ 30 secondes pour que la première étape de l Assistant apparaisse. C est le temps nécessaire pour mettre en mémoire les classes Java requises. Pour démarrer le programme d installation, procédez comme suit : Ou : Pour une installation sur Windows, double-cliquez sur l icône du fichier «install.bat» dans le dossier d installation; Pour une installation sur Linux, ouvrez une invite de commande et inscrivez la commande suivante : «./install.sh» 1 Oracle 11g (ou au minimum 10g Enterprise) est nécessaire au bon fonctionnement de l outil «Tableau de données». 2 SQL Server 2012 est nécessaire au bon fonctionnement de l outil «Tableau de données». 3
Instructions pas-à-pas 1) Une fois l installateur lancé, la première opération consiste à choisir la langue d installation. Sélectionnez la langue désirée dans la liste, puis appuyez sur OK. 2) Une fois le programme chargé, la boîte de dialogue Introduction apparaît. Cliquez sur le bouton Suivant. 4
3) Le contrat lié à la licence d'utilisation du logiciel apparaît. Si vous n acceptez pas les termes du contrat, cliquez sur Annuler pour arrêter l installation. Cliquez sur le bouton Suivant, si vous acceptez les termes du contrat. 4) La fenêtre suivante vous permet de spécifier le répertoire de destination des fichiers de l application. Vous pouvez choisir un répertoire autre que celui par défaut à l aide du bouton Parcourir. Cliquez sur Suivant une fois le répertoire d installation entré. 5
5) La boîte de dialogue suivante vous invite ensuite à indiquer où est installée la JDK requise (1.7.0_25). Cette composante est nécessaire au fonctionnement de KMS. Si elle est déjà installée, sélectionnez son répertoire d installation à l aide du bouton Parcourir. Sinon, cliquez sur Annuler pour quitter l installateur et procéder à son installation. Notez qu une version 64-bit de la JDK est requise. Une fois le répertoire de la JDK sélectionné, cliquez sur Suivant pour poursuivre le programme d installation. 6
6) Certaines informations concernant le serveur Web seront par la suite nécessaires, notamment le nom du serveur ainsi que les ports pour accéder et fermer KMS. La case à cocher dans le bas de la page vous permet d installer le serveur Tomcat en service Windows plutôt qu en console. Un champ de saisie vous permet aussi d entrer le nom du service désiré lors d une installation sur Windows. Celui-ci doit respecter les règles de saisie de Windows (caractères alphanumériques sans espace). Note : Les numéros de port que vous choisissez doivent être attribués au serveur d application Apache-Tomcat. Aucune autre application ne devra utiliser ces ports. Le cas contraire peut entraîner une perte de stabilité de KMS, ainsi que de l autre application utilisant le port. Cliquez sur Suivant pour poursuivre l installation. 7
7) Le choix vous est ensuite offert d utiliser le SGBD générique PostgreSQL (avec PostGIS) fourni avec KMS, ou encore de vous connecter à votre propre base de données Oracle ou SQL Server. Faites votre choix, puis cliquez sur Suivant. 8
a) PostgreSQL Si le SGBD PostgreSQL a été sélectionné, deux options s offrent à vous. Vous pouvez choisir d installer PostgreSQL (avec PostGIS) fourni avec KMS ou de vous connecter sur une base de données PostgreSQL existante. Dans ce dernier cas, l extension PostGIS doit déjà être installée sur le serveur. ATTENTION : Si l installation est effectuée avec Linux, l installation de PostgreSQL (avec PostGIS) n est pas disponible. Avec Linux, cette interface est donc remplacée par celle de connexion à une base de données PostgreSQL existante. Installation de PostgreSQL (Windows seulement) Pour l installation de PostgreSQL, il vous sera demandé de spécifier le port du service PostgreSQL ainsi que le nom du service Windows qui sera créé. Assurez-vous que le port spécifié n est ou ne sera pas utilisé par un autre service. Cliquez sur Suivant pour poursuivre l installation. 9
Connexion à une base de données PostgreSQL existante Entrez les informations nécessaires à la connexion à votre base de données. L extension PostGIS doit déjà être installée sur le serveur. Si ce n est pas déjà fait, il faut préalablement créer un utilisateur ainsi qu une nouvelle base de données pour KMS. L utilisateur doit être le propriétaire de la base de données nouvellement créée ou avoir les droits de connexion à la base de données et de création sur son schéma : GRANT CONNECT ON DATABASE; GRANT CREATE ON SCHEMA; L utilitaire pgadmin, fourni gratuitement sur le site de PostgreSQL, peut être utilisé pour cette procédure. 10
En revanche, si la base de données indiquée contient des tables provenant d une version antérieure de KMS, l interface suivante demandera de spécifier le dossier de la version de KMS à partir duquel vous voulez récupérer les configurations. Cliquez sur Suivant pour poursuivre l installation. 11
b) Oracle Entrez les informations nécessaires à la connexion à votre base de données. La version minimale d Oracle requise est 10g Enterprise mais la version 11g est recommandée. Si ce n est pas déjà fait, il faut préalablement créer un nouveau schéma pour KMS et donner à l utilisateur KMS les droits suivants sur son schéma : CONNECT; CREATE TABLE; CREATE VIEW; CREATE PROCEDURE; CREATE SEQUENCE; CREATE TRIGGER; CREATE ANY INDEX. 12
Si le schéma indiqué (SID) contient des tables provenant d une version antérieure de KMS, l interface suivante demandera de spécifier le dossier de la version de KMS à partir duquel vous voulez récupérer les configurations. Cliquez sur Suivant pour poursuivre l installation. 13
c) SQL Server Entrez les informations nécessaires à la connexion à votre base de données. La version minimale requise est SQL Server 2012. Si ce n est pas déjà fait, il faut préalablement créer un utilisateur ainsi qu une nouvelle base de données pour KMS. L utilisateur doit être le propriétaire de la base de données nouvellement créée ou avoir au minimum les rôles suivants : db_datareader; db_datawriter; db_ddladmin. Cliquez sur Suivant pour poursuivre l installation. 14
8) La fenêtre de confirmation des paramètres de l installation apparaît. Notez que l installation prendra également en charge l installation et la configuration du serveur d application Tomcat 7.0.29 d Apache. Cliquez sur Installer pour copier les fichiers sur le disque dur du serveur. 9) Une barre de progression affiche l avancement de l opération. 15
10) La fenêtre de confirmation de l installation apparaît. Vous pouvez aussi consulter le fichier «Lisezmoi» en sélectionnant la case Ouvrir le fichier Lisez-moi. L adresse pour accéder à la console de gestion à partir d un navigateur Web est affichée. Cliquez sur Terminé pour quitter l installateur. 16
2.2 Démarrer la console de gestion KMS Avant d ouvrir KMS, vous devez démarrer le serveur d application Apache-Tomcat. Si KMS a été installé en service, celui-ci démarrera automatiquement. Attention : Si le serveur d application Apache-Tomcat a été configuré avec des ports déjà utilisés (pour une version antérieure de KMS par exemple), le serveur d application Apache-Tomcat ne démarrera pas automatiquement. Vous devrez arrêter le service utilisant les ports en question et ensuite démarrer le serveur d application Apache-Tomcat. Démarrer le serveur d application Pour démarrer le serveur d application en mode console, allez dans le répertoire suivant : %INSTALL%\KMS2015\apache-tomcat-7.0.29\bin Exécutez ensuite l un ou l autre de ces fichiers : startup.bat, si vous êtes dans un environnement Windows; startup.sh, si vous êtes dans un environnement Unix. Accéder à la console de gestion Pour accéder à la console de gestion KMS, ouvrez votre navigateur Web habituel et entrez l adresse suivante : http://hostname:port/kms/index.do Ouvrir une session Lors de l installation du logiciel KMS, un usager a été créé afin de vous permettre d ouvrir une session en mode super administrateur. Ce mode vous permet entre autres de créer de nouveaux usagers et groupes, de définir les droits de chacun de ces usagers et groupes, ainsi que de gérer les paramètres du système. Il est fortement recommandé de changer immédiatement le mot de passe de cet usager par un nouveau de votre choix afin que personne d autre ne puisse accéder aux options d administration. Vous pouvez également créer un nouvel usager ayant les droits d administration sur le système et supprimer l usager administrateur original. Pour ouvrir une session en mode administrateur, entrez l information suivante : Nom d usager : admin Mot de passe : admin 17
3. Maintenance 3.1 Activation de KMS Pour activer votre version de KMS, vous devez vous rendre dans la section Maintenance du module Système. Sélectionnez l option Licence. Une option permet à l administrateur de générer une demande d activation du logiciel. Cette demande pourra ensuite être envoyée au support de Korem (support@korem.com) qui procédera à l enregistrement de la copie et renverra un fichier d activation à l administrateur. Celui-ci pourra ensuite procéder à l enregistrement de sa copie du logiciel. 3 Pour générer une demande de licence, cliquez sur le bouton correspondant (1) dans l interface de gestion de la licence. Pour procéder à l enregistrement de votre KMS, sélectionnez un fichier d activation (2) et cliquez sur le bouton Ajouter (3). 2 1 3 3.2 Installation d une mise à jour Une fois l installation de KMS complétée, nous vous recommandons d installer la dernière mise à jour disponible. Si une mise à jour était disponible au moment de la livraison de votre version, vous la retrouverez dans le répertoire d installation. La disponibilité des mises à jour majeures vous seront communiquées par courriel le cas échéant. Référez-vous toujours au fichier Lisez-moi de la mise à jour avant de procéder à l installation. Pour installer une mise à jour, rendez-vous dans la section Maintenance du module Système. Sélectionnez l option Installer un correctif. IMPORTANT : Si vous procédez à la mise à jour de KMS à partir d une version antérieure à 2014.1, veuillez contacter l équipe de support de Korem à support@korem.com. De plus, la version de base requise pour effectuer la migration vers KMS 2015 est 2014.1. Pour toute information relative à la procédure pour la migration, veuillez contacter l équipe de support de Korem à support@korem.com. 3 Pour davantage de détails sur la gestion de votre licence, veuillez vous référer au Chapitre VIII, section 2.1 du «Guide de l utilisateur». 18
À partir de cette interface, cliquez sur Parcourir pour sélectionner le fichier de mise à jour, puis sur Valider pour confirmer. L étape suivante présente les informations sur la mise à jour (nom et numéro de version), ainsi que la liste de tous les fichiers qui seront ajoutés, modifiés ou supprimés. Cliquez sur Installer pour lancer le processus de mise à jour. Une fois la mise à jour installée, vous devrez redémarrer le serveur d application pour que les corrections soient effectives. Les informations sur la mise à jour installée seront immédiatement disponibles dans l historique des mises jour de KMS, dans la section Maintenance du module Système. 19
4. Désinstaller KMS Un programme de désinstallation est disponible pour supprimer correctement les fichiers de KMS de votre ordinateur. Ce programme est accessible via le menu Démarrer \ Tous les programmes \ KOREM \ KMS 2015. Un item Uninstall KMS 2015 s y trouve. Le programme de désinstallation est aussi accessible dans le répertoire _KMS 2015_installation\Uninstall KMS 2015.exe situé à la racine de KMS. Le programme supprimera les fichiers servant au fonctionnement de l application. Les projets et les données ne seront pas effacés. Le répertoire KOREM\Data sera toujours accessible et contiendra encore les projets utilisés dans KMS. Pour enlever cet élément, il faut le supprimer manuellement. Instructions pas-à-pas Note : Il est recommandé d arrêter le service Apache Tomcat de l instance de KMS 2015 à désinstaller, autrement certains fichiers et dossiers concernés ne seront pas supprimés correctement. Pour arrêter le serveur d application avec Linux, rendez-vous dans le répertoire suivant (en mode console ou dans l arborescence des fichiers) : %INSTALL%\KMS2015\apache-tomcat-7.0.29\bin Exécutez ensuite le fichier suivant : shutdown.sh Enfin, supprimez les répertoires contenus dans le répertoire d installation. 20
1. Dans la page d accueil du programme de désinstallation, cliquez sur Désinstaller pour lancer la désinstallation ou sur Annuler pour quitter le programme. Une option permet également de supprimer les données des projets. 2. Si la version de KMS que vous désinstallez utilisait la version de PostgreSQL incluse avec l installateur comme base de données administrative, une option supplémentaire vous offrira la possibilité de désinstaller l instance de PostgreSQL également. 21
3. La page de désinstallation indique que le processus est en cours. 22
4. Une fois la désinstallation terminée, la page de confirmation vous indiquera que le processus s est bien déroulé. Cliquez sur Terminé pour quitter le programme. 23
Annexe A - Configuration manuelle de KMS Il est assez simple de procéder à la configuration manuelle de l installation de KMS. Pour ce faire, ouvrez le fichier «config.properties» situé dans le répertoire de base de KMS2015/appl/WEB- INF/classes. Deux variables sont à modifier : «fileshome» et «workspaceshome». 1. fileshome = Le répertoire de base de KMS. Exemple : fileshome = C:\\Program Files\\KOREM\\KMS2015\\appl (par défaut) 2. workspaceshome = Le répertoire où les workspaces sont enregistrés. Par défaut, cette variable pointe vers le répertoire de base de Korem/data/workspaces. Cette variable peut être modifiée sans problème en autant que le serveur sur lequel est installé KMS ait plein accès à ce répertoire. Exemple : workspaceshome = C:\\Program Files\\KOREM\\data\\workspaces (par défaut) Si vous avez bien suivi toutes ces étapes, KMS devrait bien fonctionner. Toutefois, si quoi que ce soit ne fonctionnait pas adéquatement, n'hésitez pas à contacter notre département de Support technique à l'adresse suivante : support@korem.com. Au besoin, une visite sur le site de Apache-Tomcat vous permettra aussi d'obtenir de l'information complémentaire : http://tomcat.apache.org/. 24