ShareWay IP Standard Edition
User's Guide

Using ShareWay IP

 

Using ShareWay IP Standard under Mac OS 9

Mac OS 9 includes built-in file sharing over IP, based on a special bundled version of ShareWay IP. This built-in IP file sharing is enabled and disabled through the File Sharing Control Panel. When using ShareWay IP Standard with Mac OS 9, there are two points to keep in mind:

It is therefore recommended (as described in the Setup section) that the "Enable File Sharing clients to connect over TCP/IP" checkbox in the File Sharing Control Panel be unchecked before first launching ShareWay IP Standard, and that the checkbox remain unchecked while ShareWay IP Standard is in use.

When ShareWay IP Standard is used, Mac OS 9's file sharing over IP cannot also be used on that machine. To make both the ShareWay Macintosh and another target machine accessible over IP, the Pro edition of ShareWay must be used. The choice of which edition to use for your specific situation is discussed in depth at Open Door's Web site.

 

The Status Window

ShareWay IP's status window is shown below in Figure 1.

Figure 1. Status Window

ShareWay IP's status window displays important information:

This window will display a 'not available' warning next to the server name if ShareWay IP has not been able to contact the target server. ShareWay IP periodically checks the availability of the target server, updating the 'not available' display as appropriate. ShareWay might display 'not available' if:

This window may also show that the IP address is not available. This would happen if:

 

Changing the Target Server

If the status window is not showing, choose "Show ShareWay Status" from the File menu. If ShareWay IP is active, you will need to stop it before selecting another target server. Once ShareWay IP is stopped, the status window appears as shown in Figure 1 above.

There are two basic choices for target servers:

Note that ShareWay IP Standard Edition can communicate with only one AFP server at a time. When you have selected a target server, you can start ShareWay IP by clicking the "Start" button. The server will not be accessible over TCP/IP until ShareWay IP has been started, and will be made inaccessible again by clicking the "Stop" button, quitting ShareWay IP, or shutting down the Macintosh where ShareWay IP is installed. If users are connected to ShareWay IP's targeted server when you attempt to stop or quit ShareWay IP, you will be warned that there are users connected and asked to confirm your choice.

NOTE: ShareWay IP can be run on the same machine as an AppleShare 4 server with AppleTalk multihoming enabled. As in other configurations, ShareWay will connect to the server using the primary AppleTalk interface.

 

The Background Version

The ShareWay IP background application provides the functionality of ShareWay IP as a faceless, background-only application. As a background application, ShareWay IP will not show up in the application menu or "About this Computer" window, and cannot be accidentally quit by the user. The background application has no user interface, so configuration must be done through the foreground version of the product. Any errors encountered by the background application will be posted as alerts, after which the background application will quit.

 

Administration of the Background Version

Changes to the background version's configuration are made through the foreground version. When the foreground version is launched with the background version already running, you will be asked to confirm that you want the background version to quit. If you choose Quit, the background version will quit and the foreground version will launch, allowing you to make the desired changes. When all changes are made, quit the foreground version and relaunch the background version.

Changes include:

To simply quit the background version, run the foreground version, confirm that you want to quit the background version, and then quit the foreground version. Alternatively, the background version can be quit by sending it a "quit" Apple Event.

 

Logging

ShareWay IP has the option of logging significant events relating to ShareWay IP, such as:

To turn ShareWay's logging feature on (or off), choose "Turn Logging On" (or "Turn Logging Off") from the File menu.

When logging is enabled, a file called "ShareWay IP Log" is written to the ShareWay Macintosh's Preferences folder. ShareWay IP always appends to an existing log file. ShareWay IP's log file can be analyzed in real-time by Open Door's LogDoor Real-time Server Monitor. LogDoor provides an up-to-the-minute view of accesses to your server, which may be important for both security and management reasons. See ShareWay IP Log File for details of the log file format.

 

Changing ShareWay's TCP Port Number

Under certain circumstances it may be desirable to change ShareWay IP's TCP port number from its default of 548. For example, if an installation has a firewall which blocks port 548, it may be easier, for administrative reasons, to change ShareWay's port number than to change the firewall. It is also possible that another application on the ShareWay machine might use port 548.

Note that changing ShareWay's TCP port number requires clients to specify the new port number when accessing the ShareWay machine, if they are entering the URL directly. Suppose, for example, that ShareWay IP on a given machine had an AFP URL of afp://192.0.0.1/; if ShareWay was changed to use TCP port 8548, its AFP URL would become afp://192.0.0.1:8548/. If ShareWay's Service Location Protocol feature is utilized, the correct port number will be determined automatically, and need not be entered by the client.

To bring up ShareWay's TCP Port dialog, stop ShareWay if it is not already stopped and select "Set Port Number..." from the File menu. The dialog appears as shown below in Figure 2.

Figure 2. Port Number Dialog

ShareWay's port number is initially set to 548, the default for AFP. To change ShareWay's port number to another value, just enter the value (between 1 and 65535) and click OK. To prevent port number conflicts, it is recommended that alternate port numbers be 8548 or above. To revert to ShareWay's default value, click "Revert to Default" and then click OK.

 

Number of Users Supported

ShareWay IP Standard supports up to 20 simultaneous users. If you need to support more than 20 simultaneous users, you should use ShareWay IP Professional Edition. ShareWay IP Standard could adversely affect its machine's performance if a large number of users connects simultaneously, depending on the traffic they generate. If you expect heavy usage of ShareWay, you may want to run it on a separate machine.

 

Serial Numbers

ShareWay IP uses a serial number mechanism to easily convert evaluation versions of the software to paid-for versions and to prevent unauthorized duplication of the software. It is available as an evaluation version that will stop working 10 days after the date it is first run. Until expiration, the eval version has all the functionality of a full working version. An eval version of ShareWay can be converted to a permanent working version by giving it a valid serial number.

Background version - Serial numbers for the background version are entered through the foreground version. For details, see Administration of the Background Version above.

Foreground version - When an unexpired eval of the ShareWay IP foreground version is launched, a dialog appears with the options "Enter Serial Number..." and "OK". Clicking OK lets you run the software as an eval. Clicking "Enter Serial Number..." brings up a dialog which allows you to enter a serial number and convert the software into a permanent working version. Enter the serial number you were provided when you paid for the product, and click OK.

When an expired eval version is launched, a dialog appears with the options "Enter Serial Number..." and "Quit". To convert an expired version into a full working version, click "Enter Serial Number...", enter a serial number and click OK.

The "Enter Serial Number..." dialog can also be brought up while the product is running. Stop ShareWay IP, choose "Enter Serial Number..." from the File menu, and proceed as described above.

If more than one copy of ShareWay IP is used, each copy must have a unique serial number. A ShareWay serial number is registered on the network (and checked for duplicates) when ShareWay is started, not when the serial number is first entered.

Serial numbers for previous versions of ShareWay IP will not work with ShareWay IP 3.0. You must purchase an upgrade to ShareWay IP 3.0 to obtain a valid 3.0 serial number. To purchase a serial number for an eval copy, or to obtain a lost serial number, contact Open Door Networks.

 

Online Help

With OS 8.5 and later, online help for ShareWay IP is available in two ways:

Either method will invoke ShareWay's online help, which is structured much like this user guide. Note that when running the background-only version of ShareWay, online help is only available through the Finder's Help menu's Help Center, since the background application has no menus.

 

Mac OS 9 and Multiple Users

When running ShareWay IP in Mac OS 9's Multiple Users environment, all users share the same preferences file and log file. These files are stored in the System Folder's Preferences folder.

If a user is set up as a Normal User, they will be able to change ShareWay IP's configuration, and those changes will affect all other users. It is therefore recommended that all users be set up as Limited Users, and denied access to the foreground version of ShareWay IP. In this way, only the Owner will be able to configure ShareWay IP.

In the Multiple Users environment, it is recommended that you use the background version of ShareWay IP. The foreground version will quit whenever a user logs off the ShareWay machine, causing all of ShareWay's connected clients to be disconnected. The background version will keep running when a user logs off, providing continuity for ShareWay's connected clients.


Back to Table of Contents
Back to Getting Started
Forward to Security