在 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 协议的代理服务器。
过程
- 可选: 第一次配置存储库或代理设置时,可运行 installUtility viewSettings 命令以输出 repositories.properties 文件的配置模板。
将该模板复制到位于 ${wlp.install.dir}/etc/repositories.properties 的新属性文件。属性文件必须为 ASCII 格式以用于所有平台。
- 在 ${wlp.install.dir}/etc/repositories.properties 文件中定义设置。
如果通过 installUtility viewSettings 命令复制该模板,请通过将示例存储库和代理设置更改为指向您的环境来修改该模板。以井号 (#) 开头的行不会被处理。
- 将更改保存至 repositories.properties 文件。
- 通过运行 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: ********
- 通过运行 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 命令搜索资产并从所配置存储库安装或下载这些资产。