Comando addSCMConnectivityProvider

Modifica in linea


Utilizzare il comando addSCMConnectivityProvider per aggiungere un provider di connettività SCM (Service Connectivity Management).

Un provider di connettività è una partizione logica dell'ESB esposta tramite il protocollo di gestione della connettività del servizio. Definisce la destinazione (server o cluster) a cui verranno distribuiti i moduli del gateway proxy quando viene creato un proxy del gruppo Service Federation Management su tale provider di connettività. Definisce anche le proprietà che verranno utilizzate per le destinazioni proxy create su tali proxy di gruppo.

Utilizzare il comando riportato di seguito per elencare tutti i comandi di gestione di Service Connectivity Management:
print AdminTask.help('SCMAdminCommands')

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

Prerequisiti

Devono essere soddisfatte le condizioni seguenti:
  • Il comando deve essere eseguito sul nodo del gestore distribuzione.
  • Se il gestore distribuzione è arrestato, utilizzare l'opzione wsadmin -conntype none per eseguire il comando in modalità disconnessa.
  • Se il gestore distribuzione è in esecuzione, è necessario connettersi con un ID utente che dispone dei privilegi del configuratore WebSphere Application Server . Non utilizzare l'opzione wsadmin -conntype none .

Ubicazione

Avviare il client di script wsadmin dalla directory deployment_manager_profile/bin . Il comando addSCMConnectivityProvider 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 troveranno le tracce di stack delle eccezioni e altre informazioni.

Sintassi

addSCMConnectivityProvider
-name connectivityProviderName
-node nodeName -server serverName
-cluster clusterName
-proxyHostHTTP httpHost
-proxyPortHTTP httpPort
-proxyHostHTTPS httpsHost
-proxyPortHTTPS httpsPort
[-description connectivityProviderDescription]
[-contact contactName]
[-organization organizationName]
[-location locationName]
[-authAlias alias]
[-repertoire sslConfig]

Parametri

-nome connectivityProviderName
Un parametro obbligatorio che specifica il nome del provider di connettività come una stringa. Deve essere univoco all'interno della cella. Se il nome esiste già, viene generata un'eccezione. Il nome, la descrizione, il contatto, l'organizzazione e l'ubicazione saranno visibili agli utenti della console Service Federation Management.
-node nodeName
Un parametro obbligatorio che specifica il nome del nodo che ospita il server su cui deve essere distribuito il modulo gateway proxy per un proxy di gruppo. Per aggiungere un server come provider di connettività, è necessario specificare sia un server che un nodo.
-server serverName
Un parametro obbligatorio che specifica il nome del server su cui deve essere distribuito il modulo gateway proxy per un proxy di gruppo. Per aggiungere un server come provider di connettività, è necessario specificare sia un server che un nodo.
-cluster clusterName
Un parametro obbligatorio che specifica il nome del cluster in cui deve essere distribuito il modulo gateway proxy per un proxy di gruppo. Per aggiungere un cluster come provider di connettività, è necessario specificare solo il nome del cluster.
-proxyHostHTTP httpHost
Un parametro obbligatorio che specifica il nome host che verrà restituito per l'endpoint di una destinazione proxy non sicura. Deve essere l'host che i client del servizio Web in un altro dominio utilizzeranno per accedere al proxy, tenendo conto dei server Web e di altri componenti di rete.
-proxyPortHTTP httpPort
Un parametro obbligatorio che specifica la porta che verrà restituita per l'endpoint di una destinazione proxy non sicura. Deve essere l'host che i client del servizio Web in un altro dominio utilizzeranno per accedere al proxy, tenendo conto dei server Web e di altri componenti di rete.
-proxyHostHTTPS httpsHost
Un parametro obbligatorio che specifica il nome host che verrà restituito per l'endpoint di una destinazione proxy sicura. Deve essere l'host che i client del servizio Web in un altro dominio utilizzeranno per accedere al proxy, tenendo conto dei server Web e di altri componenti di rete.
-proxyPortHTTPS httpsPort
Un parametro obbligatorio che specifica la porta che verrà restituita per l'endpoint di una destinazione proxy sicura. Deve essere l'host che i client del servizio Web in un altro dominio utilizzeranno per accedere al proxy, tenendo conto dei server Web e di altri componenti di rete.
-descrizione connectivityProviderDescription
Un parametro obbligatorio che fornisce una breve descrizione del provider di connettività. Il valore predefinito è una stringa vuota. Il nome, la descrizione, il contatto, l'organizzazione e l'ubicazione saranno visibili agli utenti della console Service Federation Management.
-contact contactName
Un parametro obbligatorio che specifica il nome di una persona di contatto per il provider di connettività. Il valore predefinito è una stringa vuota. Il nome, la descrizione, il contatto, l'organizzazione e l'ubicazione saranno visibili agli utenti della console Service Federation Management.
-organization organizationName
Un parametro obbligatorio che specifica il nome dell'organizzazione proprietaria per il provider di connettività. Il valore predefinito è una stringa vuota. Il nome, la descrizione, il contatto, l'organizzazione e l'ubicazione saranno visibili agli utenti della console Service Federation Management.
-location locationName
Un parametro obbligatorio che specifica l'ubicazione per il provider di connettività. Il valore predefinito è una stringa vuota. Il nome, la descrizione, il contatto, l'organizzazione e l'ubicazione saranno visibili agli utenti della console Service Federation Management.
-authAlias alias
Un parametro opzionale che specifica l'alias di autenticazione che fornirà le credenziali di autenticazione di base utilizzate per recuperare i documenti WSDL tramite HTTP dal registro dei servizi associato al dominio del fornitore di connettività. Questo parametro non deve essere specificato se non è richiesta l'autenticazione di base per connettersi al registro del servizio.
-repertoire sslConfig
Un parametro opzionale che specifica la configurazione SSL utilizzata per recuperare i documenti WSDL tramite HTTP da un registro di servizi sicuro associato al dominio del fornitore di connettività. Se questo parametro non viene specificato, verrà utilizzata la configurazione SSL predefinita del server.

Esempi

Il seguente esempio Jython aggiunge un provider di connessione denominato myProvider associato al server server1 sul nodo cpNode in cui i client del servizio Web accedono direttamente a tale server:

wsadmin>AdminTask.addSCMConnectivityProvider( ['-name', 'myProvider, 
'-node', 'cpNode', '-server', 'server1, '-proxyHostHTTP', 'webserver.example.com', 
'-proxyPortHTTP, '80', '-proxyHostHTTPS', 'webserver.example.com', 
'-proxyPortHTTPS', '443' ])

Il seguente esempio Jython aggiunge un fornitore di connettività di nome myScalableProvider associato al cluster cpCluster dove i client dei servizi web accedono ai server di quel cluster tramite un server web:

wsadmin>AdminTask.addSCMConnectivityProvider( ['-name', 'myScalableProvider',
'-cluster', 'cpCluster', '-proxyHostHTTP', 'webserver.example.com', 
'-proxyPortHTTP', '80', '-proxyHostHTTPS', 'webserver.example.com', 
'-proxyPortHTTPS', '443'] )

Il seguente esempio Jython illustra l'utilizzo dei parametri facoltativi per specificare ulteriori informazioni che verranno visualizzate nella console Service Federation Management e per la connessione al registro del servizio in modo sicuro:

wsadmin>AdminTask.addSCMConnectivityProvider( ['-name', 'myScalableProvider',
'-cluster', 'cpCluster', '-proxyHostHTTP', 'webserver.example.com', 
'-proxyPortHTTP', '80', '-proxyHostHTTPS', 'webserver.example.com', 
'-proxyPortHTTPS', '443', '-description', 'My Connectivity Provider', 
'-contact', 'Contact Name', '-organization', 'Owning Organization', 
'-location', 'ESB location', '-authAlias', 'REGISTRY_AUTH_ALIAS', 
'-repertoire', 'REGISTRY_SSL_CONFIG'] )