Kapitel 5 Problem som rör dokumentationen

I det här kapitlet beskrivs kända dokumentationsproblem.

Fel i dokumentationen

Dokument som påverkas: Bilaga A, “Solaris Schema” in Solaris WBEM Developer's Guide

Bilaga A, Solaris-schemat i den nya Solaris WBEM Developer's Guide tar upp referenser till MOF-filer som har uppdaterats från de MOF-filer som tidigare dokumenterades i Solaris WBEM SDK Developer's Guide. Referenser till de nya filerna Solaris_DMGT1.0.mof och Solaris_VM2.0.mof skulle inte ha varit med i den nya Solaris WBEM Developer's Guide. De här två filerna finns inte med i den här versionen.

Dokument som påverkas: “Solaris Developer Documentation” i Nyhetssamling för Solaris 9 4/03

I beskrivningen av den nya Solaris WBEM Developer's Guide nämns att referenser till MOF-filer har uppdaterats i bilagan för den här nya boken, från de MOF-filer som tidigare dokumenterades i Solaris WBEM SDK Developer's Guide. Den nya WBEM Developer's Guide och Nyhetssamlingen skulle dock inte ha innehållit referenser till de nya filerna Solaris_DMGT1.0.mof eller Solaris_VM2.0.mof. De här två filerna finns inte med i den här versionen.

Dokument som påverkas: Solaris WBEM Developer's Guide

I CIM-schemat för Solaris har följande klasser och egenskaper märkts med kvalifieraren Deprecated.

• Klassen Solaris_LogRecord

• Klassen Solaris_LogService

• Klassen Solaris_LogServiceSetting

• Klassen Solaris_LogServiceSetting

• Egenskapen OptionsEnabled i klassen Solaris_IPProtocolEndpoint

Använd passande alternativ för de här föråldrade klasserna och egenskaperna. Ta del av klassbeskrivningskvalifierarna för att avgöra vilka klass- och egenskapsalternativ som är de korrekta.

Dokument som påverkas: “Writing a Client Program” in Solaris WBEM Developer's Guide

I “Writing a Client Program” finns information om hur du skapar WBEM-klienter som använder RMI-protokollet tillsammans med API:n javax.com.sun.client . Om du vill ansluta till en server som kör operativmiljön Solaris 8 måste du inkludera filen /usr/sadm/lib/wbem/cimapi.jar i klientens CLASSPATH. I filen cimapi.jar finns de com.sun.wbem-klasser som krävs för att kommunicera med en server som kör operativmiljön Solaris 8.

Dokument som påverkas: Sun ONE Application Server 7 Developer's Guide

Denna dokumentation gäller användningen av indexerade installationskataloger.

Installerade program indexeras via nummerschemat i katalognamnet. Med den här indexeringsmekanismen kan en utvecklare ändra en JAR- eller klassfil som associeras med det installerade programmet. Den här mekanismen är viktig för Windows-plattformen eftersom ett fillås placeras på en öppen fil som skrivs över då ett fildelningsfel inträffar. Filen installeras på serverinstansen eller IDE:n när sessionen startas. Det finns två alternativ för att kringgå delningsfelet:

• Om du vill att den uppdaterade klassfilen ska laddas före de gamla klasserna kompilerar du filen (ursprungligen en del av JAR-filen) och placerar den först i klassökvägen. Tillåt sedan att det här programmet uppdateras av Sun ONE Application Server (så länge som uppdateringen är aktiv).

• Uppdatera JAR-filen, skapa en ny EAR-fil och installera om programmet.

Det är inte nödvändigt att installera programmet på Solaris-plattformen igen eftersom det inte finns några fillåsbegränsningar.

Se upp för andra ändringar när du ändrar ett program som redan installerats på Windows-plattformen för IDE-installation, ANT-filkopiering, kompilering eller andra åtgärder. Som lösning på fillåsbegränsningen skapas en ny katalog med ett graderat indexnummer. På till exempel Solaris-plattformen installeras J2EE-programmet, helloworld, på Sun ONE Application Server med följande katalogstruktur:

appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_1

En ändring görs sedan på en servlet som ingår i det här installerade programmet (t ex HelloServlet.java). Sun ONE Studio IDE startas, källfilen för denna servlet ändras och kompileras med javac-målet angivet till ovanstående katalog. Om källan kompilerats på rätt plats finns det en uppdateringsfil för det här programmet. Uppdateringsflaggan i server.xml får värdet sant och om serverinstansen körs gäller ändringarna utan att programmet behöver återskapas eller installeras igen.

På Windows-plattformen går inte JAR-filen eller klassfilen att ändra eller uppdatera på grund av problemet med fillåset. Därför finns det två sätt att lösa det här problemet på Windows:

• Kompilera den ändrade källfilen och planera klassfilen eller JAR-filen i klassökvägen så att ändringarna i källkoden träder i kraft.

• Gör ändringarna i källkoden till helloworld, assemblera den, och återinstallera den utan att avinstallera tidigare version av helloworld.

Det andra alternativet är att föredra eftersom det innebär att det graderade indexnumret läggs till i det installerade programmets katalognamn. Efter den andra installationen av helloworld ser katalogstrukturen ut på följande sätt:

appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_1

appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_2

Den andra installationen av helloworld utförs under helloworld_2.