Update Doku und readmes

git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@1241 d688527b-c9ab-4aba-bd8d-4036d912da1d

1 files changed, 153 insertions, 9 deletions

diff --git a/id/readme_1.5.1.txt b/id/readme_1.5.1.txt
index e742212df..e86ee5968 100644
--- a/id/readme_1.5.1.txt
+++ b/id/readme_1.5.1.txt
@@ -19,8 +19,11 @@ gleichen Verzeichnis):
 	- Fixer Target-Parameter für Online-Applikation konfigurierbar

 	- Optionaler Parameter zur Angabe der IssueInstant im UTC Format in der SAML-Assertion

 - Weiterer optionaler Parameter sourceID beim MOA-ID Aufruf

-- IAIK Libraries aktualisiert:

-	iaik-moa:           Version 1.31	

+- Update der Standard Trustprofile

+- Libraries aktualisiert:

+@TODO

+	iaik-moa:           Version 1.31 

+	Axis:				Version 1.0_IAIK	

 

 -------------------------------------------------------------------------------

 B. Durchführung eines Updates

@@ -31,7 +34,78 @@ eine Aktualisierung bestehender Installationen möglich.
 

 

 ...............................................................................

-B.1 Durchführung eines Updates von Version 1.5.0

+B.1 Durchführung eines Updates von Version Pre-Release 1.5.1

+...............................................................................

+

+1. Stoppen Sie den Tomcat, in dem Ihre bisherige Installation betrieben wird.

+   Fertigen Sie eine Sicherungskopie Ihrer kompletten Tomcat-Installation an.

+

+2. Entpacken Sie die Distribution von MOA ID Auth (moa-id-auth-1.5.1.zip) in

+   ein temporäres Verzeichnis, in weiterer Folge als MOA_ID_AUTH_INST 

+   bezeichnet.

+   Für MOA ID Proxy:

+   Entpacken Sie die Distribution von MOA ID Proxy (moa-id-proxy-1.5.1.zip) in

+   ein temporäres Verzeichnis, in weiterer Folge als MOA_ID_PROXY_INST 

+   bezeichnet.    

+

+3. Wechseln Sie in jenes Verzeichnis, das die Webapplikation von MOA ID Auth

+   beinhaltet (für gewöhnlich ist dieses Verzeichnis CATALINA_HOME_ID/webapps,

+   wobei CATALINA_HOME_ID für das Basisverzeichnis der Tomcat-Installation 

+   für MOA ID steht). Löschen Sie darin sowohl die Datei moa-id-auth.war als 

+   auch das komplette Verzeichnis moa-id-auth.

+   Für MOA ID Proxy:

+   Wechseln Sie in jenes Verzeichnis, das die Webapplikation von MOA ID Proxy

+   beinhaltet (für gewöhnlich ist dieses Verzeichnis CATALINA_HOME_ID/

+   webappsProxy, wobei CATALINA_HOME_ID für das Basisverzeichnis der Tomcat-Installation 

+   für MOA ID steht). Löschen Sie darin sowohl die Datei moa-id-proxy.war als 

+   auch das komplette Verzeichnis moa-id-proxy.

+

+4. Kopieren Sie die Datei MOA_ID_AUTH_INST/moa-id-auth.war nach

+   CATALINA_HOME_ID/webapps.

+   Für MOA ID Proxy:

+   Kopieren Sie die Datei MOA_ID_PROXY_INST/moa-id-proxy.war nach

+   CATALINA_HOME_ID/webappsProxy.

+

+5. Update des Cert-Stores.

+   Kopieren Sie den Inhalt des Verzeichnisses

+   MOA_ID_INST_AUTH\conf\moa-spss\certstore in das Verzeichnis

+   CATALINA_HOME\conf\moa-spss\certstore. Wenn Sie gefragt werden, ob Sie 

+   vorhandene Dateien oder Unterverzeichnisse überschreiben sollen, dann 

+   bejahen sie das.

+

+6. Update der Trust-Profile. Wenn Sie Ihre alten Trust-Profile durch die Neuen ersetzen 

+   wollen, dann gehen Sie vor, wie in Punkt a). Wenn Sie Ihre eigenen Trust-Profile 

+   beibehalten wollen, dann gehen Sie vor, wie in Punkt b).

+

+   a. Gehen Sie wie folgt vor, um die Trust-Profile auszutauschen:

+

+    1)  Löschen Sie das Verzeichnis CATALINA_HOME\conf\moa-spss\trustprofiles.

+    2)  Kopieren Sie das Verzeichnis 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles in das Verzeichnis 

+        CATALINA_HOME\conf\moa-spss.

+

+   b. Falls Sie Ihre alten Trust-Profile beibehalten wollen, gehen Sie wie 

+      folgt vor, um die Profile auf den aktuellen Stand zu bringen:

+

+    1)  Ergänzen Sie ihre Trustprofile durch alle Zertifikate aus den 

+        entsprechenden Profilen im Verzeichnis 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles, die nicht in Ihren 

+        Profilen enthalten sind. Am einfachsten ist es, wenn Sie den Inhalt 

+        der einzelnen Profile aus der Distribution 

+        (MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles) in die entsprechenden 

+        Profile Ihrer Installation (CATALINA_HOME\conf\moa-spss\trustProfiles) 

+        kopieren und dabei die vorhandenen gleichnamigen Zertifikate 

+        überschreiben), also z.B: Kopieren des Inhalts von 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles\

+        MOAIDBuergerkarteAuthentisierungsDatenMitTestkarten nach 

+        CATALINA_HOME\conf\moa-spss\trustProfiles\

+        MOAIDBuergerkarteAuthentisierungsDatenMitTestkarten usw.

+   

+7. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im

+   Logging von MOA ID beim Einlesen der Konfiguration.

+   

+...............................................................................

+B.2 Durchführung eines Updates von Version 1.5.0

 ...............................................................................

 

 1. Stoppen Sie den Tomcat, in dem Ihre bisherige Installation betrieben wird.

@@ -84,13 +158,48 @@ B.1 Durchführung eines Updates von Version 1.5.0
    betreiben, sondern es von MOA ID über die API-Schnittstelle angesprochen

    wird, lautet dieses Stammverzeichnis für gewöhnlich

    CATALINA_HOME_ID/conf/moa-spss.

+   

+9. Update des Cert-Stores.

+   Kopieren Sie den Inhalt des Verzeichnisses

+   MOA_ID_INST_AUTH\conf\moa-spss\certstore in das Verzeichnis

+   CATALINA_HOME\conf\moa-spss\certstore. Wenn Sie gefragt werden, ob Sie 

+   vorhandene Dateien oder Unterverzeichnisse überschreiben sollen, dann 

+   bejahen sie das.

+

+10. Update der Trust-Profile. Wenn Sie Ihre alten Trust-Profile durch die Neuen ersetzen 

+   wollen, dann gehen Sie vor, wie in Punkt a). Wenn Sie Ihre eigenen Trust-Profile 

+   beibehalten wollen, dann gehen Sie vor, wie in Punkt b).

+

+   a. Gehen Sie wie folgt vor, um die Trust-Profile auszutauschen:

+

+    1)  Löschen Sie das Verzeichnis CATALINA_HOME\conf\moa-spss\trustprofiles.

+    2)  Kopieren Sie das Verzeichnis 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles in das Verzeichnis 

+        CATALINA_HOME\conf\moa-spss.

+

+   b. Falls Sie Ihre alten Trust-Profile beibehalten wollen, gehen Sie wie 

+      folgt vor, um die Profile auf den aktuellen Stand zu bringen:

+

+    1)  Ergänzen Sie ihre Trustprofile durch alle Zertifikate aus den 

+        entsprechenden Profilen im Verzeichnis 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles, die nicht in Ihren 

+        Profilen enthalten sind. Am einfachsten ist es, wenn Sie den Inhalt 

+        der einzelnen Profile aus der Distribution 

+        (MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles) in die entsprechenden 

+        Profile Ihrer Installation (CATALINA_HOME\conf\moa-spss\trustProfiles) 

+        kopieren und dabei die vorhandenen gleichnamigen Zertifikate 

+        überschreiben), also z.B: Kopieren des Inhalts von 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles\

+        MOAIDBuergerkarteAuthentisierungsDatenMitTestkarten nach 

+        CATALINA_HOME\conf\moa-spss\trustProfiles\

+        MOAIDBuergerkarteAuthentisierungsDatenMitTestkarten usw.

  	

-9. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im

+11. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im

    Logging von MOA ID beim Einlesen der Konfiguration.

 

 

 ...............................................................................

-B.1 Durchführung eines Updates von Version 1.4.8

+B.3 Durchführung eines Updates von Version 1.4.8

 ...............................................................................

 

 1. Stoppen Sie den Tomcat, in dem Ihre bisherige Installation betrieben wird.

@@ -156,12 +265,47 @@ B.1 Durchführung eines Updates von Version 1.4.8
 	Konfiguration vorhanden ist. URIs für lokale BKUs müssen nicht 

 	angegeben werden.

 	

-10. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im

+10. Update des Cert-Stores.

+   Kopieren Sie den Inhalt des Verzeichnisses

+   MOA_ID_INST_AUTH\conf\moa-spss\certstore in das Verzeichnis

+   CATALINA_HOME\conf\moa-spss\certstore. Wenn Sie gefragt werden, ob Sie 

+   vorhandene Dateien oder Unterverzeichnisse überschreiben sollen, dann 

+   bejahen sie das.

+

+11. Update der Trust-Profile. Wenn Sie Ihre alten Trust-Profile durch die Neuen ersetzen 

+   wollen, dann gehen Sie vor, wie in Punkt a). Wenn Sie Ihre eigenen Trust-Profile 

+   beibehalten wollen, dann gehen Sie vor, wie in Punkt b).

+

+   a. Gehen Sie wie folgt vor, um die Trust-Profile auszutauschen:

+

+    1)  Löschen Sie das Verzeichnis CATALINA_HOME\conf\moa-spss\trustprofiles.

+    2)  Kopieren Sie das Verzeichnis 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles in das Verzeichnis 

+        CATALINA_HOME\conf\moa-spss.

+

+   b. Falls Sie Ihre alten Trust-Profile beibehalten wollen, gehen Sie wie 

+      folgt vor, um die Profile auf den aktuellen Stand zu bringen:

+

+    1)  Ergänzen Sie ihre Trustprofile durch alle Zertifikate aus den 

+        entsprechenden Profilen im Verzeichnis 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles, die nicht in Ihren 

+        Profilen enthalten sind. Am einfachsten ist es, wenn Sie den Inhalt 

+        der einzelnen Profile aus der Distribution 

+        (MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles) in die entsprechenden 

+        Profile Ihrer Installation (CATALINA_HOME\conf\moa-spss\trustProfiles) 

+        kopieren und dabei die vorhandenen gleichnamigen Zertifikate 

+        überschreiben), also z.B: Kopieren des Inhalts von 

+        MOA_ID_INST_AUTH\conf\moa-spss\trustProfiles\

+        MOAIDBuergerkarteAuthentisierungsDatenMitTestkarten nach 

+        CATALINA_HOME\conf\moa-spss\trustProfiles\

+        MOAIDBuergerkarteAuthentisierungsDatenMitTestkarten usw.

+	

+12. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im

    Logging von MOA ID beim Einlesen der Konfiguration.

 

 

 ...............................................................................

-B.2 Durchführung eines Updates von Version 1.4.3 oder 1.4.4 oder 1.4.5 oder 

+B.4 Durchführung eines Updates von Version 1.4.3 oder 1.4.4 oder 1.4.5 oder 

     1.4.6

 ...............................................................................

 

@@ -321,7 +465,7 @@ B.2 Durchführung eines Updates von Version 1.4.3 oder 1.4.4 oder 1.4.5 oder
    Logging von MOA ID beim Einlesen der erneuerten Konfiguration.

 

 ...............................................................................

-B.3 Durchführung eines Updates von Version 1.4.1 oder 1.4.2 (incl. beta 1)

+B.5 Durchführung eines Updates von Version 1.4.1 oder 1.4.2 (incl. beta 1)

 ...............................................................................

 

 1. Stoppen Sie den Tomcat, in dem Ihre bisherige Installation betrieben wird.

@@ -480,7 +624,7 @@ B.3 Durchführung eines Updates von Version 1.4.1 oder 1.4.2 (incl. beta 1)
    Logging von MOA ID beim Einlesen der erneuerten Konfiguration.

    

 ...............................................................................

-B.4 Durchführung eines Updates von einer älteren Version

+B.6 Durchführung eines Updates von einer älteren Version

 ...............................................................................

 

 Bitte führen Sie eine Neuinstallation von MOA ID laut Handbuch durch und passen