Sun Java™ System Identity Manager 7.1 Update 1 Versionshinweise

Installations- und Aktualisierungshinweise

In diesem Abschnitt finden Sie Informationen zur Installation und Aktualisierung; die Informationen sind wie folgt unterteilt:

Eine Schemaänderung findet bei den meisten Identity Manager-Hauptversionen statt. Vor der Aufrüstung auf eine neue Identity Manager-Version müssen Sie das Schema aktualisieren. Je nach der Version, von der aus Sie aufrüsten, führen Sie zur Aufrüstung auf Identity Manager 7.1 eines der folgenden Aufrüstungsskripte für Schemata aus: (ID-15392 und ID-15722)


Installationshinweise

Die folgenden Informationen beziehen sich auf die Installation des Produktes:


Aufrüstungshinweise

In diesem Abschnitt sind die Aufgaben zusammengefasst, die zum Aufrüsten von Identity Manager von Version 6.0 oder 7.0 auf Version 7.1 ausgeführt werden müssen. (Weitere Informationen zu den Versionen, die auf Identity Manager 7.1 aufgerüstet werden können, finden Sie in Aufrüstungsmöglichkeiten für Identity Manager.)

Die Informationen in diesem Abschnitt sind wie folgt unterteilt:

Probleme bei der Aufrüstung

Arbeiten mit dem Identity Manager-Aufrüstungsprogramm

In diesem Abschnitt sind die Schritte beschrieben, die zum Aufrüsten von Identity Manager mit dem Identity Manager-Installations- und Aufrüstungsprogramm erforderlich sind.


Hinweise

  • Eine Schemaänderung findet bei den meisten Identity Manager-Hauptversionen statt. Vor der Aufrüstung auf eine neue Identity Manager-Version müssen Sie das Schema aktualisieren. Je nach der Version, von der aus Sie aufrüsten, führen Sie zur Aufrüstung auf Identity Manager 7.1 eines der folgenden Aufrüstungsskripte für Schemata aus: (ID -15722)
    • Ausgehend von Identity Manager 6.0: Führen Sie das Skript upgradeto71from60 aus.
    • Ausgehend von Identity Manager 7.0: Führen Sie das Skript upgradeto71from70 aus.

    Weitere Informationen finden Sie in Sun Java System Identity Manager-Upgrade.

  • In einigen Umgebungen wie z. B. HP-UX müssen oder möchten Sie u. U. eine manuelle Aktualisierung durchführen. In diesem Fall gehen Sie direkt zu Manuelle Aufrüstung.
  • Stellen Sie in UNIX-Umgebungen sicher, dass an einem der folgenden Speicherorte ein Verzeichnis mit der Bezeichnung install vorhanden ist und dass dieses beschreibbar ist:
    • Linux/HP-UX: /var/opt/sun/install
    • Solaris: /var/sadm/install
  • Während der Aktualisierung müssen Sie den Pfad angeben, auf dem der Anwendungsserver installiert ist.
  • Alle zuvor installierten Hotfixes werden im folgenden Verzeichnis archiviert:

    $WSHOME/patches/HotfixName

  • Alle in den folgenden Schritten angegebenen Befehle setzen eine Windows-Installation und einen Tomcat-Anwendungsserver voraus. Die von Ihnen verwendeten Befehle können sich daher je nach Umgebung unterscheiden.

So rüsten Sie Identity Manager auf:

  1. Schließen Sie den Anwendungsserver.
  2. Wenn Sie auf Identity Manager 6.0 oder Identity Manager 7.0 aufrüsten, müssen Sie das Repository-Datenbankschema wie folgt aktualisieren:
    • Ab Identity Manager 6.0 wird ein Schema verwendet, das neue Tabellen für Aufgaben, Gruppen und Organisationen sowie die syslog-Tabelle enthält. Sie müssen diese neuen Tabellenstrukturen erstellen und die vorhandenen Daten verschieben.
    • In Identity Manager 6.0 werden Benutzerobjekte in zwei Tabellen gespeichert. Sie können für die Schemaänderungen die Beispielskripte verwenden, die sich im Verzeichnis db_scripts befinden. Verwenden Sie das Skript db_scripts/upgradeto2005Q4M3.DatabaseName, um die Repository-Tabellen zu aktualisieren.

    • Hinweise

      • Vor der Aktualisierung des Repository-Schemas erstellen Sie eine vollständige Datensicherung der Repository-Tabellen.
      • Die Aufrüstung der MySQL-Datenbanken ist höchst komplex. Weitere Informationen hierzu finden Sie in db_scripts/upgradeto2005Q4M3.mysql.

    • Identity Manager 7.0 führt neue Tabellen für Benutzeransprüche (UserEntitlement-Objekte) ein.
      Sie müssen diese neuen Tabellenstrukturen erstellen und die vorhandenen Daten verschieben. Sie können für die Schemaänderungen die Beispielskripte verwenden, die sich im Verzeichnis db_scripts befinden.

    • Hinweise

      • Vor der Aktualisierung des Repository-Schemas erstellen Sie eine vollständige Datensicherung der Repository-Tabellen.
      • Weitere Informationen hierzu finden Sie im Skript db_scripts/upgrade7.0.DBMSName.

  3. Wenn Sie Sun Identity Manager-Gateway auf dem Identity Manager-Server ausführen, unterbrechen Sie den Gateway-Dienst mit dem folgenden Befehl:
  4. net stop "Sun Identity Manager-Gateway"

  5. Wählen Sie eine der folgenden beiden Möglichkeiten zum Starten des Installationsprogramms:
    • Um das GUI-Installationsprogramm zu verwenden, führen Sie install.bat (für Windows) oder install (für UNIX) aus.

      Das Installationsprogramm zeigt das Begrüßungsfenster an.

    • Um das Installationsprogramm im Modus nodisplay zu aktivieren, wechseln Sie in das Verzeichnis, in dem sich die Software befindet, und geben den folgenden Befehl ein:

      install -nodisplay

      Das Installationsprogramm zeigt eine Begrüßung an und fährt dann mit einer Liste von Fragen fort, mit der in der gleichen Reihenfolge wie beim GUI-Installationsprogramm Installationsinformationen erfasst werden sollen:


      Hinweise

      • Wenn nichts angezeigt wird, arbeitet das Installationsprogramm im Modus nodisplay.
      • Das Installationsprogramm installiert keine ältere Version der Software über eine neuere Version. Sollte diese Situation eintreten, wird eine Fehlermeldung angezeigt und das Installationsprogramm wird geschlossen.

  6. Klicken Sie im Fenster Willkommen auf Weiter.
  7. Wählen Sie im Fenster „Install or Upgrade?“ die Option „Upgrade“ und klicken Sie dann auf „Weiter“.
  8. Wählen Sie im Fenster „Select Installation Directory“ das Verzeichnis aus, in dem sich die vorherige Identity Manager-Version befindet und klicken Sie auf „Weiter“.
  9. Das Installationsprogramm zeigt Fortschrittsbalken für die Prozesse vor und nach der Aufrüstung an; danach wird das Fenster „Installation Summary“ angezeigt.

  10. Um detaillierte Installationsinformationen anzuzeigen, klicken Sie auf „Details“ und zeigen die Protokolldatei an. Klicken Sie dann auf „Schließen“, um das Installationsprogramm zu beenden.
  11. Entfernen Sie alle kompilierten Identity Manager-Dateien aus dem Arbeitsverzeichnis des Anwendungsservers.
  12. Wenn Sie ein Gateway auf einem Remotesystem betreiben, rüsten Sie dieses wie folgt auf.
    1. Melden Sie sich beim Windows-System an und wechseln Sie in das Verzeichnis, in dem das Gateway installiert ist.
    2. Stoppen Sie den Gateway-Dienst durch die Ausführung des folgenden Befehls:
    3. gateway -k

    4. Wenn Sie unter Windows 2000 oder höher arbeiten, beenden Sie alle Instanzen des Services MMC-Plugins.
    5. Entfernen Sie den Gateway-Dienst durch die Ausführung des folgenden Befehls:
    6. gateway -r

    7. Sichern und löschen Sie die vorhandenen Gateway-Dateien.
    8. Extrahieren Sie die neuen Gateway-Dateien.
    9. Wenn Sie das neu aufgerüstete Gateway auf einem System installieren, bei dem es sich nicht um den Identity Manager-Server handelt, kopieren Sie die Datei gateway.zip von der Identity Manager Installations-CD.

    10. Entpacken Sie die Datei gateway.zip in das Verzeichnis, in dem das Gateway installiert war.
    11. Installieren Sie den Gateway-Dienst durch die Ausführung des folgenden Befehls:
    12. gateway -i

    13. Starten Sie den Gateway-Dienst durch die Ausführung des folgenden Befehls:
    14. gateway -s

Manuelle Aufrüstung

In einigen Umgebungen möchten Sie die Aufrüstung u. U. nicht mit Identity Manager-Installations- und Aufrüstungsprogramm, sondern manuell durchführen.


Hinweise

  • Achten Sie darauf, dass Sie die Umgebungsvariable JAVA_HOME einstellen.
  • Vergewissern Sie sich, dass sich das Verzeichnis bin im Verzeichnis JAVA_HOME in Ihrem Pfad befindet.
  • Alle zuvor installierten Hotfixes werden im Verzeichnis $WSHOME/patches/HotfixName archiviert.

Auf einer Windows-Plattform

So rüsten Sie Identity Manager auf einer unterstützten Windows-Plattform auf:

  1. Beenden Sie den Applikationsserver und Sun Identity Manager-Gateway.
  2. Aktualisieren Sie die Identity Manager-Datenbank (ausführliche Anweisungen finden Sie unter Schritt 2).
  3. Führen Sie zur Einstellung der Umgebung die folgenden Befehle aus:
  4. set ISPATH=Pfad zur Installationssoftware
    set WSHOME=Pfad zum Identity Manager Installations- oder Stagingverzeichnis
    set TEMP=Pfad zum temporären Verzeichnis

  5. Führen Sie den Prozess vor der Aufrüstung aus:
  6. mkdir %TEMP%
    cd /d %TEMP%
    jar -xvf %ISPATH%\IDM.WAR \
    WEB-INF\lib\idm.jar WEB-INF\lib\idmcommon.jar
    set TMPLIBPTH=%TEMP%\WEB-INF\lib
    set CLASSPATH=%TMPLIBPTH%\idm.jar;\
    %TMPLIBPTH%\idmcommon.jar;
    java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME% \
       com.waveset.install.UpgradePreProcess

  7. Installieren Sie die Software:
  8. cd %WSHOME%
    jar -xvf %ISPATH%\IDM.WAR

  9. Führen Sie den Prozess nach der Aufrüstung aus:
  10. java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME%
      com.waveset.install.UpgradePostProcess


    Hinweis

    Das Installationsprogramm unterstützt die Aufrüstung von Installationen, in denen das standardmäßige Konfiguratorkonto umbenannt, gelöscht oder deaktiviert wurde.

    Das Installationsprogramm fordert Sie zur Eingabe des Benutzernamens und Passwortes auf, um im Rahmen des Prozesses nach der Aufrüstung die Datei update.xml zu importieren. Wenn Sie den falschen Benutzernamen oder das falsche Passwort eingeben, werden Sie (maximal dreimal) aufgefordert, die richtigen Daten einzugeben. Der Fehler wird im Textfeld im Hintergrund angezeigt.

    Für eine manuelle Installation müssen Sie die Flags -U Benutzername -P Passwort angeben, um die Anmeldedaten an die Prozedur UpgradePostProcess zu übergeben.


  11. Bei Installation in einem Stagingverzeichnis erstellen Sie zur Bereitstellung für Ihren Anwendungsserver die Datei .war.
  12. Entfernen Sie die Identity Manager-Dateien aus dem Arbeitsverzeichnis des Anwendungsservers.
  13. Wenn nicht bereits während der Aufrüstung geschehen, verschieben Sie alle Hotfix-Klassendateien vom Verzeichnis WEB-INF\classes in das Verzeichnis $WSHOME\patches\HotfixName.
  14. Starten Sie den Anwendungsserver.
  15. Rüsten Sie Sun Identity Manager-Gateway auf und starten Sie die Anwendung dann (ausführliche Anweisungen finden Sie unter Schritt 10).

Auf einer UNIX-Plattform

So rüsten Sie Identity Manager auf einer unterstützten UNIX-Plattform auf:

  1. Beenden Sie den Applikationsserver und Sun Identity Manager-Gateway.
  2. Aktualisieren Sie die Identity Manager-Datenbank (Anweisungen finden Sie unter Schritt 2).
  3. Führen Sie zur Einstellung der Umgebung die folgenden Befehle aus:
  4. export ISPATH=Pfad zur Installationssoftware
    export WSHOME=Pfad zum Identity Manager-Installations- oder Stagingverzeichnis
    export TEMP=Pfad zum temporären Verzeichnis

  5. Führen Sie den Prozess vor der Aufrüstung aus:
  6. mkdir $TEMP
    cd $TEMP
    jar -xvf $ISPATH/idm.war \
    WEB-INF/lib/idm.jar WEB-INF/lib/idmcommon.jar
    CLASSPATH=$TEMP/WEB-INF/lib/idm.jar:\
    $TEMP/WEB-INF/lib/idmcommon.jar:
    java -classpath $CLASSPATH -Dwaveset.home=$WSHOME \
    com.waveset.install.UpgradePreProcess

  7. Installieren Sie die Software:
  8. cd $WSHOME
    jar -xvf $ISPATH/idm.war

  9. Führen Sie den Prozess nach der Aufrüstung aus:
  10. java -classpath $CLASSPATH -Dwaveset.home=$WSHOME
      com.waveset.install.UpgradePostProcess


    Hinweis

    Das Installationsprogramm unterstützt die Aufrüstung von Installationen, in denen das standardmäßige Konfiguratorkonto umbenannt, gelöscht oder deaktiviert wurde.

    Das Installationsprogramm fordert Sie zur Eingabe des Benutzernamens und Passwortes auf, um im Rahmen des Prozesses nach der Aufrüstung die Datei update.xml zu importieren. Wenn Sie den falschen Benutzernamen oder das falsche Passwort eingeben, werden Sie (maximal dreimal) aufgefordert, die richtigen Daten einzugeben. Der Fehler wird im Textfeld im Hintergrund angezeigt.

    Für eine manuelle Installation müssen Sie die Flags -U Benutzername -P Passwort angeben, um die Anmeldedaten an die Prozedur UpgradePostProcess zu übergeben.


  11. Ändern Sie das Verzeichnis auf $WSHOME/bin/solaris oder $WSHOME/bin/linux und legen Sie dann für die Dateien im Verzeichnis Berechtigungen fest, damit diese ausführbar sind.
  12. Bei Installation in einem Stagingverzeichnis erstellen Sie zur Bereitstellung für Ihren Anwendungsserver die Datei .war.
  13. Entfernen Sie die Identity Manager-Dateien aus dem Arbeitsverzeichnis des Anwendungsservers.
  14. Wenn nicht bereits während der Aufrüstung geschehen, verschieben Sie alle Hotfix-Klassendateien vom Verzeichnis WEB-INF/classes in das Verzeichnis $WSHOME/patches/HotfixName.
  15. Starten Sie den Anwendungsserver.
  16. Rüsten Sie Sun Identity Manager-Gateway auf und starten Sie die Anwendung dann (Anweisungen finden Sie unter Schritt 10).