WebShare UB+ Benutzerhandbuch

7 WebShare File Server

"websharesrv" ist der Programmname des WebShare File Servers. Das Programm kann auf dem Host laufen, auf welchem die HELIOS Server EtherShare oder PCShare installiert sind und wird durch den HELIOS Service Controller gesteuert (siehe HELIOS Base Handbuch). Es startet einen eigenen Prozess für jeden angemeldeten Benutzer.

Der WebShare File Server bietet verschiedene nützliche Funktionen für die Benutzer- und Dokumentenverwaltung, wie Benachrichtigung per E-Mail bei Benutzeranmeldung am Server, zusätzliche Anpassung von WebShare Aktionsskripten usw.

7.1 Benutzer-Konfigurationsdatei

"HELIOSDIR/var/conf/webshare.passwd" ist die Benutzer-Konfigurationsdatei für den WebShare File Server. In ihr werden, zusammen mit dem Kennwort eines jeden Benutzers, die individuellen Benutzereinstellungen gespeichert. Einstellungen, die im Fenster "Persönliche Voreinstellungen" ( Kapitel 5.6 "Meine Benutzereinstellungen") gemacht wurden, werden in dieser Datei gesichert:

heliosuser::::zs=1,nocp=1:::

martin::::zs=1,nocp=0:::

ws1:md5_dd1c91f5d657b421c339592f:demo::zs=1,nocp=1:::

Jede Zeile der Konfigurationsdatei "webshare.passwd" beginnt mit dem Benutzernamen gefolgt von mehreren, durch Doppelpunkte getrennte Felder. Das erste Feld (Benutzername) und das dritte Feld (Benutzer-ID) sind obligatorisch, die anderen Felder können auch leer bleiben.

Feld	Erläuterung
1. Benutzername	Name des virtuellen oder des Host-Benutzers
2. Kennwort	Kennwort (unverschlüsselt oder aus dem unverschlüsselten UTF-8 Kennwort generierter MD-5 Code). Eine Zeichenkette, die mit md5_ beginnt, ist ein verschlüsseltes Kennwort für virtuelle Benutzer.Für virtuelle Benutzer muss dieses Feld einen Kennworteintrag enthalten. Für Host-Benutzer kann dieses Feld leer bleiben, wenn kein zusätzliches WebShare Kennwort gesetzt wurde und das HELIOS Host-Kennwort benutzt wird. Wir raten Ihnen aber dennoch, ein zusätzliches Kennwort für WebShare zu setzen.
3. Host-Benutzer	Ein leeres Feld kennzeichnet einen Host-Benutzer. Für virtuelle Benutzer ist hier der Name eines Host-Benutzers eingetragen, dem der virtuelle Benutzer zugeordnet ist.
4. Feld Ablaufdatum	In diesem Feld kann ein Datum angegeben sein, nach dessen Ablauf sich ein Benutzer nicht mehr anmelden kann. Das Format ist: dd-MMM-yyyy-kk-mm Beispiel: 28-Feb-2004-14-21 Das Ablaufdatum wird im Feld Ablaufdatum im Fenster "Benutzer verwalten" gemäß der durch DateFormat (Kapitel 7.5 "Präferenzen") festgelegten Syntax eingegeben.
5. Feld	Durch Komma getrennte Optionen "zs" (zipstream) "nocp" (Kennwort kann nicht geändert werden) "pt" (Privilegierter Transfer) "br" (Branding) Für alle Präferenzen gilt: 1=TRUE; 0=FALSE Ausnahme: "br" (branding)=<branding_name> Beispiel: Ist zipstream aktiviert, zeigt dieses Feld "zs=1", ansonsten "zs=0". Ohne Eintrag ist zipstream aktiviert.
6. Feld	Client-Kodierung beim Hoch- und Herunterladen von Dateien
7. Feld	E-Mail Adresse des Benutzers Die E-Mail Adresse muss vollständig angegeben werden, z. B.: username@meinefirma.com
8. Feld	Kommentare Vergewissern Sie sich, dass Kommentare keine Sonderzeichen wie beispielsweise einen Doppelpunkt (":") enthalten. Diese würden durch einen Unterstrich ("_") ersetzt um die Dateikompatibilität von "webshare.passwd" zu wahren.

7.2 WebShare Dienstprogramme

Hinweis: "zipstream" und "unzipstream" befinden sich im Verzeichnis "HELIOSDIR/bin". Alle übrigen in diesem Abschnitt beschriebenen Skripte liegen im Verzeichnis "HELIOSDIR/etc/webshare/".

7.2.1 zipstream

Dieses Programm legt ein Zip-Archiv an, dem Sie Dateien und Ordner in komprimierter Form hinzufügen können. Die Vorteile von "zipstream" gegenüber dem Zip-Programm sind: Es werden während der Komprimierung keine temporären Dateien angelegt und das Herunterladen von Daten kann unmittelbar beginnen, ohne dass das Zip-Archiv schon angelegt worden ist. Dateiattribute wie Erstellungsdatum und Mac Ressourceinformationen werden als MacBinary kodiert, welches dann im komprimierten Zip-Archiv erhalten bleibt. Die für die Datei- und Ordnernamen im Dateisystem verwendete Kodierung ist UTF-8. Die Kodierung, die für Datei- und Ordnernamen im Zip-Archiv verwendet wird, kann je nach Client-System ausgewählt werden, z. B. MacRoman, PC850, ISO8859-1 oder UTF-8.

Gebrauch:

zipstream [options] file
zipstream -h (for help info)

Beispiel:

Legen Sie ein Zip-Archiv namens "archiv.zip" an und fügen Sie dem Archiv file1, file2, dir1 und dir2 hinzu:

zipstream -f archiv.zip file1 file2 dir1 dir2

Beispiel:

Legen Sie ein Zip-Archiv an und leiten Sie es zur Anwendung "tar" weiter:

zipstream file1 file2 dir1 dir2 | tar cvf test.tar -

Folgende Optionen stehen mit "zipstream" zur Verfügung:

-f

Das Zip-Archiv wird anstatt nach "stdout" in eine Datei geschrieben.

-C

Eingehende Dateien werden aus diesem Verzeichnis gelesen.

-l

Zip-Komprimierungsgrad. Gültige Werte reichen von 1 (höchste Geschwindigkeit ) bis 9 (beste Komprimierung). Der Vorgabewert ist 6.

-c

Die für Dateinamen im Zip-Archiv benutzte Kodierung. Vorgabe ist UTF8. Um alle verfügbaren Kodierungsmöglichkeiten aufzulisten verwenden Sie uniconv -l (siehe Base Handbuch).
"zipstream" wird mit dieser Option vom WebShare File Server aufgerufen, wenn aus dem Aufklappmenü Download Encoding im Fenster "Meine Benutzereinstellungen" oder "Benutzer verwalten" eine Kodierung ausgewählt wurde.

Hinweis: Als "zipstream"-Kodierung des Servervolumes wird immer UTF-8 angenommen. Volumes, die nicht UTF-8 kodiert sind, werden nicht von "zipstream" unterstützt.

-S

Die geschätzte Größe des Zip-Archivs wird nach "stdout" ausgegeben (8 byte integer, network byte order)

-s

Die geschätzte Größe des Zip-Archivs wird nach "stdout" ausgegeben (4 byte integer, network byte order).

-b

Die Ausgabe erfolgt in Blöcken von n kBytes. Der Vorgabewert ist 32 kB.

-n

Es wird kein Zip-Streaming Format verwendet.

"zipstream" wird mit dieser Option vom WebShare File Server aufgerufen, wenn die Option Zip-Streaming Format deaktiviert ist.

-m

Daten- und Ressourcezweig einer Mac Datei werden als MacBinary kodiert.

-t

Dateikommentare werden in MacBinary eingebunden (Option -m muss gleichzeitig auch gesetzt sein).

-r

".rsrc"-Verzeichnisse werden beibehalten. Standardmäßig werden ".rsrc"-Verzeichnisse nämlich beim Anlegen eines Zip-Archivs übergangen. Wenn -m gesetzt ist, hat diese Option keine Auswirkungen.

-e

Dem Zip-Archiv wird die Datei "DownloadLog.txt", die Dateizugriffsfehler und, falls -v gesetzt ist, Erklärungen in Wortform beinhaltet, hinzugefügt.

-v

Erklärungen in Wortform werden nach "stderr" ausgegeben oder, falls -e auch gesetzt ist, in die Datei "DownloadLog.txt" in das Zip-Archiv geschrieben.

-x

Mac OS X Finder kompatible Zip-Archive werden erstellt. Solche Zip-Archive sind auch mit Safari kompatibel, so dass keine zusätzliche Software für Archivierungszwecke benötigt wird.

-z

Symbolische Links werden aufgelöst und die Dateien dann dem Zip-Archiv hinzugefügt.

7.2.2 unzipstream

Das Dienstprogramm "unzipstream" entpackt Zip-Archive und dekodiert MacBinary Dateien.

Dabei liest es standardmäßig die Zip- oder MacBinary Datei von "stdin" ein. Mit der Option -f kann dann eine Zip- oder MacBinary-Eingangsdatei ausgewählt werden. Ausgegebene Dateien werden unter den Namen, die in der Zip- oder MacBinary-Datei definiert sind, gesichert. Handelt es sich bei der Eingangsdatei weder um eine Zip- noch um eine MacBinary-Datei, wird sie nach "stdout" oder in die mit der Option -o festgelegten Datei ausgegeben. Die Option -C legt das Zielverzeichnis für die Ausgabedateien fest. Der Name eines Benachrichtigungsskripts, das immer dann aufgerufen wird, wenn eine Datei auf die Festplatte geschrieben wird, kann mit der Option -n definiert werden. Dieses Skript wird dann mit zwei Parametern aufgerufen: dem temporären Dateinamen sowie dem Originalnamen der Datei.

Gebrauch:

unzipstream [options] file
unzipstream -h (for help info)

Beispiele:

Zeigt die Liste des Zip-Archivs bei angenommener Windows (PC850) Kodierung:

unzipstream -l -c PC850 -f archive.zip

Entpackt das Zip-Archiv, das von DropZip angelegt wurde, am Beispiel einer Mac (MacRoman) Kodierung:

unzipstream -c MacRoman -f archive.zip

Entpackt alle Dateien aus dem Archiv "abc.zip" in das Verzeichnis "/data/zips":
unzipstream -f abc.zip -C /data/zips

Hinweis: Als Kodierung für das Servervolume, auf welchem Zip-Dateien entpackt werden, wird immer UTF-8 angenommen. Volumes, die nicht UTF-8 kodiert sind, werden nicht von "unzipstream" unterstützt.

Folgende Optionen stehen mit "unzipstream" zur Verfügung:

-f

Anstelle von "stdin" wird aus dem Zip-Archiv gelesen.

-o

Der Dateiname wird angegeben. Diese Option wird nur dann benutzt, wenn die Eingangsdatei weder eine Zip- noch eine MacBinary-Datei ist.

-C

Die Ausgabedateien werden in dieses Verzeichnis geschrieben.

-c

Legt die Kodierung für Dateinamen im Zip-Archiv fest. Der Vorgabewert ist UTF8.

Mit dem Kommando uniconv -l (siehe HELIOS Base Handbuch) können alle verfügbaren Kodierungen aufgelistet werden.

-r

".rsrc"-Verzeichnisse werden beibehalten. Standardmäßig werden Dateien in ".rsrc"-Verzeichnissen nicht aus dem Zip-Archiv entpackt.

Hinweis: Um eine Übereinstimmung zwischen der Information in der Desktop-Datenbank eines HELIOS Volumes und den auf diesem Volume befindlichen Dateien/Ordnern zu gewährleisten, laden oder entpacken Sie ein Zip-Archiv, welches ".rsrc"-Verzeichnisse enthält, nicht direkt auf ein aktives HELIOS Volume. Verwenden Sie zu diesem Zweck besser die "dt" Tools (siehe Base Handbuch).

-n

Diese Option lässt Sie den Namen eines Benachrichtigungsskripts angeben, das immer dann aufgerufen wird wenn eine Datei entpackt wird. Das Skript wird mit den folgenden Parametern aufgerufen:

• Verzeichnis
• Temporärer Dateiname
• Originalname der Datei
• Dateityp ("Image" oder "NoImage")

-m

Gibt den MIME-Typ der Eingangsdatei an.

Wird die Option -m gesetzt, so nimmt "unzipstream" keine Überprüfung des Headers der Eingangsdatei vor um den Dateityp zu ermitteln. Der zurzeit einzig bekannte MIME-Typ ist "application/x-macbinary".

-l

Die Dateien werden aufgelistet statt entpackt.

-u

Zeigt "dot"-Dateien an, wobei der Punkt zu Beginn des Namens durch einen Unterstrich ersetzt wird.

Beispiel:

.DS_Store wird als _DS_Store dargestellt

-v

Erklärungen in Wortform werden nach "stderr" ausgegeben.

Beachten Sie bitte, dass, wenn eine Zip-Datei ihrerseits weitere Zip-Archive enthält, diese nicht weiter entpackt werden.

Das Kommando "dt" wird automatisch von den meisten WebShare Skripten und Dienstprogrammen aufgerufen. So wird sichergestellt, dass alle Änderungen sowohl auf den Daten- als auch auf den Ressourcezweig der Datei angewandt werden. Auf diese Weise genügen Sie den speziellen Anforderungen an ein HELIOS Volume.

Hinweis: Eine benutzerspezifische Anpassung des Perl-Skripts sollten Sie niemals direkt im Originalskript vornehmen. Kopieren Sie stattdessen das Skript in das Verzeichnis "HELIOSDIR/var/webshare". WebShare sucht immer erst in "var/webshare" nach Skripten und benutzt das Verzeichnis "etc/webshare" lediglich als Alternative, falls das Skript in "var/webshare" nicht verfügbar ist.

7.2.3 wscommon.pm

Diese Datei ist ein Library-Modul in Perl, welches von allen WebShare Perl Skripten verwendet wird. Es beinhaltet beispielsweise Informationen über weitere installierte HELIOS Produkte.

7.2.4 Umgebungsvariablen für Aktionsskripte

Eine Beschreibung der Umgebungsvariablen kann bei der Anpassung von WebShare Aktionsskripten und Dienstprogrammen hilfreich sein:

Umgebungsvariable	Beschreibung
WSUserEncoding	z. B. OS Default; Kodierung beim Herunterladen
WSAccept-Language	z. B. en-us; Standardsprache für die Darstellung von Webseiten
WSWindowsEncoding	z. B. PC850; Standard Windows Kodierung
WSStreamingZip	z. B. Yes; Zip-Streaming Format
WSMacintoshEncoding	z. B. MacRoman; Standard Mac OS Kodierung
WSUserId	z. B. 105; Effektive Benutzer-ID der aktuellen Sitzung
WSGroupId	z. B. 30; Effektive Gruppen-ID der aktuellen Sitzung
WSUser	Name des angemeldeten Benutzers
WSUserEMail	E-Mail Adresse des angemeldeten Benutzers
WSSessionSeq	z. B. 843-64; websharesrv Prozess ID (843) und Anzahl von Logins (64)
WSClientAddress	IP Adresse des angemeldeten Client
WSPREVIEWDIR	WebShare Cache Verzeichnispfad
WSUserAgent	z. B. Mozilla/5.0 (Mac; U; PPC Mac OS X Mach-O; en-US; rv:1.6) Gecko/20040113; Browserinformation
HELIOSDIR	z. B. /usr/local/helios; HELIOS Verzeichnispfad

7.2.5 wscopy.pl

Gebrauch:

wscopy.pl destdir srcdir files...

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Kopieren oder Einfügen aus dem Menü Bearbeiten > ausgewählt wird. "destdir" gibt das Zielverzeichnis, in das die ausgewählten Dateien und Ordner von "srcdir" aus kopiert werden, an.

7.2.6 wsmove.pl

Gebrauch:

wsmove.pl destdir srcdir files...

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Verschieben > aus dem Menü Bearbeiten > ausgewählt wird. "destdir" gibt das Zielverzeichnis, in das die ausgewählten Dateien und Ordner von "srcdir" aus verschoben werden, an.

7.2.7 wsdownload.pl

Gebrauch:

wsdownload.pl srcdir files...

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Download > aus dem Menü Transfer > ausgewählt wird. Das Verzeichnis "srcdir" gibt das aktuelle Verzeichnis der Web-Sitzung des Benutzers an. Das Argument files repräsentiert die Dateien und Ordner, die vom Benutzer zum Herunterladen markiert worden sind. "wsdownload" verwendet das WebShare Dientprogramm "zipstream" um ein während der Übertragung erstelltes Zip-Archiv ohne temporäre Dateien nach "stdout" zu leiten. Einstellungen wie z. B. das Zip-Format, die Kodierung des Dateinamens, die Unterstützung für MacBinary, die Client-Plattform (Mac oder Windows) werden automatisch durch das Skript "wsdownload" festgelegt.

7.2.8 wsdup.pl

Gebrauch:

wsdup.pl dir files...

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Duplizieren aus dem Menü Datei > ausgewählt wird.

7.2.9 wsmkdir.pl

Gebrauch:

wsmkdir.pl dir newdir

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Verzeichnis anlegen aus dem Menü Datei > ausgewählt wird.

7.2.10 wsmv.pl

Gebrauch:

wsmv.pl dir source dest

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Umbenennen aus dem Menü Datei > ausgewählt wird.

7.2.11 wspreview.pl

Gebrauch:

wspreview.pl srcfile dstfiletype previewfile resOptions page antialiasPDF

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn Sie einen Dateinamen in der Spalte "Name" des Sharepoints anklicken, die Voransichtsdatei sich aber nicht im Cache befindet (oder veraltet ist).

Parameter:

Name	Erläuterung
srcfile	Der vollständige Pfadname der Bild- oder Dokumentendatei, die der Benutzer zur Voransicht ausgewählt hat.
srcfiletype	Dateiformat des Dokuments, von dem eine Voransicht erzeugt werden soll.
dstfiletype	Der Dateityp des Vorschaubildes, üblicherweise JPEG oder PNG. Details finden Sie in Kapitel 7.4.4 "Formate der Voransichtsdateien".
previewfile	Der Pfad des Dateinamens der Voransicht. Der Dateiname legt den Namen, unter dem die Voransicht im Cache gesichert wird, fest.
resOptions	Dieser Parameter legt die Voransichtsoptionen für das ImageServer-Kommando "layout" fest. Mehrere Parameter werden durch eine vertikale Linie ("|") getrennt. Ein Beispiel: "ocoaLigature0 -oxpix=256|-orotate=90|-oflipvertical"ocoaLigature1.
page	Die Seitennummer, mit 1 beginnend, wird für mehrseitige Dokumente benutzt.
antialiasPDF	Mit "True" oder "False" bestimmen Sie, ob Antialiasing für PDF-Eingangsdateien an- oder abgeschaltet wird.

Hinweis: Die beiden folgenden Dienstprogramme können auch ohne Anmeldung des Benutzers aufgerufen werden.

7.2.12 wsforgotpw.pl

Gebrauch:

wsforgotpw.pl opts...

Dieses Skript wird jedesmal dann vom WebShare File Server aufgerufen, wenn Kennwort vergessen? auf der Startseite geklickt wird. Die folgende Tabelle führt die Perl-Skript Variablen in der linken Spalte, und in der rechten die entsprechenden HTML Felder der Datei "ForgotPassword.wod" (siehe 6.3.2 ""*.wod"-Dateien anpassen"). Beachten Sie bitte, dass die Namen der Perl-Skript Variablen feststehen und nicht umbenannt werden dürfen! Falls Felder nicht benötigt werden, können sie leer gelassen werden:

wsforgotpw.pl	ForgotPassword.wod
$username	editUser.username
$email	editUser.email
$organization	editUser.organization
$comment	editUser.comment
$field5 - $field10	editUser.field5-10

7.2.13 wsregnewuser.pl

Gebrauch:

wsregnewuser.pl opts...

Dieses Skript wird jedesmal dann vom WebShare File Server aufgerufen, wenn Als neuer Benutzer registrieren auf der Startseite geklickt wird. Die folgende Tabelle führt die Perl-Skript Variablen in der linken Spalte, und in der rechten die entsprechenden HTML Felder der Datei "RegisterNewUser.wod" (siehe 6.3.2 ""*.wod"-Dateien anpassen"). Beachten Sie bitte, dass die Namen der Perl-Skript Variablen feststehen und nicht umbenannt werden dürfen! Falls Felder nicht benötigt werden, können sie leer gelassen werden:

wsregnewuser.pl	RegisterNewUser.wod
$username	editUser.username
$password	editUser.password
$verifyPassword	editUser.verifyPassword
$email	editUser.email
$comment	editUser.comment
$organization	editUser.organization
$field7 - $field20	editUser.field7- 20

7.2.14 wsrm.pl

Gebrauch:

wsrm.pl dir files...

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Löschen aus dem Menü Datei > ausgewählt wird.

7.2.15 wsperm.pl

Gebrauch:

wsperm.pl dir user group userMode groupMode otherMode recursive files...

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Zugriffsrechte aus dem Menü Datei > ausgewählt wird.

7.2.16 wsupload.pl

Gebrauch:

wsupload.pl dstdir filesize filename mimetype

Dieses Programm wird immer dann vom WebShare File Server aufgerufen, wenn in der Menüleiste die Funktion Upload aus dem Menü Transfer > ausgewählt wird. "wsupload" erhält den Datenstrom von "stdin" und entpackt ihn in das durch den Parameter "dstdir" festgelegte Verzeichnis. Das Dienstprogramm "unzipstream" wird als eine Art Ausgabeprogramm zum Entpacken des Datenstroms während der Übertragung benutzt. Sobald eine Datei im Zip-Datenstrom entdeckt wird, wird sie unter einem temporären Namen mit der Prozess-ID als Suffix gesichert. Das Skript "wsuploadmv" wird für jede einzelne Datei im Zip-Datenstrom aufgerufen, um die Datei mit dem Suffix der Prozess-ID in ihren endgültigen Namen umzubenennen. All dies geschieht während der Übertragung, während "unzipstream" mit dem Empfang von weiteren Dateien innerhalb des Zip-Datenstroms fortfährt. "wsupload" findet automatisch heraus, ob das Hochladen von Daten von einem Windows oder einem Mac Client geschieht und wählt so eine geeignete Zeichensatzkodierung gemäß der Benutzer- sowie der Systemeinstellungsvorgaben.

7.2.17 wsuploadmv.pl

Gebrauch:

wsuploadmv.pl dir source dest

Dieses Programm benennt hochgeladene Dateien von ihrem temporären Namen in ihren endgültigen Namen um. "wsuploadmv" eignet sich hervorragend zur Integration anderer Aufgaben und Abläufe, z. B. einer Anti-Virus-Software, die die hochgeladenen Dateien prüft.

7.2.18 WebShare File Server Service Port

Dieser Dienst zeigt Benutzer- und Statusinformationen des WebShare File Servers an.

Nachdem Sie localhost auf der Kommandozeile mit einer geeigneten Portnummer aufgerufen haben, können Sie zusätzliche Befehle wie users, status oder help eingeben um sich mögliche Optionen anzeigen zu lassen:

$ socket localhost 2016

Trying 127.0.0.1...

Connected to localhost.

Escape character is '^]'.

Welcome to the HELIOS WebShare File Server service port

help

help - print a list of available commands

quit - close connection

status - show status information

users - show user information

rmcache - remove all cache files

users

# PID User UID Address CRC Login
1 inactive tom 101 192.168.1.2 24c9ce Mon 10:38
1 active joe 108 192.168.1.8 3bffc9d6 Thu 11:23
Summary: 1 active users (1 inactive users)

status

WebShare File Server, Version 2.0.0

Up since: Thu Nov 13 10:25:30 2003

Max users: 2

Max users allowed: 100

Hinweis: Aus Sicherheitsgründen akzeptiert der "telnet" Port über die localhost-Adresse ausschließlich eingehende Verbindungen auf dem WebShare File Server.

7.3 WebShare Skripte

7.3.1 Benutzerdefinierte Skripte

Es ist ohne Weiteres möglich, Skripte in den WebShare Arbeitsablauf zu integrieren, die z. B. Aufgaben automatisieren. WebShare wird mit Beispielskripten ausgeliefert ("wslogin.pl", "wsaddshare.pl", "wslogout.pl", "wsmail" und "wspreviewaccess"), welche - sollen sie etwas bewirken - erst vom Benutzer angepasst werden müssen, und Aktionsskripten (siehe Kapitel 7.3.3 "Aktionsskript: Beispiele"). Benutzerdefinierte Skripte werden im Verzeichnis "etc/webshare/samples" gespeichert. Zusätzlich können die WebShare Skripte, die in Kapitel 7.2 "WebShare Dienstprogramme" beschrieben wurden, angepasst werden.

Hinweis: Die Ausgabegröße von eigenen Skripten ist standardmäßig auf 64 kB begrenzt. Die Fehlerausgabe ist jedoch auf 2 kB begrenzt.

Die im Folgenden beschriebenen Skripte werden erst dann aktiv, wenn sie nach "var/webshare" kopiert worden sind.

wslogin.pl

Dieses Skript wird nach einer erfolgreichen Anmeldung am WebShare Server mit folgenden Parametern aufgerufen:

• Benutzername
• Scheinbare Benutzer-IP-Adresse (befindet sich der Benutzer z. B. "hinter" einem Proxy-Server, wird die IP-Adresse des Proxys als IP-Adresse des Benutzers angenommen)
• Vollständiger Browsereintrag des Benutzers
• Zeichenkette mit der Benutzer-ID
• Options-Zeichenkette mit dem Benutzertyp (virtueller oder Host-Benutzer) als ersten Eintrag; der Eintrag "IsAdmin" erscheint, durch Komma getrennt, wenn der Benutzer administrative Rechte besitzt

Das Skript kann so angepasst werden, dass es bei einer Benutzeranmeldung jede gewünschte Aktion ausführt.

wsaddshare.pl

Jedesmal wenn ein WebShare Administrator einen Sharepoint neu anlegt oder Änderungen an einem bestehenden vornimmt, wird das Skript "wsaddshare.pl" aufgerufen. Folgende Parameter stehen dafür zur Verfügung:

• Name des Sharepoints
• Pfad des Sharepoints
• E-Mail Adresse für den Sharepoint
• Options-Zeichenkette mit den Boolschen Präferenzen des Sharepoints (Publish, AllowDownload usw.), der die Sharepoint-Präferenzen in einer durch Komma getrennten Liste enthält
• Zeichenkette, die alle Benutzer, die den Sharepoint sehen dürfen, aufführt
• Eine Liste aller Gruppen, deren Mitglieder den Sharepoint sehen dürfen

Durch Anpassung dieses Skripts kann ein Systemadministrator verhindern, dass ein WebShare Administrator einen Sharepoint anlegt, dessen Pfad jenseits des für ihn erlaubten Bereichs liegt. Der Ausgabewert=0 erlaubt das Anlegen eines Sharepoints sowie Änderungen an diesem, während ein Wert0 derlei Aktionen verbietet. Gleichzeitig würde eine Meldung an den Systemadministrator nach "stderr" ausgegeben.

Beispiel:

#!var/run/runperl -w

# $Id: Kap7_doc.html,v 1.4 2009/06/08 08:03:54 hendrik Exp $

#@(#)HeliosVersion 2.0.0p5 Copyright 2003-2007 HELIOS Software Garbsen

# WebShare sample script to perform any actions or checks whenever

# a new Sharepoint is defined or Sharepoint setting are modified.

# The script must either

# - exit with status 0 to allow saving the Sharepoint, or

# - write an error text to STDERR and exit with status != 0 if

# saving the Sharepoint is not allowed.

#

# NOTE: To use the sample script, copy this file into the

# HELIOSDIR/var/webshare directory, edit it according to your needs,

# and make sure that it is executable.

sub BEGIN {

use vars qw($HELIOSDIR);

my $HELIOSDIR = $ENV{"HELIOSDIR"} or die "HELIOSDIR not set in environment\n";

unshift (@INC, ".", "$HELIOSDIR/etc/webshare", "$HELIOSDIR/etc/perl");

}

use strict;

use wscommon;

use HELIOS::Utils;

if ($#ARGV + 1 != 6) {

print STDERR "Usage: $prog sharename sharepath sharemail shareoptions usermembers groupmembers\n";

exit 1;

}

my $sharename = shift; # Sharepoint Name

my $sharepath = shift; # Sharepoint Path

my $sharemail = shift; # E-Mail on Access

my $shareoptions = shift; # Options, comma separated

my $usermembers = shift; # User Members, comma separated

my $groupmembers = shift; # Group Members, comma separated

# exit 0 without any stderr messages will allow to add the share

exit 0;

# Example: Allow only sharepoint paths starting with "/webshare/" or "/samples/":

my @allowedPaths = ("/webshare/", "/samples/");

foreach my $path (@allowedPaths) {

exit 0 if ($sharepath =~ /^$path/);

}

print STDERR "Adding sharepoint directory $sharepath not allowed!\n";

exit 1;

wslogout.pl

Sobald sich ein Benutzer vom WebShare Server abgemeldet hat, wird dieses Skript mit den folgenden Parametern aufgerufen:

• Benutzername
• TCP/IP-Adresse des HTTP-Clients
• Browserinformation

Dieses Skript könnte z. B. so angepasst werden, dass Verzeichnisse aufgeräumt oder ähnliche Aufgaben erledigt werden. Im Gegensatz zu wslogin.pl und wsaddshare.pl wird der Ausgabewert dieses Skripts nicht interpretiert.

wsemail.pl

Dieses Aktionsskript wird immer dann aufgerufen, wenn ein Benutzer eine E-Mail über WebShare verschickt. Das Skript wird mit folgenden Parametern aufgerufen:

• Benutzername
• Empfänger (Feld An:)
• Kopie der Mail an (Feld Cc:)
• Blindkopie der Mail an (Feld Bcc:)
• Betreff
• Mail text

Das Skript muss mit Status 0 beenden, damit der Benutzer eine E-Mail verschicken kann oder mit Status 1 um dies nicht zuzulassen.

wspreviewaccess.pl

Wird ein Skript mit dem Namen "wspreviewaccess.pl" in das Verzeichnis "HELIOSDIR/var/webshare" kopiert, wird es jedes Mal dann aufgerufen, wenn eine Bildvorschau angefordert wird.

Das Skript wird mit zwei Argumenten aufgerufen:

1. <Pfadname> zum Bild
2. <Pfadname> zum Vorschau-Cache

Dadurch wird Skripten von Drittanbietern, die diese Information nutzen könnten um über Vorschau-Aktivitäten benachrichtigt zu werden, ein exaktes Logging ermöglicht.

7.3.2 Fehlerbeseitigung in WebShare Skripten

Alle WebShare Skripte inklusive der Beispielskripte sind in Perl geschrieben worden. WebShare Skripte können aber auch in jeder anderen Sprache wie z. B. shell, PHP, Perl, Java, C/C++ geschrieben werden. HELIOS bevorzugt Perl, da es sehr leistungsfähig und zu vielen verschiedenen Plattformen kompatibel ist. Dieser Abschnitt stellt eine Anleitung für die Fehlerbehebung in Perl Skripten vor, die als Werkzeug und Aktionsskript in WebShare benutzt werden können. Achten Sie darauf Ihr Skript so aufzusetzen, dass es grundsätzlich funktioniert, bevor Sie an ihm eine Fehlerbeseitigung in der WebShare Umgebung vornehmen.

Umgebungsvoraussetzungen:
Alle Skripte werden normalerweise mit dem Verzeichnis HELIOSDIR, welches standardmäßig "/usr/local/helios" ist, aufgerufen. Um unabhängig vom Perl Installationspfad zu allen Plattformen kompatibel zu sein, findet sich bei allen WebShare Perl-Skripten die Zeichenkette #!var/run/runperl in der ersten Zeile. "runperl" ist ein symbolischer Link zum lokalen Perl-Interpreter. Der "runperl"-Link wird während der Installation von WebShare automatisch angelegt. Alle WebShare Vorgabeskripte befinden sich in "etc/webshare". Eigene Skripte sollten in "var/webshare" gespeichert werden, damit ein Überschreiben der Skripte während einer Neuinstallation der Software vermieden wird. Ein weiterer Vorteil ist, dass der Ordner "var" alle Benutzeranpassungen und -einstellungen enthält, was eine einfache und schnelle Migration auf andere Server-Plattformen gewährleistet, da die Änderungen nicht mehr neu eingegeben werden müssen.

Informationen über die Fehlerbeseitigung ausdrucken:
Da viele Skripte ihre Ergebnisse nach "stdout" oder "stderr" ausgeben, führt das Drucken von Skriptvariablen zu einer uneinheitlichen Ausgabe, was wiederum zu Fehlfunktionen führt. Alle HELIOS Skripte geben ihre Informationen in eine Datei aus, wenn die Umgebungsvariable "DEBUGTTY" gesetzt wird.

Einfache Fehlerbeseitigung:

# cd /usr/local/helios
# export DEBUGTTY=/dev/tty
# var/webshare/actions/yourscriptname

Mit den oben aufgeführten Befehlen können Sie das Skript testweise durchlaufen lassen und das Ergebnis überprüfen.

Fehlerbeseitigung bei einem laufenden WebShare File Server:

# cd /usr/local/helios
# bin/srvutil stop websharesrv # to stop the webshare file
server
# export DEBUGTTY=/dev/tty
# sbin/websharesrv

Das Skript wird jetzt bei der Ausführung von Aktions- oder eigenen Skripten vom WebShare File Server aufgerufen. Wird der WebShare File Server manuell gestartet, wird die gesamte Ausgabe in das Terminal ausgegeben (unter Benutzung des momentanen "tty").

7.3.3 Aktionsskript: Beispiele

Wie schon in Kapitel 7.3.1 "Benutzerdefinierte Skripte" erwähnt, wird WebShare mit diversen Aktionsskripten ausgeliefert:

wscheckpdf.pl

wsdu.pl

wsimageinfo.pl

wsll.pl

wssendmsg.pl

wsxpvcollect.pl

wsxpvinfo.pl

wspdfinfo.pl

wscmdargs.pl

wsdialog.pl

Die Skripte werden bei der Installation im Verzeichnis "var/settings/WebShare/Actions/Samples" abgelegt, müssen jedoch nach "var/settings/WebShare/Actions" kopiert werden, damit sie im Aufklappmenü Aktionen > in der Menüleiste des Sharepoints (siehe Aktionen > in Kapitel 5.3 "In einem Sharepoint arbeiten") verfügbar sind. Darüber hinaus regeln die Dateizugriffsrechte eines jeden Aktionsskripts, ob dieses für den einzelnen Benutzer überhaupt sichtbar ist. Siehe auch Kapitel 8.1.7 "Aktionsskripte".

wssendmsg.pl

Dieses Aktionsskript sendet Benachrichtigungen direkt aus WebShare an alle Benutzer, die über "afpsrv", "pcshare" oder "heladmsrv" angemeldet sind.

wscmdargs.pl

Dieses Aktionsskript gibt alle Argumente sowie die Umgebungsvariablen des Skripts aus.

wsll.pl

Dieses Aktionsskript listet den Inhalt des aktuellen Verzeichnisses mithilfe des Kommandos ls -l (unter Windows mit dem Kommando dir) auf:

#!var/run/runperl -w

# $Id: Kap7_doc.html,v 1.4 2009/06/08 08:03:54 hendrik Exp $

#@(#)HeliosVersion 2.0.0p5 Copyright 2003-2007 HELIOS Software Garbsen

#Title=ls -l

# WebShare sample action script to list the content of a directory.

#

# NOTE: To use the sample action, copy this file into the

# HELIOSDIR/var/settings/WebShare/Actions directory, edit it according to your

# needs, and make sure that it is executable.

sub BEGIN {

use vars qw($HELIOSDIR);

$HELIOSDIR = $ENV{"HELIOSDIR"} or die "HELIOSDIR not set in environment\n";

unshift (@INC, ".", "$HELIOSDIR/etc/webshare", "$HELIOSDIR/etc/perl");

}

use strict;

use wscommon;

use HELIOS::Utils;

if ($#ARGV + 1 < 2) {

print STDERR "Usage: $prog dir\n";

exit 1;

}

my $dir = shift; # given directory

my $nfield = shift; # unused content of the input field

if ($^O eq 'MSWin32') {

system("dir", $dir);

} else {

system("ls", "-l", $dir);

}

exit 0;

wsdu.pl

Dieses Aktionsskript zeigt die Plattenplatzbelegung der ausgewählten Dateien mithilfe des Kommandos du an.

wsdialog.pl

Dieses zweistufige Aktionsskript generiert zuerst ein Formular mit eigenen HTML-Feldern (Textfelder, Schaltflächen usw.) und verarbeitet diese anschließend.

Hinweis: Zur Ausführung der folgenden drei Skripte ist es erforderlich, dass ImageServer auf demselben Host installiert ist:

wsimageinfo.pl

Aktionsskript zum Abrufen von Informationen über ein Bild.

wsxpvinfo.pl

Aktionsskript zum Abrufen von Informationen über ein XPV-Dokument.

wsxpvcollect.pl

Aktionsskript zum Sammeln der referenzierten Daten (QuarkXPress oder InDesign Dokument oder Bilder) aus dem XPV-Dokument. Zusätzlich wird eine Liste der verwendeten Schriften erstellt.

Hinweis: Zur Ausführung der folgenden zwei Skripte ist es erforderlich, dass PDF HandShake auf demselben Host installiert ist:

wscheckpdf.pl

Aktionsskript zum Prüfen eines PDF-Dokuments auf Basis des Programms "pdfInspektor" von callas software.

wspdfinfo.pl

Aktionsskript zum Abrufen von Informationen über ein PDF-Dokument.

7.4 Bild- und Dokumentenvorschau

Durch Einschalten der Option Dateivorschau zulassen in WebShare Sharepoints verwendet WebShare HELIOS ImageServer, um Bitmap-Voransichten von Bildern und Dokumenten zu erzeugen, wenn ein Benutzer auf ein Dokument klickt. WebShare erkennt automatisch den Dateityp von Bildern und Dokumenten und öffnet eine HTML-Seite, die die Bild- und Dokumentenvorschau in der vorgegebenen Auflösung enthält.

Die Voransicht wird vom Skript "wspreview.pl", welches das ImageServer Konvertierungsprogramm "layout" verwendet, generiert. Alle Vorschaudateien werden entweder als JPEG oder PNG im RGB- oder Graustufen-Farbraum erzeugt.

Um das Standardverhalten zu ändern, kann das Skript modifiziert werden. Gleichermaßen können Sie es als Vorlage für eigene Aktionsskripte verwenden, z. B. um eine Voransicht mit bestimmten ICC-Profilen zu erzeugen.

7.4.1 Bildvorschau (ImageServer)

Die folgenden Bild-Eingangsformate werden unterstützt:

TIFF, EPSF, DCS-1, DCS-2, Scitex-CT, JPEG, JPEG2000, JBIG2, PICT, Photoshop, BMP und PNG.

7.4.2 Dokumentenvorschau (ImageServer)

Voransichten von QuarkXPress Dokumenten für Mac und Windows sowie Adobe InDesign Dokumenten für Mac und Windows werden unterstützt. Um die Vorschaufunktion nutzen zu können ist es erforderlich, dass Sie die HELIOS Preview XTension oder das Plug-in für QuarkXPress oder InDesign installieren. Diese sichern zusammen mit dem Dokument eine ".xpv"-Datei, die die Dokumentenvorschau enthält. Ein WebShare Benutzer kann sich durch Anklicken dieser ".xpv"-Datei die Dokumentenvorschau seitenweise anzeigen lassen.

7.4.3 PDF Dokumentenvorschau (PDF HandShake & ImageServer)

Unterstützt alle PDF 1.0-1.7 Dateien, die nicht durch ein Kennwort geschützt sind.

7.4.4 Formate der Voransichtsdateien

WebShare erzeugt eine PNG-Voransicht für die folgenden Formate:

• PDF
• QuarkXPress- & InDesign-Dokumente (".xpv")
• Alle Bilddateien, die einen Beschneidungspfad enthalten
• 1-Bit Bilddateien (s/w Bild)
• Alle Bilder in der Proof-Ansicht sind PNG-Dateien hoher Farbqualität mit eingebettetem Profil.

WebShare erzeugt eine JPEG-Voransicht für die folgenden Formate:

• Alle Graustufen- oder Farbbilder ohne Beschneidungspfad

Alle erzeugten Bildvoransichten werden in einem Cache-Bereich gesichert, damit andere Benutzer die bereits vorhandenen und berechneten Voransichtsdateien wiederverwenden können.

Durch die Verwendung verschiedener ImageServer Parameter im Skript "wspreview.pl" ist es möglich die Generierung der Voransichtsdatei benutzerspezifisch anzupassen, beispielsweise um dem RGB-Farbraum, der für die Voransichtsdateien benutzt wird, ein anderes ICC-Profil zuzuweisen.

Die folgenden Bildauflösungen werden standardmäßig unterstützt:

• Zoom 1: 256 Pixel (Vorgabewert nach dem Klicken auf das Bildsymbol; die Bildbreite wird auf 256 Pixel skaliert)
• Zoom 2: 512 Pixel
• Zoom 3: 768 Pixel
• Zoom 4: 1024 Pixel
• Zoom 5: 1280 Pixel
• Zoom 6: 1536 Pixel
• Zoom 7: 1792 Pixel
• Zoom 8: 2048 Pixel
• Zoom 9: 2304 Pixel

Weitere Auflösungen für die Voransicht können als Werte in Pixel oder dpi im Fenster "Servereinstellungen" angegeben werden. Die benutzerspezifisch anpassbaren Auflösungen werden aus dem Aufklappmenü ausgewählt. Die Auflösung der Voransicht sollte möglichst klein gehalten werden. So vermeiden Sie extrem große Vorschaudateien, die dementsprechend lange brauchen, bis sie heruntergeladen sind und vom Browser angezeigt werden können.

Hinweis: Ist JavaScript nicht aktiviert, wird die Erzeugung der im Aufklappmenü angegebenen Voransicht durch Klicken der Schaltfläche Go gestartet.

7.5 Präferenzen

Hinweis: Dieses Kapitel wurde nicht übersetzt, um die Eindeutigkeit der Beschreibung zu bewahren.

This section lists all the preference keys that are pertinent to the WebShare File Server. Find a description of how to set, view, change or delete preferences, with the HELIOS "prefdump", "prefvalue", and "prefrestore" utility programs in the HELIOS Base manual, chapter 6, "HELIOS utility programs".

Important: Make sure that preference keys DO NOT start or end with a slash ("/") character, and note that they are case-sensitive! Also, if any preference key or preference value includes spaces, that key or value must be enclosed in quotes.

Preference

Type Default (""=no preference stored)

7.5.1 WebShare File Server Präferenzen

Key: Programs/websharesrv/<key>

WrongAuthDelay

int 2

Specifies the time delay in seconds between failed login requests. This helps increase the security against unauthorized logins, e.g. by password robots, which try to match the password by issuing a large number of passwords per second.

AllowForgotPassword

bool FALSE

Determines whether the Forgot Password? link becomes visible in the login window. The setting of this preference reflects the state of the Enable Forgot Password Option checkbox in the "Server Preferences" window (Abb. 7).

AllowRegisterUser

bool FALSE

Determines whether the Register as a New User link becomes visible in the login window. The setting of this preference reflects the state of the Enable Register User Option checkbox in the "Server Preferences" window (Abb. 7).

AllowEMailMessages

bool TRUE

Determines whether the Mail function (in the Edit > toolbar menu) is selected. The settings of this preference reflects the setting of the Enable E-Mail message for Users checkbox in the "Server Preferences" window (Abb. 7).

EnforceCryptedLogin

bool FALSE

With this preference set to TRUE, only encrypted user logins are permitted. For this purpose, JavaScript must be active in the web browser. The setting of this preference reflects the state of the Enforce RSA Crypted Passwords checkbox in the "Server Preferences" window (Abb. 7).

AllowLinkShares

bool FALSE

With this preference set to TRUE, WebShare allows direct URL access from remote clients.

The following keys require a new login to take effect:

logdenied

bool FALSE

If set to TRUE, this parameter lets "websharesrv" append a record to the system messages if, due to the IP access list, access to one or more users has been denied.

TcpRecvSize

int 65536 (64 x 1024)

Specifies the maximum number of TCP data bytes that are passed from the clients to "websharesrv" over the network during a transaction. The number of bytes may need to be limited if the buffer size in the UNIX server is too small. TcpRecvSize can be varied to optimize the data transfer rate.

TcpSendSize

int 65536 (64 x 1024)

Specifies the maximum number of TCP data bytes that are passed from "websharesrv" to the clients over the network during a transaction. The number of bytes may need to be limited if the buffer size in the UNIX server is too small. TcpSendSize can be varied to optimize the data transfer rate.

Note: Changed values in TcpRecvSize and TcpSendSize will automatically be assigned to the WebShare WebObjects Server as well, for the next login.

CacheSize

int 30 (in MB)

Specifies the cache size value of the WebShare File Server for preview files. It corresponds to the Cache Size in MB value in the "WebShare Server Preferences" menu.

Note: The default value for CacheSize is 30 (MB), due to the usually limited disk space in "HELIOSDIR/var". If you change the CacheDir preference to another path, it is recommended to set CacheSize to a value of at least 300 (MB).

AllowHostUsers

bool TRUE

Specifies whether users are allowed to log on to the WebShare File Server with their host login name. The setting reflects that of the Enable WebShare for Host Users checkbox in the "WebShare Server Preferences" menu.

AllowVirtualUsers

bool TRUE

Specifies whether users are allowed to log on to the WebShare File Server with their (virtual) WebShare login name. The setting reflects that of the Enable WebShare for Virtual Users checkbox in the "WebShare Server Preferences" menu.

AdminNotify

str ""

Specifies an e-mail address to which a notification is sent as soon as a client with Admin rights logs on to the WebShare File Server. It corresponds to the E-Mail Notification on Admin Login entry in the "WebShare Server Preferences" menu.

Note: Make sure that the complete receiver account is specified, e.g. webshare@meinecompany.com

UserNotify

str ""

Specifies an e-mail address to which a notification is sent as soon as a user logs on to the WebShare File Server. It corresponds to the E-Mail Notification on User Login entry in the "WebShare Server Preferences" menu.

Note: Make sure that the complete receiver account is specified, e.g. webshare@meinecompany.com

AllowAllReadWrite

bool FALSE

If set to TRUE, this preference enables the sharepoint preferences AllRead and AllReadWrite. In that case, the additional options Always Allow Reading and Always Allow Read/Write (see 7.5.2 "Sharepointpräferenzen") will be shown in the "Sharepoint Administration" window.

Important: It may considerably reduce host security to set the AllowAllReadWrite flag to TRUE because if required, host access rights are bypassed, with all user processes changing to "root" processes!

DateFormat

str "dd MMM yyyy kk:mm"

Specifies the format with which the date is displayed in the directory listing of the "Sharepoint" menu. It corresponds to the Directory Listing Date Format entry in the "WebShare Server Preferences" menu. Also, this preference specifies the required syntax for the Expires field in the "User Administration" window. See Datumsformat in 4.1 "Serverpräferenzen".

mail

bool TRUE

Specifies whether e-mail notification is used at all.

SendMailOnActionScript

bool FALSE

If set to TRUE, this preference sends an e-mail, as soon as a WebShare action script is executed, to the address that is specified in the E-Mail on Access field in the "Sharepoint Administration" window. See EmailAccess.

DefaultWindowsEncoding

str "PC850"

Specifies the default encoding method when downloading files on Windows clients. The setting reflects that of the Default Windows Encoding pop-up menu in the "WebShare Server Preferences" menu.

DefaultMacintoshEncoding

str "MacRoman"

Specifies the default encoding method when downloading files on Mac clients. The setting reflects that of the Default Macintosh Encoding pop-up menu in the "WebShare Server Preferences" menu.

ShowHiddenFiles

bool FALSE

If set to TRUE, hidden files ("dot files" and files which have been marked as hidden in an EtherShare volume) are displayed in a sharepoint directory listing.

HideSpecialFiles

strlist ""

Specifies file names which should always be hidden in a directory listing.

PreviewResolutions

str "36 dpi,72 dpi,96 dpi,
144 dpi,
128 pixel,256 pixel,
512 pixel,768 pixel,
1024 pixel"

Specifies the (comma-separated) pixel/resolution values which are available in the "Sharepoint" preview pop-up menu. The "zoom icon" resolution values are fixed, and are not affected by this preference.

URLWebOnlyUsers

strlist ""

If this preference is set, the specified users have only URL based WebShare web access. See also the AllowLinkShares preference.

URLImageOnlyUsers

strlist ""

If this preference is set, the specified users have only URL based WebShare image fetching access. This allows setting up a special user (real or virtual) for remote URL image-only access. If somebody tries to steal the URL specified user name and password for a manual WebShare login, this will be denied. See also the AllowLinkShares preference.

Important: Specifying the same user name(s) with both preferences URLWebOnlyUsers and URLImageOnlyUsers will cause that the access for the specified user(s) is denied at all - be it via URL share access or manual login. So make sure to use different user names with both preferences!

The following keys require a service restart to take effect:

TcpPort

int 2010

Specifies the WebShare File Server port number. Additional TCP ports (up to a total of five) will automatically be allocated as needed by the WebShare File Server.

Important: The value of the TcpPort preference needs to be identical with the WebShare WebObjects Server preference WSHostPort (6.5 "Präferenzen"). If there should be the need to change a value, then make sure that both preference keys are assigned the same value!

TelnetPort

int 2016

Specifies the "telnet" port number of the WebShare File Server.

sessions

int (see text)

Specifies the maximum number of workstations (clients) that are permitted to work on the WebShare File Server simultaneously. This value should normally be the same as the total number of workstations that are connected to the WebShare File Server, and should be less than or equal to the number of sessions allowed by your software license. The default value for sessions is the number of sessions allowed by your software license.

minuid

int see text

Specifies the lowest number allowed for user IDs. All host users which have a lower user ID than that specified by minuid, and all virtual users running as a host user with a user ID lower than that specified by minuid, are not permitted to log in. The default behavior is that all IDs are allowed.

maxuid

int see text

Specifies the highest number allowed for user IDs. All host users which have a higher user ID than that specified by maxuid, and all virtual users running as a host user with a user ID higher than that specified by maxuid, are not permitted to log in. The default behavior is that all IDs are allowed.

ipaccess

str "ipaccess"

Specifies the file containing the access list with the IP addresses which are permitted to log on to "websharesrv".

CacheDir

str "var/tmp/wscache"

Specifies the directory which contains the preview files on the WebShare File Server. It corresponds to the Cache Directory entry in the "WebShare Server Preferences" menu.

Note: This directory must already exist and have rwx
(read-write-execute) permissions for all.

AliasPDF

bool TRUE

If set to FALSE, antialiasing for PDF previews is deactivated.

7.5.2 Sharepointpräferenzen

Key: Programs/websharesrv/Shares/<Sharename>/<key>

The following keys take effect immediately:

Path

str ""

Specifies the sharepoint path. It corresponds to the Sharepoint Path entry in "Sharepoint Administration".

Publish

bool TRUE

Specifies whether a sharepoint is published in the "Home" menu. The setting reflects that of the Publish checkbox in the "Sharepoint Administration" window.

EmailAccess

str ""

Specifies an e-mail address for notification mails on user access and action to the selected sharepoint. It corresponds to the E-Mail on Access entry in the "Sharepoint Administration" window. Make sure that the complete receiver account is specified, e.g. webshare@meinecompany.com

CollectMails

bool TRUE

Specifies whether notification mails, as stated in the EmailAccess preference, are issued after the users' logout, which is the default behavior, or after each file download, deletion or upload action that has been done by a user.

Comments

str ""

Specifies a comment on the selected sharepoint. It corresponds to the Comments entry in the "Sharepoint Administration" window.

AllowPreview

bool TRUE

Specifies whether previews of images in the sharepoint are allowed. The setting reflects that of the Allow Preview checkbox in the "Sharepoint Administration" window.

AllowDownload

bool FALSE

Specifies whether downloading files from the sharepoint is allowed. The setting reflects that of the Allow Download checkbox in the "Sharepoint Administration" window.

AllowUpload

bool FALSE

Specifies whether uploading files to the sharepoint is allowed. The setting reflects that of the Allow Upload checkbox in the "Sharepoint Administration" window.

AllowRename

bool FALSE

Specifies whether renaming files and directories in the sharepoint is allowed. The setting reflects that of the Allow Rename checkbox in the "Sharepoint Administration" window. Setting this preference allows changing permissions, too.

AllowCopy

bool FALSE

Specifies whether copying files to the sharepoint and creating directories is allowed. The setting reflects that of the Allow Copy checkbox in the "Sharepoint Administration" window.

AllowDelete

bool FALSE

Specifies whether deleting files in the sharepoint is allowed. The setting reflects that of the Allow Delete checkbox in the "Sharepoint Administration" window.

AllRead

bool FALSE

Specifies whether file read access in the sharepoint is enabled for all users, irrespective of the server file access settings. Read access includes file download and preview. The setting reflects that of the Always Allow Reading checkbox in the "Sharepoint Administration" window. This preference must first be enabled by the WebShare administration preference key AllowAllReadWrite.

AllReadWrite

bool FALSE

Specifies whether file read/write access in the sharepoint is enabled for all users, irrespective of the server file access settings. Read/write access includes file download, upload and preview. The setting reflects that of the Always Allow Read/Write checkbox in the "Sharepoint Administration" window. This preference must first be enabled by the WebShare administration preference key AllowAllReadWrite.

OnlyLayouts

bool FALSE

If set to TRUE, only layouts of the images in the sharepoint can be downloaded. The setting reflects that of the Download Layouts only checkbox in the "Sharepoint Administration" window. For this preference to be enabled, the WebShare File Server preference AllowDownload must also be TRUE.

Users

strlist ""

Specifies one or more user names for which the sharepoint is available. If no names are specified, the sharepoint is available for all users. It corresponds to entries in Allowed Users in the "Sharepoint Administration" window.

Groups

strlist ""

Specifies one or more group names for whose members the sharepoint is available. If no names are specified, the sharepoint is available for all groups. It corresponds to entries in Allowed Groups in the "Sharepoint Administration" window.

For WebShare, the sharepoint (volume) key is the name of the sharepoint, for example "WebShare Public", whereas for EtherShare and PCShare the volume key is the UNIX directory path, for example "/demovol".

To set up a sharepoint "Mycompany Public", similar to the "WebShare Public" by using "prefvalue", the following prefvalue sequences must be called:

bin/prefvalue -k "Programs/websharesrv/Shares/Mycompany Public/Path" -t str "/mycompany/public/WebShare"

bin/prefvalue -k "Programs/websharesrv/Shares/Mycompany Public/AllowDownload" -t bool TRUE

bin/prefvalue -k "Programs/websharesrv/Shares/Mycompany Public/AllowPreview" -t bool TRUE

By default the Publish flag is on, therefore it need not be specified.