Installation de Portal for ArcGIS sous Linux en mode silencieux

Les étapes suivantes expliquent comment installer Portal for ArcGIS en mode silencieux.

Remarque :

Si vous procédez à la mise à niveau vers 10.9.1, reportez-vous à la rubrique Mettre à niveau votre portail ArcGIS Enterprise pour plus d’informations.

Préparation de l’installation de Portal for ArcGIS

1. Vérifiez que le site respecte la configuration système requise.
2. Connectez-vous à l'ordinateur en tant qu'utilisateur disposant de privilèges d'administration. Vous ne pouvez pas installer Portal for ArcGIS en tant qu’utilisateur racine.
3. Ouvrez les ports, comme expliqué dans la rubrique Ports utilisés par Portal for ArcGIS.
4. Fermez toutes les applications non critiques sur le serveur.
5. Accédez au dossier téléchargé contenant le programme d’installation de Portal for ArcGIS ou insérez le support Portal for ArcGIS dans le lecteur approprié pour démarrer automatiquement le programme d’installation.

Vous êtes maintenant prêt à installer Portal for ArcGIS.

Installation de Portal for ArcGIS sous Linux en mode silencieux

1. Lisez le contrat de licence disponible dans <CD_ROOT or untar directory>/Documentation/EULA.pdf et acceptez-en les termes.
2. Exécutez le fichier d'installation en mode silencieux à l'invite. Consultez l’exemple de syntaxe ci-après :

   <CD_ROOT or untar directory>/Setup -m silent -l yes

   Utilisation : Setup [Options]

   Option	Description
   -m; --mode MODE	Facultatif. Prend par défaut la valeur GUI. MODE peut prendre l’une des valeurs suivantes : silent, console ou gui.
   -l; --license-agreement CHOICE	Obligatoire pour le mode silencieux. CHOICE peut prendre la valeur Yes ou No. La valeur Yes indique que vous avez lu et accepté le Contrat principal Esri (E204, E300). Rendez-vous sur http://www.esri.com/legal/licensing-translations pour prendre connaissance du contrat.
   -d; --directory DIRECTORY	Facultatif. Par défaut, Portal for ArcGIS est installé dans le répertoire $HOME de l’utilisateur. DIRECTORY spécifie un répertoire d’installation différent. Le chemin /arcgis/portal est ajouté au répertoire d’installation. Si vous pointez le programme d'installation sur le répertoire d'une installation précédente, le contenu de ce répertoire est automatiquement utilisé pour la nouvelle installation. Le contenu provenant d’installations antérieures à la version 10.2 n’est pas pris en charge.
   -v; --verbose	Le programme d'installation est exécuté en mode commentaire.
   -h; --help	Affiche l’aide sur la ligne de commande et ferme l’outil.
   -e; --examples	Affiche des exemples d’utilisation de ces options et quitte.

   Remarque :

   Vous pouvez également exécuter l’utilitaire de ligne de commande createportal pour créer un portail une fois Portal for ArcGIS installé.

Utilisation d’un utilitaire de ligne de commande createportal pour créer un portail

Vous pouvez utiliser l’utilitaire createportal comme suit :

• Exécutez l’utilitaire createportal en tant qu’administrateur à partir d’une invite de commande et spécifiez les paramètres prénom, nom, nom d’utilisateur, mot de passe, e-mail, question secrète, réponse et répertoire de contenu.
• Fournissez un fichier createportal.properties contenant les paramètres spécifiés.

Pour utiliser l’utilitaire de ligne de commande createportal, exécutez le script createportal.sh avec -h ou -help comme suit :

<Portal for ArcGIS Installation Directory>/tools/createportal/createportal.sh -help

Exemple d’utilisation avec l’utilitaire : createportal.sh [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [ -lf <arg>] [ -ut <arg>]

Exemple d’utilisation avec un fichier : createportal.sh [-f <FILE>]

Remarque :

Lorsque vous référencez un chemin dans le fichier createportal.properties, vous devez indiquer un caractère d’échappement devant les barres obliques inverses, par exemple C:\\arcgisportal ou \\\\<Absolute path to>\\<portal arcgisportal>.

Option	Description
-fn; --firstname	Prénom pour un compte administrateur initial utilisé pour configurer le portail. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets.
-ln; --lastname	Nom pour un compte administrateur initial utilisé pour configurer le portail. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets.
-u; --username	Nom d’utilisateur pour un compte administrateur initial utilisé pour configurer le portail. Le nom d’utilisateur peut être composé des chiffres de 0 à 9, des lettres ASCII de a à z et de A à Z, et du point (.).
-p; --password	Mot de passe pour un compte administrateur initial utilisé pour configurer le portail. Le mot de passe peut être composé des chiffres de 0 à 9, des lettres ASCII de a à z et de A à Z, et du point (.).
-e; --email	Adresse e-mail pour un compte administrateur initial utilisé pour configurer le portail.
-qi; --question	Index de la question secrète permettant de récupérer un mot de passe oublié. Les questions disponibles avec les numéros d’index respectifs sont les suivantes : 1, Dans quelle ville êtes-vous né(e) ? 2, Quelle était la mascotte de votre lycée ? 3, Quel est le nom de jeune fille de votre mère ? 4, Quelle était la marque de votre première voiture ? 5, Dans quel lycée êtes-vous allé ? 6, Quel est le nom de famille de votre meilleur(e) ami(e) ? 7, Quel est le deuxième prénom de votre sœur ou frère le plus jeune ? 8, Quel est le nom de la rue où vous avez grandi ? 9, Quel est le nom de votre personnage de fiction préféré ? 10, Quel est le nom de votre animal de compagnie préféré ? 11, Quel est le nom de votre restaurant préféré ? 12, Quel est le titre de votre livre préféré ? 13, Quel est le métier de vos rêves ? 14, Où êtes-vous allé(e) pour votre premier rendez-vous ?
-qa; --answer	Réponse à la question secrète que vous avez choisie pour le paramètre -qi. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets.
-d; --contentDirectory	Chemin absolu et nom du répertoire de contenu utilisé pour stocker les données hébergées sur le portail. Par défaut, le répertoire de contenu du portail est créé localement à cet emplacement : <Portal for ArcGIS Installation Directory>/usr/arcgisportal
-f; --file	Le fichier de propriétés de l’utilitaire createportal. Par défaut, le fichier createportal.properties se trouve à cet emplacement : <Portal for ArcGIS Installation Directory>\tools\createportal
-lf; --licenseFile	Il s’agit du chemin d’accès au fichier de licence du portail.
-ut; --userTypeID	Il s’agit de l’ID du type d’utilisateur pour l’administrateur initial. Ce paramètre est facultatif. Pour générer une liste de types d’utilisateurs compatibles (à la disposition de votre organisation) pour le paramètre -ut, exécutez l’utilitaire listadministratorusertypes. Si aucun ID de type d’utilisateur n’est spécifié et que le fichier de licence du portail contient un seul type d’utilisateur compatible, celui-ci est attribué. Si le fichier de licence contient plusieurs types d’utilisateurs compatibles, un type d’utilisateur temporaire est attribué et l’administrateur initial est tenu de sélectionner un type d’utilisateur après s’être connecté.
-h; --help	Affiche l’aide sur la ligne de commande et quitte.

Vous trouverez ci-dessous un exemple de fichier createportal.properties :

#
#
# Portal for ArcGIS site creation properties
#
# First name for initial administrator account
PORTAL_ADMIN_FIRSTNAME =
# Last name for initial administrator account
PORTAL_ADMIN_LASTNAME =
# User name for initial administrator account
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_USERNAME =
# Password for primary site administrator.
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_PASSWORD =
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
# E-mail address for initial administrator account
# e.g [e-mail]
PORTAL_ADMIN_EMAIL =
#This is the index of the secret question to retrieve a forgotten password.
#The list of questions with their respective index numbers is as follows:
#1, What city were you born in ?"
#2, What was your high school mascot?"
#3, What is your mother's maiden name?"
#4, What was the make of your first car?"
#5, What high school did you go to?"
#6, What is the last name of your best friend?"
#7, What is the middle name of your youngest sibling?"
#8, What is the name of the street on which you grew up?"
#9, What is the name of your favorite fictional character?"
#10, What is the name of your favorite pet?"
#11, What is the name of your favorite restaurant?"
#12, What is the title of your favorite book?"
#13, What is your dream job?"
#14, Where did you go on your first date?");
PORTAL_ADMIN_SECURITY_QUESTION_INDEX =
# Answer to the secret question
# e.g \"My Answer\"
PORTAL_ADMIN_SECURITY_QUESTION_ANSWER =
# Portal content directory where portal will store default and user-generated content.
# By default, the portal content directory will be created locally,
# e.g./<Portal for ArcGIS installation directory>/usr/arcgisportal.
PORTAL_CONTENT_DIRECTORY =
# The path to the portal license file
PORTAL_LICENSE_FILE =
# The ID of the user type for the Initial Administrator
PORTAL_USER_TYPE_ID =

Avant que l’outil ne se ferme, vous recevez un message indiquant que le portail a bien été créé.

Utilisation de l’utilitaire de ligne de commande listadministratorusertypes pour identifier les types d’utilisateurs compatibles

Pour identifier les ID de types d’utilisateurs disposant d’une licence pour votre organisation et compatibles avec le rôle Administration, exécutez l’utilitaire de ligne de commande listadministratorusertypes. Cela permet de générer une liste d’entrées pour le paramètre -ut dans l’outil createportal. Exécutez l’outil avec -la comme indiqué ci-dessous, en utilisant le fichier de licence du portail comme entrée :

<Portal for ArcGIS Installation Directory>/tools/createportal/listadministratorusertypes.sh

Exemple d’utilisation avec l’utilitaire : listadministratorusertypes.sh [-la <arg>] ou listadministratorusertypes.sh [--listadministratorusertypes <arg>]

Configuration de la post-installation

Pour que Portal for ArcGIS démarre avec le système d’exploitation, suivez les étapes ci-dessous correspondant à votre système d’exploitation.

Systèmes d'exploitation prenant en charge systemd

Si votre système d’exploitation prend en charge l’utilisation de systemd pour initialiser et gérer les processus (par exemple, si vous utilisez Red Hat 7.x), procédez comme suit pour configurer le démarrage de Portal for ArcGIS avec le système d’exploitation.

1. Dans un shell de commande, connectez-vous en tant qu’utilisateur racine.
2. Copiez le fichier d’unité <Portal for ArcGIS installation directory>/framework/etc/arcgisportal.service dans /etc/systemd/system.. Une fois le fichier copié, assurez-vous que les autorisations du fichier de /etc/systemd/system/arcgisportal.service sont définies sur 600.

   Remarque :

   Ce fichier est installé avec Portal for ArcGIS 10.9.1.

3. Toujours en tant qu'utilisateur racine, exécutez la commande suivante pour créer automatiquement les liens dans /etc/systemd/system/multi-user.target.wants :

   # systemctl enable arcgisportal.service

4. Pour vous assurer que le service systemd est correctement configuré, redémarrez le service et vérifiez son statut.

   # systemctl stop arcgisportal.service
   # systemctl start arcgisportal.service
   # systemctl status arcgisportal.service

   Remarque :

   Pour empêcher un service de produire un trop grand nombre de threads et de consommer trop de ressources système, systemd v228 et les versions ultérieures inclus dans SLES12 SP2 et versions ultérieures fixent le nombre maximum de threads pouvant être créés à 512. Les utilisateurs sur SLES12 devront peut-être activer et augmenter cette limite en cas d’utilisation intense du système. Pour activer et augmenter cette limite, en tant qu’utilisateur racine, supprimez les marques de commentaires et modifiez la ligne suivante dans le fichier d’unité arcgisportal.service avant de le déployer vers le dossier /etc/systemd/system : # TasksMax=512

5. Déconnectez-vous en tant qu'utilisateur racine.
6. Redémarrez le système d’exploitation et vérifiez que Portal for ArcGIS redémarre correctement.

Systèmes d'exploitation prenant en charge SysV

Si votre système d’exploitation prend en charge d’utilisation de SysV pour initialiser et gérer les processus, procédez comme suit pour configurer le démarrage de Portal for ArcGIS avec le système d’exploitation.

1. Dans un shell de commande, connectez-vous en tant qu’utilisateur racine.
2. Copiez le script shell figurant dans <Portal for ArcGIS installation directory>/framework/etc/arcgisportal aux emplacements de distribution Linux pris en charge indiqués ci-dessous :
   • RHEL : /etc/rc.d/init.d/
   • SUSE : /etc/init.d/
3. Placez-vous dans le dossier init.d correct et vérifiez le script arcgisportal pour vous assurer que la racine dispose au moins d’autorisations de lecture et d’exécution.
4. Modifiez le script comme suit :

   1. Mettez à jour la variable portalhome en lui affectant comme valeur le répertoire d'installation de Portal for ArcGIS. Par exemple, /home/username/arcgis/portal.

   2. Uniquement pour RHEL, ajoutez la ligne ci-dessous juste avant # Description: Portal for ArcGIS Service :

      # chkconfig: 35 99 01

   3. Enregistrez les modifications apportées au script arcgisportal.

5. Toujours en tant qu’utilisateur racine, exécutez les commandes suivantes pour créer automatiquement les liens dans /etc/rc*.d avec les niveaux d’exécution appropriés :
   • RHEL :

     $ chkconfig --add arcgisportal
     $ chkconfig arcgisportal on

   • SUSE :

     $ insserv arcgisportal
     $ chkconfig arcgisportal on

6. Déconnectez-vous en tant qu'utilisateur racine.
7. Réinitialisez le système d'exploitation et vérifiez que Portal for ArcGIS redémarre correctement.