Space

Setting Up Clients

Configuring the Client Setup Program
Installing Clients
Removing Clients
Reviewing the Client Setup Log
Web Proxy Clients
WinSock Proxy Clients
Using the WSP Client Application
Creating a Local LAT File
Editing the Mspclnt.ini File
Configuring Windows Sockets Applications

To TopConfiguring the Client Setup Program

During Microsoft Proxy Server setup, you are asked to complete a Client Configuration dialog box. The options in this dialog box are used to create an Mspclnt.ini file, which is installed on the server, along with a client Setup program. Later, when a client connects to the server and runs the client Setup program, the Mspclnt.ini file is copied to the client, and determines its client configuration parameters. For information about using the Microsoft Proxy Server Setup program and completing the Client Configuration dialog box, see “Server Installation.”

If you need to change the server’s copy of the Mspclnt.ini file after a server has been installed, you can:

If you need to change a client’s copy of the Mspclnt.ini file after a client has been installed, you can:

To TopInstalling Clients

Running Client Setup
Reinstalling a Client
Installing on a Dual-Boot Client
Running Client Setup from the Command Line

For information about upgrading a client from a preliminary release of Microsoft Proxy Server, see the Readme.txt file provided on the Microsoft Proxy Server compact disc.

To TopRunning Client Setup

You can set up a client computer by using either the Setup program or a Web browser.

To set up a client computer using the Setup program

  1. From the client computer, connect to the server’s Mspclnt share.

    For example, for the server Wolfhound, you would connect to \\Wolfhound\Mspclnt.

  2. From the Mspclnt share, run Setup and follow the on-screen instructions.

    The client components will be installed, and the client computer will be configured according to the settings of the Mspclnt.ini file.

To set up a client computer using the client’s Web browser

  1. From a browser on the client computer, connect to the server's installation page by typing the URL http://servername/Msproxy, where servername is the name of the server.

    For example, for the server Delaney, you would type http://Delaney/Msproxy.

  2. Once the client installation Web page is loaded, follow the on-screen instructions to run Setup and install client components.

If the browser proxy settings configured by client Setup are not appropriate for a particular client, or if a client’s Web browser is not Microsoft Internet Explorer or Netscape Navigator, then you must use the Web browser’s own configuration interface to specify the name of the computer running Microsoft Proxy Server and the protocol port number. For more information see Web Proxy Clients, later in this chapter.

To TopReinstalling a Client

After installing a client, if you need to reinstall you can rerun Setup.

To use Setup to reinstall a client

  1. At the client computer, open the Microsoft Proxy Client program group, and click Setup.

    –Or–

    Connect to the Mspclnt share on the server and rerun client Setup from there, as described in Running Client Setup.

  2. When the Client Setup dialog box appears, select Reinstall and follow the on-screen instructions.

For computers running Windows 95 or Windows NT 4.0, you can also reinstall client software by using Control Panel.

To use Control Panel to reinstall a client

  1. At the client computer, open Control Panel and click Add/Remove Programs.
  2. The Add/Remove Programs Properties dialog box appears.
  3. Make sure the Install/Uninstall tab is selected.
  4. Select Microsoft Proxy Client, click Add/Remove, and follow the on-screen instructions.

To TopInstalling on a Dual-Boot Client

It is possible to run client Setup and install the WinSock Proxy client software on a dual-boot computer. Client Setup should be run twice (once for each operating system). After the first installation, you must specify a different client directory. For example, install client software on the Windows NT operating system, then install client software on the Windows 95 operating system in a different directory.

To TopRunning Client Setup from the Command Line

Optionally, you can run client Setup from the command line and take advantage of the command-line options. The client Setup syntax is as follows:

Syntax

setup [/r] [/u] [/q[1,t]]

where

/r

Reinstalls the client.

Note   The /r switch cannot be used with 16-bit clients (computers running Microsoft Windows 3.1 or Microsoft Windows for Workgroups).

/u

Removes the client application but leaves shared components.

Note   The /u switch cannot be used with 16-bit clients (computers running Microsoft Windows 3.1 or Microsoft Windows for Workgroups).

/q

Runs client Setup in “quiet” setup mode. The screen displays progress windows and a Setup completion dialog box, but does not prompt the user to approve or modify installation settings. Quiet setup will always install the client software into the default directory (Mspclnt).

Note   You can only use quiet mode for an initial setup. If a client is already installed, you cannot reinstall or remove it by using the /q option.

/q1

Same as /q, but also hides the Setup completion dialog box.

/qt
Same as /q, but also hides the progress windows and completion dialog box. (After installation completes, the client computer will be restarted if a restart is required by the Setup program.)

To TopRemoving Clients

To remove the client software from a computer

  1. From the Microsoft Proxy Client program group, click Uninstall.

    The Uninstall Proxy Client dialog box appears.

  2. Click Yes.

    All installed client components are removed from the computer.

You can also remove the client software by using the Setup program, but you must be connected to the Mspclnt share on the server.

To use the Setup program to remove a client

  1. From the Microsoft Proxy Client program group, click Setup.

    –Or–

    Connect to the Mspclnt share on the server and run client Setup from there, as described in Running Setup.

  2. Click Remove All and follow the on-screen instructions.

You can also remove client software by using Control Panel.

To use Control Panel to remove a client

  1. From the client, open Control Panel and click Add/Remove Programs.
  2. The Add/Remove Programs Properties dialog box appears.
  3. Make sure the Install/Uninstall tab is selected.
  4. Select Microsoft Proxy Client, click Add/Remove, and follow the on-screen instructions.

To TopReviewing the Client Setup Log

During client installation, the client Setup program creates a log, Mpcsetup.log, and places it in the root directory of the drive where the client is installed. (This location is C:\Mpcsetup.log.) If you encounter problems with client Setup, review this log by using any text editor (such as Microsoft WordPad or Microsoft Notepad).

To TopWeb Proxy Clients

About Web Proxy Clients
Configuring the Internet Application in Control Panel
Configuring Microsoft Internet Explorer 3.0 Clients
Configuring Microsoft Internet Explorer 1.5 Clients
Configuring Netscape Navigator Clients
Configuring Apple Macintosh Clients
Configuring UNIX Clients
Configuring the Server’s Browser
Web Proxy Client Considerations

To TopAbout Web Proxy Clients

The term Web Proxy client refers to a client computer whose Web browser is configured to use the Web Proxy service on a Microsoft Proxy Server. Usually, this is accomplished by running the client Setup program, as described in Installing Clients earlier in this chapter.

If the browser proxy settings configured by client Setup are not appropriate for a particular client, you can reconfigure that client’s Web browser (by using the Web browser’s own configuration interface) after installing the client software. Also, if a client’s Web browser is not Microsoft Internet Explorer or Netscape Navigator, or if client Setup does not successfully configure a client’s Web browser to use the Web Proxy service, then you must use the Web browser’s own configuration interface to specify the name of the appropriate Microsoft Proxy Server and the protocol port number (usually 80).

Each browser is configured through its own user interface. Typically, an application’s relevant settings are found in menu items called “Options,” “Preferences,” or “Settings.” You can configure Internet Explorer by using the Internet application in Control Panel.

To TopConfiguring the Internet Application in Control Panel

When you run client Setup, it will configure Microsoft Internet Explorer 2.0 as a client of Microsoft Proxy Server. However, you can also use the Internet application in Control Panel to specify the name of the Microsoft Proxy Server and the protocol port number. Internet Explorer 2.0 uses the settings from the Internet application, but other client applications may have their own property sheets or dialog boxes for their proxy service settings.

To configure the Internet application with a Microsoft Proxy Server name and protocol port number

  1. Open Control Panel and click the Internet icon.

  2. Select the Advanced tab.

  3. Select the Use Proxy Server check box.

  4. In the Proxy Server box, type the protocol, proxy server name, and port number (for example, http://myproxy:80.)

  5. Optionally, in the Bypass Proxy On box, type the name of computers, domains, and ports through which client applications can request objects without going through the Web Proxy service. For example, type domainname.com:80 to gain access to computers inside domainname and to services running on port 80 without using the Web Proxy service.

    This option is useful if you want to access Internet servers within your private network.

To TopConfiguring Microsoft Internet Explorer 3.0 Clients

When you run the client Setup program, it will configure Microsoft Internet Explorer 3.0 as a client of Microsoft Proxy Server. However, you can also use the browser’s own configuration interface to set this up.

To configure Internet Explorer 3.0 as a Microsoft Proxy Server client

  1. Obtain the proxy system address from the network administrator.
  2. From the Windows desktop, right-click the Internet icon.
  3. Select Properties from the drop-down menu that appears.
  4. Click the Connection tab.
  5. In the Proxy Server area, select the Connect Through A Proxy Server check box, then click the Settings box.
  6. In the protocol Type box, type the appropriate proxy system address or addresses, then type the connection port number (usually 80) in the adjacent Port box.

You can also configure the browser while it is running

To configure Internet Explorer 3.0 while it is running

  1. Start Internet Explorer 3.0.
  2. Obtain the proxy system address from the network administrator.
  3. In the View menu, click Options.
  4. Click the Connection tab.
  5. In the Proxy Server area, select the Connect Through a Proxy Server check box, then click the Settings box.
  6. In the protocol Type box, type the appropriate proxy system address or addresses, then type the connection port number (usually 80) in the adjacent Port box.

To TopConfiguring Microsoft Internet Explorer 1.5 Clients

Internet Explorer 1.5 is available for computers running the Windows NT 3.51 and Windows 3.x operating systems.

To configure Internet Explorer 1.5 as a Web Proxy client

  1. Start Internet Explorer, click the Tools menu, and click Set Proxy Server.

    The Set Proxy Server dialog box appears.

  2. Select the Use Proxy Server check box.

  3. In the Proxy Server box, type the name of the server.

  4. In the box after the colon, type the protocol port number (for example, 80).

  5. Optionally, in the Bypass Proxy On box, type the IP addresses of sites that should be accessed without using Microsoft Proxy Server. These can be Internet or private network sites running HTTP, FTP, or Gopher.

To TopConfiguring Netscape Navigator Clients

When you run the client Setup program, it will configure Netscape Navigator as a client of Microsoft Proxy Server. However, you can also use the browser’s own configuration interface to set this up.

In Netscape Navigator 2.01 for Windows NT and for Windows 95, you define the name of the computer running Microsoft Proxy Server and the port number for each protocol.

To configure Netscape Navigator 2.01 to use Web Proxy service for HTTP protocol requests

  1. Open Netscape Navigator.
  2. Select the Options menu.
  3. In the Proxies property sheet, select Network Preferences.
  4. Select Manual Proxy Configuration.
  5. Click View.
  6. In HTTP Proxy, type the name of the computer running Microsoft Proxy Server.
  7. In the Port box adjacent to HTTP Proxy, type the port number used on the Microsoft Proxy Server for HTTP protocol requests.

For each protocol you use with the Web Proxy service, you define a Microsoft Proxy Server name and port number in the Proxies property sheet.

To TopConfiguring Apple Macintosh Clients

To configure an Apple Macintosh client application running under UNIX, you need to specify the name of the computer running Web Proxy service and the Microsoft Proxy Server port number for the client protocol.

To TopConfiguring UNIX Clients

To configure a UNIX client application running under UNIX, you need to specify the name of the computer running Web Proxy service and the Microsoft Proxy Server port number for the client protocol.

To TopConfiguring the Server’s Browser

If you use a browser from the server computer that is running Microsoft Proxy Server, and if that browser is configured as a client, you must configure that browser to use as its proxy the IP address of the server’s network adapter card that is connected to the private network. Do not use the server’s computer name or DNS name.

If you configure the server’s browser to use the computer or DNS name, this name can be resolved to the IP address of a network adapter card connected to the Internet. When this occurs, requests from that browser will be filtered (because the LAT should not contain that IP address) and an “Access is denied” error will be returned.

To TopWeb Proxy Client Considerations

Following are some considerations about Web Proxy clients:

To TopWinSock Proxy Clients

About WinSock Proxy Clients
WinSock Proxy Client Considerations

To TopAbout WinSock Proxy Clients

The term WinSock Proxy client refers to a client computer that is configured to use the Web Proxy service on a Microsoft Proxy Server. The WinSock Proxy client components are installed by running the client Setup program, as described in Installing Clients earlier in this chapter. The client Setup program does not configure individual Windows Sockets applications. Instead, the client computer is configured to use the WinSock Proxy service on a server. All Windows Sockets applications on that computer access the Internet through the WinSock Proxy service on Microsoft Proxy Server.

The WinSock Proxy service supports Windows Sockets version 1.1 applications. Before a Windows Sockets application can access the Internet through Microsoft Proxy Server, the server must be configured to permit access for the required protocol on the required outbound and inbound ports. For details on configuring server support for particular Windows Sockets client applications, see “Configuring the WinSock Proxy Service.”

In a private network with multiple Microsoft Proxy Server gateways, install an equal number of WinSock Proxy clients from each gateway to balance Internet traffic across all the gateways. For information about configuring multiple Microsoft Proxy Server gateways, see “Server Administration.”

To TopWinSock Proxy Client Considerations

Following are some considerations for WinSock Proxy client computers:

To TopUsing the WSP Client Application

Use the WSP Client application in Control Panel to enable or disable the WinSock Proxy client software, change the server from which client configuration files are downloaded, and download fresh copies of the WinSock Proxy client configuration files from that server.

Turning the WinSock Proxy Client On or Off
Changing the Server Used to Download Client Configuration Files
Updating the WinSock Proxy Client Configuration Files

To TopTurning the WinSock Proxy Client On or Off

After a computer has the WinSock Proxy client software installed, it is able to use Windows Sockets applications to access Internet sites through Microsoft Proxy Server on the corporate network. However, unless the WinSock Proxy client is turned off, the computer will be unable to use Windows Sockets applications to access any Internet sites through a dial-up connection to a private Internet service provider (ISP). This might occur, for example, if a user has a home computer that is sometimes used to connect to the corporate network, and other times to a private ISP. You can turn the WinSock Proxy client on and off by using the WSP Client application in the Control Panel.

To turn the WinSock Proxy client on or off

  1. From the client computer, open Control Panel and double-click the WSP Client icon.

    The Microsoft WinSock Proxy Client dialog box appears.

  2. Select or clear the Enable WinSock Proxy Client check box.

    • To turn on the WinSock Proxy client software and use Windows Sockets applications with Microsoft Proxy Server, select the Enable WinSock Proxy Client check box.

    • To turn off the WinSock Proxy client software and use Windows Sockets applications with a private ISP, clear the Enable WinSock Proxy Client check box.

  3. Click OK, then reboot the computer.

To TopChanging the Server Used to Download Client Configuration Files

The WSP Client application can be used to change the server from which a computer downloads client configuration files. (Note that this is not necessarily the same server that the computer uses to access the Internet. That server is defined in the downloaded Mspclnt.ini file.)

To change the WinSock Proxy Server from which a client downloads client configuration files

  1. At the client computer, open Control Panel and double-click the WSP Client icon.

    The Microsoft WinSock Proxy Client dialog box appears.

  2. Type a server name in the Configuration Location box.

    Note   The entry in the Configuration Location box must be a computer name. It cannot be a DNS name that resolves to multiple IP addresses.

  3. Click OK, then reboot the computer.

    The client is set to use the new server as the source of its client configuration files, and those files are downloaded to the client.

To TopUpdating the WinSock Proxy Client Configuration Files

To update client configuration files, you can force an immediate download of client configuration files from the server to the client.

To update the client configuration files

  1. At the client computer, open Control Panel and double-click the WSP Client icon.

    The Microsoft WinSock Proxy Client dialog box appears.

  2. Click Update Now.

    Fresh copies of the client configuration files are downloaded from the server to the client.

To TopCreating a Local LAT File

When the client Setup program runs, it installs a file named Msplat.txt into the Mspclnt directory on the client computer. The Msplat.txt file contains the Local Address Table (LAT), which defines the IP addresses of the private network.

In some situations the LAT table downloaded by the server may not completely define some addresses that a particular client needs to access in the private network. To correct this condition, you can edit the LAT on the server (which would propagate the updated LAT to all its clients) or you can create a local LAT for a particular client. You might create a local LAT, for example, to allow client access to a private subnet inside a private network.

To create a custom LAT table for a particular client, do not edit the client’s copy of the Msplat.txt file, because each client’s Msplat.txt file is overwritten at regular intervals by a fresh version downloaded from the server. Any changes you make locally are lost each time the server updates the file.

Instead, to create a custom LAT file for a client, use a text editor to create a file named Locallat.txt, and place it in the client’s Mspclnt directory. In this way you can add additional IP address ranges that the client recognizes as part of the private network. The client will use both the Msplat.txt and Locallat.txt files to determine which IP addresses are part of the private network (and can be directly communicated with) and which IP addresses are on the Internet (and must be communicated with through Microsoft Proxy Server).

When creating a Locallat.txt table, enter IP address pairs in the file. Each address pair defines either a range of IP addresses (from the first, lower-number address to the second, higher-number address), or a single IP address (if both addresses of the pair are identical). The following is an example of a Locallat.txt file that has two entries. The first entry is an IP address range, and the second is a single IP address.

10.51.0.0 10.51.255.255
10.52.144.103 10.52.144.103

Note that the second entry is an IP address (not a subnet mask).

To TopEditing the Mspclnt.ini File

The Mspclnt.ini file contains client configuration information. The master copy of the Mspclnt.ini file is created by the Microsoft Proxy Server Setup program and is stored in the Msp\Clients folder on the server. Each instance of client software that is installed from a server receives a copy of the Mspclnt.ini file, which is stored in the Mspclnt folder on the client. The Mspclnt.ini file can be modified by using a text editor (such as Microsoft WordPad).

The following is a sample Mspclnt.ini file.

 

[Master Config]
Path1=\\COLLIE2\Mspclnt\
[Servers Ip Addresses]
Name=COLLIE
[Servers Ipx Addresses]
Addr1=00002610-0080d830525f
[Common]
Port=1745
Configuration Refresh Time (Hours)=6
Set Browsers to use Proxy=1
WWW-Proxy=COLLIE
WebProxyPort=80

The following table describes the entries in the Mspclnt.ini file.

Section Entry Description
[Master Config] Path1 A UNC path to the shared network directory on the server, containing the master copy of the client configuration files.
[Servers IP addresses] Name The computer or DNS name for the WinSock Proxy server used by the client. (This entry will not appear if an IP address is used.)
[Servers IP addresses] Addr1 The IP address of the WinSock Proxy server used by the client. (This entry will not appear if a computer or DNS name is used.) Additional entries are shown as Addr2, Addr3, and so on.
[Servers Ipx Addresses] Addr1 The IPX address of the WinSock Proxy server. Additional entries are shown as Addr2, Addr3, and so on.
[Common] Port The port Microsoft Proxy Server uses for the control channel.

This value will rarely be changed. It should be changed by the administrator on the server’s master copy of the Mspclnt.ini file only if there is a conflict with another service on the server. This value should never be edited in the client’s copy of the Mspclnt.ini file.

[Common] Configuration Refresh Time (Hours) At this interval, specified in hours, the client will ask the server to download a fresh copy of the Local Address Table (Msplat.txt).
[Common] Set Browsers to use Proxy In the server’s file, set this value to 1 to have the client Setup program configure the client computer’s browser to use the proxy server defined in the WWW Proxy field. Set the value to 0 to prevent the client Setup program from configuring clients to use a proxy server. This field has no effect on the client’s version of the file.
[Common] LocalDomains A list of suffixes for names that will be resolved locally, separated by commas (,). Domain names that end in the listed strings are resolved at the client.
[Common] WWW-Proxy In the server’s file, if Set Browsers to Use Proxy is set to 1, the client Setup program will configure client browsers to use the proxy server named here. This field has no effect on the client’s version of the file.
[Common] WebProxyPort The listen-on port used by the Web Proxy service. In the server’s file, if Set Browsers to Use Proxy is set to 1, the client Setup program will configure client browsers to use the port named in that box. This should be the same port number that is set for the WWW service of Internet Information Server.

To TopConfiguring Windows Sockets Applications

Advanced options for configuring individual Windows Sockets applications are not required for most applications to work with the WinSock Proxy service. In most cases, the default WinSock Proxy configuration will work with no need for further modification. However, in some situations the advanced options discussed in this section may be necessary.

Configuration information can be set for all WinSock Proxy applications in two ways:

WinSock Proxy service will first look for an Wspcfg.ini file in a client Windows Sockets application directory. If one is not found, WinSock Proxy service will use the settings found in the Mspclnt.ini file under the [Wsp client] section. The settings used for a particular Windows Sockets application are taken from one of these two files only.

The following is a sample [Wsp client] section in an Mspclnt.ini file. Keep in mind that where shared settings exist in both a Wspcfg.ini file and the Mspclnt.ini file located in the WinSock Proxy Client directory (C:\Mspclnt), application-specific settings made in Wspcfg.ini will override global settings in Mspclnt.ini. 

[Wsp client]
Disable=0 
NameResolution=R
LocalBindTcpPorts=7777
LocalBindUdpPorts=7000-7022, 7100-7170
RemoteBindTcpPorts=30
RemoteBindUdpPorts=3000-3050
MultipleAccessTcpPorts=100-300
MultipleAccessUdpPorts=500-900, 1000-2000
ProxyBindIp=80:10.52.144.103, 82:10.51.0.0

The following table describes the possible entries that can be placed in a configuration file.

Entry Description
Disable Disables WinSock Proxy service functionality; all functions are directly forwarded to the system. Note if the Disable value is set to 0, all following file entries are ignored.
NameResolution By default, resolution for all dot-convention names is redirected. Forces name resolution to local (L) or redirected (R), as specified.
LocalBindTcpPorts Specifies a TCP port, list, or range that will be bound locally.
LocalBindUdpPorts Specifies a UDP port, list, or range that will be bound locally.
RemoteBindTcpPorts Specifies a TCP port, list, or range that will be bound remotely.
RemoteBindUdpPorts Specifies a UDP port, list, or range that will be bound remotely. By default, this is set to 6970-7170 to support client computers running RealAudio player version 2.1 or newer. If this entry does not appear in the Mspclnt.ini file, when RealAudio player version 2.1 or newer is used with Microsoft Proxy Server it will display “Buffering 18” in the status bar, and will not play sound. To resolve this condition, click the Stop button, and then click the Play button.
MultipleAccessTcpPorts Specifies a TCP port, list, or range used by a server application, so an accept operation on these ports is intended to serve clients both locally and on the Internet. By default, the socket is considered of client process with one connection, so the listening socket is reused. Requires that the port will be available both on the client and Microsoft Proxy Server.
MultipleAccessUdpPorts Specifies a UDP port, list, or range used by a server application, so an accept operation on these ports is intended to serve clients both locally and on the Internet. By default, the socket is considered of client process with one connection, so the listening socket is reused. Requires that the port will be available both on the client and Microsoft Proxy Server.
ProxyBindIp Specifies an IP address or list that will be used when binding with a corresponding port. Used by multiple servers that use the same port and need to bind to different ports on Microsoft Proxy Server.

Note   A port can appear in only one of the entries, either as Local, Remote (redirected), or MultipleAccess. There is no provision for client applications that require connections both on the private network and on the Internet. For such applications, incoming connections from the private network will be directed through Microsoft Proxy Server as well.

© 1996 by Microsoft Corporation. All rights reserved.