Administration Guide : Command-line manual pages

VENTURELOG(8) manual page

Name

venturelog - when the state of the filesystem changes, takes command-line arguments and sends dblogd (8) events

Synopsis

venturelog [ -u username ] [ -a IP_Address ] [ -start | -cont | -end ] [ -fn ] action

Description

Some stages of your workflow may include custom scripts or programs that alter the state of the filesystem. It is necessary to keep WebNative Venture informed of these changes, so it can correctly display images and other files to Web clients. You could accomplish this by using syncvoltodb (8) after any changes to the filesystem occur, but a full update of the system with this program would be a time-consuming process. Using venturelog provides a better option. The venturelog program takes command line arguments that send dblog (8) events in the same way other Xinet programs do.

Options

-u username
Allows you to specify the name of web user who performed the action. This parameter is optional and its value is only shown in the detailed history tab in WebNative.
-a IP_Address
Allows you to specify the IP address whence the event comes. This parameter is optional and its value is only shown in the detailed history tab in the WebNative Venture GUI.
-start
-cont
-end
These options are useful for setmeta, trigger and upload actions. They set flags on the events to create a grouped sequence of events which are to be treated together for trigger or event logging purposes (for example, when a folder full of files is uploaded).
-fn
For some actions (archived, backedup, mediachg, online and tapedel ), supplying -fn first makes older Flashnet events (as opposed to WebNative Archive events).

Action

-addcmt filename
Establishes that the Mac finder comment has been added or modified for filename .
-archived
filename isdir | isfile [ -b backend_id ] [ -bf backendflags ] [ -m medianame ] [ -an archivenumber ] [ -ad archivedate(Unix_format) ] [ -at thumboffset(low_32-bit) ] [ -ath thumboffset(high_32-bit) ] [ -al thumblen ] [ -info data ]
Establishes that filename has been archived. You must specify if filename is a file or a directory (isfile or isdir ). You can optionally specify the name of the media where the archive has been made (-m media_name ).
-backedup filename isdir | isfile [-m medianame ]
Establishes that filename is now backed up. You must specify if filename is a file or a directory (isfile or isdir ). You can optionally specify the name of the media where the backup has been made (-m media name ). This does not imply that the original in the filesystem is gone. If you are archiving the file, use the -archived flag.
-copy filename filename2
Establishes that filename has been copied to another path or filename. This event takes two filenames, source (filename ) and target (filename2 ).
-create filename
Establishes that filename has been created in a WebNative Suite database-enabled volume; however, this will not trigger dblogd (8) in such a way that a new preview for the file will be created. This flag has been preserved for historical purposes and in most cases, it is better to use dtrebuild (8) instead.
-delete filename
Establishes that filename has been removed from a WebNative Venture enabled volume. Note: If it has been moved to the trash, use -rename instead. Then use -delete when the trash can is emptied.
-downfpo filename
Establishes that a user has downloaded a copy of the FPO for filename .
-downhires filename
Establishes that a user has downloaded a copy of the hires for filename .
-downprev filename
Establishes that a user has downloaded a copy of the web preview for filename .
-doxmpsync filename
Perfoms a syncxmp (-tofile) call to update the XMP data of filename to match the data in the database.
-fpo filename
Establishes that an FPO was created for filename .
-imageordr filename
Establishes that filename has been custom ordered from the WebNative Venture server.
-mediachg media_name online[=val]|nearline[=val]|offline[=val]
Establishes that the media name has changed state to online , nearline or offline . An optional value can be set (default=1). A value of 2 indicates that the file was set by the archiveevent action.
-metachg filename keywordid "newvalue |NULL" "oldvalue |NULL"
Establishes that filename metadata value has been changed. This flag will not trigger actions. To trigger actions based on keyword changes, use the -trigger flag.
-mkdir directoryname
Establishes that a new directory has been created with the name directoryname .
-online filename
Establishes that filename has been restored from a backup/archive.
-pdfimage filename
Establishes that a PDF preview was created for filename .
-portaltrig path_to_file
Posts a Portal Trigger event for a given path, which, when the path is within the Active Path, will in turn fire the Portal Trigger Actions defined in the related Trigger Set.
-print filename
Establishes that filename has been printed.
-pubvols
Reads /var/adm/appletalk/KASPubVols and updates the Venture volume table accordingly. (The filename parameter is ignored).
-quarkimage filename
Establishes that a Web preview was created for a QuarkXPress or InDesign document filename .
-read filename
Establishes that filename has been opened and closed without being written. This event is not written to the database; this flag is preserved for historical purposes only.
-rename filename filename2
Establishes that filename has been renamed or moved to another path. This event takes two filenames, source (filename ) and target (filename2 ).
-rmdir directoryname
Establishes that a directory, directoryname , has been deleted. This event does not affect any child of the deleted directory. You will need to send delete events for each element inside the directory before sending -rmdir directoryname .
-setmeta filename fileid keywordid new_value
Writes a request to assign a new value to filename 's keyword1 Venture table entry for the keyword with id keywordid . The fileid argument is currently ignored.
-setparms filename
Establishes that the Mac finder parameters have been modified for filename , e.g., directory position, locked status, etc.
-sync directoryname "syncvoltodb_parameters_in_double_quotes "
Performs a "listdir" sync on directoryname using the syncvoltodb parameters passed in double quotes.
-tapedel media_name
Establishes that media_name has been discarded and all the backups in that media have been lost.
-trigger
filename fileid keywordid trigsetid unix_date newvalue oldvalue
Informs trigsetid that keywordid for fileid has been changed from oldvalue to newvalue . If the keyword change matched a trigger condition of trigsetid , this venturelog command will trigger the corresponding action of trigsetid .
-upload filename
Establishes that filename has been uploaded to the WebNative Venture server.
-webimage filename
Establishes that a WEB preview was created for filename .
-write filename
Establishes that filename has been opened and closed and that there was at least one write operation performed upon it. As a result, dblogd(8) will update the file's parameters, including metadata. It does not, however, trigger the creation of a preview for the file if it's an image format supported by Xinet and doesn't already have a preview. Use dtrebuild(8) with the -web and/or -fpo options to force preview creation.

Examples

venturelog -write path_to_mynewfile.pdf

venturelog -archived path_to_myarchivedfile isfile -m tape009

Files

/usr/etc/venture/bin/venturelog

C:\Program Files\Xinet\Venture\Bin\venturelog.exe