
iAdmin 指令
這個指令支援在 IBM® i 平台上操作 Liberty 設定檔伺服器。 這個指令檔是在 wlp/lib/native/os400/bin 目錄中。 指令檔是一個名稱為 iAdmin 的 Script。
語法
指令語法如下:
iAdmin task [options]
其中 task 值可以是下列選項之一:
- POSTINSTALL
- PREUNINSTALL
- GRANTAUTH
POSTINSTALL 作業會配置 server start 指令將伺服器當作 QWAS85 子系統中的工作來啟動。
此外,這個作業還會執行下列動作:
- 配置 Liberty 設定檔在 QEJBSVR 使用者設定檔之下執行伺服器。
- 將 wlp/etc/default.env 檔中的 WLP_DEFAULT_JAVA_HOME 設為支援的最低 Java™ 層次之 32 位元版本的位置,以配置預設的 JDK 位置。
- 在 IBM i 原生產品登錄中,新增產品項目。
- 建立 IBM i 原生程式庫和物件,例如,QWAS85 子系統和 QEJBSVR 使用者設定檔。
只在解壓縮保存檔來安裝 Liberty 設定檔之後,或利用工作管理程式來安裝 Liberty 設定檔資源之時,才呼叫 iAdmin POSTINSTALL 指令。
GRANTAUTH 作業會授與 QEJBSVR 使用者設定檔,伺服器角色的必要檔案許可權以及所有權。 POSTINSTALL 會正確設定 QEJBSVR 使用者設定檔的檔案所有權和各種權限。 不過,如果您手動建立檔案,或修改 Liberty 設定檔伺服器所用檔案的權限,您可以呼叫 iAdmin GRANTAUTH 指令來確保 QEJBSVR 有正確的權限。
PREUNINSTALL 作業會移除 POSTINSTALL 作業所建立的原生程式庫和物件。 請在從系統中移除 Liberty 設定檔應用程式提供環境之前呼叫 iAdmin PREUNINSTALL 指令,不過,只有在執行 JAR 檔來安裝 Liberty 設定檔的情況下,才需要這麼做。
註:
- 您必須具備 *ALLOBJ 和 *SECADM 特殊權限,才能使用 POSTINSTALL 和 PREUNINSTALL 指令。
- 您必須具備 *ALLOBJ 特殊許可權,擁有或具備指定目錄子樹狀結構中之所有物件的 *OBJMGT 權限,才能使用 GRANTAUTH 指令。
- 在執行 POSTINSTALL 作業之後,您也必須具備 *ALLOBJ 和 *SECADM 特殊權限,才能啟動和停止 Liberty 設定檔伺服器。
選項
iAdmin 指令的可用選項如下:
- --outputdir wlp_user_dir
- 伺服器產生之檔案的目錄。 這個選項只能是絕對路徑,在 GRANTAUTH 作業中是選用的,所有其他作業都會忽略它。 當沒有指定時,會使用伺服器產生之輸出的預設位置。
- --rolename role_name
- 指派了使用者設定檔的角色。 伺服器角色是目前唯一支援的角色。 GRANTAUTH 作業需要這個選項,所有其他作業都會忽略這個選項。
- --userdir wlp_user_dir
- 包含共用資源和伺服器定義的目錄。 這個選項只能是絕對路徑,在 GRANTAUTH 作業中是選用的,所有其他作業都會忽略它。 當沒有指定時,會使用共用資源和伺服器定義的預設位置。
- --userprofilename user_profile_name
- 要授與權限的使用者設定檔。 QEJBSVR 是伺服器角色目前唯一受支援的使用者設定檔名稱。 GRANTAUTH 作業需要這個選項,所有其他作業都會忽略這個選項。
使用實務
下列範例示範正確的語法。
請在單行中執行下列任何範例中的指令。
- 將 Liberty 設定檔配置成作為 QWAS85 子系統中的一項工作來啟動,且在執行時切換至 QEJBSVR 使用者設定檔。
wlp/lib/native/os400/bin/iAdmin POSTINSTALL
- 針對這個 Liberty 設定檔執行時期環境所配置的共用資源、伺服器定義及輸出位置,將伺服器角色授與 QEJBSVR 使用者設定檔。
wlp/lib/native/os400/bin/iAdmin GRANTAUTH –-rolename server –-userprofilename QEJBSVR
- 移除 POSTINSTALL 作業所建立的原生程式庫和物件。
wlp/lib/native/os400/bin/iAdmin PREUNINSTALL