SiteVision 2.0 Driftdokumentation 1
Innehållsförteckning 1 Introduktion...3 2 Installation... 4 2.2 Katalogstruktur... 4 2.3 Tjänster... 4 3 Backup-hantering... 5 3.2 Backup av filer... 5 3.3 Återställning från backup... 6 3.4 Partiell återställning från backup... 6 4 Felsökning... 6 2
1 Introduktion Syftet med detta dokument är att fungera som stöd för de som ansvarar för driften av SiteVision på en server. Dokumentet innehåller en beskrivning över de tjänster och kataloger som skapats samt information om backup-hantering. 3
2 Installation Detta avsnitt beskriver de kataloger och tjänster som skapas på en server där SiteVision installeras. 2.2 Katalogstruktur Denna katalogstruktur gäller för Windows. För Linux, se separat dokument: SiteVision RPMpaketering. Vid installation av SiteVision skapas ett antal kataloger och filer. I tabellen nedan finns en beskrivning av de viktigaste kataloger- och filerna. /custom /custom/conf /custom/conf/apache /custom/conf/iis /custom/deploy /data /app /server Katalogstrukturen under custom innehåller de konfigurationsinställningar som är specifika för varje installation. Konfigurationsfilen system.properties innehåller inställningar för SiteVisions systemlösenord samt när backupjobbet skall startas. Konfigurationsfilen workers.properties innehåller inställningar som används av Tomcat som SiteVision utnyttjar. Här finns bland annat inställningar för var Java finns installerat på servern. Konfigurationsfiler som används när SiteVision utnyttjar webbservern Apache. Innehåller konfigurationsfiler som används när SiteVision utnyttjar webbservern IIS. Tredjepartsportlets ligger här Data som skapas i SiteVision lagras i denna katalogstruktur, se avsnittet om backuphanteringen för en mer detaljerad beskrivning. Innehåller programvaran SiteVision. Katalogstruktur som innehåller Tomcat som SiteVision använder sig av. 2.3 Tjänster Windows NT/2000/XP/2003 Vid installation registreras en SiteVision tjänst under Windows. För att SiteVision skall fungera krävs det att både denna tjänst samt den webbserver som systemet utnyttjar är startad. Unix (Linux/Solaris) Det finns två skript som används i Unix-miljö. Dessa hittar du under /server/bin. catalina.sh start kör igång SiteVision(via webbcontainer Tomcat) catalina.sh stop avslutar denna process. Se separat dokument, SiteVision RPM-paketering, för mer information. 4
3 Backup-hantering Detta avsnitt beskriver de backup-möjligheter som finns i SiteVision. 3.2 Backup av filer Data i SiteVision sparas i katalogen /data som innehåller följande understruktur. /data/archive /data/backup /data/dictionaries /data/export /data/import /data/jisp /data/files /data/license /data/log /data/mckoi /data/search Katalog för manuellt exporterade sidor Katalog dit SiteVision kopierar en backupkopia av sin interna databas. Filer heter sitevision.database.gz och sitevision.index.gz. Innehåller den eller de ordböcker som rättstavningsfunktionen använder sig av. Katalog dit webbplatser som exporteras hamnar.(används internt av systemet) Katalog där webbplatser som skall importeras ligger. (Används internt av systemet) SiteVision's interna databas där data lagras. Lagring av bifogade filer Lagring av de licenser som finns installerad på servern. Katalogen innehåller systemloggar samt besöksloggar för de webbplatser som finns uppsatta. De moduler som utnyttjar databasen McKoi lagrar sin data i denna katalog. Lagring av de sökindex som den interna sökmotor Lucene skapar. Vid backup-tagning av SiteVision så bör nedanstående kataloger inkluderas. /data/backup /data/license /data/files Dessa innehåller det huvudsakliga data som är relevant för SiteVision. Övriga katalogen innehåller data som inte är kritiskt (t.ex. /data/dictionaries), eller som enkelt kan återskapas (t.ex. /data/search). Obs! Under inga omständigheter får katalogen /jisp inkluderas i backup-hantering då katalogen innehåller filer som inte kan läsas av SiteVision och backup-verktyg samtidigt. Det är av den anledningen som SiteVision själv explicit exporterar data katalogen backup. Standardinställningen för SiteVision är att skapa backupen av databasen klockan 2 på morgonen. Detta är inställbart, och ändras genom att modifiera filen /custom/conf/system.properties. Inställningarna ser ut som följer: # Backup time (hh:mm) senselogic.sitevision.backuptime=02:00 För att ändringen skall slå igenom krävs att SiteVision startas om. 3.3 Återställning från backup Om databasen har blivit korrupt av någon anledning och data skall återtas från backup skall följande protokoll följas. 1. Hämta tillbaka data/backup/sitevision.database.gz & /backup/sitevision.index.gz från backupmedia 2. Stäng av SiteVision. 5
3. Packa upp data/backup/sitevision.database.gz och /backup/sitevision.index.gz och placera filerna i /data/jisp 4. Starta SiteVision Databasen är nu återställd till det läge som fanns i backup-filen. 3.4 Partiell återställning från backup I vissa lägen är det olämpligt att ta tillbaka hela databasen från backup, t.ex. om bara en liten del av databasen är trasig eller om mycket jobb gjorts sedan senast giltiga backup. I dessa fall finns det möjlighet att göra partiella återställningar från backup, där endast de delar som gått sönder återtas. Detta kan endast utföras av personal från Senselogic. Kontakta Senselogic support i dessa fall. 4 Felsökning Om ett fel uppstår kan du följa tipsen nedan. Du kan se meddelanden från SiteVision i loggen /data/log/server.log. Där skrivs information om de olika saker som händer i systemet, och denna fil är väldigt värdefull vid felsökning. Denna kan även hämtas via webdav (http://<hostnamn>/webdav/data/log/server.log), och det går att följa loggen i realtid på följande address: http://<hostnamn>/editor/log Kontrollera att disken inte är slut. Serverloggen innehåller då normalt Disk write error. Om så är fallet finns det risk för att databasen har blivit korrupt. Kontakta Senselogic för vidare hjälp. När 100 MB återstår av disken skickas en varning med mail till serveransvarig. När mindre än 50 MB återstår stängs SiteVision automatiskt av. Kontrollera att uppkopplingen till katalogtjänsten fungerar. Serverloggen innehåller då normalt Connection timeout meddelanden. Kontrollera att eventuella mailkopplingar fungerar. 6