createInstance.sh 命令(仅限 OS/400)

此命令在 OS/400 上创建 WebSphere Commerce 或 WebSphere Commerce Payments 实例。此命令位于以下路径中:

WC_installdir/bin

与 WebSphere Commerce 或 WebSphere Commerce Payments 实例关联的文件位于运行 createInstance.sh 命令的节点上的以下路径中:

WC_userdir/instances/instance_name

命令先决条件

在运行此命令之前,WebSphere Commerce 配置管理器服务器必须正在运行。

要启动 WebSphere Commerce 配置管理器,请发出 config_server.sh 命令

命令结构

此命令必须从 Q-Shell 会话中发出。

命令结构的图表:此命令用 Websphere Commerce Server 的全限定名称和配置路径(后面跟有命令名称 createInstance.sh 和 ? 字符)启动。请用“名称值”对形式的参数列表结束此命令。请用 & 字符分隔每个名称值对。有关参数及其值的详细描述,请参阅标题为“参数值”的列表。

参数值

InstanceName
这是您希望称呼 WebSphere Commerce 实例的名称。如果您不指定此参数,则实例名称设置为 demo。

每个 WebSphere Commerce 实例都必须具有唯一名称。

实例名称包含的字符不得超过 9 个。
InstancePwd
(必需)这是与此实例关联的“用户概要文件”的密码。
MerchantKey
(必需)这是配置管理器用作加密密钥的 16 位十六进制数。商家密钥必须符合以下条件:
  • 必须包含至少一个数字字符(0 - 9)
  • 必须包含至少一个字母字符(a - f)
  • 不能包含任何大写字母字符
  • 一个字符不能连续出现四次

十六进制数包含以下数字和字母:0123456789abcdef

InstanceHostname
这是与 WebSphere Commerce 实例关联的全限定 TCP/IP 名称。

如果您不指定此参数,则 WebSphere Commerce 实例将与运行 createInstance.sh 命令的节点的全限定 TCP/IP 名称关联。

WASInstance
这是 WebSphere Commerce 实例将部署到的 WebSphere Application Server 实例的名称。

如果您不指定此参数,则 WebSphere Commerce 实例将部署到名为 default 的缺省 WebSphere Application Server 实例。

DefaultLang
这是代表正在创建的 WebSphere Commerce 实例的缺省语言的数字。然而,选择不同于 WebSphere Commerce 安装期间使用的语言作为缺省语言将会导致用对选定语言无效的数据填充该实例。有关用不同于 WebSphere Commerce 安装语言的缺省语言创建 WebSphere Commerce 实例的指导,请参阅《WebSphere Commerce 安装指南》。

如果您不指定此参数,则缺省语言将设置为 -1(美国英语)。

下表列出此参数的有效值:

DefaulLang 值  语言
-1英语(美国)
-2法语
-3德语
-4意大利语
-5日语
-6韩国语
-7葡萄牙语(巴西)
-8简体中文
-9西班牙语
-10繁体中文
SiteAdminID
(必需)这是用于 WebSphere Commerce 站点管理员的标识。此标识一开始是唯一可用于登录到新 WebSphere Commerce 实例的 WebSphere Commerce 工具的标识。
SiteAdminPwd
(必需)这是 WebSphere Commerce 站点管理员的密码。
ServerShutdown
此参数指定在完成 createInstance.sh 命令之后是否关闭 WebSphere Commerce 配置管理器服务器。

如果您不指定此参数,则 ServerShutdown 参数将设置为 yes

ConnectTime
此参数指定必须进行与配置管理器服务器的连接的分钟数。

如果您不指定此参数,则 ConnectTime 参数设置成 2 分钟。

ServerPort
此参数指定 createInstance.sh 命令和 WebSphere Commerce 配置管理器通信的端口号。

如果您不指定此参数,则端口号将设置为 1099

logFile
这是此命令生成的日志文件的位置。

如果您不指定此参数,则日志文件写到以下路径:

WC_userdir/instances

用于创建 WebSphere Commerce Payments 实例的参数值

Payments
(必需)此参数指定您正在创建 WebSphere Commerce Payments 实例。
InstanceName
这是您希望称呼 WebSphere Commerce Payments 实例的名称。如果您不指定此参数,则实例名称设置为 wpm。

每个 WebSphere Commerce Payments 实例都必须具有唯一名称。

实例名称包含的字符不得超过 9 个。

PInstancePwd
(必需)此参数指定 WebSphere Commerce Payments 实例的密码。这是 WebSphere Commerce Payments 在解密任何存储在数据库中的敏感数据时使用的密码。

WebSphere Commerce Payments 实例密码必需符合以下条件:

  • 必须包含至少一个数字字符(0 - 9)
  • 必需包含至少一个字母字符(a - z,A - Z)
  • 一个字符不能连续出现四次
InstanceHostname
这是将创建 WebSphere Commerce Payments 实例的节点的全限定 TCP/IP 名称。

如果您不指定此参数,则 WebSphere Commerce Payments 实例将在运行 createInstance.sh 命令的节点上创建。

WASInstance
这是 WebSphere Commerce Payments 实例将部署到的 WebSphere Application Server 实例的名称。

如果您不指定此参数,则 WebSphere Commerce Payments 实例将部署到名为 default 的缺省 WebSphere Application Server 实例。

EnableSSL
如果此参数设置为 yes,则必须指定以下参数
SysStorePwd
这是 DCM 系统证书商店密码。
CertAuthPwd
这是 CA 密码。
ServerShutdown
此参数指定在完成 createInstance.sh 命令之后是否关闭 WebSphere Commerce 配置管理器服务器。

如果您不指定此参数,则 ServerShutdown 参数将设置为 yes

ConnectTime
此参数指定必须进行与配置管理器服务器的连接的分钟数。

如果您不指定此参数,则 ConnectTime 参数设置成 2 分钟。

ServerPort
此参数指定 createInstance.sh 命令和 WebSphere Commerce 配置管理器通信的端口号。

如果您不指定此参数,则端口号将设置为 1099

logFile
这是此命令生成的日志文件的位置。

如果您不指定此参数,则日志文件写到以下路径:

WC_userdir/instances

示例 1

以下示例创建名为 demo 的 WebSphere Commerce 实例:

./createInstance.sh -MerchantKey 1234feedbeef1234

示例 2

以下示例创建名为 wpm 的 WebSphere Commerce Payments 实例:

./createInstance.sh -Payments -PInstancePwd p4ym3nt5

行为

此命令创建 WebSphere Commerce 或 WebSphere Commerce Payments 实例。

异常情况