Configuración de adaptadores personalizados para repositorios federados utilizando wsadmin

Puede utilizar el lenguaje de scripts Jython o Jacl con la herramienta wsadmin para definir adaptadores personalizados en el archivo de configuración de repositorios federados.

Antes de empezar

Concluya WebSphere Application Server y la ventana de mandatos de wsadmin.

Acerca de esta tarea

Realice los pasos siguientes para añadir un adaptador personalizado a cualquier archivo de configuración de repositorios federados y a cualquier dominios definido en el archivo de configuración.

Los ejemplos siguientes utilizan el repositorio SampleFileRepository como identificador para el repositorio personalizado.

Nota: Si desea información adicional sobre los mandatos que hay que utilizar para este tema, consulte el grupo de mandatos IdMgrRepositoryConfig.

Procedimiento

  1. Entre el mandato siguiente para iniciar la herramienta wsadmin:
    wsadmin –conntype none
  2. Utilice el mandato createIdMgrCustomRepository para añadir un repositorio personalizado y para especificar la clase del adaptador.

    El siguiente ejemplo configura un repositorio personalizado para utilizar la clase com.ibm.ws.wim.adapter.sample.SampleFileAdapter y establece el repositorio SampleFileRepository como el identificador.

    En Jython:
    AdminTask.createIdMgrCustomRepository('-id SampleFileRepository -adapterClassName com.ibm.ws.wim.adapter.sample.SampleFileAdapter')
    En Jacl:
    createIdMgrCustomRepository {-id SampleFileRepository -adapterClassName com.ibm.ws.wim.adapter.sample.SampleFileAdapter}
  3. Copie el archivo vmmsampleadapter.jar que se proporciona en app_server_root/lib.
  4. Inhabilite la paginación en la configuración de repositorio común. Establezca el parámetro supportPaging del mandato updateIdMgrRepository en false para inhabilitar la paginación.
    Nota: Debe realizar este paso porque el adaptador de ejemplo no soporta la paginación.

    Los ejemplos siguientes utilizan el repositorio SampleFileRepository como identificador para el repositorio personalizado.

    Utilizando Jython:
    AdminTask.updateIdMgrRepository('-id SampleFileRepository -supportPaging false')
    Utilizando Jacl:
    $AdminTask updateIdMgrRepository {-id SampleFileRepository -supportPaging
    false}
    Nota: Aparecerá un aviso hasta que la configuración del repositorio de ejemplo esté completa.
  5. Añada las propiedades personalizadas necesarias para el adaptador. Utilice el mandato setIdMgrCustomProperty repetidamente para añadir varias propiedades. Utilice este mandato una vez por propiedad para añadir varias propiedades a la configuración. Debe utilizar los parámetros name y value para añadir la propiedad personalizada para el repositorio especificado. Por ejemplo, para añadir una propiedad personalizada de fileName, entre el mandato siguiente.
    Utilizando Jython:
    AdminTask.setIdMgrCustomProperty('-id SampleFileRepository -name fileName 
    -value "c:\sampleFileRegistry.xml"')
    Utilizando Jacl:
    $AdminTask setIdMgrCustomProperty {-id SampleFileRepository -name fileName
    -value "c:\sampleFileRegistry.xml"}
  6. Añada una entrada base a la configuración de adaptador. Utilice el mandato addIdMgrRepositoryBaseEntry para especificar el nombre de la entrada base del repositorio especificado. Por ejemplo:
    Utilizando Jython:
    AdminTask.addIdMgrRepositoryBaseEntry('-id SampleFileRepository -name
    o=sampleFileRepository')
    Utilizando Jacl:
    $AdminTask addIdMgrRepositoryBaseEntry {-id SampleFileRepository -name
    o=sampleFileRepository}
  7. Utilice el mandato addIdMgrRealmBaseEntry para añadir la entrada base al dominios, lo cual enlaza el dominios con el repositorio:
    En Jython:
    AdminTask.addIdMgrRealmBaseEntry('-name defaultWIMFileBasedRealm -baseEntry o=sampleFileRepository')
    Utilizando Jacl:
    $AdminTask addIdMgrRealmBaseEntry {-name defaultWIMFileBasedRealm -baseEntry o=sampleFileRepository}
  8. Guarde los cambios de configuración. Entre los mandatos siguientes para guardar la nueva configuración y cerrar la herramienta wsadmin.
    En Jython:
    AdminConfig.save()  
    exit
    Utilizando Jacl:
    $AdminConfig save
    exit
    El ejemplo siguiente visualiza el texto completo del archivo wimconfig.xml recién revisado:
    Nota: El archivo de configuración de repositorios federados, wimconfig.xml, se encuentra en el directorio app_server_root/profiles/profile_name/config/cells/cell_name/wim/config.
    <!--
      Comienzo Copyright
    
      Material bajo licencia - Propiedad de IBM
    
      gestor de miembros virtuales
    
      (C) Copyright IBM Corp. 2005 Reservados todos los derechos.
    
      Derechos restringidos de los usuarios del gobierno de EE.UU. : utilización, duplicación o 
      divulgación restringidas por el contrato GSA ADP Schedule con IBM Corp.
    
      Final Copyright
    -->
    <sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:config="http://www.ibm.com/websphere/wim
    /config" xmlns:sdo="commonj.sdo">
      <config:configurationProvider maxPagingResults="500" maxSearchResults="4500" 
    maxTotalPagingResults="1000" 
    pagedCacheTimeOut="900" pagingEntityObject="true" searchTimeOut="600000">
        <config:dynamicModel xsdFileName="wimdatagraph.xsd"/>
        <config:supportedEntityTypes defaultParent="o=defaultWIMFileBasedRealm" name="Group">
          <config:rdnProperties>cn</config:rdnProperties>
        </config:supportedEntityTypes>
        <config:supportedEntityTypes defaultParent="o=defaultWIMFileBasedRealm" name="OrgContainer">
          <config:rdnProperties>o</config:rdnProperties>
          <config:rdnProperties>ou</config:rdnProperties>
          <config:rdnProperties>dc</config:rdnProperties>
          <config:rdnProperties>cn</config:rdnProperties>
        </config:supportedEntityTypes>
        <config:supportedEntityTypes defaultParent="o=defaultWIMFileBasedRealm" name="PersonAccount">
          <config:rdnProperties>uid</config:rdnProperties>
        </config:supportedEntityTypes>
        <config:repositories xsi:type="config:FileRepositoryType" adapterClassName="com.ibm.
        ws.wim.adapter.file.was.FileAdapter" 
    id="InternalFileRepository" supportPaging="false" supportSorting="false" messageDigestAlgorithm="SHA-1">
          <config:baseEntries name="o=defaultWIMFileBasedRealm"/>
        </config:repositories>
        <config:repositories adapterClassName="com.ibm.ws.wim.adapter.sample.SampleFileAdapter" 
        id="SampleFileRepository">
          <config:CustomProperties name="fileName" value="c:\sampleFileRegistry.xml"/>
          <config:baseEntries name="o=sampleFileRepository"/>
        </config:repositories>
        <config:realmConfiguration defaultRealm="defaultWIMFileBasedRealm">
          <config:realms delimiter="@" name="defaultWIMFileBasedRealm" securityUse="active">
            <config:participatingBaseEntries name="o=defaultWIMFileBasedRealm"/>
            <config:participatingBaseEntries name="o=sampleFileRepository"/>
            <config:uniqueUserIdMapping propertyForInput="uniqueName" propertyForOutput="uniqueName"/>
            <config:userSecurityNameMapping propertyForInput="principalName" propertyForOutput="principalName"/>
            <config:userDisplayNameMapping propertyForInput="principalName" propertyForOutput="principalName"/>
            <config:uniqueGroupIdMapping propertyForInput="uniqueName" propertyForOutput="uniqueName"/>
            <config:groupSecurityNameMapping propertyForInput="cn" propertyForOutput="cn"/>
            <config:groupDisplayNameMapping propertyForInput="cn" propertyForOutput="cn"/>
          </config:realms>
        </config:realmConfiguration>
    </config:configurationProvider></sdo:datagraph>
  9. Reinicie el servidor de aplicaciones.

Icon that indicates the type of topic Task topic



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