Référence d'installation
improve this page | report issuePrésentation
Informations de référence sur les tâches Ant et les exemples de fichier de configuration pour l’installation d’IBM MobileFirst Foundation Server, d’IBM MobileFirst Foundation Application Center et d’IBM MobileFirst Foundation Operational Analytics.
Aller à
- Référence de la tâche Ant configuredatabase
- Tâches Ant pour l’installation de MobileFirst Operations Console, des artefacts de MobileFirst Server et des services d’administration et Live Update de MobileFirst Server
- Tâches Ant pour l’installation du service push de MobileFirst Server
- Tâches Ant pour l’installation des environnements d’exécution de MobileFirst
- Tâches Ant pour l’installation d’Application Center
- Tâches Ant pour l’installation de MobileFirst Analytics
- Bases de données d’environnement d’exécution internes
- Exemples de fichier de configuration
- Exemples de fichiers de configuration pour MobileFirst Analytics
Référence de la tâche Ant configuredatabase
Informations de référence relatives à la tâche Ant configuredatabase. Ces informations de référence concernent uniquement les bases de données relationnelles. Elles ne s’appliquent pas à Cloudant.
La tâche Ant configuredatabase crée les bases de données relationnelles qui sont utilisées par le service d’administration de MobileFirst Server, le service Live Update de MobileFirst Server, le service push de MobileFirst Server, l’environnement d’exécution de MobileFirst et les services Application Center. Cette tâche Ant configure une base de données relationnelle à l’aide des actions suivantes :
- Elle vérifie si les tables MobileFirst existent et les créent si nécessaire.
- Si les tables existent pour une version précédente de Mobile Foundation, elle les migre vers la version en cours.
- Si les tables existent pour la version en cours de Mobile Foundation, elle n’intervient pas.
De plus, si l’une des conditions suivantes est remplie :
- Le type du système de gestion de base de données est Derby.
- Un élément interne
<dba>
est présent. - Le type de système de gestion de base de données est DB2 et l’utilisateur spécifié dispose des droits nécessaires pour créer des bases de données.
La tâche peut avoir les effets suivants :
- Créer la base de données si nécessaire (sauf pour Oracle 12c, et Cloudant).
- Créer un utilisateur, si nécessaire, et lui attribuer les droits d’accès à la base de données.
Remarque : La tâche Ant configuredatabase n’a aucun effet si vous l’utilisez avec Cloudant.
Attributs et éléments pour la tâche configuredatabase
La tâche configuredatabase possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
kind | Type de base de données : Dans MobileFirst Server : MobileFirstRuntime, MobileFirstConfig, MobileFirstAdmin ou push. Dans Application Center : ApplicationCenter. | Oui | Aucune |
includeConfigurationTables | Spécifier si des opérations de base de données doivent être exécutées à la fois sur le service Live Update et sur le service d’administration ou uniquement sur le service d’administration. La valeur est true ou false. | Non | true |
execute | Spécifier si la tâche Ant configuredatabase doit être exécutée. La valeur est true ou false. | Non | true |
kind
Mobile Foundation prend en charge quatre types de base de données : L’environnement d’exécution de MobileFirst utilise la base de données MobileFirstRuntime. Le service d’administration de MobileFirst Server utilise la base de données MobileFirstAdmin. Le service Live Update de MobileFirst Server utilise la base de données MobileFirstConfig. Par défaut, il est créé avec le type MobileFirstAdmin. Le service push de MobileFirst Server utilise la base de données push. Application Center utilise la base de données ApplicationCenter.
includeConfigurationTables
L’attribut includeConfigurationTables ne peut être utilisé que lorsque l’attribut kind a pour valeur MobileFirstAdmin. La valeur valide peut être true ou false. Lorsque cet attribut a pour valeur true, la tâche configuredatabase effectue des opérations de base de données à la fois sur la base de données du service d’administration et sur la base de données du service Live Update en une seule exécution. Lorsque cet attribut a pour valeur false, la tâche configuredatabase effectue des opérations de base de données uniquement sur la base de données du service d’administration.
execute
L’attribut execute active ou désactive l’exécution de la tâche Ant configuredatabase. La valeur valide peut être true ou false. Lorsque cet attribut a pour valeur false, la tâche configuredatabase n’effectue pas d’opération de configuration ou de base de données.
La tâche configuredatabase prend en charge les éléments ci-après.
Elément | Description | Nombre |
---|---|---|
<derby> |
Paramètres pour Derby. | 0..1 |
<db2> |
Paramètres pour DB2. | 0..1 |
<mysql> |
Paramètres pour MySQL. | 0..1 |
<oracle> |
Paramètres pour Oracle. | 0..1 |
<driverclasspath> |
Chemin de classe du pilote JDBC. | 0..1 |
Pour chaque type de base de données, vous pouvez utiliser un élément <property>
afin de spécifier une propriété de connexion JDBC pour l’accès à la base de données. L’élément <property>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
Apache Derby
L’élément <derby>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
database | Nom de la base de données. | Non | MFPDATA, MFPADM, MFPCFG, MFPPUSH ou APPCNTR, selon l’attribut kind. |
datadir | Répertoire contenant les bases de données. | Oui | Aucune |
schema | Nom du schéma. | Non | MFPDATA, MFPCFG, MFPADMINISTRATOR, MFPPUSH ou APPCENTER, selon l’attribut kind. |
L’élément <derby>
prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de connexion JDBC. | 0..∞ |
Pour les propriétés disponibles, voir Setting attributes for the database connection URL.
DB2
L’élément <db2>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
database | Nom de la base de données. | Non | MFPDATA, MFPADM, MFPCFG, MFPPUSH ou APPCNTR, selon l’attribut kind. |
server | Nom d’hôte du serveur de base de données. | Oui | Aucune |
port | Port sur le serveur de base de données. | Non | 50000 |
user | Nom d’utilisateur permettant d’accéder aux bases de données. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
instance | Nom de l’instance DB2. | Non | Dépend du serveur |
schema | Nom du schéma. | Non | Dépend de l’utilisateur |
Pour plus d’informations sur les comptes utilisateur DB2, voir DB2 security model overview.
L’élément <db2>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de connexion JDBC. | 0..∞ |
<dba> |
Données d’identification de l’administrateur de base de données. | 0..1 |
Pour connaître les propriétés disponibles, voir Properties for the IBM Data Server Driver for JDBC and SQLJ.
L’élément interne <dba>
spécifie les données d’identification des administrateurs de base de données. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
user | Nom d’utilisateur permettant d’accéder à la base de données. | Oui | Aucune |
password | Mot de passe permettant d’accéder à la base de données. | Non | Demandée en mode interactif |
L’utilisateur spécifié dans l’élément <dba>
doit disposer du privilège DB2 SYSADM ou SYSCTRL. Pour plus d’informations, voir Authorities overview.
L’élément <driverclasspath>
doit contenir les fichiers JAR pour le pilote JDBC DB2 et pour la licence qui lui est associée. Vous pouvez extraire ces fichiers de plusieurs façons :
- Téléchargez les pilotes JDBC DB2 depuis la page DB2 JDBC Driver Versions page
- Ou bien, procédez à l’extraction du fichier db2jcc4.jar et des fichiers db2jcc_license_*.jar qui lui sont associés à partir du répertoire DB2_INSTALL_DIR/java sur le serveur DB2.
Vous ne pouvez pas spécifier de détails sur les allocations de table, comme l’espace table, avec la tâche Ant. Pour contrôler l’espace table, vous devez utiliser les instructions manuelles décrites dans la section Exigences utilisateur et base de données DB2.
MySQL
L’élément <mysql>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
database | Nom de la base de données. | Non | MFPDATA, MFPADM, MFPCFG, MFPPUSH ou APPCNTR, selon l’attribut kind. |
server | Nom d’hôte du serveur de base de données. | Oui | Aucune |
port | Port sur le serveur de base de données. | Non | 3306 |
user | Nom d’utilisateur permettant d’accéder aux bases de données. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
Pour plus d’informations sur les comptes utilisateur MySQL, voir MySQL User Account Management.
L’élément <mysql>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de connexion JDBC. | 0..∞ |
<dba> |
Données d’identification de l’administrateur de base de données. | 0..1 |
<client> |
Hôte autorisé à accéder à la base de données. | 0..∞ |
Pour connaître les propriétés disponibles, voir Driver/Datasource
Class Names, URL Syntax and Configuration Properties for Connector/J.
L’élément interne <dba>
spécifie les données d’identification de l’administrateur de base de données. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
user | Nom d’utilisateur permettant d’accéder aux bases de données. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
L’utilisateur spécifié dans un élément <dba>
doit être un compte superutilisateur MySQL. Pour plus d’informations, voir Securing the Initial MySQL Accounts.
Chaque élément interne <client>
spécifie un ordinateur client ou un caractère générique pour les ordinateurs client. Ces ordinateurs sont autorisés à se connecter à la base de données. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
hostname | Nom d’hôte symbolique, adresse IP ou modèle avec % comme marque de réservation. | Oui | Aucune |
Pour plus d’informations sur la syntaxe de l’attribut hostname, voir Specifying Account Names.
L’élément <driverclasspath>
doit contenir un fichier JAR MySQL Connector/J. Vous pouvez télécharger ce fichier depuis la page Download Connector/J.
Vous pouvez aussi utiliser l’élément <mysql>
avec les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
url | URL de connexion à la base de données. | Oui | Aucune |
user | Nom d’utilisateur permettant d’accéder aux bases de données. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
Remarque :
Si vous spécifiez la base de données avec des attributs alternatifs, cette base de données doit exister, le compte utilisateur doit exister et la base de données doit être déjà accessible pour l’utilisateur. Dans ce cas, la tâche configuredatabase ne tente pas de créer la base de données ou l’utilisateur ni d’accorder l’accès à l’utilisateur. La tâche configuredatabase garantit seulement que la base de données comporte les tables requises pour la version en cours de MobileFirst Server. Vous n’avez pas besoin de spécifier l’élément interne<dba>
ou<client>
.
Oracle
L’élément <oracle>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
database | Nom de base de données, ou nom de service Oracle. Remarque : Vous devez toujours utiliser un nom de service pour vous connecter à une base de données PDB. | Non | ORCL |
server | Nom d’hôte du serveur de base de données. | Oui | Aucune |
port | Port sur le serveur de base de données. | Non | 1521 |
user | Nom d’utilisateur permettant d’accéder aux bases de données. Voir la note sous ce tableau. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
sysPassword | Mot de passe de l’utilisateur SYS. | Non | Demandée en mode interactif si la base de données n’existe pas encore |
systemPassword | Mot de passe de l’utilisateur SYSTEM. | Non | Demandée en mode interactif si la base de données ou l’utilisateur n’existe pas encore |
Remarque:
Pour l’attribut user, utilisez plutôt un nom d’utilisateur en lettres majuscules. Les noms d’utilisateur Oracle sont en général en lettres majuscules. A la différence des autres outils de bases de données, la tâche Ant configuredatabase ne convertit pas les majuscules en minuscules en ce qui concerne le nom d’utilisateur. Si la tâche Ant configuredatabase ne parvient pas à se connecter à la base de données, essayez de saisir une valeur en majuscules pour l’attribut user.
Pour plus d’informations sur les comptes utilisateur Oracle,
voir Overview of Authentication Methods.
L’élément <oracle>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de connexion JDBC. | 0..∞ |
<dba> |
Données d’identification de l’administrateur de base de données. | 0..1 |
Pour des informations sur les propriétés de connexion disponibles, voir Class OracleDriver.
L’élément interne <dba>
spécifie les données d’identification de l’administrateur de base de données. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
user | Nom d’utilisateur permettant d’accéder aux bases de données. Voir la note sous ce tableau. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
L’élément <driverclasspath>
doit contenir un fichier JAR de pilote JDBC Oracle. Vous pouvez télécharger des pilotes JDBC Oracle depuis la page JDBC, SQLJ, Oracle JPublisher and Universal Connection
Pool (UCP).
Vous ne pouvez pas spécifier de détails sur une allocation de table, comme l’espace table, avec la tâche Ant. Pour contrôler l’espace table, vous pouvez créer le compte utilisateur manuellement et lui affecter un espace table par défaut avant d’exécuter la tâche Ant. Pour contrôler les autres détails, vous devez utiliser les instructions manuelles décrites dans la section Exigences utilisateur et base de données Oracle.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
url | URL de connexion à la base de données. | Oui | Aucune |
user | Nom d’utilisateur permettant d’accéder aux bases de données. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
Remarque : Si vous spécifiez la base de données avec des attributs alternatifs, cette base de données doit exister, le compte utilisateur doit exister et la base de données doit être déjà accessible pour l’utilisateur. Dans ce cas, la tâche ne tente pas de créer la base de données ou l’utilisateur ni d’accorder l’accès à l’utilisateur. La tâche configuredatabase garantit seulement que la base de données comporte les tables requises pour la version en cours de MobileFirst Server. Vous n’avez pas besoin de spécifier l’élément interne
<dba>
.
Tâches Ant pour l’installation de MobileFirst Operations Console, des artefacts de MobileFirst Server et des services d’administration et Live Update de MobileFirst Server
Les tâches Ant installmobilefirstadmin, updatemobilefirstadmin et uninstallmobilefirstadmin sont fournies pour l’installation de MobileFirst Operations Console, du composant des artefacts, du service d’administration et du service Live Update.
Effets des tâches
installmobilefirstadmin
La tâche Ant installmobilefirstadmin configure un serveur d’applications pour exécuter les fichiers WAR du service d’administration et du service Live Update sous forme d’applications Web, et éventuellement, pour installer la MobileFirst Operations Console. Elle a les effets suivants :
- Elle déclare l’application Web du service d’administration dans la racine de contexte spécifiée, par défaut, /mfpadmin.
- Elle déclare l’application Web du service Live Update dans une racine de contexte dérivée de la racine de contexte spécifiée pour le service d’administration. Par défaut, il s’agit de /mfpadminconfig.
- Pour les bases de données relationnelles, elle déclare les sources de données et, sur le profil complet de WebSphere Application Server, elle déclare les fournisseurs JDBC pour les services d’administration.
- Elle déploie le service d’administration et le service Live Update sur le serveur d’applications.
- Le cas échéant, elle déclare MobileFirst Operations Console en tant qu’application Web dans la racine de contexte spécifiée, par défaut, /mfpconsole. Si l’instance de MobileFirst Operations Console est spécifiée, la tâche Ant déclare l’entrée d’environnement JNDI appropriée pour communiquer avec le service de gestion correspondant. Exemple :
<target name="adminstall">
<installmobilefirstadmin servicewar="${mfp.service.war.file}">
<console install="${mfp.admin.console.install}" warFile="${mfp.console.war.file}"/>
- Le cas échéant, elle déclare l’application Web des artefacts MobileFirst Server dans la racine de contexte spécifiée, /mfp-dev-artifacts, lorsque MobileFirst Operations Console est installé.
- Elle configure les propriétés de configuration pour le service d’administration à l’aide des entrées d’environnement JNDI. Ces entrées d’environnement JNDI fournissent également des informations supplémentaires sur la topologie du serveur d’applications ; par exemple, elles peuvent indiquer si la topologie est une configuration autonome, un cluster ou un parc de serveurs.
- Le cas échéant, elle configure les utilisateurs qu’elle mappe aux rôles utilisés par MobileFirst Operations Console, ainsi que les applications Web des services d’administration et Live Update.
- Elle configure le serveur d’applications en vue de l’utilisation de JMX.
- Le cas échéant, elle configure la communication avec le service push de MobileFirst Server.
- Le cas échéant, elle définit les entrées d’environnement JNDI MobileFirst pour configurer le serveur d’applications en tant que membre de parc de serveurs pour le composant d’administration de MobileFirst Server.
updatemobilefirstadmin
La tâche Ant updatemobilefirstadmin met à jour une application Web MobileFirst Server déjà configurée sur un serveur d’applications. Elle a les effets suivants :
- Elle met à jour le fichier WAR du service d’administration. Ce fichier doit porter le même nom de base que le fichier WAR correspondant précédemment déployé.
- Elle met à jour le fichier WAR du service Live Update. Ce fichier doit porter le même nom de base que le fichier WAR correspondant précédemment déployé.
- Elle met à jour le fichier WAR de MobileFirst Operations Console. Ce fichier doit porter le même nom de base que le fichier WAR correspondant précédemment déployé. La tâche ne change pas la configuration du serveur d’applications, c’est-à-dire la configuration de l’application Web, les sources de données, les entrées d’environnement JNDI, les mappages des utilisateurs à des rôles et la configuration JMX.
uninstallmobilefirstadmin
La tâche Ant uninstallmobilefirstadmin annule les effets d’une précédente exécution de la tâche installmobilefirstadmin. Elle a les effets suivants :
- Elle supprime la configuration de l’application Web de service d’administration avec la racine de contexte spécifiée. En conséquence, elle supprime également les paramètres ajoutés manuellement à cette application.
- Elle supprime les fichiers WAR des services d’administration et Live Update et la console MobileFirst Operations Console du serveur d’applications en tant qu’option.
- Pour le système de gestion de base de données relationnelle, elle retire les sources de données et, sur le profil complet de WebSphere Application Server, elle retire les fournisseurs JDBC pour les services d’administration et Live Update.
- Pour le système de gestion de base de données relationnelle, elle retire du serveur d’applications les pilotes de base de données qui étaient utilisés par les services d’administration et Live Update.
- Elle supprime les entrées associées de l’environnement JNDI.
- Sur WebSphere Application Server Liberty et Apache Tomcat, elle retire les utilisateurs configurés par l’appel de la tâche installmobilefirstadmin.
- Elle supprime la configuration JMX.
Attributs et éléments
Les tâches Ant installmobilefirstadmin, updatemobilefirstadmin et uninstallmobilefirstadmin possèdent les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
contextroot | Préfixe commun pour les URL vers le service d’administration afin d’obtenir des informations sur les environnements d’exécution, les applications et les adaptateurs de MobileFirst. | Non | /mfpadmin |
id | Permet de distinguer différents déploiements. | Non | Vide |
environmentId | Permet de distinguer différents environnements MobileFirst. | Non | Vide |
servicewar | Fichier WAR pour le service d’administration. | Non | Le fichier mfp-admin-service.war se trouve dans le même répertoire que le fichier mfp-ant-deployer.jar. |
shortcutsDir | Répertoire dans lequel placer les raccourcis. | Non | Aucune |
wasStartingWeight | Ordre de démarrage pour WebSphere Application Server. Les valeurs les plus faibles démarrent en premier. | Non | 1 |
contextroot et id
Les attributs contextroot et id permettent de distinguer différents déploiements de MobileFirst Operations Console et du service d’administration.
Dans les profils Liberty de WebSphere Application Server et dans les environnements Tomcat, le paramètre contextroot est suffisant pour atteindre cet objectif. Dans les environnements de profil complet de WebSphere Application Server, l’attribut id est utilisé à la place. Sans l’attribut id, deux fichiers WAR possédant les mêmes racines de contexte pourraient entrer en conflit et ne pas être déployés.
environmentId
Utilisez l’attribut environmentId pour distinguer plusieurs environnements, constitués chacun du service d’administration de MobileFirst Server et des applications Web d’environnement d’exécution de MobileFirst, qui doivent fonctionner indépendamment. Par exemple, avec cette option, vous pouvez héberger un environnement de test, un environnement de préproduction et un environnement de production sur le même serveur ou dans la même cellule WebSphere Application Server Network Deployment. Cet attribut environmentId crée un suffixe qui est ajouté aux noms de bean géré que le service d’administration et les projets d’exécution de MobileFirst utilisent lorsqu’ils communiquent via JMX (Java Management Extensions).
servicewar
Utilisez un attribut servicewar afin de spécifier un autre répertoire pour le fichier WAR du service d’administration. Vous pouvez spécifier le nom de ce fichier WAR avec un chemin d’accès absolu ou relatif.
shortcutsDir
L’attribut shortcutsDir indique où placer les raccourcis vers MobileFirst Operations Console. Si vous le définissez, vous pouvez ajouter les fichiers suivants dans ce répertoire :
- mobilefirst-console.url - ce fichier est un raccourci Windows. Il ouvre MobileFirst Operations Console dans un navigateur.
- mobilefirst-console.sh - ce fichier est un script shell UNIX qui ouvre MobileFirst Operations Console dans un navigateur.
- mobilefirst-admin-service.url - ce fichier est un raccourci Windows. Il s’ouvre dans un navigateur Web et appelle un service REST qui renvoie la liste des projets MobileFirst pouvant être gérés au format JSON. Pour chaque projet MobileFirst répertorié, des détails sur ses artefacts sont également disponibles, par exemple le nombre d’applications, le nombre d’adaptateurs, le nombre d’appareils actifs et le nombre d’appareils mis hors service. La liste indique aussi si l’environnement d’exécution du projet MobileFirst est en cours d’exécution ou en veille.
- mobilefirst-admin-service.sh - ce fichier est un script shell UNIX qui fournit la même sortie que le fichier mobilefirst-admin-service.url.
wasStartingWeight
Utilisez l’attribut wasStartingWeight pour spécifier une valeur qui est utilisée dans WebSphere Application Server comme une pondération pour s’assurer que l’ordre de démarrage est respecté. Conformément à la valeur d’ordre de démarrage, l’application Web du service d’administration est déployée et démarrée avant tout autre projet d’exécution MobileFirst. Si des projets MobileFirst sont déployés ou démarrés avant l’application Web, la communication JMX n’est pas établie, l’environnement d’exécution ne peut pas être synchronisé avec la base de données du service d’administration et ne peut pas traiter les demandes de serveur.
Les tâches Ant installmobilefirstadmin, updatemobilefirstadmin et uninstallmobilefirstadmin prennent en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<applicationserver> |
Serveur d’applications. | 1 |
<configuration> |
Service Live Update. | 1 |
<console> |
Console d’administration. | 0..1 |
<database> |
Bases de données. | 1 |
<jmx> |
Permet d’activer Java Management Extensions. | 1 |
<property> |
Propriétés. | 0.. |
<push> |
Service push. | 0..1 |
<user> |
Utilisateur à mapper à un rôle de sécurité. | 0.. |
Pour spécifier MobileFirst Operations Console
L’élément <console>
collecte des informations permettant de personnaliser l’installation de MobileFirst Operations Console. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
contextroot | URI de MobileFirst Operations Console. | Non | /mfpconsole |
install | Permet d’indiquer si MobileFirst Operations Console doit être installé. | Non | Oui |
warfile | Fichier WAR de la console. | Non | Le fichier mfp-admin-ui.war se trouve dans le même répertoire que le fichier themfp-ant-deployer.jar. |
L’élément <console>
prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
<artifacts> |
Artefacts de MobileFirst Server. | 0..1 |
<property> |
Propriétés. | 0.. |
L’élément <artifacts>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
install | Permet d’indiquer si le composant des artefacts doit être installé. | Non | true |
warFile | Fichier WAR des artefacts. | Non | Le fichier mfp-dev-artifacts.war se trouve dans le même répertoire que le fichier mfp-ant-deployer.jar. |
Vous pouvez utiliser cet élément pour définir vos propres propriétés JNDI ou remplacer la valeur par défaut des propriétés JNDI qui sont fournies par le service d’administration et les fichiers WAR de MobileFirst Operations Console.
L’élément <property>
spécifie une propriété de déploiement à définir dans le serveur d’applications. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
Vous pouvez utiliser cet élément pour définir vos propres propriétés JNDI ou remplacer la valeur par défaut des propriétés JNDI qui sont fournies par le service d’administration et les fichiers WAR de MobileFirst Operations Console.
Pour plus d’informations sur les propriétés JNDI, voir Liste des propriétés JNDI pour le service d’administration de MobileFirst Server.
Pour spécifier un serveur d’applications
Utilisez l’élément <applicationserver>
pour définir les paramètres qui dépendent du serveur d’applications sous-jacent. L’élément <applicationserver>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<websphereapplicationserver> ou <was> |
Paramètres pour WebSphere Application Server. L’élément <websphereapplicationserver> (ou was> dans sa forme abrégée) signale une instance WebSphere Application Server. Le profil complet de WebSphere Application Server (versions Base et Network Deployment) est pris en charge, de même que WebSphere Application Server Liberty Core et WebSphere Application Server Liberty Network Deployment. |
0..1 |
<tomcat> |
Paramètres pour Apache Tomcat. | 0..1 |
Les attributs et les éléments internes de ces éléments sont décrits dans les tableaux de la page Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Toutefois, pour l’élément interne de l’élément <was>
pour la collectivité Liberty, voir le tableau suivant :
Elément | Description | Nombre |
---|---|---|
<collectiveController> |
Contrôleur de collectivité Liberty. | 0..1 |
L’élément <collectiveController>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
serverName | Nom du contrôleur de collectivité. | Oui | Aucune |
controllerAdminName | Nom d’administrateur qui est défini dans le contrôleur de collectivité. Il s’agit du même utilisateur que celui utilisé pour joindre de nouveaux membres à la collectivité. | Oui | Aucune |
controllerAdminPassword | Mot de passe de l’administrateur. | Oui | Aucune |
createControllerAdmin | Permet d’indiquer si l’administrateur doit être créé dans le registre de base du contrôleur de collectivité. Les valeurs possibles sont true ou false. | Non | true |
Pour spécifier la configuration du service Live Update
Utilisez l’élément <configuration>
pour définir les paramètres qui dépendent du service Live Update. L’élément <configuration>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
install | Permet d’indiquer si le service Live Update doit être installé. | Oui | true |
configAdminUser | Administrateur du service Live Update. | Non. En revanche, obligatoire dans le cadre d’une topologie de parc de serveurs. | Si cet attribut n’est pas défini, un utilisateur est généré. Dans le cadre d’une topologie de parc de serveurs, le nom d’utilisateur doit être identique pour tous les membres du parc de serveurs. |
configAdminPassword | Mot de passe administrateur de l’utilisateur du service Live Update. | Si un utilisateur est spécifié pour configAdminUser. | Aucune. Dans le cadre d’une topologie de parc de serveurs, le mot de passe doit être identique pour tous les membres du parc de serveurs. |
createConfigAdminUser | Permet d’indiquer si un administrateur doit être créé dans le registre de base du serveur d’applications, s’il est manquant. | Non | true |
warFile | Fichier WAR du service Live Update. | Non | Le fichier mfp-live-update.war se trouve dans le même répertoire que le fichier mfp-ant-deployer.jar. |
L’élément <configuration>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<user> |
Utilisateur du service Live Update. | 0..1 |
<property> |
Propriétés. | 0.. |
L’élément <user>
collecte les paramètres relatifs à un utilisateur qui doivent être inclus dans un rôle de sécurité spécifique pour une application.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
role | Rôle de sécurité valide pour l’application. Valeur possible : configadmin. | Oui | Aucune |
name | Nom d’utilisateur. | Oui | Aucune |
password | Mot de passe si l’utilisateur doit être créé. | Non | Aucune |
Une fois que vous avez défini les utilisateurs à l’aide de l’élément <user>
, vous pouvez les mapper à n’importe lequel des rôles suivants à des fins d’authentification dans MobileFirst Operations Console : configadmin
.
Pour plus d’informations sur les autorisations implicites pour les rôles spécifiques, voir Configuration de l’authentification d’utilisateur pour l’administration de MobileFirst Server.
Astuce : Si les utilisateurs existent dans un annuaire LDAP externe, définissez uniquement les attributs role et name, mais ne définissez pas de mots de passe.
L’élément <property>
spécifie une propriété de déploiement à définir dans le serveur d’applications. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
Vous pouvez utiliser cet élément pour définir vos propres propriétés JNDI ou remplacer la valeur par défaut des propriétés JNDI qui sont fournies par le service d’administration et les fichiers WAR de MobileFirst Operations Console. Pour plus d’informations sur les propriétés JNDI, voir Liste des propriétés JNDI pour le service d’administration de MobileFirst Server.
Pour spécifier un serveur d’applications
Utilisez l’élément <applicationserver>
pour définir les paramètres qui dépendent du serveur d’applications sous-jacent. L’élément <applicationserver>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<websphereapplicationserver> ou <was> |
Paramètres pour WebSphere Application Server. L’élément |
0..1 |
<tomcat> |
Paramètres pour Apache Tomcat. | 0..1 |
Les attributs et les éléments internes de ces éléments sont décrits dans les tableaux de la page Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Toutefois, pour l’élément interne de l’élément
Elément | Description | Nombre |
---|---|---|
<collectiveMember> |
Membre d’une collectivité Liberty. | 0..1 |
L’élément <collectiveMember>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
serverName | Nom du membre de collectivité. | Oui | Aucune |
clusterName | Nom du cluster auquel appartient le membre de collectivité. | Oui | Aucune |
Remarque : Si le service push et les composants d’exécution sont installés dans le membre de collectivité, ils doivent porter le même nom de cluster. Si ces composants sont installés sur des membres distincts de la même collectivité, les noms de cluster peuvent être différents.
Pour spécifier le composant Analytics
L’élément <analytics>
indique que vous souhaitez connecter le service push de MobileFirst à un service MobileFirst Analytics déjà installé. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
install | Permet d’indiquer si le service push doit être connecté à MobileFirst Analytics. | Non | false |
analyticsURL | URL des services MobileFirst Analytics. | Oui | Aucune |
username | Nom d’utilisateur. | Oui | Aucune |
password | Mot de passe. | Oui | Aucune |
validate | Permet de déterminer si la MobileFirst Analytics Console est accessible ou non. | Non | true |
install
Utilisez l’attribut install pour indiquer que ce service push doit être connecté et pour envoyer des événements à MobileFirst Analytics. Les valeurs valides sont true ou false.
analyticsURL
Utilisez l’attribut analyticsURL afin de spécifier l’URL qui est exposée par MobileFirst Analytics, qui reçoit les données d’analyse entrantes.
Par exemple : http://<hostname>:<port>/analytics-service/rest
username
Utilisez l’attribut username afin de spécifier le nom d’utilisateur qui est utilisé si le point d’entrée des données pour
MobileFirst Analytics est protégé avec l’authentification de base.
password
Utilisez l’attribut password afin de spécifier le mot de passe qui est utilisé si le point d’entrée des données pour
MobileFirst Analytics est protégé avec l’authentification de base.
validate
Utilisez l’attribut validate pour déterminer si la console MobileFirst Analytics Console est accessible ou non et pour vérifier l’authentification par nom d’utilisateur avec un mot de passe. Les valeurs possibles sont true ou false.
Pour spécifier une connexion à la base de données du service push
L’élément <database>
collecte les paramètres permettant de spécifier une déclaration de source de données dans un serveur d’applications pour accéder à la base de données du service push.
Vous devez déclarer une seule base de données : <database kind="Push">
. Vous spécifiez l’élément <database>
en procédant comme pour la tâche Ant configuredatabase, à ceci près que l’élément <database>
ne possède pas les éléments <dba>
et <client>
. Il peut posséder les éléments <property>
.
L’élément <database>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
kind | Type de base de données (Push). | Oui | Aucune |
validate | Permet de déterminer si la base de données est accessible. | Non | true |
L’élément <database>
prend en charge les éléments suivants : Pour plus d’informations sur la configuration de ces éléments de base de données pour le système de gestion de base de données relationnelle, voir les tableaux de la page Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Elément | Description | Nombre |
---|---|---|
Paramètre pour les bases de données DB2. | 0..1 | |
Paramètre pour les bases de données Apache Derby. | 0..1 | |
Paramètre pour les bases de données MySQL. | 0..1 | |
Paramètre pour les bases de données Oracle. | 0..1 | |
Paramètre pour les bases de données Cloudant. | 0..1 | |
Paramètre pour le chemin de classe du pilote JDBC (système de gestion de base de données relationnelle uniquement). | 0..1 |
Remarque : Les attributs de l’élément
<cloudant>
sont légèrement différents de ceux de l’environnement d’exécution. Pour plus d’informations, voir le tableau suivant :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
url | URL du compte Cloudant. | Non | https://user.cloudant.com |
user | Nom d’utilisateur du compte Cloudant. | Oui | Aucune |
password | Mot de passe du compte Cloudant. | Non | Demandée en mode interactif |
dbName | Nom de la base de données Cloudant. Important : Ce nom de base de données doit commencer par un caractère en minuscule et ne peut contenir que des caractères en minuscules (a-z), des chiffres (0-9) et les caractères _, $ et -. | Non | mfp_push_db |
Tâches Ant pour l’installation du service push de MobileFirst Server
Les tâches Ant installmobilefirstpush, updatemobilefirstpush et uninstallmobilefirstpush sont fournies pour l’installation du service push.
Effets des tâches
installmobilefirstpush
La tâche Ant installmobilefirstpush configure un serveur d’applications pour exécuter le fichier WAR du service push en tant qu’application Web. Elle a les effets suivants : Elle déclare l’application Web de service push dans la racine de contexte /imfpush. La racine de contexte ne peut pas être modifiée. Pour les bases de données relationnelles, elle déclare les sources de données et, sur le profil complet de WebSphere Application Server, elle déclare les fournisseurs JDBC pour le service push. Elle configure les propriétés de configuration pour le service push à l’aide des entrées d’environnement JNDI. Ces entrées d’environnement JNDI configurent la communication OAuth avec le serveur d’autorisations MobileFirst, avec MobileFirst Analytics et avec Cloudant lorsque ce produit est utilisé.
updatemobilefirstpush
La tâche Ant updatemobilefirstpush met à jour une application Web MobileFirst Server déjà configurée sur un serveur d’applications. Elle met à jour le fichier WAR du service push. Ce fichier doit porter le même nom de base que le fichier WAR correspondant précédemment déployé.
uninstallmobilefirstpush
La tâche Ant uninstallmobilefirstpush annule les effets d’une précédente exécution de la tâche installmobilefirstpush. Elle a les effets suivants : elle supprime la configuration de l’application Web de service push avec la racine de contexte spécifiée. En conséquence, elle supprime également les paramètres ajoutés manuellement à cette application. Elle supprime le fichier WAR du service push du serveur d’applications en tant qu’option. Pour le système de gestion de base de données relationnelle, elle retire les sources de données et, sur le profil complet de WebSphere Application Server, elle retire les fournisseurs JDBC pour le service push. Elle supprime les entrées associées de l’environnement JNDI.
Attributs et éléments
Les tâches Ant installmobilefirstpush, updatemobilefirstpush et uninstallmobilefirstpush possèdent les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
id | Permet de distinguer différents déploiements. | Non | Vide |
warFile | Fichier WAR du service push. | Non | Le fichier ../PushService/mfp-push-service.war est relatif au répertoire MobileFirstServer contenant le fichier mfp-ant-deployer.jar. |
Id
L’attribut id distingue différents déploiements du service push dans la même cellule WebSphere Application Server. Sans l’attribut id, deux fichiers WAR possédant les mêmes racines de contexte pourraient entrer en conflit et ne pas être déployés.
warFile
Utilisez l’attribut warFile afin de spécifier un autre répertoire pour le fichier WAR du service push. Vous pouvez spécifier le nom de ce fichier WAR avec un chemin d’accès absolu ou relatif.
Les tâches Ant installmobilefirstpush, updatemobilefirstpush et uninstallmobilefirstpush prennent en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<applicationserver> |
Serveur d’applications. | 1 |
<analytics> |
Analyses. | 0..1 |
<authorization> |
Serveur d’autorisations permettant d’authentifier la communication avec d’autres composants MobileFirst Server. | 1 |
<database> |
Bases de données. | 1 |
<property> |
Propriétés. | 0..∞ |
Pour spécifier le serveur d’autorisations
L’élément <authorization>
collecte des informations afin de configurer le serveur d’autorisations pour la communication d’authentification avec d’autres composants MobileFirst Server. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
auto | Permet d’indiquer si l’URL de serveur d’autorisations est calculé. Les valeurs possibles sont true ou false. | Obligatoire sur un cluster ou un noeud WebSphere Application Server Network Deployment. | true |
authorizationURL | URL du serveur d’autorisations. | Si le mode n’est pas auto. | Racine de contexte de l’environnement d’exécution sur le serveur local. |
runtimeContextRoot | Racine de contexte de l’environnement d’exécution. | Non | /mfp |
pushClientID | ID confidentiel de service push dans le serveur d’autorisations. | Oui | Aucune |
pushClientSecret | Mot de passe client confidentiel de service push dans le serveur d’autorisations. | Oui | Aucune |
auto
Si la valeur définie est true, l’URL du serveur d’autorisations est calculée automatiquement à l’aide de la racine de contexte de l’environnement d’exécution sur le serveur d’applications local. Le mode auto n’est pas pris en charge si vous procédez au déploiement sur WebSphere Application Server Network Deployment sur un cluster.
authorizationURL
URL du serveur d’autorisations. Si le serveur d’autorisations est l’environnement d’exécution de MobileFirst, l’URL est l’URL de l’environnement d’exécution. Exemple : http://myHost:9080/mfp
.
runtimeContextRoot
Racine de contexte de l’environnement d’exécution qui est utilisée pour calculer l’URL du serveur d’autorisations en mode automatique.
pushClientID
ID de cette instance de service push en tant que client confidentiel du serveur d’autorisations. L’ID et le secret doivent être enregistrés pour le serveur d’autorisations. Ils peuvent être enregistrés par la tâche Ant installmobilefirstadmin ou à partir de MobileFirst Operations Console.
pushClientSecret
Clé secrète de cette instance de service push en tant que client confidentiel du serveur d’autorisations. L’ID et le secret doivent être enregistrés pour le serveur d’autorisations. Ils peuvent être enregistrés par la tâche Ant installmobilefirstadmin ou à partir de MobileFirst Operations Console.
L’élément <property>
spécifie une propriété de déploiement à définir dans le serveur d’applications. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
Vous pouvez utiliser cet élément pour définir vos propres propriétés JNDI ou remplacer la valeur par défaut des propriétés JNDI qui sont fournies par le fichier WAR de service push.
Pour plus d’informations sur les propriétés JNDI, voir Liste des propriétés JNDI pour le service push de MobileFirst Server.
Pour spécifier un serveur d’applications
Utilisez l’élément <applicationserver>
pour définir les paramètres qui dépendent du serveur d’applications sous-jacent. L’élément <applicationserver>
prend en charge les éléments suivants :
Elément | Description | Nombre | |
---|---|---|---|
Paramètres pour WebSphere Application Server. | L’élément <websphereapplicationserver> (ou <was> dans sa forme abrégée) signale une instance WebSphere Application Server. Le profil complet de WebSphere Application Server (versions Base et Network Deployment) est pris en charge, de même que WebSphere Application Server Liberty Core et WebSphere Application Server Liberty Network Deployment. |
0..1 | |
<tomcat> |
Paramètres pour Apache Tomcat. | 0..1 |
Les attributs et les éléments internes de ces éléments sont décrits dans les tableaux de la page Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Toutefois, pour l’élément interne de l’élément <was>
pour la collectivité Liberty, voir le tableau suivant :
Elément | Description | Nombre |
---|---|---|
<collectiveMember> |
Membre d’une collectivité Liberty. | 0..1 |
L’élément <collectiveMember>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
serverName | Nom du membre de collectivité. | Oui | Aucune |
clusterName | Nom du cluster auquel appartient le membre de collectivité. | Oui | Aucune |
Remarque : Si le service push et les composants d’exécution sont installés dans le membre de collectivité, ils doivent porter le même nom de cluster. Si ces composants sont installés sur des membres distincts de la même collectivité, les noms de cluster peuvent être différents.
Pour spécifier le composant Analytics
L’élément <analytics>
indique que vous souhaitez connecter le service push de MobileFirst à un service MobileFirst Analytics déjà installé. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
install | Permet d’indiquer si le service push doit être connecté à MobileFirst Analytics. | Non | false |
analyticsURL | URL des services MobileFirst Analytics. | Oui | Aucune |
username | Nom d’utilisateur. | Oui | Aucune |
password | Mot de passe. | Oui | Aucune |
validate | Permet de déterminer si la MobileFirst Analytics Console est accessible ou non. | Non | true |
install
Utilisez l’attribut install pour indiquer que ce service push doit être connecté et pour envoyer des événements à MobileFirst Analytics. Les valeurs valides sont true ou false.
analyticsURL
Utilisez l’attribut analyticsURL afin de spécifier l’adresse URL qui est exposée par
MobileFirst Analytics, qui reçoit les données d’analyse
entrantes.
Par exemple : http://<hostname>:<port>/analytics-service/rest
username
Utilisez l’attribut username afin de spécifier le nom d’utilisateur qui est utilisé si le point d’entrée des données pour MobileFirst Analytics est protégé avec l’authentification de base.
password
Utilisez l’attribut password afin de spécifier le mot de passe qui est utilisé si le point d’entrée des données pour MobileFirst Analytics est protégé avec l’authentification de base.
validate
Utilisez l’attribut validate pour déterminer si la console MobileFirst Analytics Console est accessible ou non et pour vérifier l’authentification par nom d’utilisateur avec un mot de passe. Les valeurs possibles sont true ou false.
Pour spécifier une connexion à la base de données du service push
L’élément <database>
collecte les paramètres permettant de spécifier une déclaration de source de données dans un serveur d’applications pour accéder à la base de données du service push.
Vous devez déclarer une seule base de données : <database kind="Push">
. Vous spécifiez l’élément <database>
en procédant comme pour la tâche Ant configuredatabase, à ceci près que l’élément <database>
ne possède pas les éléments <dba>
et <client>
. Il peut posséder les éléments <property>
.
L’élément <database>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
kind | Type de base de données (Push). | Oui | Aucune |
validate | Permet de déterminer si la base de données est accessible. | Non | true |
L’élément <database>
prend en charge les éléments suivants : Pour plus d’informations sur la configuration de ces éléments de base de données pour le système de gestion de base de données relationnelle, voir les tableaux de la page Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Elément | Description | Nombre |
---|---|---|
<db2> |
Paramètre pour les bases de données DB2. | 0..1 |
<derby> |
Paramètre pour les bases de données Apache Derby. | 0..1 |
<mysql> |
Paramètre pour les bases de données MySQL. | 0..1 |
<oracle> |
Paramètre pour les bases de données Oracle. | 0..1 |
<cloudant> |
Paramètre pour les bases de données Cloudant. | 0..1 |
<driverclasspath> |
Paramètre pour le chemin de classe du pilote JDBC (système de gestion de base de données relationnelle uniquement). | 0..1 |
Remarque : Les attributs de l’élément
<cloudant>
sont légèrement différents de ceux de l’environnement d’exécution. Pour plus d’informations, voir le tableau suivant :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
url | URL du compte Cloudant. | Non | https://user.cloudant.com |
user | Nom d’utilisateur du compte Cloudant. | Oui | Aucune |
password | Mot de passe du compte Cloudant. | Non | Demandée en mode interactif |
dbName | Nom de la base de données Cloudant. Important : Ce nom de base de données doit commencer par un caractère en minuscule et ne peut contenir que des caractères en minuscules (a-z), des chiffres (0-9) et les caractères _, $ et -. | Non | mfp_push_db |
Tâches Ant pour l’installation des environnements d’exécution de MobileFirst
Informations de référence pour les tâches Ant installmobilefirstruntime, updatemobilefirstruntime et uninstallmobilefirstruntime.
Effets des tâches
installmobilefirstruntime
La tâche Ant installmobilefirstruntime configure un serveur d’applications pour exécuter un fichier WAR de l’environnement d’exécution de MobileFirst en tant qu’application Web. Elle a les effets suivants :
- Elle déclare l’application Web de MobileFirst dans la racine de contexte spécifiée, par défaut, /mfp.
- Elle déploie le fichier WAR de l’environnement d’exécution sur le serveur d’applications.
- Elle déclare les sources de données et, sur le profil complet de WebSphere Application Server, elle déclare les fournisseurs JDBC pour l’environnement d’exécution.
- Elle déploie les pilotes de base de données dans le serveur d’applications.
- Elle définit les propriétés de configuration de MobileFirst via des entrées d’environnement JNDI.
- Le cas échéant, elle définit les entrées d’environnement JNDI MobileFirst pour configurer le serveur d’applications en tant que membre de parc de serveurs pour l’environnement d’exécution.
updatemobilefirstruntime
La tâche Ant updatemobilefirstruntime met à jour un environnement d’exécution de MobileFirst qui est déjà configuré sur un serveur d’applications. Elle met à jour le fichier WAR de l’environnement d’exécution. Le fichier doit porter le même nom de base que le fichier WAR de l’environnement d’exécution précédemment déployé. A part cela, la tâche ne change pas la configuration du serveur d’applications, c’est-à-dire la configuration de l’application Web, les sources de données et les entrées d’environnement JNDI.
uninstallmobilefirstruntime
La tâche Ant uninstallmobilefirstruntime annule les effets d’une précédente exécution de la tâche installmobilefirstruntime. Elle a les effets suivants :
- Elle supprime la configuration de l’application Web de MobileFirst avec la racine de contexte spécifiée. Elle supprime également les paramètres ajoutés manuellement à cette application.
- Elle supprime le fichier WAR de l’environnement d’exécution sur le serveur d’applications.
- Elle supprime les sources de données et, sur le profil complet de WebSphere Application Server, elle retire les fournisseurs JDBC pour l’environnement d’exécution.
- Elle supprime les entrées associées de l’environnement JNDI.
Attributs et éléments
Les tâches Ant installmobilefirstruntime, updatemobilefirstruntime et uninstallmobilefirstruntime possèdent les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut | |
---|---|---|---|---|
contextroot | Préfixe commun dans les URL vers l’application (racine de contexte). | Non | /mfp | |
id | Permet de distinguer différents déploiements. | Non | Vide | |
environmentId | Permet de distinguer différents environnements MobileFirst. | Non | Vide | |
warFile | Fichier WAR de l’environnement d’exécution de MobileFirst. | Non | Le fichier mfp-server.war se trouve dans le même répertoire que le fichier mfp-ant-deployer.jar. | |
wasStartingWeight | Ordre de démarrage pour WebSphere Application Server. Les valeurs les plus faibles démarrent en premier. | Non | 2 |
contextroot et id
Les attributs contextroot et id distinguent différents projets MobileFirst.
Dans les profils Liberty de WebSphere Application Server et dans les environnements Tomcat, le paramètre contextroot est suffisant pour atteindre cet objectif. Dans les environnements de profil complet de WebSphere Application Server, l’attribut id est utilisé à la place.
environmentId
Utilisez l’attribut environmentId pour distinguer plusieurs environnements, constitués chacun du service d’administration de MobileFirst Server et des applications Web d’environnement d’exécution de MobileFirst, qui doivent fonctionner indépendamment. Vous devez affecter à cet attribut la même valeur que pour l’application d’exécution qui a été définie dans l’appel de la tâche
warFile
Utilisez l’attribut warFile afin de spécifier un répertoire différent pour le fichier WAR de l’environnement d’exécution de MobileFirst. Vous pouvez spécifier le nom de ce fichier WAR avec un chemin d’accès absolu ou relatif.
wasStartingWeight
Utilisez l’attribut wasStartingWeight pour spécifier une valeur qui est utilisée dans WebSphere Application Server comme une pondération pour s’assurer que l’ordre de démarrage est respecté. Conformément à la valeur d’ordre de démarrage, l’application Web du service d’administration de MobileFirst Server est déployée et démarrée avant tout autre projet d’exécution MobileFirst. Si des projets MobileFirst sont déployés ou démarrés avant l’application Web, la communication JMX n’est pas établie et vous ne pourrez pas gérer vos projets MobileFirst.
Les tâches installmobilefirstruntime, updatemobilefirstruntime et uninstallmobilefirstruntime prennent en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriétés. | 0.. |
<applicationserver> |
Serveur d’applications. | 1 |
<database> |
Bases de données. | 1 |
<analytics> |
Composant Analytics. | 0..1 |
L’élément <property>
spécifie une propriété de déploiement à définir dans le serveur d’applications. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
L’élément <applicationserver>
décrit le serveur d’applications sur lequel l’application MobileFirst est déployée. Il s’agit d’un conteneur
pour l’un des éléments ci-après.
Elément | Description | Nombre |
---|---|---|
<websphereapplicationserver> ou <was> |
Paramètres pour WebSphere Application Server. | 0..1 |
<tomcat> |
Paramètres pour Apache Tomcat. | 0..1 |
L’élément <websphereapplicationserver>
(ou <was>
dans sa forme abrégée) signale une instance WebSphere Application Server. Le profil complet de WebSphere Application Server (versions Base et Network Deployment) est pris en charge, de même que WebSphere Application Server Liberty Core et WebSphere Application Server Liberty Network Deployment. L’élément <websphereapplicationserver>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
installdir | Répertoire d’installation de WebSphere Application Server. | Oui | Aucune |
profile | Profil WebSphere Application Server ou Liberty. | Oui | Aucune |
user Nom de l’administrateur WebSphere Application Server. | Oui, sauf pour Liberty | Aucune | |
password | Mot de passe de l’administrateur WebSphere Application Server. | Non demandée de manière interactive | |
libertyEncoding | Algorithme permettant de coder les mots de passe de source de données pour WebSphere Application Server Liberty. Les valeurs possibles sont none, xor et aes. Que le codage xor ou aes soit utilisé, le mot de passe déchiffré est transmis en tant qu’argument au programme securityUtility, appelé via un processus externe. Vous pouvez afficher le mot de passe à l’aide d’une commande ps ou dans le système de fichiers /proc sur les systèmes d’exploitation UNIX. | Non | xor |
jeeVersion | Pour le profil Liberty. Permet de spécifier si les fonctions du profil Web JEE6 ou du profil Web JEE7 doivent être installées. Les valeurs possibles sont 6, 7 ou auto. | Non | auto |
configureFarm | Pour le profil Liberty de WebSphere Application Server et pour le profil complet de WebSphere Application Server (non pour l’édition WebSphere Application Server Network Deployment et la collectivité Liberty). Permet de spécifier si le serveur est membre d’un parc de serveurs. Les valeurs possibles sont true ou false. | Non | false |
farmServerId | Chaîne qui identifie de manière unique un serveur dans un parc de serveurs. Les services d’administration de MobileFirst Server et tous les environnements d’exécution de MobileFirst qui communiquent avec lui doivent partager la même valeur. | Oui | Aucune |
Il prend en charge les éléments ci-après pour un déploiement sur un serveur unique :
Elément | Description | Nombre |
---|---|---|
<server> |
Serveur unique. | 0..1 |
L’élément
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom du serveur. | Oui | Aucune |
Il prend en charge les éléments suivants pour la collectivité Liberty :
Elément | Description | Nombre |
---|---|---|
<collectiveMember> |
Membre d’une collectivité Liberty. | 0..1 |
L’élément <collectiveMember>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
serverName | Nom du membre de collectivité. | Oui | Aucune |
clusterName | Nom du cluster auquel appartient le membre de collectivité. | Oui | Aucune |
serverId | Chaîne qui identifie de manière unique le membre de collectivité. | Oui | Aucune |
controllerHost | Nom du contrôleur de collectivité. | Oui | Aucune |
controllerHttpsPort | Port HTTPS du contrôleur de collectivité. | Oui | Aucune |
controllerAdminName | Nom d’administrateur qui est défini dans le contrôleur de collectivité. Il s’agit du même utilisateur que celui utilisé pour joindre de nouveaux membres à la collectivité. | Oui | Aucune |
controllerAdminPassword | Mot de passe de l’administrateur. | Oui | Aucune |
createControllerAdmin | Permet d’indiquer si l’administrateur doit être créé dans le registre de base du membre de collectivité. Les valeurs possibles sont true ou false. | Non | true |
Il prend en charge les éléments ci-après pour Network Deployment.
Elément | Description | Nombre |
---|---|---|
<cell> |
Ensemble de la cellule. | 0..1 |
<cluster> |
Tous les serveurs d’un cluster. | 0..1 |
<node> |
Tous les serveurs d’un noeud, clusters exclus. | 0..1 |
<server> |
Serveur unique. | 0..1 |
L’élément <cell>
ne possède aucun attribut.
L’élément <cluster>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom du cluster. | Oui | Aucune |
L’élément <node>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom du noeud. | Oui | Aucune |
L’élément <server>
, qui est utilisé dans un contexte Network Deployment, possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
nodeName | Nom du noeud. | Oui | Aucune |
serverName | Nom du serveur. | Oui | Aucune |
L’élément <tomcat>
désigne un serveur Apache Tomcat. Il possède l’attribut suivant :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
installdir | Répertoire d’installation d’Apache Tomcat. Pour une installation Tomcat répartie dans un répertoire CATALINA_HOME et un répertoire CATALINA_BASE, spécifiez la valeur de la variable d’environnement CATALINA_BASE. | Oui | Aucune |
configureFarm | Permet de spécifier si le serveur est membre d’un parc de serveurs. Les valeurs possibles sont true ou false. | Non | false |
farmServerId | Chaîne qui identifie de manière unique un serveur dans un parc de serveurs. Les services d’administration de MobileFirst Server et tous les environnements d’exécution de MobileFirst qui communiquent avec lui doivent partager la même valeur. | Oui | Aucune |
L’élément <database>
spécifie les informations nécessaires pour accéder à une base de données spécifique. L’élément <database>
est spécifié comme pour la tâche Ant configuredatabase, à ceci près qu’il ne possède pas les éléments <dba>
et <client>
. En revanche, il peut posséder les éléments <property>
. L’élément <database>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
kind | Type de base de données (environnement d’exécution de MobileFirst). | Oui | Aucune |
validate | Pour déterminer si la base de données est accessible ou non. Les valeurs possibles sont true ou false. | Non | true |
L’élément <database>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
<derby> |
Paramètres pour Derby. | 0..1 |
<db2> |
Paramètres pour DB2. | 0..1 |
<mysql> |
Paramètres pour MySQL. | 0..1 |
<oracle> |
Paramètres pour Oracle. | 0..1 |
<driverclasspath> |
Chemin de classe du pilote JDBC. | 0..1 |
L’élément <analytics>
indique que vous souhaitez connecter l’environnement d’exécution de MobileFirst à une console et des services MobileFirst Analytics Console déjà installés. Il possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
install | Permet d’indiquer si l’environnement d’exécution de MobileFirst doit être connecté à MobileFirst Analytics. | Non | false |
analyticsURL | URL des services MobileFirst Analytics. | Oui | Aucune |
consoleURL | URL de MobileFirst Analytics Console. | Oui | Aucune |
username | Nom d’utilisateur. | Oui | Aucune |
password | Mot de passe. | Oui | Aucune |
validate | Permet de déterminer si la MobileFirst Analytics Console est accessible ou non. | Non | true |
tenant | Titulaire des données d’indexation qui sont collectées depuis un environnement d’exécution de MobileFirst. | Non | Identificateur interne |
install
Utilisez l’attribut install pour indiquer que ce contexte d’exécution MobileFirst doit être connecté et pour envoyer des événements à MobileFirst Analytics. Les valeurs admises sont true et false.
analyticsURL
Utilisez l’attribut analyticsURL afin de spécifier l’adresse URL qui est exposée par
MobileFirst Analytics, qui reçoit les données d’analyse
entrantes.
Par exemple : http://<hostname>:<port>/analytics-service/rest
consoleURL
Utilisez l’attribut consoleURL vers l’URL qui est exposée par MobileFirst Analytics, qui établit un lien vers MobileFirst Analytics Console.
Par exemple : http://<hostname>:<port>/analytics/console
username
Utilisez l’attribut username afin de spécifier le nom d’utilisateur qui est utilisé si le point d’entrée des données pour MobileFirst Analytics est protégé avec l’authentification de base.
password
Utilisez l’attribut password afin de spécifier le mot de passe qui est utilisé si le point d’entrée des données pour MobileFirst Analytics est protégé avec l’authentification de base.
validate
Utilisez l’attribut validate pour déterminer si la console MobileFirst Analytics Console est accessible ou non et pour vérifier l’authentification par nom d’utilisateur avec un mot de passe. Les valeurs possibles sont true ou false.
tenant
Pour plus d’informations sur cet attribut, voir Propriétés de configuration.
Pour spécifier une base de données Apache Derby
L’élément <derby>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
database | Nom de la base de données. | Non | MFPDATA, MFPADM, MFPCFG, MFPPUSH ou APPCNTR, selon l’attribut kind. |
datadir | Répertoire contenant les bases de données. | Oui | Aucune |
schema | Nom du schéma. | Non | MFPDATA, MFPCFG, MFPADMINISTRATOR, MFPPUSH ou APPCENTER, selon l’attribut kind. |
L’élément <derby>
prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de source de données ou propriété de connexion JDBC. | 0.. |
Pour plus d’informations sur les propriétés disponibles, voir la documentation de la classe EmbeddedDataSource40. Voir aussi la documentation de la classe EmbeddedConnectionPoolDataSource40.
Pour plus d’informations sur les propriétés disponibles pour un serveur Liberty, voir la documentation
relative à properties.derby.embedded
sur la
page Liberty profile: Configuration elements in the server.xml
file.
Lorsque le fichier mfp-ant-deployer.jar est utilisé dans le répertoire d’installation de Mobile Foundation, un élément <driverclasspath>
n’est pas nécessaire.
Pour spécifier une base de données DB2
L’élément <db2>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut | |
---|---|---|---|---|
database | Nom de la base de données. | Non MFPDATA, MFPADM, MFPCFG, MFPPUSH ou APPCNTR, selon l’attribut kind. | ||
server | Nom d’hôte du serveur de base de données. | Oui | Aucune | |
port | Port sur le serveur de base de données. | Non | 50000 | |
user | Nom d’utilisateur permettant d’accéder aux bases de données. | Cet utilisateur n’a pas besoin de privilèges étendus pour les bases de données. Si vous implémentez des restrictions sur la base de données, vous pouvez définir un utilisateur avec des privilèges restreints | répertoriés dans Utilisateurs de base de données et privilèges correspondants. | Oui Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif | |
schema | Nom du schéma. | Non | Dépend de l’utilisateur |
Pour plus d’informations sur les comptes utilisateur DB2, voir DB2 security model overview.
L’élément <db2>
prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de source de données ou propriété de connexion JDBC. | 0.. |
Pour plus d’informations sur les propriétés disponibles, voir Properties for the IBM Data Server Driver for JDBC and SQLJ.
Pour plus d’informations sur les propriétés disponibles pour un serveur Liberty, voir la section properties.db2.jcc de la page Liberty profile: Configuration elements in the server.xml file.
L’élément <driverclasspath>
doit contenir les fichiers JAR pour le pilote JDBC DB2 et pour la licence qui lui est associée. Vous pouvez télécharger des pilotes JDBC DB2 depuis la page DB2 JDBC Driver Versions.
Pour spécifier une base de données MySQL
L’élément <mysql>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut | |
---|---|---|---|---|
database | Nom de la base de données. | Non | MFPDATA, MFPADM, MFPCFG, MFPPUSH ou APPCNTR, selon l’attribut kind. | |
server | Nom d’hôte du serveur de base de données. | Oui | Aucune | |
port | Port sur le serveur de base de données. | Non | 3306 | |
user | Nom d’utilisateur permettant d’accéder aux bases de données. Cet utilisateur n’a pas besoin de privilèges étendus pour les bases de données. Si vous implémentez des restrictions sur la base de données, vous pouvez définir un utilisateur avec des privilèges restreints | répertoriés dans Utilisateurs de base de données et privilèges correspondants. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
A la place de database, server et port, vous pouvez aussi spécifier une adresse URL. Dans ce cas, utilisez les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
url | URL pour la connexion à la base de données. | Oui | Aucune |
user | Nom d’utilisateur permettant d’accéder aux bases de données. Cet utilisateur n’a pas besoin de privilèges étendus pour les bases de données. Si vous implémentez des restrictions sur la base de données, vous pouvez définir un utilisateur avec les privilèges restreints répertoriés dans Utilisateurs de base de données et privilèges correspondants | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
Pour plus d’informations sur les comptes utilisateur MySQL, voir MySQL User Account Management.
L’élément <mysql>
prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de source de données ou propriété de connexion JDBC. | 0.. |
Pour plus d’informations sur les propriétés disponibles, voir la documentation Driver/Datasource Class Names, URL Syntax and Configuration Properties for Connector/J.
Pour plus d’informations sur les propriétés disponibles pour un serveur Liberty, voir la section Properties de la page Liberty profile: Configuration elements in the server.xml file.
L’élément <driverclasspath>
doit contenir un fichier JAR MySQL Connector/J. Vous pouvez le télécharger depuis la page Download Connector/J.
Pour spécifier une base de données Oracle
L’élément <oracle>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
database | Nom de base de données, ou nom de service Oracle. Remarque : Vous devez toujours utiliser un nom de service pour vous connecter à une base de données PDB. | Non | ORCL |
server | Nom d’hôte du serveur de base de données. Oui Aucune | ||
port | Port sur le serveur de base de données. Non 1521 | ||
user | Nom d’utilisateur permettant d’accéder aux bases de données. Cet utilisateur n’a pas besoin de privilèges étendus pour les bases de données. Si vous implémentez des restrictions sur la base de données, vous pouvez définir un utilisateur avec les privilèges restreints répertoriés dans Utilisateurs de base de données et privilèges correspondants Voir la note sous ce tableau. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
Remarque: Pour l’attribut user, utilisez plutôt un nom d’utilisateur en lettres majuscules. Les noms d’utilisateur Oracle sont en général en lettres majuscules. A la différence des autres outils de bases de données, la tâche Ant installmobilefirstruntime ne convertit pas les majuscules en minuscules en ce qui concerne le nom d’utilisateur. Si la tâche Ant installmobilefirstruntime ne parvient pas à se connecter à la base de données, essayez de saisir une valeur en majuscules pour l’attribut user.
A la place de database, server et port, vous pouvez aussi spécifier une adresse URL. Dans ce cas, utilisez les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
url | URL pour la connexion à la base de données. | Oui | Aucune |
user | Nom d’utilisateur permettant d’accéder aux bases de données. Cet utilisateur n’a pas besoin de privilèges étendus pour les bases de données. Si vous implémentez des restrictions sur la base de données, vous pouvez définir un utilisateur avec les privilèges restreints répertoriés dans Utilisateurs de base de données et privilèges correspondants Voir la note sous ce tableau. | Oui | Aucune |
password | Nom d’utilisateur permettant d’accéder aux bases de données. | Non | Demandée en mode interactif |
Remarque: Pour l’attribut user, utilisez plutôt un nom d’utilisateur en lettres majuscules. Les noms d’utilisateur Oracle sont en général en lettres majuscules. A la différence des autres outils de bases de données, la tâche Ant installmobilefirstruntime ne convertit pas les majuscules en minuscules en ce qui concerne le nom d’utilisateur. Si la tâche Ant installmobilefirstruntime ne parvient pas à se connecter à la base de données, essayez de saisir une valeur en majuscules pour l’attribut user.
Pour plus d’informations sur les comptes utilisateur Oracle, voir Overview of Authentication Methods.
Pour plus d’informations sur les adresses URL de connexion à une base de données Oracle, voir la section Database URLs and Database Specifiers de la page Data Sources and URLs.
Il prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
<property> |
Propriété de source de données ou propriété de connexion JDBC. | 0.. |
Pour plus d’informations sur les propriétés disponibles, voir la section Data Sources and URLs de la page Data Sources and URLs.
Pour plus d’informations sur les propriétés disponibles pour un serveur Liberty, voir la section properties.oracle de la page Liberty profile: Configuration elements in the server.xml file.
L’élément <driverclasspath>
doit contenir un fichier JAR de pilote JDBC Oracle. Vous pouvez télécharger des pilotes JDBC Oracle depuis la page JDBC, SQLJ, Oracle JPublisher and Universal Connection
Pool (UCP).
L’élément <property>
, qui peut être inclus dans les éléments <derby>
, <db2>
, <mysql>
ou <oracle>
, possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
type | Type Java des valeurs de propriété, généralement java.lang.String/Integer/Boolean. | Non | java.lang.String |
value | Valeur de la propriété. | Oui | Aucune |
Tâches Ant pour l’installation d’Application Center
Les tâches Ant <installApplicationCenter>
, <updateApplicationCenter>
et <uninstallApplicationCenter>
sont fournies pour l’installation de la console et des services Application Center.
Effets des tâches
installApplicationCenter
La tâche Ant <installApplicationCenter>
configure un serveur d’applications pour exécuter le fichier WAR des services Application Center en tant qu’application Web et pour installer la console Application Center. Elle a les effets suivants :
- Elle déclare l’application Web des services Application Center dans la racine de contexte /applicationcenter.
- Elle déclare les sources de données et, sur le profil complet de WebSphere Application Server, elle déclare également les fournisseurs JDBC pour les services Application Center.
- Elle déploie l’application Web des services Application Center sur le serveur d’applications.
- Elle déclare la console Application Center en tant qu’application Web dans la racine de contexte /appcenterconsole.
- Elle déploie le fichier WAR de la console Application Center sur le serveur d’applications.
- Elle configure les propriétés de configuration des services Application Center à l’aide des entrées d’environnement JNDI. Les entrées d’environnement JNDI qui sont liées au point de terminaison et aux proxys sont commentées. Vous devez supprimer leur mise en commentaire dans certains cas.
- Elle configure les utilisateurs qu’elle mappe aux rôles utilisés par les applications Web des services et de la console Application Center.
- Sur WebSphere Application Server, elle configure la propriété personnalisée nécessaire pour le conteneur Web.
updateApplicationCenter
La tâche <updateApplicationCenter>
met à jour une application Application Center déjà configurée sur un serveur d’applications. Elle a les effets suivants :
- Elle met à jour le fichier WAR des services Application Center. Ce fichier doit porter le même nom de base que le fichier WAR correspondant précédemment déployé.
- Elle met à jour le fichier WAR de la console Application Center. Ce fichier doit porter le même nom de base que le fichier WAR correspondant précédemment déployé.
La tâche ne change pas la configuration du serveur d’applications, c’est-à-dire la configuration d’application Web, les
sources de données, les entrées d’environnement JNDI et les mappages utilisateur à rôle. Elle ne s’applique qu’à une installation qui est effectuée à l’aide de la tâche
Remarque : Sur le profil Liberty de WebSphere Application Server, la tâche ne modifie pas les fonctions, laissant ainsi une liste non minimale potentielle de fonctions dans le fichier server.xml pour l’application installée.
uninstallApplicationCenter
La tâche Ant <uninstallApplicationCenter>
annule les effets d’une précédente exécution de la tâche <installApplicationCenter>
. Elle a les effets suivants :
- Elle supprime la configuration de l’application Web des services Application Center avec la racine de contexte /applicationcenter. En conséquence, elle supprime également les paramètres ajoutés manuellement à cette application.
- Elle supprime les fichiers WAR des services et de la console Application Center du serveur d’applications.
- Elle supprime les sources de données et, sur le profil complet de WebSphere Application Server, elle retire également les fournisseurs JDBC pour les services Application Center.
- Elle supprime les pilotes de base de données qui étaient utilisés par les services Application Center sur le serveur d’applications.
- Elle supprime les entrées associées de l’environnement JNDI.
- Elle supprime les utilisateurs qui sont configurés par l’appel de la tâche
<installApplicationCenter>
.
Attributs et éléments
Les tâches <installApplicationCenter>
, <updateApplicationCenter>
et <uninstallApplicationCenter>
possèdent les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
id | Distingue différents déploiements dans le profil complet de WebSphere Application Server. | Non | Vide |
servicewar | Fichier WAR des services Application Center. | Non | Le fichier applicationcenter.war se trouve dans le répertoire de la console Application Center : product_install_dir/ApplicationCenter/console. |
shortcutsDir | Répertoire dans lequel vous placez les raccourcis. | Non | Aucune |
aaptDir | Répertoire contenant le programme aapt provenant du package platform-tools du logiciel SDK Android. | Non | Aucune |
id
Dans les environnements de profil complet de WebSphere Application Server, l’attribut id est utilisé pour distinguer différents déploiements de la console et des services Application Center. Sans l’attribut id, deux fichiers WAR avec les mêmes racines de contexte peuvent entrer en conflit et ne pas être déployés.
servicewar
Utilisez l’attribut servicewar afin de spécifier un autre répertoire pour le fichier WAR des services Application Center. Vous pouvez spécifier le nom de ce fichier WAR avec un chemin d’accès absolu ou relatif.
shortcutsDir
L’attribut shortcutsDir indique où placer les raccourcis vers la console Application Center. Si vous définissez cet attribut, les fichiers suivants sont ajoutés à ce répertoire :
- appcenter-console.url : ce fichier est un raccourci Windows. Il ouvre la console Application Center dans un navigateur.
- appcenter-console.sh : ce fichier est un script shell UNIX. Il ouvre la console Application Center dans un navigateur.
aaptDir
Le programme aapt fait partie de la distribution Mobile Foundation : rép_install_produit/ApplicationCenter/tools/android-sdk.
Si cet attribut n’est pas défini, lors du téléchargement d’une application apk, Application Center effectue l’analyse syntaxique de cette dernière à l’aide de son propre code, ce qui peut entraîner les limitations.
Les tâches <installApplicationCenter>
, <updateApplicationCenter>
et <uninstallApplicationCenter>
possèdent les éléments suivants :
Elément | Description | Nombre |
---|---|---|
applicationserver | Serveur d’applications. | 1 |
console | Console Application Center. | 1 |
database | Bases de données. | 1 |
user | Utilisateur à mapper à un rôle de sécurité. | 0..∞ |
Pour spécifier une console Application Center
L’élément <console>
collecte des informations permettant de personnaliser l’installation de la console Application Center. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
warfile | Fichier WAR de la console Application Center. | Non | Le fichier appcenterconsole.war se trouve dans le répertoire de la console Application Center : rép_install_produit/ApplicationCenter/console. |
Pour spécifier un serveur d’applications
Utilisez l’élément <applicationserver>
pour définir les paramètres qui dépendent du serveur d’applications sous-jacent. L’élément <applicationserver>
prend en charge les éléments suivants :
Elément | Description | Nombre |
---|---|---|
websphereapplicationserver ou was | Paramètres pour WebSphere Application Server. L’élément <websphereapplicationserver> (ou <was> dans sa forme abrégée) signale une instance WebSphere Application Server. Le profil complet de WebSphere Application Server (versions Base et Network Deployment) est pris en charge, de même que WebSphere Application Server Liberty Core. La collectivité Liberty n’est pas prise en charge pour Application Center. |
0..1 |
tomcat | Paramètres pour Apache Tomcat. | 0..1 |
Les attributs et les éléments internes de ces éléments sont décrits dans les tableaux de la page Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Pour spécifier une connexion à la base de données des services
L’élément <database>
collecte les paramètres permettant de spécifier une déclaration de source de données dans un serveur d’applications pour accéder à la base de données des services.
Vous devez déclarer une seule base de données : <database kind="ApplicationCenter">
. Vous spécifiez l’élément <database>
en procédant comme pour la tâche Ant <configuredatabase>
, à ceci près que l’élément <database>
ne possède pas les éléments <dba>
et <client>
. Il peut posséder les éléments <property>
.
L’élément <database>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
kind | Type de base de données (ApplicationCenter). | Oui | Aucune |
validate | Pour déterminer si la base de données est accessible ou non. | Non | True |
L’élément <database>
prend en charge les éléments suivants : Pour plus d’informations sur la configuration de ces éléments de base de données, voir les tableaux dans la section Tâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Elément | Description | Nombre |
---|---|---|
db2 | Paramètre pour les bases de données DB2. | 0..1 |
derby | Paramètre pour les bases de données Apache Derby. | 0..1 |
mysql | Paramètre pour les bases de données MySQL. | 0..1 |
oracle | Paramètre pour les bases de données Oracle. | 0..1 |
driverclasspath | Paramètre pour le chemin de classe du pilote JDBC. | 0..1 |
Pour spécifier un utilisateur et un rôle de sécurité
L’élément <user>
collecte les paramètres relatifs à un utilisateur qui doivent être inclus dans un rôle de sécurité spécifique pour une application.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
role | Rôle utilisateur appcenteradmin. | Oui | Aucune |
name | Nom d’utilisateur. | Oui | Aucune |
password | Mot de passe, si vous devez créer l’utilisateur. | Non | Aucune |
Tâches Ant pour l’installation de MobileFirst Analytics
Les tâches Ant installanalytics, updateanalytics et uninstallanalytics sont fournies pour l’installation de MobileFirst Analytics.
Ces tâches Ant ont pour finalité de configurer MobileFirst Analytics Console et le service MobileFirst Analytics avec le stockage approprié pour les données sur un serveur d’applications. La tâche installe des noeuds MobileFirst Analytics qui agissent comme des noeuds principaux et des données. Pour plus d’informations, voir Gestion de cluster et Elasticsearch.
Effets des tâches
installanalytics
La tâche Ant installanalytics configure un serveur d’applications pour exécuter IBM MobileFirst Analytics. Elle a les effets suivants :
- Elle déploie les fichiers WAR des services MobileFirst Analytics et MobileFirst Analytics Console sur le serveur d’applications.
- Elle déclare l’application Web du service MobileFirst Analytics dans la racine de contexte spécifiée, /analytics-service.
- Elle déclare l’application Web de MobileFirst Analytics Console dans la racine de contexte spécifiée, /analytics.
- Elle définit les propriétés de configuration des services MobileFirst Analytics Console et MobileFirst Analytics via des entrées d’environnement JNDI.
- Sur le profil Liberty de WebSphere Application Server, elle configure le conteneur Web.
- Le cas échéant, elle crée des utilisateurs pour utiliser MobileFirst Analytics Console.
updateanalytics
La tâche Ant updateanalytics met à jour les fichiers WAR des applications Web du service MobileFirst Analytics et de MobileFirst Analytics Console déjà configurés sur un serveur d’applications. Ces fichiers doivent porter les mêmes noms de base que les fichiers WAR de projet précédemment déployés.
La tâche ne change pas la configuration du serveur d’applications, c’est-à-dire les entrées de configuration d’application Web et d’environnement JNDI.
uninstallanalytics
La tâche Ant uninstallanalytics annule les effets d’une précédente exécution de la tâche installanalytics. Elle a les effets suivants :
- Elle supprime la configuration des applications Web du service MobileFirst Analytics et de MobileFirst Analytics Console avec leurs racines de contexte respectives.
- Elle supprime les fichiers WAR du service MobileFirst Analytics et de MobileFirst Analytics Console du serveur d’applications.
- Elle supprime les entrées associées de l’environnement JNDI.
Attributs et éléments
Les tâches installanalytics, updateanalytics et uninstallanalytics possèdent les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
serviceWar | Fichier WAR pour le service MobileFirst Analytics | Non | Le fichier analytics-service.war se trouve dans le répertoire Analytics. |
serviceWar
Utilisez l’attribut serviceWar afin de spécifier un répertoire différent pour le fichier WAR des services MobileFirst Analytics. Vous pouvez spécifier le nom de ce fichier WAR avec un chemin d’accès absolu ou relatif.
Les tâches <installanalytics>
, <updateanalytics>
et <uninstallanalytics>
possèdent les éléments suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
console | MobileFirst Analytics | Oui | 1 |
user | Utilisateur à mapper à un rôle de sécurité. | Non | 0.. |
storage | Type de stockage. | Oui | 1 |
applicationserver | Serveur d’applications. | Oui | 1 |
property | Propriétés. | Non | 0.. |
Pour spécifier MobileFirst Analytics Console
L’élément <console>
collecte des informations permettant de personnaliser l’installation de MobileFirst Analytics Console. Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
warfile | Fichier WAR de la console | Non | Le fichier analytics-ui.war se trouve dans le répertoire Analytics. |
shortcutsdir | Répertoire dans lequel vous placez les raccourcis. | Non | Aucune |
warFile
Utilisez l’attribut warFile afin de spécifier un répertoire différent pour le fichier WAR de MobileFirst Analytics Console. Vous pouvez spécifier le nom de ce fichier WAR avec un chemin d’accès absolu ou relatif.
shortcutsDir
L’attribut shortcutsDir indique où placer les raccourcis vers MobileFirst Analytics Console. Si vous le définissez, vous pouvez ajouter les fichiers suivants dans ce répertoire :
- analytics-console.url : ce fichier est un raccourci Windows. Il ouvre MobileFirst Analytics Console dans un navigateur.
- analytics-console.sh : ce fichier est un script shell UNIX. Il ouvre MobileFirst Analytics Console dans un navigateur.
Remarque : ces raccourcis n’incluent pas le paramètre de titulaire ElasticSearch.
L’élément <console>
prend en charge l’élément imbriqué suivant :
Elément | Description | Nombre |
---|---|---|
property | Propriétés | 0.. |
Avec cet élément, vous pouvez définir vos propres propriétés JNDI.
L’élément <property>
possède les attributs suivants :
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
Pour spécifier un utilisateur et un rôle de sécurité
L’élément <user>
collecte les paramètres relatifs à un utilisateur qui doivent être inclus dans un rôle de sécurité spécifique pour une application.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
role | Rôle de sécurité valide pour l’application. | Oui | Aucune |
name | Nom d’utilisateur. | Oui | Aucune |
password | Mot de passe si l’utilisateur doit être créé. | Non | Aucune |
Une fois que vous avez défini les utilisateurs à l’aide de l’élément `
- mfpmonitor
- mfpoperator
- mfpdeployer
- mfpadmin
Pour spécifier un type de stockage pour MobileFirst Analytics
L’élément <storage>
indique le type de stockage sous-jacent utilisé par MobileFirst Analytics pour stocker les informations et les données qu’il collecte.
Il prend en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
elasticsearch | ElasticSearch | Cluster |
L’élément <elasticsearch>
collecte les paramètres relatifs à un cluster ElasticSearch.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
clusterName | Nom du cluster ElasticSearch. | Non | worklight |
nodeName | Nom du noeud ElasticSearch. Il doit être unique dans un cluster ElasticSearch. | Non | worklightNode_<random number> |
mastersList | Chaîne délimitée par des virgules qui contient le nom d’hôte et les ports des noeuds principaux ElasticSearch dans le cluster ElasticSearch (par exemple hostname1:transport-port1,hostname2:transport-port2) | Non | Dépend de la topologie |
dataPath | Emplacement du cluster ElasticSearch. | Non | Dépend du serveur d’applications |
shards | Nombre de fragments que le cluster ElasticSearch crée. Cette valeur ne peut être définie que par les noeuds principaux qui sont créés dans le cluster ElasticSearch. | Non | 5 |
replicasPerShard | Nombre de répliques pour chaque fragment dans le cluster ElasticSearch. Cette valeur ne peut être définie que par les noeuds principaux qui sont créés dans le cluster ElasticSearch. | Non | 1 |
transportPort | Port utilisé pour la communication noeud à noeud dans le cluster ElasticSearch. | Non | 9600 |
clusterName
Utilisez l’attribut clusterName afin de spécifier le nom de votre choix pour le cluster ElasticSearch.
Un cluster ElasticSearch se compose d’un ou de plusieurs noeuds qui partagent le même nom de cluster ; par conséquent, vous pouvez spécifier la même valeur pour l’attribut clusterName si vous configurez plusieurs noeuds.
nodeName
Utilisez l’attribut nodeName afin de spécifier le nom de votre choix pour le noeud à configurer dans le cluster ElasticSearch. Chaque nom de noeud doit être unique dans le cluster ElasticSearch même si les noeuds s’étendent sur plusieurs machines.
mastersList
Utilisez l’attribut mastersList pour fournir la liste des noeuds principaux de votre cluster ElasticSearch séparés par une virgule. Chaque noeud principal dans cette liste doit être identifié par son nom d’hôte et le port de communication de noeud à noeud ElasticSearch. Ce port est 9600 par défaut ou le numéro de port que vous avez spécifié avec l’attribut transportPort lorsque vous avez configuré ce noeud principal.
Exemple : hostname1:transport-port1, hostname2:transport-port2
.
Remarque :
- Si vous spécifiez un élément transportPort différent de la valeur par défaut 9600, vous devez aussi définir cette valeur avec l’attribut transportPort. Par défaut, lorsque l’attribut mastersList est omis, une tentative de détection du nom d’hôte et du port de transport ElasticSearch est effectuée sur tous les serveurs d’applications pris en charge.
- Si le serveur d’applications cible est un cluster WebSphere Application Server Network Deployment, et si vous ajoutez ou retirez un serveur dans ce cluster ultérieurement, vous devrez éditer cette liste manuellement pour qu’elle reste synchronisée avec le cluster ElasticSearch.
dataPath
Utilisez l’attribut dataPath afin de spécifier un répertoire différent dans lequel stocker les données ElasticSearch. Vous pouvez spécifier un chemin absolu ou un chemin relatif.
Si l’attribut dataPath n’est pas spécifié, les données du cluster ElasticSearch sont stockées dans un répertoire par défaut appelé analyticsData, dont l’emplacement dépend du serveur d’applications :
- Pour le profil Liberty de WebSphere Application Server, l’emplacement est
${wlp.user.dir}/servers/serverName/analyticsData
. - Pour Apache Tomcat, l’emplacement est
${CATALINA_HOME}/bin/analyticsData
. - Pour WebSphere Application Server et WebSphere Application Server Network Deployment, l’emplacement est
${was.install.root}/profiles/<profileName>/analyticsData
.
Le répertoire analyticsData et la hiérarchie des sous-répertoires et des fichiers qu’il contient sont créés automatiquement à l’exécution, s’ils n’existent pas déjà lorsque le composant du service MobileFirst Analytics reçoit des événements.
shards
Utilisez l’attribut shards afin de spécifier le nombre de fragments à créer dans le cluster ElasticSearch.
replicasPerShard
Utilisez l’attribut replicasPerShard afin de spécifier le nombre de répliques à créer pour chaque fragment dans le cluster ElasticSearch.
Chaque fragment peut avoir une ou plusieurs répliques, ou ne pas avoir de réplique. Par défaut, chaque fragment possède une réplique, mais le nombre de répliques peut changer de façon dynamique dans un index existant dans MobileFirst Analytics. Une réplique de fragment ne peut pas être démarrée sur le même noeud que le fragment lui-même.
transportPort
Utilisez l’attribut transportPort afin de spécifier un port que les autres noeuds dans le cluster ElasticSearch doivent utiliser pour communiquer avec ce noeud. Vous devez vous assurer que ce port est disponible et accessible s’il se trouve derrière un proxy ou un pare-feu.
Pour spécifier un serveur d’applications
Utilisez l’élément <applicationserver>
pour définir les paramètres qui dépendent du serveur d’applications sous-jacent. L’élément <applicationserver>
prend en charge les éléments suivants :
Remarque : Les attributs et les éléments internes de cet élément sont décrits dans les tableaux de la pageTâches Ant pour l’installation des environnements d’exécution de MobileFirst.
Elément | Description | Nombre |
---|---|---|
websphereapplicationserver ou was | Paramètres pour WebSphere Application Server. | 0..1 |
tomcat | Paramètres pour Apache Tomcat. | 0..1 |
Pour spécifier des propriétés JNDI personnalisées
Les éléments <installanalytics>
, <updateanalytics>
et <uninstallanalytics>
prennent en charge l’élément suivant :
Elément | Description | Nombre |
---|---|---|
property | Propriétés | 0.. |
Avec cet élément, vous pouvez définir vos propres propriétés JNDI.
Cet élément possède les attributs ci-après.
Attribut | Description | Obligatoire | Valeur par défaut |
---|---|---|---|
name | Nom de la propriété. | Oui | Aucune |
value | Valeur de la propriété. | Oui | Aucune |
Bases de données d’environnement exécution internes
Découvrez les tables de base de données d’environnement d’exécution, leur finalité et l’ordre de grandeur des données stockées dans chaque table. Dans les bases de données relationnelles, les entités sont organisées en tables de base de données.
Base de données utilisée par l’environnement d’exécution de MobileFirst Server
Le tableau ci-après contient une liste de tables de base de données d’environnement d’exécution accompagnées de leur description et indique comment elles sont utilisées dans les bases de données relationnelles.
Nom de la table de base de données relationnelle | Description | Ordre de grandeur |
---|---|---|
LICENSE_TERMS | Stocke les diverses métriques de licence capturées à chaque fois que la tâche de mise hors service de l’appareil est exécutée. | Des dizaines de lignes. Cette valeur ne dépasse pas la valeur définie par la propriété JNDI mfp.device.decommission.when. Pour plus d’informations sur les propriétés JNDI, voir Liste des propriétés JNDI pour l’environnement d’exécution de MobileFirst |
ADDRESSABLE_DEVICE | Stocke quotidiennement les indicateurs d’appareils adressables. Une entrée est également ajoutée à chaque fois qu’un cluster est démarré. | Environ 400 lignes. Les entrées dont l’ancienneté est supérieure à 13 mois sont supprimées quotidiennement. |
MFP_PERSISTENT_DATA | Stocke les instances d’applications client enregistrées auprès du serveur OAuth, y compris les informations sur l’appareil, l’application, les utilisateurs associés au client et le statut de l’appareil. | Une ligne par paire appareil/application. |
MFP_PERSISTENT_CUSTOM_ATTR | Attributs personnalisés qui sont associés à des instances d’applications client. Les attributs personnalisés sont des attributs propres à l’application qui ont été enregistrés par l’application pour chaque instance client. | Aucune ligne ou plusieurs lignes par paire appareil/application. |
MFP_TRANSIENT_DATA | Contexte d’authentification de clients et d’appareils | Deux lignes par paire appareil/application ; si la connexion unique à l’appareil est utilisée, deux lignes supplémentaires par appareil. Pour plus d’informations sur la connexion unique, voir Configuration de la connexion unique à l’appareil. |
SERVER_VERSION | Version du produit. | Une ligne |
Base de données utilisée par le service d’administration de MobileFirst Server
Le tableau ci-après contient une liste de tables de base de données d’administration accompagnées de leur description et indique comment elles sont utilisées dans les bases de données relationnelles.
Nom de la table de base de données relationnelle | Description | Ordre de grandeur |
---|---|---|
ADMIN_NODE | Stocke des informations sur les serveurs qui exécutent le service d’administration. Dans une topologie autonome avec un seul serveur, cette entité n’est pas utilisée. | Une ligne par serveur ; vide si un serveur autonome est utilisé. |
AUDIT_TRAIL | Stocke une analyse rétrospective de toutes les actions administratives effectuées avec le service d’administration. | Des milliers de lignes. |
CONFIG_LINKS | Stocke les liens vers le service Live Update. Les adaptateurs et les applications peuvent avoir des configurations stockées dans le service Live Update, et les liens sont utilisés pour retrouver ces configurations. | Des centaines de lignes. 2 à 3 lignes sont utilisées par adaptateur. 4 à 6 lignes sont utilisées par application. |
FARM_CONFIG | Stocke la configuration des parcs de serveurs lorsqu’un parc de serveurs est utilisé. | Des dizaines de lignes ; vide si aucun parc de serveurs n’est utilisé. |
GLOBAL_CONFIG | Stocke des données de configuration globale. | 1 ligne. |
PROJECT | Stocke les noms des projets déployés. | Des dizaines de lignes. |
PROJECT_LOCK | Tâches de synchronisation de cluster internes. | Des dizaines de lignes. |
TRANSACTIONS | Table de synchronisation de cluster interne ; stocke l’état de toutes les actions d’administration en cours. | Des dizaines de lignes. |
MFPADMIN_VERSION | Version du produit. | Une ligne. |
Base de données utilisée par le service Live Update de MobileFirst Server
Le tableau ci-après contient une liste de tables de base de données du service Live Update accompagnées de leur description et indique comment elles sont utilisées dans les bases de données relationnelles.
Nom de la table de base de données relationnelle | Description | Ordre de grandeur |
---|---|---|
CS_SCHEMAS | Stocke les schémas versionnés qui existent dans la plateforme. | Une ligne par schéma. |
CS_CONFIGURATIONS | Stocke des instances de configurations pour chaque schéma versionné. | Une ligne par configuration. |
CS_TAGS | Stocke les zones pouvant faire l’objet d’une recherche et les valeurs pour chaque instance de configuration. | Une ligne pour chaque nom de zone et valeur pour chaque zone pouvant faire l’objet d’une recherche dans la configuration. |
CS_ATTACHMENTS | Stocke les pièces jointes pour chaque instance de configuration. | Une ligne par pièce jointe. |
CS_VERSION | Stocke la version du MFP ayant créé les tables ou les instances. | Une ligne dans la table avec la version de MFP. |
Base de données utilisée par le service push de MobileFirst Server
Le tableau ci-après contient une liste de tables de base de données du service push accompagnées de leur description et indique comment elles sont utilisées dans les bases de données relationnelles.
Nom de la table de base de données relationnelle | Description | Ordre de grandeur |
---|---|---|
PUSH_APPS | Table des notifications push ; stocke les détails des applications push. | Une ligne par application. |
PUSH_ENV | Table des notifications push ; stocke les détails des environnements push. | Des dizaines de lignes. |
PUSH_TAGS | Table des notifications push ; stocke les détails des étiquettes définies. | Des dizaines de lignes. |
PUSH_DEVICES | Table des notifications push. Stocke un enregistrement par appareil. | Une ligne par appareil. |
PUSH_SUBSCRIPTIONS | Table des notifications push. Stocke un enregistrement par abonnement d’étiquette. | Une ligne par abonnement d’appareil. |
PUSH_MESSAGES | Table des notifications push ; stocke les détails des messages push. | Des dizaines de lignes. |
PUSH_MESSAGE_SEQUENCE_TABLE | Table des notifications push ; stocke l’ID de séquence généré. | Une ligne. |
PUSH_VERSION | Version du produit. | Une ligne. |
Pour plus d’informations sur la configuration des bases de données, voir Configuration des bases de données.
Exemples de fichier de configuration
Mobile Foundation inclut un certain nombre d’exemples de fichier de configuration destinés à vous aider à commencer à utiliser les tâches Ant pour installer MobileFirst Server.
Pour commencer à utiliser ces tâches Ant le plus facilement possible, servez-vous des exemples de fichier de configuration fournis dans le répertoire MobileFirstServer/configuration-samples/ de la distribution de MobileFirst Server. Pour plus d’informations sur l’installation de MobileFirst Server à l’aide de tâches Ant, voir Installation à l’aide de tâches Ant.
Liste des exemples de fichier de configuration
Choisissez l’exemple de fichier de configuration approprié. Les fichiers suivants sont fournis :
Tâche | Derby | DB2 | MySQL | Oracle | |
---|---|---|---|---|---|
Créer les bases de données avec les données d’identification de l’administrateur de base de données | create-database-derby.xml | create-database-db2.xml | create-database-mysql.xml | create-database-oracle.xml | |
Installer MobileFirst Server sur Liberty | configure-liberty-derby.xml | configure-liberty-db2.xml | configure-liberty-mysql.xml | (Voir Remarque sur MySQL) | configure-liberty-oracle.xml |
Installer MobileFirst Server sur le profil complet de WebSphere Application Server, serveur unique | configure-was-derby.xml | configure-was-db2.xml | configure-was-mysql.xml (voir Remarque sur MySQL) | configure-was-oracle.xml | |
Installer MobileFirst Server sur WebSphere Application Server Network Deployment (voir Remarque sur les fichiers de configuration) | configure-wasnd-cluster-derby.xml, configure-wasnd-server-derby.xml, configure-wasnd-node-derby.xml. configure-wasnd-cell-derby.xml | configure-wasnd-cluster-db2.xml, configure-wasnd-server-db2.xml, configure-wasnd-node-db2.xml, configure-wasnd-cell-db2.xml | configure-wasnd-cluster-mysql.xml (voir Remarque sur MySQL), configure-wasnd-server-mysql.xml (voir Remarque sur MySQL), configure-wasnd-node-mysql.xml (voir Remarque sur MySQL), configure-wasnd-cell-mysql.xml | configure-wasnd-cluster-oracle.xml, configure-wasnd-server-oracle.xml, configure-wasnd-node-oracle.xml, configure-wasnd-cell-oracle.xml | |
Installer MobileFirst Server sur Apache Tomcat | configure-tomcat-derby.xml | configure-tomcat-db2.xml | configure-tomcat-mysql.xml | configure-tomcat-oracle.xml | |
Installer MobileFirst Server sur une collectivité Liberty | Non pertinent | configure-libertycollective-db2.xml | configure-libertycollective-mysql.xml | configure-libertycollective-oracle.xml |
Remarque sur MySQL : L’utilisation de MySQL conjointement avec le profil Liberty de WebSphere Application Server ou le profil complet de WebSphere Application Server n’est pas considérée comme une configuration prise en charge. Pour plus d’informations, voir la déclaration de prise en charge sur WebSphere Application Server. Envisagez d’utiliser IBM DB2 ou une autre base de données qui est prise en charge par WebSphere Application Server afin de bénéficier d’une configuration entièrement prise en charge par le support IBM.
Remarque sur les fichiers de configuration pour WebSphere Application Server Network Deployment : ** Les fichiers de configuration pour **wasnd contiennent une portée qui peut avoir pour valeur cluster, node, server ou cell. Par exemple, pour le fichier configure-wasnd-cluster-derby.xml, la portée est cluster. Ces types de portée définissent la cible de déploiement de la façon suivante :
- cluster : permet de déployer un cluster.
- server : permet de déployer un serveur unique géré par le gestionnaire de déploiement.
- node : permet de déployer tous les serveurs en cours d’exécution sur un noeud, qui n’appartiennent pas à un cluster.
- cell : permet de déployer tous les serveurs sur une cellule.
Exemples de fichier de configuration pour MobileFirst Analytics
Mobile Foundation inclut un certain nombre d’exemples de fichier de configuration destinés à vous aider à commencer à utiliser les tâches Ant pour installer les services MobileFirst Analytics et MobileFirst Analytics Console.
Pour commencer à utiliser les tâches Ant <installanalytics>
, <updateanalytics>
et <uninstallanalytics>
le plus facilement possible, servez-vous des exemples de fichier de configuration fournis dans le répertoire Analytics/configuration-samples/ de la distribution de MobileFirst Server.
Etape 1
Choisissez l’exemple de fichier de configuration approprié. Les fichiers XML ci-après sont fournis. Ils sont appelés configure-file.xml dans les étapes suivantes.
Tâche | Serveur d’applications |
---|---|
Installer les services et la console MobileFirst Analytics sur le profil Liberty de WebSphere Application Server | configure-liberty-analytics.xml |
Installer les services et la console MobileFirst Analytics sur Apache Tomcat | configure-tomcat-analytics.xml |
Installer les services et la console MobileFirst Analytics sur le profil complet de WebSphere Application Server | configure-was-analytics.xml |
Installer les services et la console MobileFirst Analytics sur WebSphere Application Server Network Deployment, serveur unique | configure-wasnd-server-analytics.xml |
Installer les services et la console MobileFirst Analytics sur WebSphere Application Server Network Deployment, cellule | configure-wasnd-cell-analytics.xml |
Installer les services et la console MobileFirst Analytics sur WebSphere Application Server Network Deployment, noeud | configure-wasnd-node.xml |
Installer les services et la console MobileFirst Analytics sur WebSphere Application Server Network Deployment, cluster | configure-wasnd-cluster-analytics.xml |
Remarque sur les fichiers de configuration pour WebSphere Application Server Network Deployment :
Les fichiers de configuration pour wasnd contiennent une portée qui peut avoir pour valeur cluster, node, server ou cell. Par exemple, pour
configure-wasnd-cluster-analytics.xml, la portée est le cluster. Ces types de portée définissent la cible de déploiement de la façon suivante :
- cluster : permet de déployer un cluster.
- server : permet de déployer un serveur unique géré par le gestionnaire de déploiement.
- node : permet de déployer tous les serveurs en cours d’exécution sur un noeud, qui n’appartiennent pas à un cluster.
- cell : permet de déployer tous les serveurs sur une cellule.
Etape 2
Changez les droits d’accès à l’exemple de fichier pour qu’ils soient aussi restrictifs que possible. L’étape 3 requiert l’indication de mots de passe. Si vous devez empêcher d’autres utilisateurs sur le même ordinateur de prendre connaissance de ces mots de passe, vous devez retirer les droits d’accès en lecture au fichier pour ces autres utilisateurs. Vous pouvez utiliser une commande, comme dans les exemples suivants :
Sous UNIX : chmod 600 configure-file.xml
Sous Windows : cacls configure-file.xml /P Administrators:F %USERDOMAIN%\%USERNAME%:F
Etape 3
De la même façon, si votre serveur d’applications est un profil Liberty de WebSphere Application Server, ou Apache Tomcat, et qu’il est destiné à être démarré uniquement depuis votre compte utilisateur, vous devez également retirer les droits d’accès en lecture pour les autres utilisateurs dans les fichiers suivants :
- Pour le profil Liberty de WebSphere Application Server :
wlp/usr/servers/<server>/server.xml
- Pour Apache Tomcat :
conf/server.xml
Etape 4
Remplacez les valeurs de marque de réservation pour les propriétés au début du fichier.
Remarque :
Les caractères spéciaux suivants doivent être associés à
des caractères d’échappement lorsqu’ils sont utilisés dans les valeurs des scripts XML Ant :
- Le symbole du dollar (
$
) doit être écrit sous la forme $$, sauf si vous voulez référencer explicitement une variable Ant via la syntaxe${variable}
, comme décrit dans la section Properties du manuel Apache Ant. - Le caractère de la perluète (
&
) doit être écrit sous la forme&
, sauf si vous voulez référencer explicitement une entité XML. - Les guillemets (
"
) doivent être écrits sous la forme"
, sauf lorsqu’ils figurent au sein d’une chaîne placée entre apostrophes.
Etape 5
Exécutez la commande ant -f configure-file.xml install
Cette commande installe vos services MobileFirst Analytics et composants MobileFirst Analytics Console dans le serveur d’applications.
Pour installer les services MobileFirst Analytics et composants MobileFirst Analytics Console mis à jour, par exemple, si vous appliquez un groupe de correctifs MobileFirst Server, exécutez la commande suivante : ant -f configure-file.xml minimal-update
.
Pour inverser l’étape d’installation, exécutez la commande ant -f configure-file.xml uninstall
Cette commande désinstalle les services MobileFirst Analytics et les composants MobileFirst Analytics Console.
▲Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.