                                        README
                         Ausführung des Applets GetPackageInfoAp



GetPackageInfoAp ist ein Java-Applet, mit dem Sie die auf einem System, auf dem auch Solaris-WBEM-Services ausgeführt werden, installierten Solaris-Softwarepakete auflisten können. Sie können ein Paket auswählen und ausführliche Informationen dazu anzeigen.

Mit diesem Applet können 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
============
Für die Ausführung des Applets benötigen Sie eines der Folgenden:

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

Ausführen des Applets mit Appletviewer
=====================================

Das GetPackageInfoAp-Applet kann mit dem JDK 1.2 Appletviewer ausgeführt werden.

So führen 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


Ausführen 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 führt das Applet aus.

Sie können das Applet GetPackageInfoAp in einem Java-fähigen Web-Browser ausführen, der entweder JRE (Java Runtime Environment) 1.2.2 enthält 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, müssen Sie unter Umständen das Java Plug-in 1.2.2 herunterladen.
Java[tm] Plug-In (JPI) ist ein Produkt, mit dem Kunden bestimmen können, dass die Applets auf ihren Internetseiten durch Sun Java 2 Runtime Environment, Standard Edition JRE anstatt durch die standardmäßige virtuelle Maschine des Web-Browsers ausgeführt werden.
 
1. Starten Sie den Browser, und öffnen Sie diese Datei:

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

2. Wenn Ihr Browser nicht für 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, müssen Sie möglicherweise 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 ausführen und /usr/java1.2/jre verwenden, bearbeiten Sie /usr/java1.2/jre/lib/security/java.security.

Diese Datei mit Applet-Sicherheitsrichtlinien gewährt alle Zugriffsberechtigungen. Sie können die Richtlinie entweder verschärfen oder die Zeile aus der Datei java.security entfernen, sobald Sie mit dem Testen fertig sind.

Fügen 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 Geschwindigkeitsgründen ruft GetPackageInfoAp nur die ersten neun Pakete ab. Sie können aber den Code so ändern, dass alle Pakete abgerufen werden. Siehe hierzu /usr/demo/wbem/applet/GetPackageInfoAp.java.

Vergewissern Sie sich für die Kompilierung, dass Ihre Umgebungskonfiguration JDK1.2 sowie den folgenden Klassenpfad enthält:
CLASSPATH=.:/usr/sadm/lib/wbem/cimom.jar:/usr/sadm/lib/wbem/cimapi.jar:/usr/sadm/lib/xml.jar


So aktivieren Sie die Eigenschaften für 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 für Socket-Verbindungen zu befähigen.

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

2. Suchen Sie den folgenden Abschnitt:

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

3. Fügen 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>


