BPMSyncExistingUsersTask comando

Modifica in linea

Tradizionale:
Utilizzare il comando BPMSyncExistingUsersTask per sincronizzare gli utenti esistenti tra il registro utenti di WebSphere® Application Server e il database IBM® Business Automation Workflow . Questo comando aggiorna le informazioni per gli utenti esistenti nel database Business Automation Workflow , ma non importa nuovi utenti dal registro utenti nel database. È possibile utilizzare questo comando anche per sincronizzare lo stato utente per gli utenti nel database Business Automation Workflow con la disponibilità utente nel registro utente. Ad esempio, se gli utenti sono stati eliminati dal Registro utenti, il comando contrassegna tali utenti come inattivi nel database Business Automation Workflow .

Puoi anche sincronizzare gli utenti esistenti utilizzando lo script syncExistingUsers.[bat|sh] , come descritto in Sincronizzazione degli utenti o richiamando l'API REST descritta in Sincronizzazione degli utenti tra il database BPM e il registro utenti.

La modalità di esecuzione del comando di sincronizzazione dipende dal fatto che i repository federati (VMM) siano configurati per la sicurezza WebSphere Application Server :
Repository non federati
L'API del Registro utenti di WebSphere Application Server viene utilizzata per eseguire i comandi.
Repository federati
L'API dei repository federati viene utilizzata per eseguire i comandi. Le prestazioni di questa API sono notevolmente migliori rispetto a quelle dell'API del registro utenti. Il numero di chiamate VMM utilizzate per sincronizzare le informazioni utente dipende dal comando e dal numero di utenti disponibili nel database Business Automation Workflow .
Nel caso di syncExistingUsers, per impostazione predefinita, se si dispone di meno di 1000 utenti disponibili nel database Business Automation Workflow , viene inviata una chiamata VMM per utente per sincronizzare i dati. Se sono disponibili più di 1000 utenti nel database Business Automation Workflow , viene inviata una chiamata per tutti gli utenti. Questo valore di soglia è configurabile.
Attenzione: se la chiamata per tutti gli utenti non restituisce tutti gli utenti disponibili nel registro utenti, effettuare una delle seguenti operazioni:
  • Forzare l'utilizzo di una chiamata VMM per utente modificando il valore di soglia per riflettere il numero effettivo di utenti nel registro utenti.
  • Contattare l'amministratore LDAP per modificare la configurazione LDAP in modo che tutti gli utenti possano essere richiamati in una chiamata di ricerca LDAP.

L'output del comando contiene il numero di utenti sincronizzati.

Il comando BPMSyncExistingUsersTask viene eseguito utilizzando l'oggetto AdminTask del client di script wsadmin.

Ubicazione

Avviare il client di script wsadmin dalla directory install_root/profiles/deployment_manager_profile/bin .

Sintassi

BPMSyncExistingUsersTask
[-userState sync|any_other_value] [-userIds [username_1 username_2 ... username_n]]

Parametri

Il comando non dispone di parametri in Business Automation Workflow Versione 8.5.7.0 Cumulative Fix 2016.06 e versioni precedenti.

-userState sync|any_other_value
Questo è un parametro facoltativo che aggiorna lo stato utente per gli utenti nel database Business Automation Workflow .
  • Gli utenti che sono stati eliminati dal registro utenti diventano non attivi nel database Business Automation Workflow .
  • Gli utenti riattivati nel registro utenti diventano attivi nel database Business Automation Workflow .
Se viene fornito un altro valore, lo stato utente non viene aggiornato.
-userIds [username_1 username_2 ... username_n]
Questo è un parametro facoltativo che specifica l'elenco di nomi utente da elaborare. Se il parametro non è presente, vengono elaborati tutti gli utenti del database Business Automation Workflow .

Esempi

Il seguente esempio utilizza il comando BPMSyncExistingUsersTask per aggiornare tutti gli utenti esistenti.
wsadmin -conntype SOAP -port 8880 -host PC1.mycompany.com -user admin -password admin -lang jython

wsadmin>AdminTask.BPMSyncExistingUsersTask('[-userState sync]')
Il seguente esempio utilizza il comando BPMSyncExistingUsersTask per aggiornare gli ID utente username_1 e username_2.
wsadmin -conntype SOAP -port 8880 -host PC1.mycompany.com -user admin -password admin -lang jython

wsadmin>AdminTask.BPMSyncExistingUsersTask('[-userState sync, -userIds [username_1 username_2]]')

Configurazione

Connessioni SOAP
Se si utilizza una connessione SOAP, il completamento del comando potrebbe richiedere più tempo del valore di timeout SOAP specificato. Sebbene il comando continui ad essere eseguito fino al termine, è possibile che venga visualizzata l'eccezione java.net.SocketTimeoutException: Read timed out nel file systemOut.log . Per evitare questa eccezione, impostare un valore più alto per la proprietà com.ibm.SOAP.requestTimeout nel file profile_root/properties/soap.client.props . Per disabilitare i timeout, impostare il valore della proprietà su 0.
Ottimizzazione VMM
Se si utilizza una chiamata VMM per tutti gli utenti, ottimizzare la configurazione VMM per ciascuno dei repository LDAP associati nel file wimconfig.xml . In particolare, selezionare un'impostazione appropriata per la proprietà configurationProvider->maxSearchResults e considerare l'adattamento del valore per le proprietà ldapServers->connectTimeout e attributesCache->cacheSize . Per ulteriori informazioni sull'ottimizzazione di VMM, fare riferimento al Knowledge Center WebSphere Application Server Network Deployment .
Soglia di richiamo utente
In base al numero di utenti disponibili nel database Business Automation Workflow , la proprietà di configurazione threshold-for-existing-user-retrieval-mode determina se le chiamate al VMM vengono inviate per ciascun utente o come una sola chiamata per tutti gli utenti. Il valore predefinito è 1000 utenti disponibili.
  • Per 1000 o meno utenti disponibili, le chiamate vengono inviate per ogni utente (utente per utente).
  • Per più di 1000 utenti, viene inviata una chiamata per tutti gli utenti.
Il valore scelto per la proprietà della soglia dipende dalle prestazioni dell'ambiente. Ad esempio, se si dispone di 1500 utenti nel database Business Automation Workflow ed è più rapido richiamare tali utenti da VMM per utente rispetto a una chiamata VMM per tutti gli utenti, impostare il valore su almeno 1500. Controllare anche le seguenti impostazioni di configurazione:
  • Il valore della proprietà configurationProvider->maxSearchResults è appropriato per il valore della proprietà della soglia
  • La configurazione del repository utente associato, ad esempio, LDAP, non limita il numero totale di risultati della ricerca restituiti.
Per modificare il valore della proprietà, aggiungere il seguente elemento con il valore appropriato al file 100Custom.xml per la topologia.
<common merge="mergeChildren">
   <security>
      <threshold-for-existing-user-retrieval-mode merge="replace">1000</threshold-for-existing-user-retrieval-mode>
   </security>
</common>
Per informazioni su come individuare il file 100Custom.xml , consultare Ubicazione dei file di configurazione 100Custom.