updateBPMExternalECM comando

Modifica in linea

Tradizionale:
Quando si aggiungono o si rimuovono membri del cluster in Business Automation Workflow o FileNet® Content Manager, utilizzare il comando updateBPMExternalECM. Questo comando riconcilia la modifica dal vecchio elenco di membri cluster e server al nuovo elenco di membri cluster e server. Quando si aggiorna il sistema esterno Content Platform Engine è necessario eseguire il comando updateBPMExternalECM per scaricare le librerie Content Platform Engine librerie sul Business Automation Workflow server. Consultare l'argomento correlato Aggiornamento dei file del connettore client Content Platform Engine. È necessario eseguire questo comando solo se Business Automation Workflow è configurato con un server ECM esterno.

Nota: questo comando conserva l'impostazione iniziale per il supporto degli oggetti di contenuto. Tuttavia, se la versione di Content Platform Engine è precedente a 5.5.3, il comando disabilita automaticamente il supporto degli oggetti di contenuto. Se il supporto per gli oggetti di contenuto è disabilitato e si aggiorna Content Platform Engine alla versione 5.5.3 o successiva, è possibile abilitare manualmente il supporto per gli oggetti di contenuto utilizzando il comando BPMConfig e i parametri -update e -enableContentObjectSupport , come descritto nell'argomento Programma di utilità della riga comandi BPMConfig. È anche possibile utilizzare lo stesso comando e parametro per disabilitare il supporto degli oggetti di contenuto indipendentemente dalla versione di Content Platform Engine .

Se si utilizza Content Platform Engine come contenitore per l'integrazione con Business Automation Workflow e la versione di Content Platform Engine è 5.5.3, è necessario eseguire il comando BPMConfig e i parametri -update e -enableContentObjectSupport per disabilitare il supporto degli oggetti di contenuto.

Prerequisiti

Il comando updateBPMExternalECM viene eseguito utilizzando l'oggetto AdminTask del client di script wsadmin. Devono essere soddisfatte le condizioni seguenti:

In un ambiente di distribuzione di rete, eseguire il comando sul nodo del gestore distribuzione. In un ambiente a server singolo, eseguire il comando sul server autonomo.
In un ambiente di distribuzione di rete, uno o più membri del cluster delle applicazioni devono essere in esecuzione. In un ambiente a server singolo, il server autonomo deve essere in esecuzione.
Eseguire il comando in modalità connessa con un ID utente che dispone dei privilegi del programma di configurazione WebSphere Application Server . Non utilizzare l'opzione wsadmin -conntype none .

Ubicazione

Avviare il client di script wsadmin dalla directory dmgr_profile_root/bin . Il comando updateBPMExternalECM non scrive in un file di log, ma il client di script wsadmin scrive sempre un file di log profile_root/logs/wsadmin.traceout in cui si trovano le tracce di stack delle eccezioni e altre informazioni.

Sintassi

updateBPMExternalECM
[-de deployment_environment_name]
-ceUrl external_FileNet_content_engine_url
-designObjectStoreName external_FileNet_design_object_store_name 
-clientDownloadServicePort port_number
-clientDownloadServiceHostname CPE_server_hostname
-backLinkUrl bpm_url
-targetObjectStoreName external_FileNet_target_object_store_name
 22.0.2  -graphQLEndpoint content_services_graphql_endpoint

Parametri

-de nome_ambiente_distribuzione

Un parametro che specifica il nome dell'ambiente di distribuzione corrente. Se nella cella WebSphere è presente un solo ambiente di distribuzione, è possibile omettere questo parametro.

-ceUrl external_FileNet_content_engine_url

Un parametro obbligatorio che specifica l'indirizzo esterno FileNet Content Manager URL esterno. Per una configurazione ad alta disponibilità che utilizza un cluster di application server, vedere Content Platform Engine in un cluster di application server utilizzando il trasporto EJB.

Se IBM® Business Automation Workflow e Content Platform Engine si trovano nella stessa cella WebSphere® Application Server , è possibile utilizzare la notazione URI corbaloc più semplice per questo parametro, ad esempio corbaloc:rir:/cell/clusters/your_websphere_cluster_name/FileNet/Engine. Se si utilizza questa notazione, è necessario specificare il parametro clientDownloadServiceHostname per scaricare i file Content Platform Engine client .jar dal server Content Platform Engine server.

-designObjectStoreName external_FileNet_design_object_store_name

Un parametro obbligatorio che specifica il nome dell'archivio oggetti di progettazione di Content Platform Engine esterno.

-clientDownloadServicePort numero_porta

Un parametro obbligatorio se si specifica -ceUrl. Questo parametro fornisce il numero di porta HTTP o HTTPS del server in cui viene distribuita l'applicazione esterna Content Platform Engine esterna è distribuita. I numeri di porta predefiniti sono 9080 e 9443. Se si utilizza il sito V19.0.0.2 o successivo, si deve utilizzare il numero di porta 9443 di HTTPS.

Per verificare la connessione al servlet Client Download, inserire il seguente URL in un browser web:

http://host_name:port_number/clientDownload?command=getVersion

Questo parametro controlla se i file JAR del client Content Platform Engine devono essere aggiornati. Se aggiorna i file JAR, elenca i file aggiornati. Copiare i file dal gestore distribuzione nella stessa directory di installazione su ciascun nodo personalizzato nell'ambiente di distribuzione.

-clientDownloadServiceHostname nomehost_server_CPU

Un parametro obbligatorio se si specifica -ceURL utilizzando un URI corbaloc. Questo parametro specifica il nome host su cui è in esecuzione il server Content Platform Engine . Se questo parametro non viene specificato, il primo nome host estratto dal parametro -ceUrl viene utilizzato per connettersi a Content Platform Engine.

-backLinkUrl url_bpm

Un parametro opzionale che specifica l'indirizzo URL per connettersi dal server esterno al server esterno FileNet Content Manager al server esterno Business Automation Workflow server. Utilizzare questo parametro solo se è stato aggiunto o rimosso un membro del cluster sul server Business Automation Workflow è stato aggiunto o rimosso.

Business Automation Workflow calcola automaticamente URL, quindi specificate URL solo se URL calcolato non è corretto. Se in precedenza è stato inserito un URL ma si desidera tornare a calcolare automaticamente il URL, inserire "".

Se non è stato specificato il parametro -backLinkUrl quando è stata eseguita l'attività di gestione setBPMExternalECM , non è necessario specificarla con l'attività di gestione updateBPMExternalECM . L'elenco dei server membri del cluster Business Automation Workflow disponibili viene gestito automaticamente.
Se è stato specificato un elenco di server membri del cluster utilizzando il parametro -backLinkUrl quando è stata eseguita l'attività di gestione setBPMExternalECM , specificare questo stesso parametro con l'attività di gestione updateBPMExternalECM . L'utente è responsabile dell'aggiornamento dell'elenco di server membro del cluster Business Automation Workflow disponibili.

-targetObjectStoreName external_FileNet_target_object_store_name: Un parametro facoltativo che specifica l'archivio oggetti di destinazione predefinito (TOS) per l'area progetto predefinita. Se si dispone di più archivi oggetti di destinazione, è necessario designarne uno come predefinito.

22.0.2

-graphQLEndpoint content_services_graphql_endpoint: Un parametro che specifica l'endpoint di Content Services GraphQL per il toolkit Content Services . Se si desidera utilizzare il toolkit Content Services, questo parametro è obbligatorio.

Esempi

Nota: gli esempi sono solo a scopo illustrativo. Includono valori variabili e non sono studiati per essere riutilizzati come frammenti di codice.

Il seguente esempio Jython utilizza il comando updateBPMExternalECM per aggiornare l'elenco corrente di membri cluster e server se un membro cluster è stato aggiunto o rimosso dal sito FileNet Content Manager .

wsadmin -user admin -password admin -lang jython
wsadmin>print AdminTask.updateBPMExternalECM(['-clientDownloadServicePort', '9444', '-de', 'De1', '-ceUrl', 'iiop://MigWPS7-856-T01.cn.ibm.com:2810/FileNet/Engine', '-designObjectStoreName', 'bpmdos'])
wsadmin>AdminConfig.save()

Se questo comando ha copiato i file JAR dall'archivio oggetti esterno al profilo del gestore distribuzione, elenca automaticamente i file aggiornati. Copiare i file dal gestore distribuzione nella stessa directory di installazione su ciascun nodo personalizzato nell'ambiente di distribuzione.

Il seguente esempio Jython è simile all'esempio precedente. Tuttavia, questo esempio include il parametro -clientDownloadServiceHostname , che è possibile utilizzare per specificare il nome host del server Content Platform Engine quando è diverso dal nome host estratto dal parametro -ceUrl .

wsadmin -user admin -password admin -lang jython
wsadmin>print AdminTask.updateBPMExternalECM(['-clientDownloadServicePort', '9444', '-clientDownloadServiceHostname', 'CPE_server_hostname', '-de', 'De1', '-ceUrl', 'iiop://MigWPS7-856-T01.cn.ibm.com:2810/FileNet/Engine', '-designObjectStoreName', 'bpmdos'])
wsadmin>AdminConfig.save()

Il seguente esempio Jython utilizza il comando updateBPMExternalECM per aggiornare l'elenco corrente di membri cluster e server. Questa operazione viene eseguita se un membro del cluster è stato aggiunto o rimosso dal sito Business Automation Workflow e il parametro -backlinkUrl è stato esplicitamente impostato.

wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.updateBPMExternalECM(['-de', 'De1', '-backLinkUrl', 'corbaloc:iiop:BPM.mycompany.com:9010', '-ceUrl','iiop://MigWPS7-856-T01.cn.ibm.com:2810/FileNet/Engine', '-designObjectStoreName', 'bpmdos'])
wsadmin>AdminConfig.save()

Esempio di parametro ceUrl URL :

iiop://external FileNet Content Engine server:2809/FileNet/Engine