Kapitel 5 Problem som rör dokumentationen

I det här kapitlet beskrivs kända dokumentationsproblem. Mer information om dokumentationsproblem som upptäckts för sent för att komma med i den här tilläggsinformation finns i Tilläggsinformation för Solaris 9 12/03 på http://docs.sun.com/db/doc/817-3465.

Följande dokumentationsproblem har lagts till i detta kapitel sedan det här dokumentet publicerades på dokumentations-cd:n för Solaris 9 12/03 och i installationskiosken på installations-cd:n för Solaris 9 12/03.

• Berörda dokument: Installationsguide för Solaris 9 12/03

• Berörda dokument: “Administering DHCP (Task)” in System Administration Guide: IP Services

Fel i dokumentationen

Berörda dokument: Installationsguide för Solaris 9 12/03

Exempel 41-8, ”Installera med lokalt cd-media” anger felaktigt att du kan ange en säker HTTP URL som plats för wanboot-cgi-programmet. Värdet på bootserver-variabeln måste vara en HTTP URL, i formatet: http:/ip-adress/ sökväg/wanboot-cgi.

Berörda dokument: “Administering DHCP (Task)” in System Administration Guide: IP Services

Avsnittet ”Creating DHCP Options and Macros for Solaris Installation Parameters” borde inkludera följande information om alternativ för storleksbegränsningar för DHCP-leverantörer:

Notera att totalsumman av de värden som skrivits till alla alternativen i ett makro inte får överstiga 255 bytes, inklusive alternativkoden och längdinformationen. Storleken anges av DHCP-protokollet.

I allmänhet bör du inte använda mer leverantörsinformation än nödvändigt. Du bör använda korta sökvägsnamn i alternativ som kräver sökvägsnamn. Om du skapar symboliska länkar till långa sökvägar, kan du använda kortare länknamn.

Berörda dokument: Sun WBEM SDK Developers 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 lämpliga alternativ på dessa föråldrade klasser och egenskaper. Använd klassbeskrivningskvalifieraren för att bestämma rätt klass- och egenskapsalternativ.

Berörda dokument: “Writing Client Applications” in Sun WBEM SDK Developers 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 programvaran 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 programvaran Solaris 8.

Berörda dokument: Sun ONE Application Server 7 Developer's Guide

Det här dokumentationen gäller användningen av indexerade startkataloger.

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 laddas i serverinstansen eller IDE:t under uppstart av sessionen. Två alternativ är möjliga i fallet om detta fildelningsfel:

• 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 återstarta 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 helloworld-källkoden, återskapa och återinstallera filen utan att avinstallera föregående installation 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.