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)
  • 不能含有大寫英文字母
  • 同一字元不得連續出現 4 次

十六進位號碼含有下列的數字與字母: 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 網站管理者所用的 ID。 對新 WebSphere Commerce 實例來說, 此 ID 為一開始唯一可用來登入 WebSphere Commerce 工具的 ID。
SiteAdminPwd
(必要)WebSphere Commerce 網站管理者的密碼。
ServerShutdown
此參數指出在 createInstance.sh 指令完成後,是否要關閉 WebSphere Commerce 配置管理程式。

如果您未指定此參數,則會將 ServerShutdown 參數設為 yes

ConnectTime
此參數用以指定必須在多少分鐘內建立和配置管理程式伺服器間的連線。

如果您未指定此參數,則會將 ConnectTime 參數設為兩分鐘。

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)
  • 同一字元不得連續出現 4 次
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 參數設為兩分鐘。

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 實例。

異常狀況