Sun Java™ System Identity Manager 7.1 Notas de la versión

Anexos a la documentación y correcciones

Esta sección contiene información nueva y corregida que ha sido necesaria tras publicar la documentación de Identity Manager 7.1. Esta información se ha dividido como sigue:


Identity Manager Installation

Esta sección contiene información nueva y corregida relacionada con Sun Java™ System Identity Manager Installation.


Actualización de Identity Manager

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager Upgrade.

Otros objetos de repositorio personalizados

Anote los nombres de todos los objetos de repositorio personalizados que haya creado o actualizado. Quizá tenga que exportar dichos objetos desde la instalación actual y luego reimportarlos a la nueva versión de Identity Manager tras actualizar.

Puede usar la función de instantáneas de Identity Manager para crear una instantánea o imagen de referencia de los objetos de repositorio personalizados en su implementación, que le resultará muy útil en caso de actualización.

Cree copias instantáneas de los siguientes tipos de objetos específicos del sistema como elementos de comparación:

Ello le permitirá comparar dos instantáneas para averiguar los cambios aplicados a determinados objetos del sistema antes y después de actualizar.


Nota

Esta función no está ideada para realizar comparativas detalladas continuas de XML (diff), es una herramienta básica para efectuar comparaciones preliminares.


Para crear una instantánea:

  1. En la página Depurar de Identity Manager ( ), pulse el botón SnapShot para acceder a la página Administración de instantáneas.
  2. Figura 1 Página Administración de instantáneas
    Ejemplo de página Administración de instantáneas.

  3. Introduzca un nombre para la instantánea en el cuadro de texto Crear y pulse el botón Crear.
  4. Cuando Identity Manager añade la instantánea, su nombre aparece en la lista del menú Comparar y a la derecha de la etiqueta Exportar.

Para comparar dos instantáneas:

  1. Seleccione las instantáneas en cada uno de los dos menús Comparar ( ).
  2. Figura 2 Página Administración de instantáneas
    Elija un nombre de instantánea en cada lista de menú Comparar.

  3. Pulse el botón Comparar.
    • Si no se ha cambiado ningún objeto, la página indicará que no se han encontrado diferencias.
    • Si por el contrario se han encontrado cambios de objetos, la página mostrará el tipo y nombre del objeto, así como si el objeto es distinto, está ausente o está presente.
    • Por ejemplo, si un objeto está presente en la instantánea 1, pero no en la instantánea 2, la columna de la instantánea 1 indicará Presente y la columna de la instantánea 2 indicará Ausente.

Puede exportar instantáneas en formato XML. Haga clic en el nombre de la instantánea para exportar el archivo de la misma.

Para eliminar una instantánea, selecciónela en el menú Eliminar y haga clic en el botón Eliminar.


Identity Manager Administration Guide

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager Administration.

Capítulo 3, User and Account Management (Administración de usuarios y de cuentas)

Capítulo 5, Administration (Administración)

           Delegaciones a usuarios eliminados

Capítulo 11, Identity Auditing (Auditoría de Identity)

Se ha añadido la información siguiente a este capítulo.

Solución de limitaciones de las capacidades de auditor

Las capacidades predeterminadas que se necesitan para realizar tareas de auditoría se hallan en la organización (grupo de objetos) de nivel superior o Top. En consecuencia, sólo los administradores que controlan Top pueden asignar estas capacidades a otros administradores.

Esta limitación se puede solucionar agregando las capacidades a otra organización. Identity Manager facilita esta tarea con dos utilidades incluidas en el directorio sample/scripts.

  1. Para ver una lista de todas las capacidades (grupos Admin) y sus organizaciones asociadas (grupos de objetos), ejecute el comando:
  1. Edite el archivo CSV para ajustar como convenga las asignaciones de capacidades a las organizaciones.
  2. Ejecute este comando para actualizar Identity Manager.

Capítulo 13, Service Provider Administrator (Administrador de Service Provider)

En la sección “Configure Synchronization” debe indicarse que el intervalo de sincronización predeterminado para las tareas de sincronización de Service Provider es 1 minuto.


Identity Manager Resources Reference

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager Resources Reference:


Identity Manager Technical Deployment Overview

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager Technical Deployment Overview:

  1. Modifique las tres reglas siguientes de la biblioteca de reglas de usuario final como se indica a continuación.
  2. Modifique esta regla

    Para realizar este cambio…

    getAccountId

    Para utilizar sólo employeeId (y eliminar firstName y lastName)

    getEmailAddress

    Para utilizar el ID de empleado solamente (eliminar el nombre, el apellido y “.")

    verifyFirstname 

    Para cambiar la longitud de 2 a 1 y permitir el uso de nombres asiático de un solo carácter

  3. Modifique el formulario End User Anon Enrollment Completion para eliminar los argumentos firstName (nombre) y lastName (apellido) de las llamadas a las normas AccountId y getEmailAddress.


Identity Manager Workflows, Forms, and Views

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager Workflows, Forms, and Views.

Capítulo 2, Identity Manager Workflow (Flujo de trabajo de Identity Manager)

Capítulo 3, Identity Manager Forms (Formularios de Identity Manager)

Información relacionada

Acerca del procesamiento de formularios relacionados con auditoría

Especificación de formularios de usuario

Formularios relacionados con auditoría

¿Por qué personalizar estos formularios?

Variables de la tarea de exploración

Capítulo 4, Identity Manager Views (Vistas de Identity Manager)

Atributos comunes

La tabla siguiente muestra los atributos de nivel superior de la vista organizativa.

Nombre

¿Editable?

Tipo de datos

¿Requerido?

orgName

Leer

Cadena

Generado por sistema

orgDisplayName

Leer/Escribir

Cadena

orgType

Leer/Escribir

Cadena

No

orgId

Leer

Cadena

Generado por sistema

orgAction

Escribir

Cadena

No

orgNewDisplayName

Escribir

Cadena

No

orgParentName

Leer/Escribir

Cadena

No

orgChildOrgNames

Leer

Lista

Generado por sistema

orgApprovers

Leer/Escribir

Lista

No

allowsOrgApprovers

Leer

Lista

Generado por sistema

allowedOrgApproverIds

Leer

Lista

Generado por sistema

orgUserForm

Leer/Escribir

Cadena

No

orgViewUserForm

Leer/Escribir

Cadena

No

orgPolicies

Leer/Escribir

Lista

No

orgAuditPolicies

Leer/Escribir

Lista

No

renameCreate

Leer/Escribir

Cadena

No

renameSaveAs

Leer/Escribir

Cadena

No

orgName

Identifica el UID de la organización. Este valor se diferencia de la mayoría de los nombres de objeto de vista porque el nombre de las organizaciones puede adoptar la misma forma abreviada, pero sus organizaciones precursoras pueden ser distintas.

orgDisplayName

Especifica el nombre abreviado de la organización. Este valor sólo se utiliza en visualización y no tiene por qué ser único.

orgType

Define el tipo de organización, cuyos valores admitidos son junction o virtual. Las organizaciones que no son de tipo junction o virtual carecen de valor.

orgId

Especifica el ID que identifica a la organización en exclusiva dentro de Identity Manager.

orgAction

Sólo se admite con empalmes de directorios, organizaciones virtuales y organizaciones dinámicas. El valor permitido es refresh. Cuando una organización es virtual o un empalme de directorios, el comportamiento de la operación de regeneración depende del valor de orgRefreshAllOrgsUserMembers.

orgNewDisplayName

Especifica el nuevo nombre abreviado al renombrar la organización.

orgParentName

Identifica la ruta de acceso completa a la organización precursora.

orgChildOrgNames

Muestra una lista con los nombres de interfaz de Identity Manager de todas las organizaciones derivadas directas e indirectas.

orgApprovers

Muestra una lista con los administradores de Identity Manager necesarios para aprobar usuarios añadidos o modificados en esta organización.

allowedOrgApprovers

Muestra una lista con los posibles nombres de usuario que podrían actuar como aprobadores de los usuarios añadidos o modificados en esta organización.

allowedOrgApproverIds

Muestra una lista con los posibles ID de usuario que podrían actuar como aprobadores de los usuarios añadidos o modificados en esta organización.

orgUserForm

Especifica el formulario de usuario (userForm) que los afiliados de esta organización utilizan para crear o editar usuarios.

orgViewUserForm

Especifica el formulario de vista de usuario que los afiliados de esta organización utilizan para ver usuarios.

orgPolicies

Identifica las directivas que se aplican a todos los afiliados de esta organización. Se trata de una lista de objetos que se introducen mediante cadenas de tipo: Cada objeto de directiva contiene los siguientes atributos de vista, que llevan el prefijo orgPolicies[<type>]. <type> representa el tipo de directiva (por ejemplo, cuenta de Lighthouse).

orgAuditPolicies

Especifica las directivas de auditoría que se aplican a todos los afiliados de esta organización.

renameCreate

Cuando se define en true, clona esta organización en otra utilizando el valor de orgNewDisplayName.

renameSaveAs

Cuando se define en true, renombra esta organización utilizando el valor de orgNewDisplayName.

Atributos de empalme de directorios y organización virtual

Nombre

¿Editable?

Tipo de datos

¿Requerido?

orgContainerId

Leer

Cadena

Generado por sistema

orgContainerTypes

Leer

Lista

Generado por sistema

orgContainers

Leer

Lista

Generado por sistema

orgParentContainerId

Leer

Cadena

Generado por sistema

orgResource

Leer/Escribir

Cadena

Sí, en caso de empalme de directorios u organización virtual

orgResourceType

Leer

Cadena

Generado por sistema

orgResourceId

Leer

Cadena

Generado por sistema

orgRefreshAllOrgsUserMembers

Escribir

Cadena

No

orgContainerId

Especifica el dn del contenedor de directorio LDAP asociado (por ejemplo, cn=foo,ou=bar,o=foobar.com).

orgContainerTypes

Muestra una lista con todos los tipos de objetos de recurso permitidos que pueden contener otros objetos de recurso.

orgContainers

Muestra una lista con los contenedores básicos del recurso que la interfaz de Identity Manager utiliza para presentar una lista donde elegir.

orgParentContainerId

Especifica el dn del contenedor de directorio LDAP principal asociado (por ejemplo, cn=foo,ou=bar,o=foobar.com).

orgResource

Especifica el nombre del recurso de Identity Manager utilizado para sincronizar empalmes de directorios y organizaciones virtuales (por ejemplo, West Directory Server).

orgResourceType

Especifica el tipo de recurso de Identity Manager desde el que se sincronizan empalmes de directorios y organizaciones virtuales (por ejemplo, LDAP).

orgResourceId

Especifica el ID del recurso de Identity Manager utilizado para sincronizar empalmes de directorios y organizaciones virtuales.

orgRefreshAllOrgsUserMembers

Si se define en true y si el valor de orgAction es refresh, sincroniza la afiliación del usuario de la organización de Identity con la afiliación del contenedor de recursos para la organización seleccionada y todas las organizaciones derivadas. Si se define en false, no se sincronizará la afiliación del contenedor de recursos, sino únicamente los contenedores de recursos con las organizaciones de Identity para la organización seleccionada y todas las derivadas.

Atributos de organización dinámica

Nombre

¿Editable?

Tipo de datos

¿Requerido?

orgUserMembersRule

Leer/Escribir

Cadena

No

orgUserMembersRuleCacheTimeout

Leer/Escribir

Cadena

No

orgUserMembersRule

Identifica (por nombre o UID) la regla cuyo tipo de autorización (authType) es UserMembersRule, que se evalúa en tiempo de ejecución para determinar la afiliación del usuario.

orgUserMembersCacheTimeout

Especifica el tiempo transcurrido (en milésimas de segundo) antes de que se agote el tiempo de espera en caché si los afiliados devueltos por la regla orgUserMembersRule van a incluirse en caché. Un valor de 0 indica que no se incluye en caché.

En la actualidad, el análisis de la vista de usuario también está relacionado con los atributos accounts[Lighthouse].delegates: (ID-15468)

accounts[Lighthouse].delegates

Ofrece una lista de objetos delegados, clasificados por workItemType, en la que cada objeto incluye información concreta sobre un tipo de elemento de trabajo específico.

accounts[Lighthouse].delegatesHistory

Ofrece una lista de objetos delegados, clasificados entre 0 y n, donde n corresponde al nivel máximo actual de historiales.

Este atributo sólo tiene un atributo, selected, que es un valor booleano que indica el objeto de historial actualmente seleccionado.

accounts[Lighthouse].delegatesOriginal

Después de una operación get o checkout view, ofrece la lista original de objetos delegados, clasificados por workItemType.

Todos los atributos accounts[Lighthouse].delegates* reciben los siguientes atributos:

Atributos de accounts[Lighthouse].delegate*

Descripción

 

workItemType

Identifica el tipo de elemento de trabajo que se delega. Para obtener una lista de tipos de elementos de trabajo válidos, consulte la descripción del modelo de objeto delegado en la sección Identity Manager Technical Deployment Overview de este anexo.

workItemTypeObjects

Presenta una lista con los nombres concretos de los roles, los recursos o las organizaciones cuya solicitud futura de aprobación de elemento de trabajo piensa delegar el usuario. Este atributo es válido cuando el valor de workItemType es roleApproval, resourceApproval o organizationApproval.

Si no se especifica, este atributo establece de forma predeterminada la delegación de solicitudes futuras de aprobación de elemento de trabajo relacionadas con roles, recursos u organizaciones de los que el usuario es aprobador.

toType

Tipo al que se va a delegar. Los valores válidos son:

manager

delegateWorkItemsRule

selectedUsers

toUsers

Lista de los nombres de los usuarios en los que se delega (si toType es selectedUsers).

toRule

Especifica el nombre de la regla de evaluación que se empleará para determinar el conjunto de usuarios en el que se va a delegar (si toType es delegateWorkItemsRule).

startDate

Especifica la fecha de inicio de la delegación.

endDate

Especifica la fecha en la que termina la delegación.

Referencia de un objeto DelegateWorkItems View de un formulario

En el siguiente ejemplo de código se ilustra la forma de hacer referencia a un objeto delegado DelegateWorkItems View desde un formulario.

<Field name='delegates[*].workItemType'>

<Field name=’delegates[*].workItemTypeObjects’>

<Field name=’delegates[*].toType’>

<Field name='delegates[*].toUsers'>

<Field name=’delegates[*].toRule’>

<Field name='delegates[*].startDate'>

<Field name='delegates[*].endDate'>

donde los valores de índice (*) admitidos son valores workItemType.

Nombre

¿Editable?

Tipo

¿Requerido?

name

 

Cadena

status

 

Cadena

user

 

Cadena

userId

 

Cadena

attestorHint

 

Cadena

No

userView

 

GenericObject

reviewInstanceId

 

Cadena

reviewStartDate

 

Cadena

scanId

 

Cadena

scanInstanceId

 

Cadena

approvalWorkflowName

 

Cadena

organizationId

 

Cadena

attestorComments.name

 

Cadena

No

attestorComments.attestor

 

Cadena

No

attestorComments.time

 

Cadena

No

attestorComments.timestamp

 

Cadena

No

attestorComments.status

 

 

No

name

Identifica el derecho de usuario mediante un identificador exclusivo.

status

Especifica el estado del objeto de derecho de usuario. Los estados válidos incluyen PENDING (pendiente), ACCEPTED (aceptado), REJECTED (denegado), REMEDIATING (remediando) y CANCELLED (cancelado).

user

Identifica el nombre del WSUser asociado a este derecho.

userId

Especifica el ID del WSUser asociado.

attestorHint

Muestra al autenticador el truco (cadena) que ofrece la regla de determinación de revisión. Este truco sirve como consejo de la regla al autenticador.

userView

Contiene la vista de usuario que captura la operación de exploración de derechos de usuario. Esta vista contiene cero o más cuentas de recurso según la configuración del objeto de exploración de acceso.

reviewInstanceId

Especifica el ID de la instancia de la tarea PAR.

reviewStartDate

Indica la fecha de inicio (cadena) de la tarea PAR (en formato canónico).

scanId

Especifica el ID de la definición de tarea de exploración de acceso.

scanInstanceId

Especifica el ID de la instancia de tarea de exploración de acceso.

approvalWorkflowName

Identifica el nombre del flujo de trabajo que se debe ejecutar para aprobación. Este valor procede de la definición de tarea de exploración de acceso.

organizationId

Especifica el ID de la organización de WSUser en el momento de la exploración.

attestorComments

Muestra los registros de autenticación del derecho. Cada registro de autenticación indica una acción o instrucción efectuadas acerca del derecho, incluidas aprobación, denegación y reexploración.

attestorComments[timestamp].name

Indicación de tiempo utilizada para identificar este elemento en la lista.

attestorComments[timestamp].attestor

Identifica el nombre de WSUser del autenticador que comenta el derecho.

attestorComments[timestamp].time

Especifica la hora en que el autenticador autenticó este registro. Puede ser distinta a la indicación de tiempo.

attestorComments[timestamp].status

Indica el estado asignado por el autenticador. Puede ser cualquier cadena, pero suele indicar la acción realizada por el autenticador; por ejemplo, aprobar, denegar, reexplorar o remediar.

attestorComments[name].comment

Contiene comentarios introducidos por el autenticador.

Capítulo 6, XPRESS Language (Lenguaje XPRESS)

Este capítulo se ha actualizado sustancialmente. Consulte el archivo XPRESS.pdf, incluido en el mismo directorio que estas Notas de la versión.

Capítulo 8, HTML Display Components (Componentes de visualización HTML)

Cómo utilizar el código de ejemplo de objectSelector

  1. En el Identity Manager IDE, abra el objeto de formulario de usuario de la biblioteca del administrador.
  2. Añada el código siguiente a este formulario:
  3. <Include>

       <ObjectRef type='UserForm' name='Scalable Selection Library'/>

    </Include>

  4. Seleccione el campo accounts[Lighthouse].adminRoles en el campo AdministratorFields.
  5. Sustituya accounts[Lighthouse].adminRoles por la referencia siguiente:
  6. <FieldRef name='scalableWaveset.adminRoles'/>

  7. Guarde el objeto.
  8. Cuando después modifique un usuario y seleccione la ficha de seguridad, Identity Manager presentará el formulario personalizado. Cuando haga clic en ... se abrirá el componente Selector y aparecerá un campo de búsqueda. Utilice este campo para buscar roles de administración que empiecen con una cadena de texto y defina el campo en uno o varios valores.

    Para restaurar el formulario, importe el archivo $WSHOME/sample/formlib.xml mediante el uso del menú Configurar > Importar fichero de intercambio.

    Consulte la biblioteca de selección escalable del archivo sample/formlib.xml para ver otros ejemplos de cómo utilizar la plantilla objectSelector para administrar recursos y roles en entornos con muchos objetos.

  9. La sección relacionada con el componente TabPanel incluye la siguiente descripción de la propiedad validatePerTab: (ID-15501)

Apéndice A, Form and Process Mappings (Asignaciones de formularios y procesos)


Identity Manager Deployment Tools

Esta sección contiene información nueva y corregida relacionada con el documentoSun Java™ System Identity Manager Deployment Tools:

Novedades

El manual Identity Manager Deployment Tools contiene importante información nueva en los capítulos siguientes:

Actualizaciones

Esta sección contiene las correcciones y los anexos a la documentación Identity Manager Deployment Tools:


Ajuste, solución de problemas y mensajes de error en Identity Manager

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager Tuning, Troubleshooting, and Error Messages.


Implementación de Identity Manager Service Provider Edition

Esta sección contiene información nueva y corregida relacionada con el documento Sun Java™ System Identity Manager SPE Deployment.

Capítulo 5, Other Objects in Identity Manager SPE (Otros objetos en Identity Manager SPE)

Identity Manager Identity Manager SPE admite reglas de correlación y confirmación de vínculo.

Regla de correlación de vínculo

La opción linkTargets de la vista de IDMXUser permite al llamador especificar la lista de recursos que deberían ser objeto de la vinculación. Cuando se utilizan formularios, la lista puede presentarse como una propiedad de formulario con el mismo nombre. Las propiedades de formulario se incorporan a las opciones de la vista cuando se registra la vista de IDMXUser.

Una regla de correlación de vínculo selecciona las cuentas de recurso que puede tener el usuario. Para la vista de usuario, la regla de correlación devuelve una identidad, una lista de identidades o una asignación de opciones.

Si la regla devuelve una asignación de opciones, el controlador de la vista utiliza dicha asignación para buscar las cuentas de recurso y obtiene una lista de las identidades que cumplen esas opciones. Por ejemplo, la opción searchFilter del método getResourceObjects FormUtil sirve para transferir un filtro de búsqueda al adaptador de recursos LDAP.

En la regla de correlación de vínculo, el atributo authType debe estar configurado en SPERule y subtype en SUBTYPE_SPE_LINK_CORRELATION_RULE.

Regla de confirmación de vínculo

Una regla de confirmación de vínculo elimina todas las cuentas de recurso de la lista de posibles cuentas seleccionadas por la regla de correlación de vínculo. Para la vista de usuario y la lista de cuentas de recursos posibles, a regla de vínculo selecciona como máximo una cuenta de la lista. A la vista del usuario se accede mediante la ruta “view”, mientras que la lista de posibles cuentas se encuentra disponible en “candidates”.

Si la regla de correlación de vínculo selecciona una sola cuenta de recurso, no es necesaria la regla de confirmación de vínculo.


Nota

A diferencia de las reglas de confirmación de Identity Manager, sólo se llama a las reglas de confirmación de vínculo durante el proceso de vinculación.


En la regla de confirmación de vínculo, el atributo authType debe estar configurado en SPERule y subtype en SUBTYPE_SPE_LINK_CONFIRMATION_RULE.

API de LighthouseContext

A la clase SessionFactory se han añadido varios métodos útiles. La tabla de la página 16 debería actualizarse como sigue.

Tipo de conexión

Método

Descripción

Local anónima

getServerInternalContext()

Devuelve un contexto completamente autorizado sin autenticación.

Local autenticada

getSPESession(String user, EncryptedData password)

Crea una sesión para la interfaz de usuario de Service Provider.

Local autenticada

getSPESession(Map credentials)

Crea una sesión para la interfaz de usuario de Service Provider. La asignación especifica las credenciales del usuario, incluidas las claves y contraseñas de usuario.

Local preautenticada

getSPEPreAuthenticatedSession(String user)

Crea una sesión preautenticada para la interfaz de usuario de Service Provider.

Remota anónima

No aplicable

Este tipo de conexión sólo está disponible en SPML.

Remota autenticada

getSession(URL url, String user, EncryptedData pass)

Devuelve una sesión autenticada.


Ámbito de localización

Históricamente, en Identity Manager no se localizan las funciones y los objetos de recurso, porque son principalmente ejemplos que se cargan (mediante init.xml) durante la inicialización de Identity Manager y porque los atributos de tipo de objeto pueden variar de una a otra implementación de cliente según el nivel de personalización. A continuación se indican áreas que pueden aparecer en inglés: (ID-16349)


Utilización de helpTool

En Identity Manager 6.0 se ha añadido una nueva función que permite realizar búsquedas en la ayuda en línea y los archivos de documentación, que se encuentran en formato HTML. El motor de búsqueda se basa en la tecnología de motor de búsqueda SunLabs “Nova”.

El motor Nova funciona en dos fases: indexación y recuperación. Durante la fase de indexación se analizan los documentos introducidos y se crea un índice que se utiliza durante la fase de recuperación. Durante la recuperación es posible extraer “fragmentos” incluidos en el contexto en el que se encontraron los términos de la consulta. El proceso de recuperación de fragmentos requiere que los archivos HTML originales estén presentes, motivo por el cual deben residir en una ubicación del sistema de archivos a la que pueda acceder el motor de búsqueda.

helpTool es un programa de Java que realiza dos funciones básicas:

helpTool se ejecuta desde la línea de comandos como sigue:

$ java -jar helpTool.jar

usage: HelpTool

-d Destination directory

-h This help information

-i Directory or JAR containing input files, no wildcards

-n Directory for Nova index

-o Output file name

-p Indexing properties file

Reconstrucción/recreación del índice de la ayuda en línea

Los archivos HTML de la ayuda en línea se empaquetan en un archivo JAR. Para que el motor de búsqueda funcione, debe extraerlos a un directorio. Realice el siguiente procedimiento:

  1. Descomprima helpTool en un directorio temporal. (Detalles TBD)
  2. En este ejemplo, los archivos se van a extraer en /tmp/helpTool.

  3. En el intérprete de comandos de UNIX o en la ventana de comandos de Windows, cambie el directorio a la ubicación del contenedor Web en el que se ha implementado la aplicación Identity Manager.
  4. Por ejemplo, el siguiente podría ser un directorio de Sun Java System Application Server:

    /opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm

  5. Cambie el directorio de trabajo actual a help/.

  6. Nota

    Es importante ejecutar helpTool desde este directorio. De lo contrario, el índice no se generará correctamente. Además, debería borrar los archivos de índice anteriores eliminando el contenido del subdirectorio index/help/.


  7. Recopile la siguiente información para los argumentos de la línea de comandos:
    • Directorio de destino: html/help/en_US

    • Nota

      Utilice la cadena de configuración regional adecuada.


    • Archivo de entrada: ../WEB-INF/lib/idm.jar
    • Directorio de índice Nova: index/help
    • Nombre de archivo de salida: index_files_help.txt

    • Nota

      El nombre del archivo no es importante, pero la herramienta se cerrará si ya existe.


    • Archivo de propiedades de indexación: index/index.properties
  8. Ejecute el comando siguiente:
  9. $ java -jar /tmp/helpTool/helpTool.jar -d html/help/en_US -i ../
    WEB-INF/lib/idm.jar -n index/help -o help_files_help.txt -p index/index.properties

    Extracted 475 files.

    [15/Dec/2005:13:11:38] PM Init index/help AWord 1085803878
    [15/Dec/2005:13:11:38] PM Making meta file: index/help/MF: 0
    [15/Dec/2005:13:11:38] PM Created active file: index/help/AL
    [15/Dec/2005:13:11:40] MP Partition: 1, 475 documents, 5496 terms.
    [15/Dec/2005:13:11:40] MP Finished dumping: 1 index/help 0.266
    [15/Dec/2005:13:11:40] IS 475 documents, 6.56 MB, 2.11 s, 11166.66 MB/h
    [15/Dec/2005:13:11:40] PM Waiting for housekeeper to finish
    [15/Dec/2005:13:11:41] PM Shutdown index/help AWord 1085803878

Reconstrucción/recreación del índice de la documentación

Para reconstruir o volver a crear el índice de la documentación, realice el siguiente procedimiento:

  1. Descomprima helpTool en un directorio temporal. (Detalles TBD)
  2. En este ejemplo, los archivos se van a extraer en /tmp/helpTool.

  3. En el intérprete de comandos de UNIX o en la ventana de comandos de Windows, cambie el directorio a la ubicación del contenedor Web en el que se ha implementado la aplicación Identity Manager.
  4. Por ejemplo, el siguiente podría ser un directorio de Sun Java System Application Server:

    /opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm

  5. Cambie el directorio de trabajo actual a help/.

  6. Nota

    helpTool se debe ejecutar desde este directorio. De lo contrario, el índice no se generará correctamente. Además, debería borrar los archivos de índice anteriores eliminando el contenido del subdirectorio index/docs/.


  7. Recopile la siguiente información para los argumentos de la línea de comandos:
    • Directorio de destino: html/docs
    • Archivos de entrada: ../doc/HTML/en_US

    • Nota

      La herramienta copiará el directorio en_US/ y los subdirectorios en el destino.


    • Directorio de índice Nova: index/docs
    • Nombre de archivo de salida: index_files_docs.txt

    • Nota

      El nombre del archivo no es importante, pero la herramienta se cerrará si ya existe.


    • Archivo de propiedades de indexación: index/index.properties
  8. Ejecute el comando siguiente:
  9. $ java -jar /tmp/helpTool/helpTool.jar -d html/docs -i ../doc/HTML/en_US -n index/docs -o help_files_docs.txt -p index/index.properties

    Copied 84 files.

    Copied 105 files.

    Copied 1 files.

    Copied 15 files.

    Copied 1 files.

    Copied 58 files.

    Copied 134 files.

    Copied 156 files.

    Copied 116 files.

    Copied 136 files.

    Copied 21 files.

    Copied 37 files.

    Copied 1 files.

    Copied 13 files.

    Copied 2 files.

    Copied 19 files.

    Copied 20 files.

    Copied 52 files.

    Copied 3 files.

    Copied 14 files.

    Copied 3 files.

    Copied 3 files.

    Copied 608 files.

    [15/Dec/2005:13:24:25] PM Init index/docs AWord 1252155067

    [15/Dec/2005:13:24:25] PM Making meta file: index/docs/MF: 0

    [15/Dec/2005:13:24:25] PM Created active file: index/docs/AL

    [15/Dec/2005:13:24:28] MP Partition: 1, 192 documents, 38488 terms.

    [15/Dec/2005:13:24:29] MP Finished dumping: 1 index/docs 0.617

    [15/Dec/2005:13:24:29] IS 192 documents, 14.70 MB, 3.81 s, 13900.78 MB/h

    [15/Dec/2005:13:24:29] PM Waiting for housekeeper to finish

    [15/Dec/2005:13:24:30] PM Shutdown index/docs AWord 1252155067