Préparation des paramètres d'entrée via des variables d'environnement système

Si vous exécutez Domino sur Docker, vous définissez les variables d'environnement système que Docker doit exporter dans un fichier texte spécifié par le paramètre --env-file. Si vous exécutez Domino sous Windows ou UNIX, après avoir installé Domino, utilisez un fichier de traitement par lots ou un script shell, ou exécutez des commandes individuelles pour exporter les variables d'environnement système nécessaires à la configuration de votre serveur. La syntaxe de la commande d'exportation varie, mais un exemple d'utilisation du shell bash sur Linux est :

export SERVERSETUP_SERVER_TYPE=additional

Les noms des variables d'environnement système sont similaires aux noms de paramètres spécifiés dans un fichier JSON, à l'exception des cas suivants :

• Sur les plateformes dont les noms sont sensibles à la casse, par exemple, UNIX, vous devez spécifier les noms des variables d'environnement système en majuscules.
• Alors que l'entrée JSON est de nature hiérarchique, les variables d'environnement se trouve dans un espace de nom "plat" ou global. Par conséquent, vous formez les noms en insérant un trait de soulignement entre les noms pour indiquer une hiérarchie. Par exemple, un fichier d'entrée JSON peut fournir les données suivantes :

  "serverSetup": {
  		"server": {
  			"type": "additional",
  			"name": "mailserver1",
  			"domainName": "Renovations",
  			"title": "Renovations Mail Server"
  		},
  
  

  Les variables d'environnement système correspondantes définies dans un --env-file spécifié pour Docker seraient les suivantes :

  Remarque : Lorsque vous utilisez --env-file, ne placez pas les valeurs entre guillemets.

  SERVERSETUP_SERVER_TYPE=additional
  SERVERSETUP_SERVER_NAME=mailserver1
  SERVERSETUP_SERVER_DOMAINNAME=Renovations
  SERVERSETUP_SERVER_TITLE=Renovations Mail Server

  Les variables d'environnement système correspondantes définies dans un script de shell bash UNIX seraient les suivantes. Vous invoquez le script de shell dans le même shell que celui qui appelle la configuration de Domino en une seule touche. Dans ce cas, seules les valeurs contenant des espaces requièrent des guillemets ; l'utilisation de guillemets pour d'autres valeurs est facultative. Les guillemets sont retirés des valeurs lorsque le script s'exécute.

  export SERVERSETUP_SERVER_TYPE=additional
  export SERVERSETUP_SERVER_NAME=mailserver1
  export SERVERSETUP_SERVER_DOMAINNAME=Renovations
  export SERVERSETUP_SERVER_TITLE="Renovations Mail Server"

Les tableaux suivants décrivent les variables d'environnement système prise en charge pour la configuration du serveur, du coffre d'ID et des préférences de configuration en une seule touche.

• Un X dans la colonne Premier serveur ou Serveur supplémentaire indique qu'un paramètre se rapporte à ce type de configuration de serveur.
• Un astérisque (*) en face d'un X indique un paramètre obligatoire.
• Les types de valeur sont des chaînes, sauf spécification contraire.
• Notez les règles suivantes relatives à l'insertion de guillemets autour des valeurs de chaîne :
  • Lorsque vous spécifiez dans un fichier via l'argument --env-file Docker, les guillemets ne sont pas autorisés.
  • Lors de la spécification via un fichier de traitement par lots Windows, les guillemets ne sont pas requis.
  • Lorsque vous spécifiez via un script de shell bash UNIX, des guillemets sont requis autour des chaînes contenant des espaces. Sinon, les guillemets ne sont pas requis. Par exemple, spécifiez export SERVERSETUP_SERVER_TITLE="ACME Application Server" et non export SERVERSETUP_SERVER_TITLE=ACME Application Server.
• Les valeurs booléennes sont indiquées par true ou false sans guillemets.
• Les valeurs numériques sont spécifiées sans guillemets, sauf lorsqu'elles fonctionnent comme des chaînes, telles que les valeurs notes.ini.
• Pour appliquer une valeur par défaut, spécifiez null sans guillemets ou omettez le paramètre.