Ändern des Hostname einer WLS 12c Installation

Der Hostname ist in einer WLS 12c Installation in verschiedenen Konfigurationen versteckt und daher ist das Ändern des Hostnamen mit vielen Fallstricken versehen.

• Halten Sie den alten und neuen Full Qualified Domain Name (FQDN) als auch den kurzen Servernamen (Ohne Domain) bereit.
• Stellen Sie zunächst sicher, dass der WLS sowohl den alten als auch den neuen Hostname auflösen kann (z.B. über /etc/hosts)
• Entfernen Sie erst nach vollständiger Umstellung den alten Namen aus der Datei /etc/hosts.

• Starten Sie den AdminServer und legen Sie einen neuen Rechner-Eintrag mit dem FQDN des neuen Hostnamen an.
• Beenden Sie den AdminServer
• Starten Sie eine WLST-Konsole:

$DOMAIN_HOME/../../../oracle_common/common/bin/wlst.sh

• Lesen Sie die Domain-Konfiguration ein:

wls:/offline> readDomain('DOMAIN_HOME')

• wechseln Sie in das Verzeichnis des neu angelegten Rechners und führen Sie dann das Update der Konfiguration für den AdminServer aus:

wls:/offline/sampledomain> cd ('/Machine/newhostname')
wls:/offline/sampledomain> machine = cmo
wls:/offline/sampledomain> cd ('/Server/AdminServer')
wls:/offline/sampledomain> set('Machine', machine)
wls:/offline/sampledomain> updateDomain()
wls:/offline/sampledomain> exit()

• Liegt die Repository Datenbank für den WLS 12c ebenfalls auf dieser Maschine, muss auch der jdbc-Zugriff auf die Datenbank angepasst werden. Ändern Sie dazu die jdbc-Urls in den XML-Dateien in folgendem Verzeichnis:

cd $DOMAIN_HOME/config/jdbc

• Für den Enterprise-Manager sind die folgenden Dateien anzupassen:
  1. $DOMAIN_HOME/config/fmwconfig/jps-config.xml
  2. $DOMAIN_HOME/config/fmwconfig/servers/AdminServer/applications/em/META-INF/emoms.properties
  3. $DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml
• Die Start- und Stopskripte für Managed Server, AdminServer müssen ebenfalls angepasst werden. Sie liegen im Verzeichnis
  1. $DOMAIN_HOME/bin/*

• Stoppen Sie den Nodemanager
• Stoppen Sie den HTTP-Server
• wechseln Sie nun in das Konfigurationsverzeichnis des HTTP-Servers:

cd $DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1

• Ersetzen Sie nun in allen Konfigurationsdateien alle Vorkommen
  1. des alten FQDN durch den neuen FQDN.
  2. des alten ServerNamen durch den neuen ServerNamen.
  3. der alten IP-Adresse durch die neue IP-Adresse
• Wiederholen Sie die Änderungen für das Verzeichnis

cd $DOMAIN_HOME/config/fmwconfig/components/OHS/instances/ohs1

• Prüfen Sie nun in der Datei $DOMAIN_HOME/config/config.xml, ob der Servername für den HTTP-Server eingetragen ist:

  <system-component>
    <name>ohs1</name>
    <machine>FQDN</machine>
    <component-type>OHS</component-type>
    <system-component-start></system-component-start>
  </system-component>

• Fehlt die Zeile „<machine>…</machine>“, so fügen Sie diese bitte mit dem FQDN ein. Anderenfalls kann der HTTP-Server nicht gestartet werden und Sie erhalten die folgende Fehlermeldung: Error: Cannot find machine for System Component „ohs1“
• Starten Sie nun den Nodemanager und den HTTP-Server

• Melden Sie sich auf der Administrationskonsole des WLS 12c an. (http://localhost:7001/console)
• Wählen Sie die Server-Übersicht
• Wenn der Server läuft, stoppen Sie diesen bevor Sie fortfahren!
• Aktivieren Sie im Change Center den Button „Sperren und Bearbeiten“
• Wählen Sie einen Managed Server aus und ändern Sie auf dem Reiter Konfiguration/Allgemein den Rechner-Namen
• Klicken Sie anschließend auf Speichern
• Aktivieren Sie nun die Änderungen mit einem Klick auf „Änderungen aktivieren“ im Change Center
• Danach können Sie den Managed Server wieder starten.