Setup guide

To configure the path translation database:
1 Consider your network environment and how you can organize hosts to simplify the path translation
process.
Do you have many hosts accessing the same storage device? Do they mount the central storage using
the same syntax and drive names? Are these hosts running the same application? Are they running
the same operating system?
2 Open /usr/discreet/wiretap/cfg/sw_wiretap_path_translation_db.xml in a text editor.
3 Create the rules for translating the file path. The rules are applied in the order that they appear in the
file. The first rule is applied. If that rule matches, then the translation is complete. If the rule doesn't
match, the next rule is examined.
If your network includes groups of hosts that mount their storage using the same syntax, you may be
able to use a group or platform rule to translate the syntax for all similar hosts. If, however, all of your
hosts use different syntax and mount points for their storage, you will have to create a host/path rule
for each source and destination host.
See the sections that follow for a description of the possible path translation rules you can create.
4 Save the file.
5 You do not have to restart Stone and Wire to apply changes in the path translation database. The
Wiretap server periodically checks the timestamp of the file and, if there are changes, it updates itself
accordingly. However, if you want to test the results of your changes, you can restart Stone and Wire
manually. To restart Stone and Wire manually, type: /etc/init.d/stone+wire restart Stone and
Wire restarts.
About XML Syntax
You must respect XML syntax standards when editing the path translation file. For example, the values
assigned to attributes must not include ampersands (&) or left angle brackets (<) in their literal form. All
instances of these characters, except left and right angle brackets used to delimit XML tags, should be replaced
with &amp; and &lt; respectively. Do not concern yourself with the white-space between attributes; it is
ignored when the file is parsed.
Creating a Host/Path Rule for Host-to-Host Translation
Create a host/path rule to translate the path syntax used by the source workstation (the workstation running
the Wiretap server) to the path syntax used by the destination workstation.
The syntax of the host/path rule is as follows: <map src_host=”<src_host>” src_path=”<src_path>”
dst_host=”<dst_host>” dst_path=”<dst_path> ”>
Enter a value for each attribute. See the following table for a description of the valid values for each attribute.
DescriptionAttribute
The host name or IP address of the workstation to which a client connects.
If you create a group rule for source workstations, the value of this attribute can be the group
name.
src_host
The path to the remote storage as referred to by the source host (or hosts, when mapping a
group).
src_path
60 | Chapter 6 Software configuration