Eingebettet WebSphere eXtreme Scale (WXS) Grid-Beispiel: Konfigurieren eines Katalogs und eines Containers

Verwenden Sie dieses Beispiel, um eine grundlegende eingebettete WXS-Grid-Konfiguration zu erstellen, bei der ein einziger Integrationsserver sowohl einen Katalogserver als auch einen Container-Server hostet.

Vorbereitungen

Informationen zu dieser Task

Sie können den Inhalt des eingebetteten WXS-Grid-Abschnitts der Konfigurationsdateien kopieren und einfügen, um den vorhandenen Inhalt des GlobalCache -Abschnitts Ihrer server.conf.yaml -Dateien zu ersetzen, und ihn dann nach Bedarf ändern. Der Abschnitt GlobalCache ist ein Unterabschnitt des Abschnitts ResourceManagers in den Dateien server.conf.yaml.

Dieses Beispiel zeigt, wie das eingebettete WXS-Grid für ein Basisszenario konfiguriert wird, bei dem ein einzelner Integrationsserver verwendet wird, der sowohl einen Katalogserver als auch einen Containerserver beherbergt, wie im folgenden Diagramm dargestellt:

Diagramm mit einem einzelnen Integrationsserver, der sowohl einen Katalogserver als auch einen Container-Server hostet.

Vorgehensweise

Führen Sie die folgenden Schritte aus, um eine grundlegende eingebettete WXS-Grid-Konfiguration zu erstellen, bei der ein einzelner Integrationsserver sowohl einen Katalogserver als auch einen Container-Server hostet:

  1. Erstellen Sie einen Integrationsserver mit dem Namen integrationServer1.
  2. Öffnen Sie die Konfigurationsdatei für Ihren Integrationsserver (integrationServer1\server.conf.yaml) mithilfe eines YAML-Editors.

    Sie können die Datei mit dem im „ IBM® App Connect Enterprise -Toolkit “ integrierten YAML-Editor bearbeiten, indem Sie entweder in der Ansicht „Anwendungsentwicklung“ auf die Datei doppelklicken oder mit der rechten Maustaste auf die Datei klicken und „Öffnen mit > YAML-Editor“ auswählen. Wenn Sie die Datei mit einem Texteditor bearbeiten möchten, stellen Sie sicher, dass Sie keine Tabulatorzeichen (die in YAML nicht gültig sind) einschließen und ein YAML-Validierungstool verwenden, um den Inhalt Ihrer Datei zu validieren.

  3. Kopieren und fügen Sie den Inhalt des Abschnitts GlobalCache in die bereitgestellte Beispieldatei server.conf.yaml (im Ordner install_directory\server\samples\globalcache\basic_1_catalog_1_container ) ein, um den vorhandenen Inhalt des Abschnitts GlobalCache Ihrer Datei server.conf.yaml zu ersetzen.
    Der Abschnitt GlobalCache ist ein Unterabschnitt des Abschnitts ResourceManagers in der Datei server.conf.yaml.
    # Integration server configuration file for use as embedded WXS grid container
    # Provides a "basic" configuration with a single integration server acting as both a catalog server and a container server
    #
    # General notes:
    #  - Integration server will load server.conf.yaml from directory set via --work-dir
    #  - To ensure valid YAML avoid any use of TAB characters
    #  - File paths may be taken as absolute, or relative to the integration server's work directory
    #
    
      GlobalCache:
        cacheOn: true                                   # Set to true to enable embedded WXS grid functionality
                                                        # When using embedded WXS grid it is advisable to change your jvmMinHeapSize and jvmMaxHeapSize depending on 
                                                        # the number of live objects in the heap, complexity of live objects in the heap and number of available cores.
                                                        # see https://www.ibm.com/support/knowledgecenter/SSTVLU_8.6.0/com.ibm.websphere.extremescale.doc/cxsjvmtune.html 
        cacheServerName: 'MyCatalogServer1'             # The name of this cache server component (a cache server component can be a catalog and/or a container); it must be unique in your embedded WXS grid system
        catalogServiceEndPoints: 'localhost:2800'       # Comma-separated list of hostnames and ports for the catalog servers to use, e.g. 'localhost:2800'
        catalogDomainName: 'WMB_MyCacheDomain'          # Name of the shared embedded WXS grid domain; this value should be shared by all catalog servers in the same domain
        catalogClusterEndPoints: 'MyCatalogServer1:localhost:2803:2801'
                                                        # Comma-separated list of catalog server connection details in the format 'cacheServerName:catalogCacheServerHost:HAPort:clientPort'
                                                        # If this is a catalog server, cacheServerName should match the value above, and if not, it will be the value used on the integration server hosting it
                                                        # The list should be in the same order for all catalog and container servers which are interacting together in the same domain
        enableCatalogService: true                      # Set to true to launch a catalog service cache server component in this integration server
        enableContainerService: true                    # Set to true to launch a container service cache server component in this integration server
        enableJMX: true                                 # Allow admin access to this container service via JMX 
        listenerHost: 'localhost'                       # Comma-separated list of hostnames for this cacheServer component, e.g. 'localhost,myserver.mycompany.com'
        listenerPort: 2800                              # Port number this cache server listens on; it must be unique on this machine
                                                        # Four consecutive ports are assigned, e.g. 2800 for catalogCacheServerListenerPort, 2801 for clientPort, 2802 for JMXServicePort, 2803 for HAPort
                                                        
        #deploymentPolicyCustomFile: ''                 # Override the deployment policy  file (default is <install directory>/server/cachesupport/config/deployment.xml)
        #objectGridCustomFile: ''                       # Override the ObjectGrid file (default is <install directory>/server/cachesupport/config/objectgrid_xio.xml)
        #overrideTraceSpec: ''                          # Set a trace level for the cache server components, e.g. ObjectGrid*=event=enabled   
        #clientsDefaultToSSL: false                     # Set to true to enable SSL for any client connections to the cache servers
        #sslAlias: ''                                   # SSL Alias to use for the cache server component 
        #sslProtocol: ''                                # SSL Protocol to use for SSL connections eg. default is "TLSv1.2"
  4. Starten Sie den Integrationsserver erneut, damit die Änderungen wirksam werden.

    Nach dem Neustart ist integrationServer1 sowohl ein Katalogserver als auch ein Container-Server.

Nächste Schritte

Wenn Sie nur eine einzigen Katalogserver haben und diesen stoppen, ist der Cache nicht verfügbar und Ihre Daten gehen verloren. Haben Sie jedoch mehrere Katalogserver, kann einer dieser Server gestoppt und erneut gestartet werden, ohne dass Daten verloren gehen. Ihre Daten gehen nur verloren, wenn alle Katalogserver gestoppt werden.