Instruction createInstance.sh (OS/400 uniquement)

Cette instruction permet de créer une instance WebSphere Commerce ou WebSphere Commerce Payments sur l'OS/400. Le chemin de cette instruction est le suivant :

WC_installdir/bin

Les fichiers associés à l'instance WebSphere Commerce ou WebSphere Commerce Payments sont placés dans le chemin suivant, sur le noeud sur lequel vous exécutez l'instruction createInstance.sh :

WC_userdir/instances/instance_name

Conditions préalables à l'exécution de l'instruction

Pour que vous puissiez lancer cette instruction, le serveur du Gestionnaire de configuration WebSphere Commerce Configuration doit être actif.

Pour démarrer le Gestionnaire de configuration WebSphere Commerce, exécutez l'instruction config_server.sh.

Structure de l'instruction

Cette instruction doit être exécutée à partir d'une session Q-Shell.

Diagramme représentant la syntaxe de l'instruction : L'instruction commence par le nom qualifié complet de votre serveur WebSphere Commerce Server et par le chemin de configuration, puis sont indiqués le nom de l'instruction, createInstance.sh, et le caractère ?. L'instruction doit se terminer par une liste de paramètres indiqués sous la forme de combinaisons nom-valeur. Ces combinaisons doivent être séparées les unes des autres par le caractère &. Pour en savoir plus sur les paramètres et leurs valeurs, reportez-vous à la section Valeurs des paramètres.

Valeurs des paramètres

InstanceName
Nom que vous souhaitez attribuer à l'instance WebSphere Commerce. Si vous ne spécifiez pas ce paramètre, le nom de l'instance est demo.

Chaque nom d'instance WebSphere Commerce doit être unique.

Le nom d'instance doit contenir au moins 9 caractères.
InstancePwd
(Obligatoire) Mot de passe pour le profil utilisateur associé à cette instance.
MerchantKey
(Obligatoire) Nombre hexadécimal à 16 chiffres que le Gestionnaire de configuration utilise comme clé de chiffrement. La clé de commerçant doit respecter les conventions suivantes :
  • Elle doit contenir au moins un caractère numérique (0 - 9)
  • Elle doit contenir au moins un caractère alphabétique (a - f)
  • Elle ne doit pas contenir de caractère alphabétique en majuscule
  • Elle ne doit pas contenir quatre occurrences consécutives d'un même caractère

Un nombre hexadécimal contient les chiffres et les lettres suivants : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e et f.

InstanceHostname
Nom TCP/IP qualifié complet associé à l'instance WebSphere Commerce.

Si vous ne spécifiez pas ce paramètre, l'instance WebSphere Commerce est associée au nom TCP/IP qualifié complet du noeud sur lequel l'instruction createInstance.sh est exécutée.

WASInstance
Nom de l'instance WebSphere Application Server dans laquelle l'instance WebSphere Commerce sera déployée.

Si vous ne spécifiez pas ce paramètre, l'instance WebSphere Commerce sera déployée dans l'instance WebSphere Application Server par défaut, appelée par défaut.

DefaultLang
Nombre représentant la langue par défaut de l'instance WebSphere Commerce en cours de création. Toutefois, si vous sélectionnez une langue par défaut différente de celle qui a été utilisée lors de l'installation de WebSphere Commerce, il se peut que l'instance soit alimentée avec des données qui ne sont pas admises pour la langue que vous avez choisie. Pour connaître les instructions permettant de créer une instance WebSphere Commerce avec une langue différente de celle utilisée lors de l'installation de WebSphere Commerce, reportez-vous au manuel WebSphere Commerce Installation Guide.

Si vous ne spécifiez pas ce paramètre, la langue par défaut est -1 (Anglais - Etats-Unis).

Les valeurs admises pour ce paramètre sont répertoriées dans le tableau ci-après.

Valeur DefaulLang  Langue
-1Anglais (Etats-Unis)
-2Français
-3Allemand
-4Italien
-5Japonais
-6Coréen
-7Portugais (Brésil)
-8Chinois simplifié
-9Espagnol
-10Chinois traditionnel
SiteAdminID
(Obligatoire) ID utilisé pour l'administrateur de site de WebSphere Commerce. Au départ, cet ID est le seul qui soit disponible pour vous permettre de vous connecter aux outils de WebSphere Commerce pour la nouvelle instance WebSphere Commerce.
SiteAdminPwd
(Obligatoire) Mot de passe utilisé pour l'administrateur de site de WebSphere Commerce.
ServerShutdown
Ce paramètre vous permet d'indiquer si le serveur du Gestionnaire de configuration WebSphere Commerce doit être arrêté une fois l'instruction createInstance.sh exécutée.

Si vous ne spécifiez pas ce paramètre, le paramètre ServerShutdown a pour valeur oui.

ConnectTime
Ce paramètre indique le nombre de minutes au cours desquelles la connexion au serveur du Gestionnaire de configuration doit être établie.

Si vous ne spécifiez pas le paramètre ConnectTime, il prend la valeur deux.

ServerPort
Ce paramètre indique le numéro de port sur lequel l'instruction createInstance.sh et le serveur du Gestionnaire de configuration WebSphere Commerce communiqueront.

Si vous ne spécifiez pas ce paramètre, le numéro de port prend la valeur 1099.

logFile
Emplacement du fichier journal généré par cette instruction.

Si vous ne spécifiez pas ce paramètre, le fichier journal est écrit dans le chemin suivant :

WC_userdir/instances

Valeurs de paramètre pour la création d'une instance WebSphere Commerce Payments

Payments
(Obligatoire) Ce paramètre indique que vous créez une instance WebSphere Commerce Payments.
InstanceName
Nom que vous souhaitez attribuer à l'instance WebSphere Commerce Payments. Si vous ne spécifiez pas ce paramètre, le nom d'instance prend la valeur wpm.

Chaque nom d'instance WebSphere Commerce Payments doit être unique.

Le nom d'instance doit contenir au moins 9 caractères.

PInstancePwd
(Obligatoire) Ce paramètre indique le mot de passe de l'instance WebSphere Commerce Payments. Il s'agit du mot de passe utilisé par WebSphere Commerce Payments pour déchiffrer les données vitales stockées dans la base de données.

Le mot de passe de l'instance WebSphere Commerce Payments doit respecter les conventions suivantes :

  • Contenir au moins un caractère numérique (0 - 9)
  • Contenir au moins un caractère alphabétique (a - z, A - Z)
  • Ne doit pas contenir quatre occurrences consécutives d'un même caractère
InstanceHostname
Nom TCP/IP qualifié complet du noeud sur lequel l'instance WebSphere Commerce Payments sera créée.

Si vous ne spécifiez pas ce paramètre, l'instance WebSphere Commerce Payments sera créée sur le noeud sur lequel l'instruction createInstance.sh est exécutée.

WASInstance
Nom de l'instance WebSphere Application Server dans laquelle l'instance WebSphere Commerce Payments sera déployée.

Si vous ne spécifiez pas ce paramètre, l'instance WebSphere Commerce Payments sera déployée dans l'instance WebSphere Application Server par défaut, appelée par défaut.

EnableSSL
Si ce paramètre a pour valeur oui, vous devez définir les paramètres suivants :
SysStorePwd
Mot de passe de magasin de certificats système DCM.
CertAuthPwd
Mot de passe CA.
ServerShutdown
Ce paramètre vous permet d'indiquer si le serveur du Gestionnaire de configuration WebSphere Commerce doit être arrêté une fois l'instruction createInstance.sh exécutée.

Si vous ne spécifiez pas ce paramètre, le paramètre ServerShutdown a pour valeur oui.

ConnectTime
Ce paramètre indique le nombre de minutes au cours desquelles la connexion au serveur du Gestionnaire de configuration doit être établie.

Si vous ne spécifiez pas le paramètre ConnectTime, il prend la valeur deux.

ServerPort
Ce paramètre indique le numéro de port sur lequel l'instruction createInstance.sh et le serveur du Gestionnaire de configuration WebSphere Commerce communiqueront.

Si vous ne spécifiez pas ce paramètre, le numéro de port prend la valeur 1099.

logFile
Emplacement du fichier journal généré par cette instruction.

Si vous ne spécifiez pas ce paramètre, le fichier journal est écrit dans le chemin suivant :

WC_userdir/instances

Exemple 1

L'exemple ci-après permet de créer une instance WebSphere Commerce appelée demo.

./createInstance.sh -MerchantKey 1234feedbeef1234

Exemple 2

L'exemple ci-après permet de créer une instance WebSphere Commerce Payments appelée wpm.

./createInstance.sh -Payments -PInstancePwd p4ym3nt5

Comportement

Cette instruction permet de créer une instance WebSphere Commerce ou WebSphere Commerce Payments.

Conditions d'exception

Aucune