====== Ä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.

===== Ändern des Hostname für den AdminServer =====

  * 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:
<code>
$DOMAIN_HOME/../../../oracle_common/common/bin/wlst.sh
</code>
  * Lesen Sie die Domain-Konfiguration ein:
<code>
wls:/offline> readDomain('DOMAIN_HOME')
</code>
  * wechseln Sie in das Verzeichnis des neu angelegten Rechners und führen Sie dann das Update der Konfiguration für den AdminServer aus: 
<code>
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()
</code>
  * 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:
<code>
cd $DOMAIN_HOME/config/jdbc
</code>
  * Für den Enterprise-Manager sind die folgenden Dateien anzupassen:
    - $DOMAIN_HOME/config/fmwconfig/jps-config.xml
    - $DOMAIN_HOME/config/fmwconfig/servers/AdminServer/applications/em/META-INF/emoms.properties
    - $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
    - $DOMAIN_HOME/bin/*
===== Ändern des Hostname für den OHS =====

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

<code>
cd $DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1
</code>
  * Ersetzen Sie nun in allen Konfigurationsdateien alle Vorkommen 
    - des alten FQDN durch den neuen FQDN.
    - des alten ServerNamen durch den neuen ServerNamen.
    - der alten IP-Adresse durch die neue IP-Adresse
  * Wiederholen Sie die Änderungen für das Verzeichnis
<code>
cd $DOMAIN_HOME/config/fmwconfig/components/OHS/instances/ohs1
</code>
  * Prüfen Sie nun in der Datei $DOMAIN_HOME/config/config.xml, ob der Servername für den HTTP-Server eingetragen ist:
<code>
  <system-component>
    <name>ohs1</name>
    <machine>FQDN</machine>
    <component-type>OHS</component-type>
    <system-component-start></system-component-start>
  </system-component>
</code>
  * 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

===== Ändern des Hostnamen für einen Managed 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.