Mandato managesdk
El mandato managesdk proporciona los nombres de los kits de desarrollo de software que utiliza el producto.
- Enumerar los nombres de kit de desarrollo de software (SDK) disponibles para una instalación del producto.
- Enumerar los nombres de SDK que un perfil especificado está configurado para utilizar.
- Para cada perfil en una instalación del producto, enumerar los nombres de SDK que el perfil está configurado para utilizar.
- Habilitar un perfil para utilizar un nombre de SDK especificado.
- Habilitar todos los perfiles de una instalación para utilizar un nombre de SDK especificado.
- Obtener el nombre de SDK que se utiliza para configurar nuevos perfiles.
- Cambiar el nombre de SDK predeterminado que utilizan los perfiles.
- Obtener el nombre de SDK que utilizan los scripts a los que se llama desde un directorio bin del producto.
- Cambiar el nombre del SDK que los scripts en un producto bin utilizan de forma predeterminada. El nombre de SDK se utiliza cuando no se especifica ningún nombre de perfil existente y el nombre de perfil predeterminado no es aplicable.
El archivo de mandato se encuentra en el directorio raíz_servidor_aplicaciones/bin y el directorio raíz_cliente_aplic/bin.
![[IBM i]](../images/iseries.gif)
Si instala un nuevo SDK en una copia existente de WebSphere Application Server para z/OS, se debe reiniciar cada nodo de servidor de
aplicaciones o nodo de gestión para poder utilizar el SDK en ese nodo. Cuando se reinicia el nodo, el postinstalador crea los enlaces simbólicos necesarios a partir del sistema de archivos de configuración en el sistema de archivos del producto que contiene el nuevo SDK.
Sintaxis
Utilice la sintaxis de mandato siguiente con el mandato managesdk:
managesdk -task [-parámetro] [valor]
La herramienta de línea de mandatos valida que la tarea solicitada contenga los parámetros y valores necesarios. Los parámetros no son sensibles a las mayúsculas y minúsculas. Sin embargo, los valores son sensibles a las mayúsculas y minúsculas. Debe escribir los valores con las mayúsculas correctas, porque la herramienta de línea de mandatos no valida las mayúsculas de los valores de los parámetros. Pueden producirse resultados incorrectos si el valor del parámetro no está escrito correctamente.
Parámetros
Las siguientes opciones de -task están disponibles para el mandato managesdk:
- -help
- Muestra información detallada sobre los parámetros o valores de cada tarea
managesdk. En el ejemplo siguiente se utiliza el parámetro de
ayuda con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -help
raíz_servidor_aplicaciones/bin/managesdk -help
raíz_servidor_aplicaciones\bin\managesdk.bat -help
La salida de la opción de ayuda describe los parámetros necesarios y los opcionales.
- -listAvailable [-verbose]
- Muestra una lista de todos los nombres de SDK disponibles para la instalación del
producto. Cuando la opción -verbose también se especifica, se visualiza además una lista de propiedades para cada nombre de SDK. En el ejemplo
siguiente se utilizan los parámetros -listAvailable -verbose con el
mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -listAvailable -verbose
raíz_servidor_aplicaciones/bin/managesdk -listAvailable -verbose
raíz_servidor_aplicaciones\bin\managesdk.bat -listAvailable -verbose
La salida es una lista de todos los nombres de SDK que la instalación del producto puede utilizar, junto con una lista de las propiedades asociadas con cada nombre de SDK.
- -listEnabledProfile [-profileName nombre_perfil] [-verbose]
- Muestra una lista de todos los nombres de SDK cuyo uso se ha configurado para
un perfil especificado y su nodo y sus servidores. Cuando la opción -verbose también se especifica, se visualiza además una lista de propiedades para cada nombre de SDK. En
el ejemplo siguiente se utilizan los parámetros -listEnabledProfile -profileName y -verbose con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -listEnabledProfile -profileName AppSrv02 -verbose
raíz_servidor_aplicaciones/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
raíz_servidor_aplicaciones\bin\managesdk.bat -listEnabledProfile -profileName AppSrv02 -verbose
La salida es una lista de todos los nombres de SDK que el perfil especificado puede utilizar, junto con una lista de las propiedades asociadas con cada nombre de SDK.
- -listEnabledProfileAll [-verbose]
- Muestra una lista de todos los perfiles en una instalación y los nombres de SDK
cuyo uso se ha configurado actualmente para cada perfil y su nodo y servidores. Cuando la opción -verbose también se especifica, se visualiza además una lista de propiedades para cada nombre de SDK. En el ejemplo siguiente, se utilizan los parámetros -listEnabledProfileAll y -verbose con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -listEnabledProfileAll -verbose
raíz_servidor_aplicaciones/bin/managesdk -listEnabledProfileAll -verbose
raíz_servidor_aplicaciones\bin\managesdk.bat -listEnabledProfileAll -verbose
La salida es una lista de todos los perfiles de una instalación del producto con todos los nombres de SDK que el perfil especificado puede utilizar, junto con una lista de las propiedades asociadas con cada nombre de SDK.
- -enableProfile [-profileName nombre_perfil] [-sdkname nombre_sdk] [-enableServers] [-user nombre_usuario] [-password valor_contraseña]
- Habilita un perfil para que utilice un nombre de SDK especificado. El parámetro
-profileName especifica el perfil, y el parámetro -sdkname especifica el nombre de SDK. El mandato permite que el perfil y el SDK predeterminado de nivel
de nodo del perfil utilicen el nombre de SDK especificado. A menos que se utilice la opción -enableServers, el mandato no cambiará los valores de SDK de nivel de servidor. Si se utiliza la opción -enableServers, todos los valores de SDK de nivel de servidor se borrarán, de forma que se permitirá a todos los servidores utilizar el SDK
predeterminado en el nivel de nodo. Las condiciones siguientes se aplican cuando se ejecuta el mandato managesdk:
En el ejemplo siguiente se utiliza -enableProfile, -profileName, -sdkname y -enableServers con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
raíz_servidor_aplicaciones/bin/managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
raíz_servidor_aplicaciones\bin\managesdk.bat -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
raíz_servidor_aplicaciones/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
La salida es un mensaje que indica si el perfil especificado se ha actualizado satisfactoriamente y está ahora habilitado para utilizar el SDK especificado, o si se han encontrado problemas que han impedido que el perfil se actualizara correctamente.
- -enableProfileAll [-sdkname nombre_SDK] [-enableServers] [-user nombre_usuario] [-password valor_contraseña]
- Permite que todos los perfiles de una instalación utilicen un nombre de SDK
especificado. El parámetro -sdkname especifica el nombre de SDK. El mandato permite
que todos los perfiles y el SDK predeterminado de nivel de nodo de cada perfil
utilicen el nombre de SDK especificado. A menos que se utilice la opción -enableServers, el mandato no cambiará los valores de SDK de nivel de servidor. Si se utiliza la opción -enableServers, todos los valores de SDK de nivel de servidor se borrarán, de forma que se permitirá a todos los servidores utilizar el SDK
predeterminado en el nivel de nodo. Las condiciones siguientes se aplican cuando se ejecuta el mandato managesdk:
En el ejemplo siguiente se utiliza -enableProfileAll, -sdkname y -enableServers con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
raíz_servidor_aplicaciones/bin/managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
raíz_servidor_aplicaciones\bin\managesdk.bat -enableProfileAll -sdkname 8.0_64 -enableServers
raíz_servidor_aplicaciones/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
La salida es un mensaje para cada perfil que indica si el perfil se ha actualizado satisfactoriamente y está ahora habilitado para utilizar el SDK especificado, o si se han encontrado problemas que han impedido que el perfil se actualizara correctamente.
- -getNewProfileDefault [-verbose]
- Muestra el nombre de SDK que está configurado para todos los
perfiles creados con el mandato manageprofiles. Cuando la opción
-verbose también se especifica, también se visualizan la información de propiedades para el nombre de un SDK.
En el ejemplo siguiente se utilizan los parámetros -getNewProfileDefault -verbose con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -getNewProfileDefault -verbose
raíz_servidor_aplicaciones/bin/managesdk -getNewProfileDefault -verbose
raíz_servidor_aplicaciones\bin\managesdk.bat -getNewProfileDefault -verbose
Después de ejecutar el mandato, aparecerá el nuevo nombre de SDK del perfil predeterminado.
- -setNewProfileDefault [-sdkname nombre_SDK]
- Cambia el nombre de SDK que está configurado para todos los
perfiles creados con el mandato manageprofiles. El parámetro
-sdkname especifica el nombre de SDK predeterminado que debe utilizarse. El valor
de nombre_SDK debe ser un nombre de SDK habilitado para la
instalación del producto.
En el ejemplo siguiente se utilizan los parámetros -setNewProfileDefault -sdkname con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
raíz_servidor_aplicaciones/bin/managesdk -setNewProfileDefault -sdkname 8.0_64
raíz_servidor_aplicaciones\bin\managesdk.bat -setNewProfileDefault -sdkname 8.0_64
raíz_servidor_aplicaciones/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
Después de ejecutar el mandato, aparecerá el nuevo nombre de SDK del perfil predeterminado.
- -getCommandDefault [-verbose]
- Muestra el nombre del SDK que pueden utilizar los mandatos de script de los
directorios raíz_servidor_aplic/bin,
raíz_cliente_aplic/bin o
raíz_plug-ins/bin cuando el mandato no especifica
ningún perfil y cuando el mandato no utiliza un nombre de forma predeterminada. Cuando la opción
-verbose también se especifica, también se visualizan la información de propiedades para el nombre de un SDK.
En el ejemplo siguiente se utilizan los parámetros -getCommandDefault -verbose con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -getCommandDefault -verbose
raíz_servidor_aplicaciones/bin/managesdk -getCommandDefault -verbose
raíz_servidor_aplicaciones\bin\managesdk.bat -getCommandDefault -verbose
- -setCommandDefault [-sdkname nombre_SDK]
- Cambia el nombre del SDK que pueden utilizar los mandatos de script de los
directorios raíz_servidor_aplic/bin,
raíz_cliente_aplic/bin o
raíz_plug-ins/bin cuando el mandato no especifica
ningún perfil y cuando el mandato no utiliza un nombre de forma predeterminada. El parámetro -sdkname especifica el nombre de SDK
que debe utilizarse en los mandatos. El valor
de nombre_SDK debe ser un nombre de SDK habilitado para la
instalación del producto.
En el ejemplo siguiente se utilizan los parámetros -getCommandDefault -sdkname con el mandato managesdk:
raíz_servidor_aplicaciones/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
raíz_servidor_aplicaciones/bin/managesdk -setCommandDefault -sdkname 8.0_64
raíz_servidor_aplicaciones\bin\managesdk.bat -setCommandDefault -sdkname 8.0_64
raíz_servidor_aplicaciones/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
Las siguientes opciones especiales de parámetros están disponibles con los parámetros de tarea del mandato managesdk:
- -debug
- Utilice esta opción con cualquier parámetro -task para habilitar información de depuración adicional en la salida del mandato.
- -quiet
- Utilice esta opción con cualquier parámetro -task para suprimir la mayoría de los mensajes en la salida del mandato.
- -sdkname
- Utilice esta opción con un parámetro -set task para
especificar un nombre de SDK que está habilitado para la instalación del
producto; por ejemplo:
-sdkname 8.0_64
- -verbose
- Utilice esta opción con cualquier parámetro de tareas -list o -get para proporcionar información adicional, como las propiedades del SDK en la salida del mandato.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Ejemplo de uso
En los ejemplos siguientes se muestra la sintaxis correcta para ejecutar el mandato 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
El siguiente ejemplo demuestra la secuencia de mandatos que se utilizarán para listar los SDK disponibles, cambia el SDK predeterminado por un SDK Versión 8.0 y, si ya existen perfiles, habilita los perfiles para utilizar el SDK de la versión 8.0.
- Opcionalmente, ver una lista de nombres de SDK disponibles para la instalación de producto:
managesdk -listAvailable
- Establecer el valor predeterminado para SDK Versión 8.0:
managesdk -setCommandDefault -sdkname 8.0_64
- Establecer el nuevo perfil predeterminado para SDK Versión 8.0:
managesdk -setNewProfileDefault -sdkname 8.0_64
- Si ya existen perfiles, habilitar los perfiles para que utilicen el SDK Versión 8.0:
managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
Para cambiar los perfiles federados en una instalación de Network Deployment, el gestor de despliegue debe estar en ejecución. El mandato managesdk actualiza el repositorio de configuración maestro. Después de ejecutar el mandato, debe producirse una operación de sincronización para poder utilizar el nuevo SDK para los perfiles federados.