Transaction server Commandes Run Engine
Utilisez les instructions Run Engine suivantes pour configurer le Transaction server Docker container.
/SETUP/bin/entrypoint.sh. Si vous voulez implémenter une logique personnalisée ou remplacer les configurations existantes, assurez-vous que les commandes peuvent résoudre les paramètres nécessaires au démarrage.| Description | Commande |
|---|---|
| Convertit l'environnement en environnement de création. | run convert-to-auth Convertir l'image en direct ts-app en création d'image. |
| Définissez ou modifiez la clé de commerçant. | run update-encrypted-merchantkey MERCHANTKEY_ENCRYPT
|
 Définissez ou modifiez la clé de chiffrement de clé. |
exécuter update-key-encryption-key KEY_ENCRYPTION_KEY
|
| Le nom d'utilisateur et le mot de passe SPI sont uniquement utilisés pour l'appel d'API de serveur inter-composant. Le spiuser est configuré dans le serveur de magasin, le serveur de recherche et le serveur de personnalisation, et est utilisé dans l'appel d'API depuis ces serveurs vers le serveur de transactions. Les images doivent être configurées avec le mot de passe spiuser, sinon les serveurs de composants ne peuvent pas se connecter au serveur de transactions. Définit la propriété machine virtuelle Java : spi.username, spi.password |
run set-spi-user userName ASCII_encrypted_password
|
| Pour un environnement de développement ou de création, définissez la liaison du nom du serveur de recherche. | run set-search-server search_host search_port
|
| Pour les environnements en direct, définissez la liaison de nom Search server du répéteur de recherche. | run set-search-server search_host search_port search_repeater_host search_repeater_port
|
| Définissez la connexion au serveur Ingest. | run set-ingest-server hostName port
|
| Pour les environnements de création, ajoutez les informations de connexion JAAS, du fournisseur JDBC et de la source de données pour la connexion à la base de données opérationnelle. | run add-datasource jndi dbName dbType dbHost dbPort dbUser dbPass xa sslConnect
|
| Configurez la connexion au Store server. | run set-store-server hostName port
|
| Définissez le nom de l'hôte du Store server dans le fichier de configuration wc-component.xml de base. | sed -i "s/value=\"store\"/value=\"${STORE_HOST}\"/g" /opt/WebSphere/AppServer/profiles/default/installedApps/localhost/ts.ear/xml/config/com.ibm.commerce.foundation/wc-component.xml Remarque : Il ne s'agit pas d'une instruction Run Engine, mais d'une configuration requise pour que la fonction d'aperçu du magasin Management Center fonctionne. Si le nom d'hôte de votre Store server Docker container n'est pas store, vous devez modifier la valeur selon les besoins à l'aide de cette instruction. |
| Définissez la connexion au Store server du magasin basé sur React. | run set-react-store-server hostName port
|
| Configurez la connexion au Customization server. | run set-xc-server hostName port
|
| Configurez la connexion au serveur Web Store server pour les magasins qui ont été migrés à partir de WebSphere Commerce version 7 ou version 8. | run set-store-web-server storeWebHost storeWebPort
|
| Ajoutez une source de données de connexion de base de données pour Informix. | run add-datasource-informix dbtype dbName dbHost dbPort dbUser dbPass xa sslConnect
|
| Mettez à jour les données d'identification de l'utilisateur et du mot de passe de la base de données utilisées pour se connecter à la base de données. | run update-datasource-cred jndi dbUser dbPass
|
| Mettez à jour le nom d'hôte du serveur de base de données, le port, le nom de base de données et les informations d'identification de l'utilisateur et du mot de passe utilisées pour se connecter à la base de données. | run update-datasource-db jndi database dbHost dbPort sslConnect
|
| Ajoutez la chaîne de paramètres JVM aux options JVM existantes (/Server:server1/JavaProcessDef:/JavaVirtualMachine:/) | run add-generic-jvmarg jvmArg
Par exemple, la commande suivante définit -Xgcpolicy:gencon sur un argument JVM générique. |
| Créer une nouvelle Instance de cache d'objets Vous pouvez afficher la liste de caches d'objet dans Ressources/Instances de cache/Instances de cache d'objet de la WebSphere Application Server Administrative Console dans le Transaction server. | run add-objectcache jndiName cacheSize replicationType sizeMB
Remarque : Cette commande ajoute une instance de cache d'objet si celle-ci n'existe pas. |
| Met à jour virtualhosts.xml. | run add-virtual-host VirtualHostName ListOfPorts
|
| Créez un gestionnaire de travail réservé et définissez le nombre maximal d'unités d'exécution à 10. | run add-work-manager-reserved |
| Créez un gestionnaire de travail et définissez le nombre maximal d'unités d'exécution. | run add-work-manager name maxThread
|
| Activez la sécurité d'application. | run enable-security appName
Valeurs de configuration par défaut pour activeUserRegistry, Authtype, AppSecurityEnablement, WIMuserRegistry et mappage de rôles aux utilisateurs. |
| Activer la mise en cache des servlets et des commandes pour le paramètre de conteneur Web. | run enable-servlet-caching Active la mise en cache des servlets Par exemple, run enable-servlet-cachin |
Vérifiez si le server1 est démarré en exécutant l'instruction serverStatus. |
run get-status |
| Configurer la propriété de connexion de source de données de la base de données. | run set-connection-pool jndi connectionTimeout maxConnections minConnections reapTime unusedTimeout agedTimeout purgePolicy
|
| Définissez le niveau de trace d'une application WebSphere Application Server en cours d'exécution, qui prend effet immédiatement. Ce niveau de trace est réinitialisé au niveau de trace par défaut au redémarrage. |
run set-dynamic-trace-specification spec
Remarque :
|
| Définissez le niveau de trace par défaut pour les applications WebSphere Application Server. Cette opération prend effet après le prochain redémarrage de l'application et est conservée lors d'un redémarrage ultérieur. | run set-trace-specification spec
Remarque :
|
Réinitialisez le niveau de traçage à sa valeur par défaut (*=information). |
run reset-dynamic-trace-specification Réinitialisez n'importe quel niveau de trace sur une application HCL Commerce en cours d'exécution qui a été définie à l'aide de la |
| Générer trace.log et le journal ffdc dans ce répertoire. | run set-trace-log-directory directory
|
Définissez les valeurs initialHeapSize et maximumHeapSize. |
run set-heap-size initHeapSize maxHeapSize
|
| Créer une liaison d'espace de nom de chaîne. | run set-jndi-entry jndi value
|
| Définir le niveau de conformité des spécifications JPA. | run set-jpa-spec-level level
|
| Met à jour une propriété serveur existante ou ajoute une propriété serveur. | run set-server-property propertyName propertyValue
Par exemple, run set-server-property threshold 1800 |
| Définir le protocole SSL pour le paramètre SSL. | run set-ssl-protocol sslProtocol
|
| Définit l'alias du certificat à utiliser pour le serveur. | run set-ssl-server-alias alias
|
| Modifiez les propriétés de source de données de WebSphere Application Server (taille du cache d'instruction) pour une source de données spécifique. | run set-statement-cache jndi cacheSize
|
| Définissez la clé de session chiffrée. L'entrée JNDI |
run set-session-key sessionKey
|
| Définissez une propriété JVM personnalisée. | run set-system-property name value
Par exemple, run set-system-property SKIP_IDENTIFIER_CHECK true Définit une propriété JVM personnalisée |
| Définissez les nouvelles propriétés du pool d'unités d'exécution de l'application. | run set-thread-pool threadName minSize maxSize inactivityTimeout isGrowable
Par exemple, run set-thread-pool webContainer 60 60 3000 false |
| Définissez une propriété de conteneur Web. Ajouter des propriétés personnalisées pour les paramètres de conteneur Web (par exemple, |
run set-webcontainer-property name value
Par exemple, run set-webcontainer-property httpOnlyCookies WC_GENERIC_ACTIVITYDATA,WC_AUTHENTICATION_* |
| Modifiez le mot de passe de l'utilisateur administrateur de WebSphere Application Server. | run update-admin-password adminUser adminPassword
|
| Mettre à jour tous les magasins de clés qui utilisent le nouveau mot de passe fourni. | run update-keystore-passwords currentPassword newPassword
Par exemple, run update-keystore-passwords aaa bbb |
| Créez une chaîne de transport sur le nom de serveur et le nom de nœud spécifiés. | run add-transport-chain chainName endPointName host port
|
| Mettez à jour la valeur de sondage d'unité d'exécution du canal entrant TCP pour le point de terminaison spécifié. | run update-tcpinboundchannel-threadpool endPointName threadPoolName
|
| Mettre à jour la taille des instances de cache d'objets. La taille peut être limitée en nombre de lignes ou en mégaoctets (Mo). | run update-objectcache-size jndi size sizeMB
Par exemple :
|
| Démarrez ou arrêtez l'application Dynamic Cache Monitor lors du déploiement. |
|
| Activez ou désactivez le démarrage automatique de l'application Dynamic Cache Monitor si le conteneur est redémarré. |
run enable-cache-monitor-auto-start value
|
La commande set-cache-provider inclut deux fonctions :
|
Par exemple :
|
 Fichier de configuration de cache cachespec.xml de fusion. |
run merge-cachespec-xml source_file target_file
|
 Définissez la valeur AllowedDomain sous Webmodules dans wc-server.xml. |
run add-allowed-domain domainName moduleName
|
Définissez la valeur AllowedHost sous Webmodules dans wc-server.xml. |
run add-allowed-host hostName moduleName
|
| Ajoutez ou mettez à jour les attributs de source de données personnalisés |
run update-datasource-attribute -j JDBCProvider -d Datasource -n AttrName -t AttrType -v AttrValue
Par exemple, pour mettre à jour le niveau d'isolement de la source de données vers la stabilité du curseur : webSphereDefaultIsolationLevel sera ajouté s'il n'existe pas déjà et est défini sur 2 (Stabilité du curseur). Si l'attribut est préexistant, il sera défini sur la nouvelle valeur de 2. |
 Ajoutez un attribut d'entier personnalisé à une source de données DB2 existante. |
set-dataSource-integer-attribute jndi attributeName attributeValue
|
| Mettez à jour les paramètres d'un gestionnaire de travail si le gestionnaire de travail existe. | run update-work-manager-thread name minThreads maxThreads threadPriority
|
| Déployez un EAR sur WebSphere Application Server. | run install-ear transaction-server-ear-name
|
| Installez l'application OIDC dans le délai d'exécution du serveur d'applications. | run install-oidc ear-name
|
| Modifiez la propriété JVM (EncryptionKeysInSystemProperty, CurrentEncryptedMerchantKey, CurrentEncryptedSessionKey). | run set-encryption-keys merchantKey sessionKey
|
| Définissez ou modifiez la clé de session dans wc-server.xml. |
run set-session-key sessionKey
|
| Activez ou désactivez le paramètre de connexion unique (SSO) keepAliveSession dans wc-server.xml. Ce paramètre vous permet de maintenir une session active au-delà du HCL Commercedélai d'attente de session standard. |
run set-sso-keep-alive-session value
Pour plus d'informations, voir Activation de la connexion unique. |
| Modifiez la propriété JVM (wc.remote.kafka, wc.remote.kafka.topicPrefix, wc.remote.zookeeper, wc.store.remote.kafka, wc.store.remote.kafka.topicPrefix) |
Remarque : Les serveurs Zookeeper sont utilisés pour la rétrocompatibilité du script. Ce paramètre doit donc être ignoré.
|
|
Modifiez la propriété JVM (wc.remote.kafka, wc.remote.kafka.topicPrefix, wc.remote.zookeeper, wc.store.remote.kafka, wc.store.remote.kafka.topicPrefix) |
 Remarque : Les serveurs Zookeeper sont utilisés pour la rétrocompatibilité du script. Ce paramètre doit donc être ignoré. |
| Modifiez les informations du pool de connexions MQ. | run change-mqadapter-max-connection connectionNumber
|
| Créer une fabrique de connexions JMS. | run create-jms-connection-factory mqServerHost mqServerPort queueManager connectionNumber
Par exemple, run create-jms-connection-factory test.hcl.com 1414 FVT 15 Le serveur IBM MQ est test.cn.ibm.com, le port est 1414, le gestionnaire de files d'attente est FVT. |
| Créer des files d'attente JMS. | create-jms-queues queueManager
Par exemple, run create-jms-queues FVT |
| Activez les sessions d'activité d'application. | run enable-activity-session timeout
|
| Mettez à jour les informations de source de données dans le fichier wc-server.xml. | run update-wcserver-db dbType dbHost dbPort dbname dbauser dbapassword dbuser dbpassword nodeName
|
Définissez schedulerID. |
run add-generic-jvmarg -Dcom.ibm.commerce.scheduler.SchedulerHostName=${schedulerID} Fonctionne avec |
Définissez schedulerCloneID. |
run add-generic-jvmarg -Dcom.ibm.commerce.scheduler.SchedulerCloneId=${schedulerCloneID} Fonctionne avec |
 Définissez les propriétés du pool de connexions de l'adaptateur de ressources. |
run set-resource-adaptor-connection-pool-props uriName connectionTimeout maxConnections minConnections reapTime unusedTimeout agedTimeout purgePolicy Où :
|
| Pour l'intégration de WebSphere eXtreme Scale, créez un domaine extreme scale. Conseil : Pour en savoir plus sur cette intégration, voir Intégration de HCL Commerce version 9 avec WebSphere eXtreme Scale.
|
run create-XS-Domain hostname port
|
| Pour l'intégration de WebSphere eXtreme Scale, connectez l'instance de cache de base au fournisseur de cache WebSphere eXtreme. Conseil : Pour en savoir plus sur cette intégration, voir Intégration de HCL Commerce version 9 avec WebSphere eXtreme Scale.
|
run connect-basecache-wxs size gridName mapName
|
| Pour l'intégration de WebSphere eXtreme Scale, connectez l'instance de cache d'objet au fournisseur de cache WebSphere eXtreme. Conseil : Pour en savoir plus sur cette intégration, voir Intégration de HCL Commerce version 9 avec WebSphere eXtreme Scale.
|
exécuter connect-objectcache-wxs jndi size gridName mapName
|
| Mettez à jour le serveur de source de données. |
update-wc-server-datasource dbType dbHost dbPort dbname dbauser dbapassword dbuser dbpassword où
|
run set-cache-provider cacheProvider jndiName