為 installUtility 指令配置儲存庫和 Proxy 設定

repositories.properties 檔中,您可以配置 installUtility 指令要如何存取本端目錄型儲存庫、「Liberty 資產儲存庫服務」實例,以及 Liberty Repository

關於這項作業

installUtility 指令可存取下列儲存庫:
  • Liberty Repository,這是一個可透過網際網路存取且由 IBM® 管理的公用儲存庫。如需相關資訊,請參閱Liberty Repository
  • Liberty 資產儲存庫服務,這是一個開放程式碼服務,可用來建立內部部署的儲存庫,以便在企業防火牆保護下從遠端存取它。 如需相關資訊,請參閱 GitHub 上的 WASdev/tool.lars 儲存庫
  • 本端目錄型儲存庫,若要建立它,請使用 installUtility download 動作或是下載 wlp-featureRepo-<version>.zip 檔,其中含有所有適用的特性和附加程式。如需相關資訊,請參閱使用 installUtility 指令來下載資產

installUtility 指令和 featureManager 指令使用相同的配置內容檔 repositories.properties。Proxy 設定是共用的,但是儲存庫設定僅供 installUtility 指令使用。如果要管理資產並完成儲存庫型的安裝、尋找或解除安裝作業,請使用 installUtility 指令而不是 featureManager 指令。

提示: 您可以在 --from 選項上指定儲存庫,以從單一本端目錄型儲存庫下載或安裝資產。 不需要 repositories.properties 檔中的任何其他配置。 如需相關資訊,請參閱installUtility 指令
如果要以受限的網際網路存取權來存取 IBM WebSphere® Liberty Repository,或透過防火牆來存取,請確定您具備下列主機和埠的存取權:
  • 埠 443 上的 public.dhe.ibm.com
  • 埠 443 上的 asset-websphere.ibm.com
註: installUtility 指令只支援使用 HTTP/HTTPS 通訊協定的 Proxy 伺服器。

程序

  1. 選擇性的: 當您先配置儲存庫或 Proxy 設定時,您可以執行 installUtility viewSettings 指令,以便輸出 repositories.properties 檔的配置範本。

    將範本複製到位於 ${wlp.install.dir}/etc/repositories.properties 的新內容檔。內容檔必須是適用於所有平台的 ASCII 格式。

  2. ${wlp.install.dir}/etc/repositories.properties 檔中定義設定。

    如果您已複製 installUtility viewSettings 指令產生的範本,請修改範本,作法是變更範例儲存庫和 Proxy 設定,以參照您的環境。不會處理開頭是 # 記號的字行。

    • 如果要停用對 Liberty Repository 的存取權,請將 useDefaultRepository 內容設為 false。依預設會啟用 Liberty Repository,且這是您安裝或下載資產時所存取的最後一個儲存庫。
      useDefaultRepository=false
    • 如果要定義儲存庫,請以 repoName.url=urlrepoName.url=file_path 形式來新增內容。每一個儲存庫名稱都必須是唯一的。

      所定義的儲存庫會依其在 repositories.properties 檔中指定順序來存取。

      適用於 Windows 平台
      dev-rep.url=http://dev.repo.ibm.com:9080/ma/v1local-rep2.url=file:///c:/IBM/localrepo2
      local-rep3.url=C:\IBM\localrepo3
      local-rep4.url=C:\IBM\localrepo4.zip
      適用於 HP UNIX 平台適用於 Solaris 平台適用於 LINUX 平台適用於 UNIX 平台
      dev-rep.url=http://dev.repo.ibm.com:9080/ma/v1local-rep2.url=file:///usr/IBM/localrepo2
      local-rep3.url=/usr/IBM/localrepo3
      local-rep4.url=/usr/IBM/localrepo4.zip
    • 如果儲存庫需要使用者名稱與密碼,請設定 repoName.user=userIdrepoName.userPassword=password 內容。
      如果需要使用者名稱與密碼,但卻未設定,會提示您提供。若要加強安全,請使用 securityUtility encode 動作,將密碼編碼。如需相關資訊,請參閱 Liberty:securityUtility 指令
      dev-rep.user=myname                            
      dev-rep.userPassword={aes}AH5NLyd7DfGb12pK17Pw+
    • 如果您的系統要求透過 Proxy 伺服器存取 Liberty Repository 或「Liberty 資產儲存庫服務」實例,請設定 proxyHostproxyPortproxyUserproxyPassword Proxy 內容。

      若要加強安全,請使用 securityUtility encode 動作,來編碼 proxyPassword 內容值。如果您沒有設定使用者名稱和密碼,您會收到提示,要求您提供。

      例如:
      proxyHost=my.proxy.server.ibm.com
      proxyPort=9080
      proxyUser=myname
      proxyPassword={aes}AH5NLyd7DfGb12pK17Pw+
  3. 儲存您對 repositories.properties 檔的變更。
  4. 執行 installUtility viewSettings 指令,以檢閱儲存庫和 Proxy 設定。 執行 installUtility viewSettings 指令時,會自動驗證儲存庫和 Proxy 的配置。如果要檢視詳細的驗證訊息,請執行含有 --viewValidationMessages 選項的指令。
    >installUtility viewSettings
    
    installUtility Settings
    ----------------------------------------------------------------------
    Properties File: c:\wlp\etc\repositories.properties
    Default Assets Repository: IBM WebSphere Liberty Repository
    Use Default Repository: True
    
    Properties File Validation
    ----------------------------------------------------------------------
    Validation Results: The properties file successfully passed the 
    validation.
    
    Configured Repositories
    ----------------------------------------------------------------------
    Name: dev-rep
    Location: http://dev.repo.ibm.com:9080/ma/v1
    User Name: myname
    Password: <Unspecified>
    
    Proxy Settings
    ----------------------------------------------------------------------
    Proxy Server: my.proxy.server.ibm.com
    Port: 9080
    User Name: myname
    Password: ********
  5. 執行 installUtility testConnection 指令,來測試儲存庫連線。 如果您沒有設定使用者名稱和密碼,您會收到提示,要求您提供。
    >installUtility testConnection
    Testing the connection to all configured repositories...
    This process might take several minutes to complete.
    
    Configured Repositories
    ----------------------------------------------------------------------
    Name: dev-rep
    Location: http://dev.repo.ibm.com:9080/ma/v1
    Status: Successfully connected to the configured repository.
    Name: IBM WebSphere Liberty Repository (Default Assets Repository)
    Status: Successfully connected to the configured repository.
    您可以執行 installUtility testConnection 指令,且不要指定 repoName,以測試 repositories.properties 檔中所配置的所有儲存庫。Liberty Repository 的儲存庫名稱為 default。如果要測試 Liberty Repository 連線,請執行下列指令:
    installUtility testConnection default

下一步

您可以使用 installUtility 指令來搜尋資產,並從所配置的儲存庫安裝或下載它們。

指示主題類型的圖示 作業主題

檔名:twlp_config_installutility.html