Cachebenachrichtigungen einrichten

Bearbeiten Sie die Konfigurationsdatei .conf.yaml , um die Cachebenachrichtigung zu aktivieren, sodass der Cache über Ereignisse benachrichtigt wird, die in WebSphere® Service Registry and Repository (WSRR) auftreten.

Informationen zu dieser Task

WSRR veröffentlicht Benachrichtigungsereignisse über WebSphere Application Server. Dank der Cachebenachrichtigung kann der Cache diese Ereignisse subskribieren.

Zum Festlegen der WSRR-Parameter müssen Sie die WSRRConnectorProvider-Einträge im Abschnitt ConnectorProviders der Konfigurationsdatei node.conf.yaml oder server.conf.yaml bearbeiten. Wenn Sie einen neuen Integrationsknoten oder einen neuen unabhängigen Integrationsserver erstellen, enthält die Konfigurationsdatei .conf.yaml das folgende Subset der WSRR-Parameter. Alle anderen WSRR-Parameter haben Standardeinstellungen, die im Allgemeinen nicht geändert werden müssen. Wenn Sie einen der anderen WSRR-Parameter ändern müssen, müssen Sie sie der Konfigurationsdatei .conf.yaml hinzufügen.

ConnectorProviders:
    #WSRRConnectorProvider:    # Requires the optional WSRR component install
    #endpointAddress: 'https://host:9443/WSRR8_0/services/WSRRCoreSDOPort'   # WSRR server endpoint url
    #needCache: true                                                         # enable WSRR cache
    #predefinedCacheQueries: ''                                              # semicolon-separated XPath querys to initialize WSRR cache at start-up
    #enableCacheNotification: false                                          # enable WSRR cache notification
    #locationJNDIBinding:  'iiop://host:2809'                                # WSRR cache WAS JMS provider JNDI bindings url

Führen Sie zum Aktivieren der Cachebenachrichtigung die folgenden Schritte aus, um die relevanten Eigenschaften in der Konfigurationsdatei .conf.yaml zu ändern und eine Benutzer-ID mit Kennwort hinzuzufügen, wenn Sie eine Verbindung zu einem sicheren WebSphere Application Serverherstellen. Alle Eigenschaften, die Sie für den Integrationsknoten in der Datei node.conf.yaml definieren, werden von den Integrationsservern des Integrationsknotens übernommen. Alle Integrationsservereigenschaften können jedoch in der entsprechenden Datei server.conf.yaml geändert werden. Weitere Informationen zur Konfiguration von Integrationsservern, die von einem Integrationsknoten verwaltet werden, finden Sie unter Integrationsserver durch Änderung der Datei server.conf.yaml konfigurieren.

Vorgehensweise

  1. Setzen Sie den Eigenschaftswert enableCacheNotification in der Konfigurationsdatei .conf.yaml auf true :
    enableCacheNotification: true # The default value is false. Select true to enable IBM® App Connect Enterprise WSRR Cache Notification.
  2. Setzen Sie die Eigenschaft locationJNDIBinding auf den Wert, den Sie für Ihren WSRR-Server in der Konfigurationsdatei .conf.yaml benötigen:
    Zum Beispiel:
    locationJNDIBinding: 'iiop://host_name:2809/' # The URL to the WebSphere Application Server JMS provider JNDI bindings. The default value is iiop://host_name:2809/
  3. Wenn Sie „ WebSphere Application Server “ Version 8.0 oder höher verwenden, lautet die standardmäßige IIOP-Sicherheitseinstellung „ SSL -Required “. Wenn Sie also eine Verbindung zu Ihrem Server herstellen, ohne diese Option auf „ SSL -Optional“ zu ändern, müssen Sie die ssl.client.propssas.client.props Dateien und wie folgt konfigurieren:
    sas.client.props
    - Set com.ibm.ssl.alias=AnotherSSLSettings
    - Set com.ibm.CORBA.loginSource=properties
    ssl.client.proprs
    -- Use the AnotherSSLAlias template that is already in the file, but comment ou the DefaultAlias Keystore and Truststore information to prevent it affecting the current configuration
    -- Comment out the KeyStore part of the 'another SSL Alias' because the TrustStore is the only one that is required:
    - Set com.ibm.ssl.enableSignerExchangePrompt=false in all scenarios
  4. Definieren Sie die Eigenschaft secureJNDIPropertiesFiles in der Datei .conf.yaml so, dass sie auf das Verzeichnis verweist, in dem Ihre .props -Dateien gespeichert sind.
    Zum Beispiel:
    secureJNDIPropertiesFiles: 'C:\SSLPropsFiles' #  The directory where your .props files are stored. For example C:\SSLPropsFiles.

Wenn Sie eine Verbindung zu einem sicheren WebSphere Application Serverherstellen, müssen Sie eine Benutzer-ID und ein Kennwort verwenden. Führen Sie einen der folgenden Schritte aus, um die Benutzer-ID und das Kennwort festzulegen:

  1. Optional: Legen Sie die Benutzer-ID und das Kennwort mit dem Befehl mqsisetdbparms fest:
    1. Wenn der Integrationsknoten aktiv ist, stoppen Sie ihn mit dem Befehl mqsistop .
    2. Setzen Sie den Befehl mqsisetdbparms ab, um Ihre Benutzer-ID und Ihr Kennwort einzurichten.
      Zum Beispiel:
      mqsisetdbparms INODE -n jms::DefaultWSRR@jms/SRConnectionFactory 
      -u userid -p password
      Dabei gilt:
      -n gibt den Namen der Datenquelle an
      (in diesem Fall wird jms::DefaultWSRR@jms/SRConnectionFactory verwendet).
      Sie können auch verwenden wsrr)
      -u gibt die Benutzer-ID an, die dieser Datenquelle zugeordnet werden soll
      (in diesem Fall userid)
      -p gibt das Kennwort an, das dieser Datenquelle zugeordnet werden soll
      (in diesem Fall password).
    3. Starten Sie den Integrationsknoten mit dem Befehl mqsistart erneut.
  2. Optional: Legen Sie die Benutzer-ID und das Kennwort mit dem Befehl mqsicredentials fest:
    1. Wenn die Integration aktiv ist, stoppen Sie sie mit dem Befehl mqsistop .
    2. Setzen Sie den Befehl mqsicredentials ab, um Ihre Benutzer-ID und Ihr Kennwort einzurichten.
      Zum Beispiel:
      mqsicredentials --work-dir --create --credential-type jms --credential-name wsrr@jms/SRConnectionFactory --vault-key 12345abcde --username jmsvaultuser --password jmsvaultpwd 
      -u userid -p password
      Dabei gilt:
      --work-dir gibt den Pfad zu dem Arbeitsverzeichnis an, das von einem unabhängigen Integrationsserver verwendet wird.
      --credential-type gibt die Ressource an, die für den Zugriff Berechtigungsnachweise erfordert
      (in diesem Fall jms)
      --credential-name gibt den Vaultschlüssel an, der für den Zugriff auf die Vault verwendet wird, in der der Berechtigungsnachweis gespeichert ist.
      --vault-key gibt den Vaultschlüssel für den Zugriff auf die Vault an, in der der Berechtigungsnachweis gespeichert wird.
      --username gibt die Benutzer-ID für diese Ressource an.
      --password gibt das Kennwort für diese Ressource an.
    3. Starten Sie den Integrationsknoten mit dem Befehl mqsistart erneut.