Anhang A. Bearbeiten von Profilen mit eingebautem Texteditor

Zusammenfassung

Wenn viele Änderungen und Hinzufügungen an der Konfiguration eines Profils vorzunehmen sind, so ist es in der Regel praktischer, dies mit dem eingebauten Texteditor für Profile auf interaktive Weise zu tun. Der Zugriff auf den Editor kann über den profile-edit Befehl ohne Argumente außer dem Profilnamen (und optional der Version) erfolgen. Alternativ kann auch die --pid Option für das Bearbeiten der OSGi PID-Eigenschaften oder das Hinzufügen der --resource Option für das Bearbeiten allgemeiner Ressourcen verwendet werden.

A.1. Bearbeiten von Agent-Eigenschaften

A.1.1. Überblick

Dieser Abschnitt erläutert die Verwendung des eingebautenTexteditors zum Bearbeiten der Agent-Eigenschaften eines Profils, die hauptsächlich zur Definition der von dem Profil bereitgestellten Bündel und Features eingesetzt werden.

A.1.2. Öffnen Sie die Agent Properties Ressource

Um mit dem Bearbeiten der Agent-Eigenschaften eines Profils mit dem eingebauten Texteditor zu beginnen, geben Sie den folgenden Befehl ein:

JBossFuse:karaf@root> profile-edit Profile [Version]

Wobei Profile der Name des zu bearbeitenden Profils ist und Sie optional auch die Profilversion Version festlegen können. Der Texteditor öffnet sich im Konsolenfenster und zeigt den aktuellen Profilnamen und die Version oben links im Fenster an. Die Zeile ganz unten im Editor-Bildschirm bietet eine Übersicht der verfügbaren Bearbeitungsbefehle und Sie können mittels der Pfeiltasten innerhalb des Bildschirms navigieren.

A.1.3. Festlegen der Speicherorte des Feature-Repository

Um den Speicherort für ein Feature-Repository festzulegen, fügen Sie eine Zeile in folgendem Format hinzu:

repository.ID=URL

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und URL den Speicherort eines einzelnen Feature Repository angibt (es kann nur eine Repository URL in einer Zeile festgelegt werden).

A.1.4. Festlegen bereitgestellter Features

Um ein bereitzustellendes Feature festzulegen (das von einem der festgelegten Features-Repositorys verfügbar sein muss), fügen Sie eine Zeile in folgendem Format hinzu:

feature.ID=FeatureName

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und FeatureName der Name eines Feature ist.

A.1.5. Festlegen bereitgestellter Bündel

Um ein bereitzustellendes Bündel festzulegen, fügen Sie eine Zeile in folgendem Format hinzu:

bundle.ID=URL

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und URL den Speicherort des Bündels festlegt.

Anmerkung

Ein Bündeleintrag kann in Verbindung mit einem blueprint: (oder spring:) URL-Handler zum Bereitstellen einer Blueprint XML Ressource (oder einer Spring XML Ressource) als ein OSGi-Bündel verwendet werden.

A.1.6. Festlegen von Bündel-Overrides

Um ein Bündel-Override festzulegen, fügen Sie eine Zeile in folgendem Format hinzu:

override.ID=URL

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und URL den Speicherort des Bündels festlegt.

Anmerkung

Ein Bündel-Override wird für das Außerkraftsetzen eines durch ein Feature installierten Bündels verwendet, wobei es durch eine andere Version des Bündels ersetzt wird. Diese Funktionalität wird zum Beispiel vom Patching System für die Installation eines aktualisierten Bündels in einem Container verwendet.

A.1.7. Festlegen von etc/config.properties Eigenschaften

Um Java Systemeigenschaften festzulegen, die den Apache Karaf Container beeinflussen (analog zum Bearbeiten von etc/config.properties in einem Standalone-Container), fügen Sie eine Zeile in folgendem Format hinzu:

config.Property=Value

A.1.8. Festlegen von etc/system.properties Eigenschaften

Um Java Systemeigenschaften festzulegen, die die im Container bereitgestellten Bündel beeinflussen (analog zum Bearbeiten von etc/system.properties in einem Standalone-Container), fügen Sie eine Zeile in folgendem Format hinzu:

system.Property=Value

Ist die Systemeigenschaft Property bereits auf der JVM-Ebene eingestellt (zum Beispiel durch die --jvm-opts Option am fabric:container-create Befehl), so setzt der vorangehende fabric:profile-edit Befehl die Einstellung auf JVM-Ebene nicht außer Kraft. Um eine Einstellung auf JVM-Ebene außer Kraft zu setzen, stellen Sie die Systemeigenschaft wie folgt ein:

system.karaf.override.Property=Value

A.1.9. Festlegen von Bibliotheken zum Hinzufügen zu Java runtime lib/

Um eine Java Bibliothek zur Bereitstellung festzulegen (äquivalent zum Hinzufügen einer Bibliothek zum lib/ Verzeichnis der zugrundeliegenden Java Runtime), fügen Sie eine Zeile im folgenden Format hinzu:

lib.ID=URL

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und URL den Speicherort der Bibliothek festlegt.

A.1.10. Festlegen der Bibliotheken, die Java Runtime lib/ext/ hinzugefügt werden sollen

Um eine Java Erweiterungsbibliothek zur Bereitstellung festzulegen (äquivalent zum Hinzufügen einer Bibliothek zum lib/ext/ Verzeichnis der zugrundeliegenden Java Runtime), fügen Sie eine Zeile im folgenden Format hinzu:

ext.ID=URL

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und URL den Speicherort der Erweiterungsbibliothek festlegt.

A.1.11. Festlegen der Bibliotheken, die Java Runtime lib/endorsed/ hinzugefügt werden sollen

Um eine von Java unterstützte Bibliothek zur Bereitstellung festzulegen (äquivalent zum Hinzufügen einer Bibliothek zum lib/endorsed/ Verzeichnis der zugrundeliegenden Java Runtime), fügen Sie eine Zeile im folgenden Format hinzu:

endorsed.ID=URL

Wobei ID ein arbiträrer eindeutiger Bezeichner ist und URL den Speicherort der unterstützten Bibliothek festlegt.

A.1.12. Beispiel

Um die Agent-Eigenschaften des mq-client Profils zum Bearbeiten zu öffnen, geben Sie den folgenden Konsolenbefehl ein:

JBossFuse:karaf@root> profile-edit mq-client

Der Texteditor startet, und Sie sollten den folgenden Bildschirm im Konsolenfenster sehen:

Profile:mq-client 1.0                                                                 L:1 C:1
#
# Copyright (C) Red Hat, Inc.
# http://redhat.com
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

repository.activemq=mvn:org.apache.activemq/activemq-karaf/${version:activemq}/xml/features
repository.karaf-standard=mvn\:org.apache.karaf.assemblies.features/standard/${version:karaf}/
xml/features

     ^X Quit    ^S Save    ^Z Undo    ^R Redo    ^G Go To    ^F Find    ^N Next    ^P Previous

Geben Sie ^X ein, um den Texteditor zu beenden und zurück zum Konsolenprompt zu gelangen.