                                        README
                         Ausfhrung des Applets GetPackageInfoAp



GetPackageInfoAp ist ein Java-Applet, mit dem Sie die auf einem System, auf dem auch Solaris-WBEM-Services ausgefhrt werden, installierten Solaris-Softwarepakete auflisten knnen. Sie knnen ein Paket auswhlen und ausfhrliche Informationen dazu anzeigen.

Mit diesem Applet knnen Sie eine Verbindung zu einem CIM Object Manager auf Ihrem lokalen oder auf einem entfernten System herstellen.

Beachten Sie bitte, dass die hier vorliegenden Beispiele aus der Solaris-Plattform entnommen sind, dass /usr/java auf jdk1.2 zeigt und dass WBEM-Dateien im Verzeichnis "/usr" installiert sind.

Anforderungen
============
Fr die Ausfhrung des Applets bentigen Sie eines der Folgenden:

- Java Development Kit (JDK) 1.2 Appletviewer
- Netscape Navigator 4.7
- Java-fhigen Web-Browser, der mit JRE 1.2.2 arbeitet oder in dem die Software Java Plug-in 1.2.2 Software aktiviert ist
- Sie mssen dieses Applet auf einem Client ausfhren, der ber Netzwerk auf ein System mit installiertem CIM Object Manager zugreifen kann.

Ausfhren des Applets mit Appletviewer
=====================================

Das GetPackageInfoAp-Applet kann mit dem JDK 1.2 Appletviewer ausgefhrt werden.

So fhren Sie das Applet GetPackageInfoAp mit dem Appletviewer aus:

1.  Geben Sie folgenden Befehl ein:

appletviewer -J-Djava.security.policy=/usr/demo/wbem/applet/applet.policy 
/usr/demo/wbem/applet/GetPackageInfoAp.html


Ausfhren des Applets in Netscape(r) Navigator 4.7 
==================================================

Der Browser Netscape Navigator 4.7, der mit Solaris 8 installiert wird, umfasst JRE 1.2.2 und fhrt das Applet aus.

Sie knnen das Applet GetPackageInfoAp in einem Java-fhigen Web-Browser ausfhren, der entweder JRE (Java Runtime Environment) 1.2.2 enthlt oder so konfiguriert ist, dass er die Java-Plug-in-Software 1.2.2 verwendet.

Sollte Ihr Netscape Navigator 4.7 Browser nicht aus dem Lieferumfang von Solaris 8 stammen, mssen Sie unter Umstnden das Java Plug-in 1.2.2 herunterladen.
Java[tm] Plug-In (JPI) ist ein Produkt, mit dem Kunden bestimmen knnen, dass die Applets auf ihren Internetseiten durch Sun Java 2 Runtime Environment, Standard Edition JRE anstatt durch die standardmige virtuelle Maschine des Web-Browsers ausgefhrt werden.
 
1. Starten Sie den Browser, und ffnen Sie diese Datei:

   /usr/demo/wbem/applet/GetPackageInfoAp.html

2. Wenn Ihr Browser nicht fr die Verwendung der Software Java Plug-in 1.2.2 konfiguriert ist, werden Sie dazu aufgefordert, diese Software herunterzuladen.

3. Laden Sie die Software Java Plug-in 1.2.2 herunter und installieren Sie sie gem den Anweisungen auf der Website auf Ihrem System.

    Solaris - http://www.sun.com/software/solaris/netscape/jpis/index.html
    Windows - http://java.sun.com/products/jdk/1.2/jre/download-windows.html

    Hinweise zur Verwendung von Plug-ins in Netscape finden Sie unter
    http://www.netscape.com/plugins/index.html.

    HINWEIS: Bei einem Solaris-System, auf dem mehrere Versionen von Netscape installiert sind, mssen Sie mglicherweise die Umgebungsvariable PX_PLUGIN_PATH auf den Pfad zu der Java Plug-in-Software setzen. Wenn Sie die Java Plug-in-Software beispielsweise in /opt/NSCPcom/plugins installiert haben, setzen Sie NPX_PLUGIN_PATH wie folgt:

	setenv NPX_PLUGIN_PATH /opt/NSCPcom/plugins

4. Bearbeiten Sie die Datei java.security im Verzeichnis lib/security, in dem Java Runtime Environment installiert ist. Wenn Sie z. B. Java 1.2 unter Solaris 8 ausfhren und /usr/java1.2/jre verwenden, bearbeiten Sie /usr/java1.2/jre/lib/security/java.security.

Diese Datei mit Applet-Sicherheitsrichtlinien gewhrt alle Zugriffsberechtigungen. Sie knnen die Richtlinie entweder verschrfen oder die Zeile aus der Datei java.security entfernen, sobald Sie mit dem Testen fertig sind.

Fgen Sie diese Zeile an das Ende des folgenden Abschnitts in der Datei an:

policy.url.3=file:///usr/demo/wbem/applet/applet.policy

# Standard ist es, eine einzige systemweite Richtliniendatei 
# und eine Richtliniendatei in dem Home-Verzeichnis des Benutzers zu verwenden.
policy.url.1=file:${java.home}/lib/security/java.policy
policy.url.2=file:${user.home}/.java.policy

5. Beenden Sie den Netscape-Browser, starten Sie ihn neu, und ffnen Sie das Applet:

   /usr/demo/wbem/applet/GetPackageInfoAp.html



Anpassen des Applets
====================

Aus Geschwindigkeitsgrnden ruft GetPackageInfoAp nur die ersten neun Pakete ab. Sie knnen aber den Code so ndern, dass alle Pakete abgerufen werden. Siehe hierzu /usr/demo/wbem/applet/GetPackageInfoAp.java.

Vergewissern Sie sich fr die Kompilierung, dass Ihre Umgebungskonfiguration JDK1.2 sowie den folgenden Klassenpfad enthlt:
CLASSPATH=.:/usr/sadm/lib/wbem/cimom.jar:/usr/sadm/lib/wbem/cimapi.jar:/usr/sadm/lib/xml.jar


So aktivieren Sie die Eigenschaften fr Netscape Communicator
security.lower_java_network_security_by_trusting_proxies. (Genaueres entnehmen Sie bitte der Netscape-Website unter http://www.netscape.com oder http://developer.netscape.com/tech/security/index.html)


Aktivieren der "Phone Home"-Funktion im Java-Applet
=================================================== 

Gehen Sie wie folgt vor, um die Funktion "Phone Home" im Java-Applet zu aktivieren oder es fr Socket-Verbindungen zu befhigen.

1. Bearbeiten Sie /usr/demo/wbem/applet/GetPackageInfoAp.html

2. Suchen Sie den folgenden Abschnitt:

    <body>
    <h1>Get Package Parameters</h1>

3. Fgen Sie die folgenden Zeilen hinzu:

      <SCRIPT LANGUAGE="JavaScript1.2" ARCHIVE="ScriptSigs.jar" 
ID="ReadPrefScript">

netscape.security.PrivilegeManager.enablePrivilege("UniversalPreferencesRead");
              var prefValue = 
navigator.preference("security.lower_java_network_security_by_trusting_proxies"
);
              document.write("Der aktuelle Wert der Proxy-Einstellung ist: " + 
prefValue);
      </SCRIPT>
      <SCRIPT LANGUAGE="JavaScript1.2" ARCHIVE="ScriptSigs.jar"
ID="WritePrefScript">
              
netscape.security.PrivilegeManager.enablePrivilege("UniversalPreferencesWrite")
;

navigator.preference("security.lower_java_network_security_by_trusting_proxies"
, 
"true");
      </SCRIPT>


