<?Pub UDT _bookmark _target?><?Pub EntList bsol dash hellip gt lt minus?><?Pub CX solbook(book(title()bookinfo()part()part(title()partintro()chapter()?><chapter id="vscan-1"><?Pub Tag atict:info tracking="off" ref="0"?><?Pub Tag
atict:user user="sharonr" fullname="Sharon Veach"?><title>Virus Scanning Service
(Tasks)</title><indexterm><primary>antivirus software</primary><see>virus scanning</see>
</indexterm><highlights><itemizedlist remap="jumplist"><para>This chapter provides information about using antivirus software, and
covers the following topics:</para><listitem><para><olink targetptr="vscan-3" remap="internal">About Virus Scanning</olink></para>
</listitem><listitem><para><olink targetptr="vscan-4" remap="internal">About the Vscan Service</olink></para>
</listitem><listitem><para><olink targetptr="vscan-5" remap="internal">Using the Vscan Service</olink></para>
</listitem>
</itemizedlist>
</highlights><sect1 id="vscan-3"><title>About Virus Scanning</title><indexterm><primary>virus scanning</primary><secondary>files</secondary>
</indexterm><para>Data is protected from viruses by a scanning service, vscan, that uses
various <firstterm>scan engines</firstterm>. A <olink targetptr="glossaryscanengine" remap="internal">scan engine</olink> is a third-party application,
residing on an external host, that examines a file for known viruses. A file
is a candidate for virus scanning if the file system supports the vscan service,
the service has been enabled, and the type of file has not been exempted.
The virus scan is then performed on a file during open and close operations
if the file has not been scanned with the current virus definitions previously
or if the file has been modified since it was last scanned.</para><para>The vscan service can be configured to use multiple scan engines. It
is recommended that the vscan service use a minimum of two scan engines. The
requests for virus scans are distributed among all available scan engines. <olink targetptr="avscanenginesoftwaretbl" remap="internal">Table&nbsp;4&ndash;1</olink> shows the
scan engines that are supported when configured with their most recent patch. </para><table frame="topbot" id="avscanenginesoftwaretbl"><title>Antivirus Scan Engine
Software</title><indexterm><primary>virus scanning</primary><secondary>engines</secondary>
</indexterm><tgroup cols="2" colsep="0" rowsep="0"><colspec colname="column1" colwidth="41.16*"/><colspec colname="column2" colwidth="33.84*"/><thead><row rowsep="1"><entry><para>Antivirus Software</para>
</entry><entry><para>ICAP Support</para>
</entry>
</row>
</thead><tbody><row rowsep="1"><entry><para>Symantec Antivirus Scan Engine 4.3</para>
</entry><entry><para>Is supported</para>
</entry>
</row><row rowsep="1"><entry><para>Symantec Antivirus Scan Engine 5.1</para>
</entry><entry><para>Is supported</para>
</entry>
</row><row rowsep="1"><entry><para>Computer Associates eTrust AntiVirus 7.1</para><para>Computer Associates Integrated Threat Management 8.1</para>
</entry><entry><para>Is not supported<footnote id="prereq"><para>Requires installation of the Sun StorageTek 5000 NAS ICAP Server for
Computer Associates Antivirus Scan Engine.  Get the package from the <ulink url="http://www.sun.com/download/" type="text_url">Sun Download Center:</ulink>.</para></footnote></para>
</entry>
</row><row rowsep="1"><entry><para>Trend Micro Interscan Web Security Suite (IWSS) 2.5</para>
</entry><entry><para>Is supported</para>
</entry>
</row><row><entry rowsep="1"><para>McAfee Secure Internet Gateway 4.5</para>
</entry><entry rowsep="1"><para>Is supported</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect1><sect1 id="vscan-4"><title>About the Vscan Service</title><indexterm><primary>virus scanning</primary><secondary>described</secondary>
</indexterm><para>The benefit of the real-time scan method is that a file is scanned with
the latest virus definitions <emphasis>before</emphasis> it is used. By using
this approach, viruses can be detected before they compromise data.</para><orderedlist><para>The following describes the virus scanning process:</para><listitem><para>When a user opens a file from the client, the vscan service
determines whether the file needs to be scanned, based on whether the file
has been scanned with the current virus definitions previously and if the
file has been modified since it was last scanned.</para><itemizedlist><listitem><para>If the file needs to be scanned, the file is transferred to
the <olink targetptr="glossaryscanengine" remap="internal">scan engine</olink>. If a connection
to a scan engine fails, the file is sent to another scan engine. If no scan
engine is available, the virus scan fails and access to the file might be
denied.</para>
</listitem><listitem><para>If the file does not need to be scanned, the client is permitted
to access the file.</para>
</listitem>
</itemizedlist>
</listitem><listitem><para>The scan engine scans the file using the current virus definitions.</para><itemizedlist><listitem><para>If a virus is detected, the file is marked as quarantined.
A quarantined file cannot be read, executed, or renamed but it can be deleted.
The system log records the name of the quarantined file and the name of the
virus and, if auditing has been enabled, an audit record with the same information
is created.</para>
</listitem><listitem><para>If the file is not infected, the file is tagged with a scan
stamp and the client is permitted to access the file.</para>
</listitem>
</itemizedlist>
</listitem>
</orderedlist>
</sect1><sect1 id="vscan-5"><title>Using the Vscan Service</title><indexterm><primary>virus scanning</primary><secondary>configuring</secondary>
</indexterm><itemizedlist><para>Scanning files for viruses is available when the following requirements
are met:</para><listitem><para>At least one scan engine is installed and configured.</para>
</listitem><listitem><para>The files reside on a file system that supports virus scanning.</para>
</listitem><listitem><para>Virus scanning is enabled on the file system.</para>
</listitem><listitem><para>The vscan service is enabled.</para>
</listitem><listitem><para>The vscan service is configured to scan files of the specified
file type.</para>
</listitem>
</itemizedlist><para>The following table points to the tasks you perform to set up the vscan
service.</para><informaltable frame="all"><tgroup cols="3" colsep="1" rowsep="1"><colspec colwidth="29.79*"/><colspec colwidth="37.77*"/><colspec colwidth="31.46*"/><thead><row><entry><para>Task</para>
</entry><entry><para>Description</para>
</entry><entry><para>For Instructions</para>
</entry>
</row>
</thead><tbody><row><entry><para>Install a <olink targetptr="glossaryscanengine" remap="internal">scan engine</olink>.</para>
</entry><entry><para>Install and configure one or more of the supported third-party products
listed in <olink targetptr="avscanenginesoftwaretbl" remap="internal">Table&nbsp;4&ndash;1</olink>.</para>
</entry><entry><para>See the product documentation.</para>
</entry>
</row><row><entry><para>Enable the file system to allow virus scans.</para>
</entry><entry><para>Use the file system command to enable virus scans if necessary. For
example, scans are disabled by default in the ZFS file system. </para>
</entry><entry><para><olink targetptr="vscan-6" remap="internal">How to Enable Virus Scanning on a File System</olink></para>
</entry>
</row><row><entry><para>Enable the vscan service.</para>
</entry><entry><para>Use the <citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command to start the scan service.</para>
</entry><entry><para><olink targetptr="vscan-7" remap="internal">How to Enable the Vscan Service</olink></para>
</entry>
</row><row><entry><para>Add a scan engine to the vscan service</para>
</entry><entry><para>Use the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command with its <command>add-engine</command> subcommand
to include the scan engine in the vscan service.</para>
</entry><entry><para><olink targetptr="vscan-8" remap="internal">How to Add a Scan Engine</olink></para>
</entry>
</row><row><entry><para>Configure the vscan service.</para>
</entry><entry><para>Use the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command to view and change vscan properties.</para>
</entry><entry><para><olink targetptr="vscan-9" remap="internal">How to View Vscan Properties</olink></para><para><olink targetptr="vscan-10" remap="internal">How to Change Vscan Properties</olink></para>
</entry>
</row><row><entry><para>Configure the vscan service for specific file types.</para>
</entry><entry><para>Use the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command to set the file type.</para>
</entry><entry><para><olink targetptr="excludefilesfromscanstask" remap="internal">How to Exclude Files From
Virus Scans</olink></para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable><task id="vscan-6"><title>How to Enable Virus Scanning on a File System</title><indexterm><primary>file systems</primary><secondary>scanning for viruses</secondary>
</indexterm><tasksummary><para>Use the file system command to allow virus scans of files. For example,
to include a ZFS file system in a virus scan, use the <citerefentry><refentrytitle>zfs</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command.</para>
</tasksummary><procedure>&rolestepz;<step><para>Enable virus scanning on a ZFS file system, for example, <filename>pool/volumes/vol1</filename>.</para><screen># <userinput>zfs set vscan=on <replaceable>path</replaceable>/pool/volumes/vol1</userinput></screen>
</step>
</procedure>
</task><task id="vscan-7"><title>How to Enable the Vscan Service</title><indexterm><primary>file systems</primary><secondary>enabling virus scanning</secondary>
</indexterm><procedure>&rolestepv;<step><para>Use the <citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command to enable virus scanning.</para><screen># <userinput>svcadm enable vscan</userinput></screen>
</step>
</procedure>
</task><task id="vscan-8"><title>How to Add a Scan Engine</title><indexterm><primary>file systems</primary><secondary>adding a virus scan engine</secondary>
</indexterm><procedure>&rolestepv;<step><para>To add a scan engine to the vscan service with default properties,
type:</para><screen>#<userinput>vscanadm add-engine <replaceable>engine_ID</replaceable></userinput></screen><para>See the manpage for the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command for a description of the
command.</para>
</step>
</procedure>
</task><task id="vscan-9"><title>How to View Vscan Properties</title><procedure remap="single-step"><step><para>View the properties of the vscan service, of all scan engines,
or of a specific scan engine.</para><stepalternatives><step><para>To view the properties of a particular scan engine, type:</para><screen># <userinput>vscanadm get-engine <replaceable>engineID</replaceable></userinput></screen>
</step><step><para>To view the properties of all scan engines, type:</para><screen># <userinput>vscanadm get-engine</userinput></screen>
</step><step><para>To view one of the properties of the vscan service, type:</para><screen># <userinput>vscanadm get -p <replaceable>property</replaceable></userinput></screen><para>where <replaceable>property</replaceable> is one of the parameters described
in the manpage for the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command.</para><para>For example, if you want to see the maximum size of a file that can
be scanned, type:</para><screen># <userinput>vscanadm get max-size</userinput></screen>
</step>
</stepalternatives>
</step>
</procedure>
</task><task id="vscan-10"><title>How to Change Vscan Properties</title><tasksummary><para>You can change the properties of a particular scan engine and the general
properties of the vscan service. Many scan engines limit the size of the files
they scan, so the vscan service's <parameter>max-size</parameter> property
must be set to a value less than or equal to the scan engine's maximum allowed
size. You then define whether files that are larger than the maximum size,
and therefore not scanned, are accessible.</para>
</tasksummary><procedure>&rolestepv;<step><para>View the current properties by using the <command>vscanadm show</command> command.</para>
</step><step><para>Set the maximum size for virus scans to, for example, 128 megabytes.</para><screen># <userinput>vscanadm set -p max-size=128M</userinput></screen>
</step><step><para>Specify that access is denied to any file that is not scanned
due to its size.</para><screen># <userinput>vscanadm set -p max-size-action=deny</userinput></screen><para>See the manpage for the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command for a description of the
command.</para>
</step>
</procedure>
</task><task id="excludefilesfromscanstask"><title>How to Exclude Files
From Virus Scans</title><indexterm><primary>file systems</primary><secondary>excluding files from virus scans</secondary>
</indexterm><tasksummary><para>When you enable antivirus protection, you can specify that all files
of specific types are excluded from the virus scan. Because the vscan service
affects the performance of the system, you can conserve system resources by
targeting specific file types for virus scans.</para>
</tasksummary><procedure>&rolestepv;<step><para>View the list of all file types included in the virus scan.</para><screen># <userinput>vscanadm get -p types</userinput></screen>
</step><step><para>Specify the types of files to be scanned for virus:</para><stepalternatives><step><para>Exclude a specific file type, for example the JPEG type, from
the virus scan.</para><screen># <userinput>vscanadm set -p types=-jpg,+*</userinput></screen>
</step><step><para>Include a specific file type, for example executable files, in
the virus scan.</para><screen># <userinput>vscanadm set -p types=+exe,-*</userinput></screen>
</step>
</stepalternatives><para>See the manpage for the <citerefentry><refentrytitle>vscanadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> command
for a description of the command.</para>
</step>
</procedure>
</task>
</sect1>
</chapter><?Pub *0000014791 0?>