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.
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 -1 Anglais (Etats-Unis) -2 Français -3 Allemand -4 Italien -5 Japonais -6 Coréen -7 Portugais (Brésil) -8 Chinois simplifié -9 Espagnol -10 Chinois 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