managesdk 命令
managesdk 命令提供产品所使用的软件开发套件的名称。
- 列示适用于产品安装的软件开发包 (SDK) 名称。
- 列示指定概要文件根据配置所要使用的 SDK 名称。
- 对于产品安装中的每个概要文件,列示该概要文件根据配置所要使用的 SDK 名称。
- 使概要文件能够使用指定的 SDK 名称。
- 使安装中的所有概要文件都能够使用指定的 SDK 名称。
- 获取用来配置新概要文件的 SDK 名称。
- 更改概要文件使用的缺省 SDK 名称。
- 获取从产品 bin 目录中调用的脚本所使用的 SDK 名称。
- 更改产品 bin 目录中的脚本在缺省情况下使用的 SDK 名称。如果未指定现有概要文件名称,并且缺省概要文件名称不适用,那么将使用此 SDK 名称。
命令文件位于 app_server_root/bin 目录和 app_client_root/bin 目录中。
![[IBM i]](../images/iseries.gif)
如果将新 SDK 安装到 WebSphere® Application Server for z/OS® 的现有副本,那么必须先启动每个应用程序服务器节点或管理节点,然后您才能在该节点上使用
SDK。重新启动节点时,postinstaller 将创建所需的从配置文件系统指向包含新 SDK 的产品文件系统的符号链接。
语法
请根据以下命令语法使用 managesdk 命令:
managesdk -task [-parameter] [value]
命令行工具将验证所请求的任务是否包含必需的参数和值。参数不区分大小写。但是,值区分大小写。您必须以正确的大小写输入值,这是因为,命令行工具不会验证参数值的大小写。如果输入的参数值不正确,那么可能导致错误的结果。
参数
下列 -task 选项可用于 managesdk 命令:
- -help
- 显示有关每个 managesdk
任务的参数或值的详细信息。以下示例将 managesdk 命令与 help 参数配合使用:
app_server_root/bin/managesdk.sh -help
app_server_root/bin/managesdk -help
app_server_root\bin\managesdk.bat -help
help 选项的输出描述了必需参数和可选参数。
- -listAvailable [-verbose]
- 显示所有适用于产品安装的 SDK 名称的列表。如果还指定了 -verbose 选项,那么还将显示每个 SDK
名称的属性列表。以下示例将 -listAvailable -verbose 参数与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -listAvailable -verbose
app_server_root/bin/managesdk -listAvailable -verbose
app_server_root\bin\managesdk.bat -listAvailable -verbose
输出是产品安装可以使用的所有 SDK 名称的列表以及每个 SDK 名称的相关属性列表。
- -listEnabledProfile [-profileName profile_name] [-verbose]
- 显示指定的概要文件及其节点和服务器根据配置所要使用的所有 SDK 名称的列表。如果还指定了 -verbose 选项,那么还将显示每个 SDK
名称的属性列表。以下示例将 -listEnabledProfile -profileName 和 -verbose 参数与
managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -listEnabledProfile -profileName AppSrv02 -verbose
app_server_root/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
app_server_root\bin\managesdk.bat -listEnabledProfile -profileName AppSrv02 -verbose
输出是指定的概要文件可以使用的所有 SDK 名称的列表以及每个 SDK 名称的相关属性列表。
- -listEnabledProfileAll [-verbose]
- 显示安装中的所有概要文件以及每个概要文件及其节点和服务器根据配置所要使用的 SDK 名称的列表。如果还指定了 -verbose 选项,那么还将显示每个 SDK
名称的属性列表。以下示例将 -listEnabledProfileAll 和 -verbose 参数与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -listEnabledProfileAll -verbose
app_server_root/bin/managesdk -listEnabledProfileAll -verbose
app_server_root\bin\managesdk.bat -listEnabledProfileAll -verbose
输出是产品安装中所有概要文件和每个概要文件可以使用的所有 SDK 名称的列表,以及每个 SDK 名称的相关属性列表。
- -enableProfile [-profileName profile_name] [-sdkname sdkName] [-enableServers] [-user user_name] [-password password_value]
- 使概要文件能够使用指定的 SDK 名称。-profileName 参数指定概要文件,而
-sdkname 参数指定 SDK 名称。此命令使概要文件以及概要文件的节点级缺省 SDK 能够使用指定的 SDK 名称。除非使用了 -enableServers 选项,否则此命令不会更改服务器级 SDK 设置。如果使用了 -enableServers 选项,那么将清除所有服务器级 SDK 设置,从而允许所有服务器使用节点级缺省 SDK。
以下条件适用于已运行 managesdk 命令的情况:
以下示例将 -enableProfile、-profileName、-sdkname 和 -enableServers 与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
app_server_root/bin/managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
app_server_root\bin\managesdk.bat -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
app_server_root/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
输出是一条消息,该消息指示更新指定概要文件成功从而使该概要文件现在能够使用指定的 SDK,或者遇到了问题从而导致无法成功地更新该概要文件。
- -enableProfileAll [-sdkname sdkName] [-enableServers] [-user user_name] [-password password_value]
- 使安装中的所有概要文件都能使用指定的 SDK 名称。-sdkname 参数指定 SDK 名称。此命令使所有概要文件以及每个概要文件的节点级缺省 SDK 能够使用指定的 SDK 名称。除非使用了 -enableServers 选项,否则此命令不会更改服务器级 SDK 设置。如果使用了 -enableServers 选项,那么将清除所有服务器级 SDK 设置,从而允许所有服务器使用节点级缺省 SDK。
以下条件适用于已运行 managesdk 命令的情况:
以下示例将 -enableProfileAll、-sdkname 和 -enableServers 与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
app_server_root/bin/managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
app_server_root\bin\managesdk.bat -enableProfileAll -sdkname 8.0_64 -enableServers
app_server_root/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
输出是每个概要文件的一条相应消息,该消息指示更新该概要文件成功从而使该概要文件现在能够使用指定的 SDK,或者遇到了问题从而导致无法成功地更新该概要文件。
- -getNewProfileDefault [-verbose]
- 显示针对使用 manageprofiles 命令创建的所有概要文件配置的 SDK 名称。如果还指定了 -verbose 选项,那么还将显示单个 SDK 名称的属性信息。
以下示例将 -getNewProfileDefault -verbose 参数与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -getNewProfileDefault -verbose
app_server_root/bin/managesdk -getNewProfileDefault -verbose
app_server_root\bin\managesdk.bat -getNewProfileDefault -verbose
此命令运行完成后,将显示新的概要文件缺省 SDK 名称。
- -setNewProfileDefault [-sdkname sdkName]
- 更改针对使用 manageprofiles 命令创建的所有概要文件配置的
SDK 名称。-sdkname 参数指定要使用的缺省 SDK 名称。sdkName 值必须是对产品安装启用的 SDK 名称。
以下示例将 -setNewProfileDefault -sdkname 参数与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
app_server_root/bin/managesdk -setNewProfileDefault -sdkname 8.0_64
app_server_root\bin\managesdk.bat -setNewProfileDefault -sdkname 8.0_64
app_server_root/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
此命令运行完成后,将显示新的概要文件缺省 SDK 名称。
- -getCommandDefault [-verbose]
- 显示命令未指定概要文件并且命令没有缺省概要文件时
app_server_root/bin、app_client_root/bin
或 plugins_root/bin 目录中的脚本命令所能够使用的
SDK 名称。如果还指定了 -verbose 选项,那么还将显示单个 SDK 名称的属性信息。
以下示例将 -getCommandDefault -verbose 参数与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -getCommandDefault -verbose
app_server_root/bin/managesdk -getCommandDefault -verbose
app_server_root\bin\managesdk.bat -getCommandDefault -verbose
- -setCommandDefault [-sdkname sdkName]
- 更改命令未指定概要文件并且命令没有缺省概要文件时
app_server_root/bin、app_client_root/bin
或 plugins_root/bin 目录中的脚本命令所能够使用的
SDK 名称。-sdkname 参数指定用于命令的 SDK 名称。sdkName 值必须是对产品安装启用的 SDK 名称。
以下示例将 -getCommandDefault -sdkname 参数与 managesdk 命令配合使用:
app_server_root/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
app_server_root/bin/managesdk -setCommandDefault -sdkname 8.0_64
app_server_root\bin\managesdk.bat -setCommandDefault -sdkname 8.0_64
app_server_root/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
以下特殊参数选项可以与 managesdk 命令的任务参数配合使用:
- -debug
- 将此选项与任意 -task 参数配合使用可以在命令输出中提供额外的调试信息。
- -quiet
- 将此选项与任意 -task 参数配合使用可以消除命令输出中的大部分消息。
- -sdkname
- 将此选项与 -set task 参数配合使用可以指定对产品安装启用的 SDK 名称;例如:
-sdkname 8.0_64
- -verbose
- 将此选项与任意 -list 或 -get 任务参数配合使用可以提供额外的信息,例如命令输出中的 SDK 属性。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
使用方案
下列示例演示运行 managesdk 命令时的正确语法:
managesdk -listAvailable -verbose
managesdk -listEnabledProfile -profileName AppSrv02 -verbose
managesdk -listEnabledProfileAll -verbose
managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
managesdk -getNewProfileDefault -verbose
managesdk -setNewProfileDefault -sdkname 8.0_64
managesdk -getCommandDefault -verbose
managesdk -setCommandDefault -sdkname 8.0_64
以下示例演示列示可用 SDK、将缺省 SDK 更改为 V8.0 SDK 以及使概要文件(如果已存在)能够使用 V8.0 SDK 时使用的正确命令序列。
- (可选)查看产品安装的可用 SDK 名称列表:
managesdk -listAvailable
- 将命令缺省值设置为 V8.0 SDK:
managesdk -setCommandDefault -sdkname 8.0_64
- 将新概要文件缺省值设置为 V8.0 SDK:
managesdk -setNewProfileDefault -sdkname 8.0_64
- 如果这些概要文件已存在,那么使其能够使用 V8.0 SDK:
managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
要更改 Network Deployment 安装中的联合概要文件,Deployment Manager 必须处于运行状态。managesdk 命令更新主配置存储库。此命令运行完成后,必须先执行同步操作,这样新的 SDK 才能用于联合概要文件。