Setting Up the TCP/IP Scanner The TCP/IP Scanner tab in the New Connection window helps you find and connect to remote computers, even when you don t know their IP addresses, by browsing your local network for active Timbuktu-compatible computers. Once the desired computer is found, you may connect to it without leaving the TCP/IP Scanner tab. The TCP/IP Scanner can detect Timbuktu Pro for Macintosh computers with TCP/IP Incoming Access enabled, Timbuktu Pro for Windows computer, and computers running HouseCall. By default, the TCP/IP Scanner searches for other computers on your local subnet. To customize your TCP/IP Scanner search and allow it to find computers on subnets other than your own, you can create a TCP/IP Zones file listing other IP addresses and ranges for your computer to search. The TCP/IP Zones File When you first run Timbuktu Pro for Macintosh, the TCP/IP Scanner tab in the New Connection window displays only one pane. This pane lists the active Timbuktu Pro computers in your local subnet, which is the only network location that the TCP/IP Scanner can search by default. To extend the TCP/IP Scanner search, you create the TCP/IP Zones file. This file lists all the IP addresses and ranges that you want the TCP/IP Scanner to search. Note that you must use this exact file name TCP/IP Zones to enable the TCP/IP Scanner to recognize the file. If you create the TCP/IP Zones file with certain Mac OS X applications, you may not be able to include the slash (/) in the file name. You may need to create the TCP/IP Zones file in a Classic application to name it correctly. 1
2 Setting Up the TCP/IP Scanner When you put this custom TCP/IP Zones file in place and reopen the New Connection window, the TCP/IP Scanner will include a second panel. This new panel lists your TCP/IP zones in way similar to the zone display on the AppleTalk tab. Any additional changes you make the TCP/IP Zones file will take effect whenever Timbuktu Pro s New Connection window is closed and reopened. Creating a Custom TCP/IP Zones File Each TCP/IP zone specification in a custom TCP/IP Zones file consists of a minimum of two parts: A zone name, such as Direct IP Numbers. The zone name will appear on the TCP/IP Scanner tab so you can select it for scanning. A TCP/IP address or range of addresses. The zone name appears in the Zone Name list in the lower panel on the TCP/IP Scanner tab. You can include comments in your TCP/IP Zones file by preceding each comment line with a pound sign (#) or by preceding the comment with a semicolon (;). For example, a simple TCP/IP Zones files may appear as follows. # This is a comment. Engineering Subnet ; the zone name 123.123.33.18 123.123.33.34 ; the TCP/IP address range Now you re ready to create your custom TCP/IP Zones file. To create a custom TCP/IP Zones file 1. Open a text editor. 2. Using the syntax discussed in the following section, TCP/IP Zones File Syntax, list the subnets that your TCP/IP Scanner should search. Make sure that each location includes a zone name. 3. Save the file with the file name TCP/IP Zones. Remember that you must use this exact file name to enable the TCP/IP Scanner to find it.
Timbuktu Pro Enterprise User s Guide 3 4. Place the saved file on your computer in the appropriate location: On Mac OS X computers, place the TCP/IP Zones file in the Library: Preferences:Netopia folder. On Mac OS 8.6 and Mac OS 9 computers, place the TCP/IP Zones file in the System Folder:Preferences:Netopia folder. 5. In Timbuktu Pro, close and reopen the New Connection window. Note that a second panel appears on the TCP/IP Scanner tab, listing the search zones you specified in the TCP/IP Zones file. The extended TCP/IP Scanner search can now take place. TCP/IP Zones File Syntax You can specify the TCP/IP address or address range in the TCP/IP Zones file in five ways: Individual numeric IP addresses Ranges of numeric IP addresses The local subnet A network number and a subnet mask A range of network numbers and a subnet mask These five methods are described in detail below. Specifying Individual Numeric IP Addresses When you specify an individual numeric IP address, the TCP/IP Scanner will find only the computer with the specified IP addresses. You can list as many individual addresses as you wish. The following syntax would find two computers with the exact TCP/IP addresses indicated. 123.123.123.6 123.123.123.123 Specifying Ranges of Numeric IP Addresses When you specify a range of numeric IP addresses, the TCP/IP Scanner will find only the computers whose IP addresses fall in that range. You can list as many IP address ranges as you wish.
4 Setting Up the TCP/IP Scanner The following syntax would find computers in the indicated range. 123.123.4.1 123.123.4.56 This example would find the computers at 123.123.4.17 and 123.123.4.29, but not the computer at 123.123.4.72. Note that you must include a space before and after the hyphen ( ) character. Specifying Computers on Your Local Subnet The <local> command causes the TCP/IP Scanner to list the Timbuktu Pro computers found on your local subnet. (This is also the default behavior of the TCP/IP Scanner if there is no Zones file present.) Including the <local> command in your TCP/IP Zones file allows you to give the local zone a logical name. For example, you could use the following syntax to name your local subnet R&D Computers. R&D Computers <local> Specifying a Network Number and a Subnet Mask Specifying a network number and subnet mask will list Timbuktu Pro computers whose IP addresses begin with the specified network number. For example, the following syntax would find all computers whose IP addresses begin with 123.123.4.x. 123.123.4.0 & 255.255.255.0 If the network number or the subnet mask does not end with 0, the TCP/IP scanner will calculate the suitable IP address range. For example, the following syntax would find the computer at 123.123.4.27, but not the computer at 123.123.4.22. 123.123.4.25 & 255.255.255.0 Note that you must include a space before and after the ampersand (&) character. Specifying a Network Range and a Subnet Mask Specifying a network range and subnet mask will list Timbuktu Pro computers whose IP addresses begin with a number in the specified range. For example, the following syntax would find all computers whose IP addresses begin with
Timbuktu Pro Enterprise User s Guide 5 123.123.1.x, 123.123.2.x, and on through 123.123.44.x, but it would not find the computer at 123.123.45.0. (123.123.1.0 123.123.44.0) & 255.255.255.0 Note that you must include a space before and after the hyphen ( ) and ampersand (&) characters. Mixing and Matching The TCP/IP Zones file you use can specify IP addresses and address ranges using any combination of the methods discussed above. Consider the following example. 123.123.20.1 123.123.20.128 11.22.33.44 (123.234.45.0 123.234.254.0) & 255.255.255.0 The preceding TCP/IP Zone file would cause your TCP/IP Scanner to find computers whose IP addresses are between 123.123.20.1 and 123.123.20.128, the single computer at 11.22.33.44, and the range of addresses between 123.234.45.x and 123.234.254.x. Using Broadcasts versus Ranges A TCP/IP Zones files that includes subnet numbers will cause the TCP/IP Scanner to use IP broadcasts to spread the word on each subnet. Some routers may not work with subnet-dependent techniques. If IP broadcasting won t work on your network, you must specify IP address ranges instead. Because specified addresses and address ranges receive individually directed packets, instead of the global packets sent by a broadcast, network responses when you use specified ranges are typically much slower than when you use broadcasts.
6 Setting Up the TCP/IP Scanner A Complete TCP/IP Zones File When you create your TCP/IP Zones file, remember to include logical labels for the different search ranges. My Local Net <local> Field Office 127.203.17.0 & 255.255.255.0 127.203.18.0 & 255.255.255.0 Engineering (24 net) 127.203.24.0 & 255.255.255.0 Marketing 127.203.7.0 & 255.255.255.0 Including A Custom TCP/IP Zones File During Installation To include a custom TCP/IP Zones file when you install Timbuktu Pro on Mac OS X, you must place it inside the Timbuktu Pro application bundle. To place the TCP/IP Zones file in the application bundle 1. Create a TCP/IP Zones file and customize it as desired. 2. Open the application bundle by holding down the control key and clicking on the Timbuktu Pro.app file, located in the For Mac OS X:Timbuktu Pro folder. 3. From the shortcut menu, choose Show Package Contents. The Timbuktu Pro.app file opens as a folder on the desktop. 4. In the Timbuktu Pro.app folder, open the Contents folder and drag the TCP/IP Zones file into the Shared Support folder. Now, when you copy the Timbuktu Pro application bundle to another computer, the custom TCP/IP Zones file is included. This document is Netopia part number 6150275-PF-01. Copyright 2002 Netopia, Inc. All rights reserved.