Mandato managesdk

El mandato managesdk proporciona los nombres de los kits de desarrollo de software que utiliza el producto.

Utilice el mandato managesdk para:
  • 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]Atención: El mandato managesdk proporciona una función que sustituye el mandato enableJvm. El mandato enableJvm está en desuso. Utilice el mandato managesdk, en lugar del mandato enableJvm.
Atención: Si utiliza el mandato managesdk en una célula federada y habilita un SDK en un nodo, el mandato no encuentra el SDK a menos que se reinicie el agente de nodo.

[z/OS]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.

Nota: Después de la instalación, WebSphere Application Server examina los SDK de Java™ instalados y elige el nivel más alto de SDK de Java que está instalado, que se utiliza como valor predeterminado para los mandatos de perfiles recién creados. Con este valor inicial en vigor, se puede utilizar el mandato managesdk para cambiar otro SDK, si hay uno disponible.

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:
[AIX][HP-UX][Linux][Solaris][z/OS]
raíz_servidor_aplicaciones/bin/managesdk.sh -help
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -help
[Windows]
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:
[AIX][HP-UX][Linux][Solaris][z/OS]
raíz_servidor_aplicaciones/bin/managesdk.sh -listAvailable -verbose
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -listAvailable -verbose
[Windows]
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:
[AIX][HP-UX][Linux][Solaris][z/OS]
raíz_servidor_aplicaciones/bin/managesdk.sh -listEnabledProfile -profileName
AppSrv02 -verbose
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
[Windows]
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:
[AIX][HP-UX][Linux][Solaris][z/OS]
raíz_servidor_aplicaciones/bin/managesdk.sh -listEnabledProfileAll -verbose
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -listEnabledProfileAll -verbose
[Windows]
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:
  • Si el perfil es un nodo federado de un gestor de despliegue, el gestor de despliegue debe estar en ejecución cuando el mandato managesdk intente actualizar el perfil.
  • Si el perfil es un servidor de aplicaciones autónomo, un servidor proxy seguro autónomo, un gestor de trabajos, un agente administrativo o un gestor de despliegue, el servidor del perfil (nodo) no debe estar en ejecución cuando el mandato managesdk intenta actualizar el perfil. Detenga el servidor antes de ejecutar el mandato managesdk.
  • Cuando habilite el SDK para un nodo, ejecute el mandato managesdk desde el directorio /bin de instalación del producto al que pertenece el nodo o desde el directorio /bin del perfil que contiene el nodo que desea actualizar.
  • Debe existir una conexión con el gestor de despliegue que utilice un protocolo conector soportado en el orden de preferencia siguiente:
    1. SOAP
    2. IPC (Inter-Process Communications)
    3. RMI (Remote Method Invocation)
    Si el protocolo SOAP está habilitado, el mandato managesdk utilizará el protocolo SOAP. Si el protocolo SOAP no está habilitado pero el protocolo IPC está habilitado, el mandato utilizará el protocolo IPC. Si no están habilitados el protocolo SOAP ni el protocolo IPC, el mandato utilizará el protocolo RMI.
  • Debe proporcionar el nombre de usuario administrativo y la contraseña con el mandato managesdk por cada perfil que contenga un nodo federado o un nodo de gestor de despliegue en una célula con la seguridad habilitada. Si no especifica los parámetros -user y -password, el mandato managesdk puede fallar o dejar de procesarse. El tema sobre la configuración de la seguridad con scripts proporciona instrucciones específicas del protocolo de conectores sobre cómo guardar los valores de nombre de usuario y de contraseña.
  • Cuando habilita el SDK para un gestor de despliegue, sólo se habilita el servidor del gestor de despliegue. Ninguno de los nodos gestionados del gestor de despliegue están habilitados para utilizar el SDK específico.

En el ejemplo siguiente se utiliza -enableProfile, -profileName, -sdkname y -enableServers con el mandato managesdk:

[AIX][HP-UX][Linux][Solaris]
raíz_servidor_aplicaciones/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
[Windows]
raíz_servidor_aplicaciones\bin\managesdk.bat -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
[z/OS]
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:
  • Si el perfil es un nodo federado de un gestor de despliegue, el gestor de despliegue debe estar en ejecución cuando el mandato managesdk intente actualizar el perfil.
  • Si el perfil es un servidor de aplicaciones autónomo, un servidor proxy seguro autónomo, un gestor de trabajos, un agente administrativo o un gestor de despliegue, el servidor del perfil (nodo) no debe estar en ejecución cuando el mandato managesdk intenta actualizar el perfil. Detenga el servidor antes de ejecutar el mandato managesdk.
  • Cuando habilite el SDK para un nodo, ejecute el mandato managesdk desde el directorio /bin de instalación del producto al que pertenece el nodo o desde el directorio /bin del perfil que contiene el nodo que desea actualizar.
  • Debe existir una conexión con el gestor de despliegue que utilice un protocolo conector soportado en el orden de preferencia siguiente:
    1. SOAP
    2. IPC (Inter-Process Communications)
    3. RMI (Remote Method Invocation)
    Si el protocolo SOAP está habilitado, el mandato managesdk utilizará el protocolo SOAP. Si el protocolo SOAP no está habilitado pero el protocolo IPC está habilitado, el mandato utilizará el protocolo IPC. Si no están habilitados el protocolo SOAP ni el protocolo IPC, el mandato utilizará el protocolo RMI.
  • Debe proporcionar el nombre de usuario administrativo y la contraseña con el mandato managesdk por cada perfil que contenga un nodo federado o un nodo de gestor de despliegue en una célula con la seguridad habilitada. Si no especifica los parámetros -user y -password, el proceso del mandato managesdk puede fallar o detenerse. El tema sobre la configuración de la seguridad con scripts proporciona instrucciones específicas del protocolo de conectores sobre cómo guardar los valores de nombre de usuario y de contraseña.
    Avoid trouble Avoid trouble: No utilice la opción -enableProfileAll a menos que la solicitud automática esté inhabilitada para las conexiones SOAP, IPC y RMI con gestores de despliegue de células que tengan un nodo federado o gestor de despliegue con la seguridad habilitada. La solicitud automática hace que el proceso del mandato managesdk falle o se detenga. gotcha
  • Cuando habilita el SDK para un gestor de despliegue, sólo se habilita el servidor del gestor de despliegue. Ninguno de los nodos gestionados del gestor de despliegue están habilitados para utilizar el SDK específico.

En el ejemplo siguiente se utiliza -enableProfileAll, -sdkname y -enableServers con el mandato managesdk:

[AIX][HP-UX][Linux][Solaris]
raíz_servidor_aplicaciones/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
[Windows]
raíz_servidor_aplicaciones\bin\managesdk.bat -enableProfileAll -sdkname 8.0_64 -enableServers
[z/OS]
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:

[AIX][HP-UX][Linux][Solaris][z/OS]
raíz_servidor_aplicaciones/bin/managesdk.sh -getNewProfileDefault -verbose
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -getNewProfileDefault -verbose
[Windows]
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:

[AIX][HP-UX][Linux][Solaris]
raíz_servidor_aplicaciones/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -setNewProfileDefault -sdkname 8.0_64
[Windows]
raíz_servidor_aplicaciones\bin\managesdk.bat -setNewProfileDefault -sdkname 8.0_64
[z/OS]
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:

[AIX][HP-UX][Linux][Solaris][z/OS]
raíz_servidor_aplicaciones/bin/managesdk.sh -getCommandDefault -verbose
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -getCommandDefault -verbose
[Windows]
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:

[AIX][HP-UX][Linux][Solaris]
raíz_servidor_aplicaciones/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
[IBM i]
raíz_servidor_aplicaciones/bin/managesdk -setCommandDefault -sdkname 8.0_64
[Windows]
raíz_servidor_aplicaciones\bin\managesdk.bat -setCommandDefault -sdkname 8.0_64
[z/OS]
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:
  • [AIX][HP-UX][IBM i][Linux][Solaris][Windows]-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][IBM i]

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.

  1. Opcionalmente, ver una lista de nombres de SDK disponibles para la instalación de producto:
    managesdk -listAvailable
  2. Establecer el valor predeterminado para SDK Versión 8.0:
    managesdk -setCommandDefault -sdkname 8.0_64
  3. Establecer el nuevo perfil predeterminado para SDK Versión 8.0:
    managesdk -setNewProfileDefault -sdkname 8.0_64
  4. 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.


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_managesdk
File name: rxml_managesdk.html