为 installUtility 命令配置存储库和代理设置

repositories.properties 文件中,可配置 installUtility 命令如何访问基于本地目录的存储库、Liberty Asset Repository Service 的实例以及 Liberty 存储库

关于此任务

installUtility 命令可访问以下存储库:
  • Liberty 存储库 是 IBM® 托管的公用存储库,可通过互联网访问。有关更多信息,请参阅 Liberty 存储库
  • Liberty Asset Repository Service 是一种开放式源代码服务,您可使用它创建可穿过企业防火墙远程访问的本地存储库。有关更多信息,请参阅 GitHub 上的 WASdev/tool.lars 项目
  • 基于本地目录的存储库,您可以通过使用 installUtility download 操作创建,也可以通过下载 wlp-featureRepo-<version>.zip 文件(其中包含了所有适用功能部件和附加组件)创建。有关更多信息,请参阅使用 installUtility 命令下载资产

installUtility 命令和 featureManager 命令使用相同配置属性文件,即 repositories.properties。代理设置是共享的,但存储库设置仅供 installUtility 命令使用。要管理资产并完成基于存储库的安装、查找或卸载操作时,应使用 installUtility 命令而不是 featureManager 命令。

提示: 通过在 --from 选项上指定存储库,可从基于单个本地目录的存储库下载或安装资产。不需要 repositories.properties 文件中的任何其他配置。有关更多信息,请参阅 installUtility 命令
要使用受限互联网访问权或通过防火墙访问 IBM WebSphere® Liberty Repository,请确保您可以访问以下主机和端口:
  • 端口 443 上的 public.dhe.ibm.com
  • 端口 443 上的 asset-websphere.ibm.com
注: installUtility 命令仅支持使用 HTTP/HTTPS 协议的代理服务器。

过程

  1. 可选: 第一次配置存储库或代理设置时,可运行 installUtility viewSettings 命令以输出 repositories.properties 文件的配置模板。

    将该模板复制到位于 ${wlp.install.dir}/etc/repositories.properties 的新属性文件。属性文件必须为 ASCII 格式以用于所有平台。

  2. ${wlp.install.dir}/etc/repositories.properties 文件中定义设置。

    如果通过 installUtility viewSettings 命令复制该模板,请通过将示例存储库和代理设置更改为指向您的环境来修改该模板。以井号 (#) 开头的行不会被处理。

    • 要禁用对 Liberty 存储库 的访问,请将 useDefaultRepository 属性设置为 falseLiberty 存储库 在缺省情况下已启用,并且是安装或下载资产时访问的最后一个存储库。
      useDefaultRepository=false
    • 要定义存储库,请以 repoName.url=urlrepoName.url=file_path 形式添加属性。每个存储库名称必须是唯一的。

      系统将访问所定义存储库以在 repositories.properties 文件中指定这些存储库。

      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+
    • 如果系统需要通过代理服务器访问 Liberty 存储库Liberty Asset Repository Service 的实例,请设置 proxyHostproxyPortproxyUserproxyPassword 代理属性。

      为提高安全性,请使用 securityUtility encode 操作对 proxyPassword 属性的值进行编码。如果未设置用户名和密码,那么您将收到要求提供用户名和密码的提示。

      例如:
      proxyHost=my.proxy.server.ibm.com
      proxyPort=9080
      proxyUser=myname
      proxyPassword={aes}AH5NLyd7DfGb12pK17Pw+
  3. 将更改保存至 repositories.properties 文件。
  4. 通过运行 installUtility viewSettings 命令来查看存储库和代理设置。 运行 installUtility viewSettings 命令时,将自动验证存储库和代理配置。要查看详细验证消息,请带 --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. 
    可通过在未指定 repoName 的情况下运行 installUtility testConnection 命令以测试 repositories.properties 文件中的所有已配置存储库。Liberty 存储库 的存储库名称为 default。要测试与 Liberty 存储库 的连接,请运行以下命令:
    installUtility testConnection default

下一步做什么

可使用 installUtility 命令搜索资产并从所配置存储库安装或下载这些资产。

用于指示主题类型的图标 任务主题

文件名:twlp_config_installutility.html