LDAP for StreetTalk 3.6 Installation Guide
Introduction
LDAP for StreetTalk® software
(version 3.6) is an adjunct to StreetTalk for Windows NT®.
The LDAP for StreetTalk service is based on the slapd source
code created by the University of Michigan.
LDAP for StreetTalk service software provides
read and write access to StreetTalk Directory Assistance (STDA)
items. You install the LDAP for StreetTalk software on StreetTalk
for Windows NT version 8.6 servers running Microsoft Windows NT
Server version 4.0.
For additional information about topics
in this guide, see the LDAP for StreetTalk Administrator's Guide.
System
Requirements
Your server must meet the following hardware
and software requirements before you install LDAP for StreetTalk:
Hardware
Software
Before
You Begin
Check the following before you begin the
installation:
Note:
You can install the LDAP Configuration
Manager on a Windows 95/98 or Windows NT workstation or on a
Banyan Enterprise Client for Windows. You use the same installation
procedure as documented later.
Installing LDAP for StreetTalk
Overview
LDAP for StreetTalk software is available
on the Banyan web site, http://www.Banyan.com, as a self-extracting
compressed file, LDAPforStreetTalk.exe. There is also a patch,
ST_NT990008.EXE, that you must install after installing LDAP for
StreetTalk. Download these self-extracting compressed files to
a temporary directory on your StreetTalk for Windows NT server.
Note:
Patch ST_NT990008.EXE is on the
Banyan web site. Use the above link.
You will perform these steps:
This document describes these steps in detail.
Note: Before you start the installation, stop any running
Windows applications.
Extracting
the LDAP for StreetTalk Software
You first extract the LDAP for StreetTalk
software from the self-extracting file LDAPforStreetTalk.exe:
1. Double-click LDAPforStreetTalk.exe,
or select Run from the Start menu, click Browse, navigate to
the directory where you downloaded LDAPforStreetTalk.exe, select
LDAPforStreetTalk.exe, click Open and then click OK.
The file is unpacked and the Choose Setup
Language screen appears.
2. Select the language version of the installation
program by selecting it from the dropdown box and click OK.
Caution: Do not install a language version of LDAP for
StreetTalk that differs from the language version that is already
present on your Windows NT server.
You can select English, French, German,
Japanese, and Spanish language versions of the installation program.
After the extraction process unpacks the
LDAPforStreetTalk.exe executable and you select the language
version, the LDAP for StreetTalk software installation starts
automatically.
3. Go to step 1
in "Installing the LDAP for StreetTalk Components."
Installing
the LDAP for StreetTalk Components
This installation loads the LDAP for StreetTalk
software components that you select on your StreetTalk for Windows
NT server. At the completion of the installation, you must create
the LDAP for StreetTalk service and set the LDAP directory suffix.
Note:
You can click Cancel at any time
(or press F3) and then select Exit Setup to exit the program,
or select Resume to continue. You can also select Back on most
screens to move back one screen at a time and make changes.
1. After you extract
the files, the Welcome screen appears. Read the Welcome screen
and, if you have no other Windows programs running, click Next
to continue.
Note: You can depress the ALT key and press the TAB key
to cycle through the programs that are running, and stop them.
2. The license agreement appears. Read
the license agreement and click Yes to accept the conditions.
If you click No, LDAP for StreetTalk Setup exits. If you click
Yes, the User Information screen appears.
3. Enter your name and the name of your
company. If this information is in the Windows NT Registry, it
appears in the screen. You can change it in the screen but it
will not change what is in the Registry.
Click Next to continue. The Setup Type
screen appears.
4. Click on the installation type you want.
The three types (which are explained more fully below and in
step 5) are:
|
Typical - All components except the text version
of the release notice. |
|
|
Compact - LDAP for StreetTalk Service, and
the StreetTalk and STDA service updates. |
|
|
Custom - You can select:
— LDAP for StreetTalk Service - Executable
and configuration files.
— StreetTalk and STDA Service Updates
- Updates for StreetTalk and StreetTalk Directory Assistance.
When you select the LDAP for StreetTalk Service, Setup automatically
selects the Service Updates.
Note: You install the StreetTalk
Name Collector and the LDAP Configuration
Manager in separate procedures.
— LDAP for StreetTalk Documentation
- Word files of the installation guide, administrator's guide,
and release notice, and a text version of the release notice.
— LDAP Command Line Utilities - Tools
for the LDAP administrator and for Banyan support personnel to
use to debug any problems you may encounter. |
Click Next to continue. If you select Typical
or Compact, go to step 6.
If you select Custom, the Select Components
screen appears. Go to step 5.
Click Next to continue. The LDAP for StreetTalk
screen that lets you select the folder for the LDAP for StreetTalk
service database appears.
Note: If you have a previous version of LDAP on this
server, Setup detects the previous version and defaults to the
folder for the previous version. Banyan recommends that you use
the default destination folder listed on the screen.
6. Click Browse
if you wish to change the default destination folder for the
LDAP for StreetTalk service, or accept the default if you will
not change the default destination. The default path is C:\Program
Files\Banyan\DATA\LDAP if you do not have a previous version
installed elsewhere. Click Next to continue. The LDAP for StreetTalk
Documentation screen appears.
7. Click Browse if you wish to change the
Destination Folder for the documentation. The default path is
C:\Program Files\Banyan Applications\LDAP for StreetTalk\Documentation.
Click Next to continue. The LDAP Command
Line Utilities screen appears.
9. Click Browse if you wish to change the
destination folder for the LDAP Command Line Utilities. The default
path is C:\Program Files\Banyan\Support\LDAP.
Click Next to install the utilities in
the destination folder and continue. The Select Program Folder
screen appears.
10. Accept the default folder, select a
folder from the Existing Folders list, or enter a new Program
Folder name to store the program icons in. Click Next to continue.
The Start Copying Files screen appears
and presents a summary of the selections you made. You can scroll
this screen to review your selections.
11. To change any of the settings listed
in the Current Settings window, click Back until you get to the
appropriate screen and go back to that step. If you are satisfied
with the current settings, click Next to start copying files
to their appropriate directories.
When file copying completes, the Setup
Complete screen appears displaying the components you installed
during this installation.
12. If the Yes and No radio buttons appear
on the screen, you must reboot. You can select No and reboot
manually later.
If you will now install the Name Collector
patch (see below), you may click No
and reboot after applying the patch.
The buttons appear if:
— This is an upgrade and the LDAP
for StreetTalk service is running or
— Any of the Microsoft runtime libraries
need updating
Note:
If the Yes and No radio buttons
appear, you must reboot before you use StreetTalk Explorer to
create the LDAP for StreetTalk service and to obtain all of the
functionality of LDAP for StreetTalk. See "Creating
and Configuring Services" below for instructions.
Installing
the Name Collector Patch
To use LDAP for StreetTalk 3.6, you must
install Patch ST_NT990008.EXE on the StreetTalk for Windows NT
8.6 server where your LDAP service resides. This patch contains
the getnames executable, the StreetTalk Name Collector,
that is compatible with LDAP for StreetTalk 3.6. The patch is
available with the LDAP for StreetTalk 3.6 software on the Banyan
web site.
Caution: Do not apply this patch to any server other than
the server that runs your LDAP for StreetTalk service.
Note:
Patch ST_NT990008.EXE is on the
Banyan web site.
To install the patch:
1. Double-click ST_NT990008.exe, or select
Run from the Start menu, click Browse, navigate to the directory
where you downloaded ST_NT990008.exe, select ST_NT990008.exe,
click Open and then click OK.
The Welcome screen appears. Read the screen.
Click Next to continue.
Note: If you this is an upgrade and LDAP or STDA is
running, click Cancel and exit the installation, use StreetTalk
Explorer to stop the LDAP and STDA services, and start the installation
again.
2. The Patch Readme appears. Read the file.
When you finish reading the file, you must close it to continue.
Note: The Patch Readme is a temporary file. If you wish
to save it, select Save as from the File menu and save the file
with an appropriate name to a directory of your choice.
3. The Ready to apply Patch screen appears.
To apply the patch, click Next. To go back to the Readme, click
Back and then click Next on the Welcome screen.
4. When the patch completes, the Setup
Complete screen appears.
If STDA is running, the Yes, I want to
start my computer now and the No, I will restart my computer
later radio buttons appear. If that is the case, you must reboot
to obtain the functionality of the new Name Collector. In addition,
if you also just installed LDAP for StreetTalk and put off rebooting
at that time, you must reboot now. Click Finish to complete the
installation.
Note: Any StreetTalk for Windows NT patches that you
apply subsequent to applying this patch may necessitate that
you reapply this patch. If that is the case, the StreetTalk for
Windows NT patch readme will warn you of this.
Installing the LDAP Configuration Manager
You can install the LDAP Configuration Manager
on Windows 95/98 or on Windows NT servers or workstations. Follow
this procedure to install the LDAP Configuration Manager.
Note: If you have the version 3.5 LDAP Configuration
Manager installed on your existing system, you do not need to
install version 3.6 unless you need the translated Japanese version.
You first extract the LDAP Configuration
Manager software from the self-extracting file LDAPConfigurationManager.exe:
1. Double-click LDAPConfigurationManager.exe,
or select Run from the Start menu, click Browse, navigate to
the directory where you downloaded LDAPConfigurationManager.exe,
select LDAPConfigurationManager.exe, click Open, and then click
OK.
The Choose Setup Language screen appears.
2. Select the language version of the installation
program by selecting it from the dropdown box and click OK.
Caution: Do not install a language version of LDAP for
StreetTalk that differs from the language version that is already
present on your Windows NT server.
You can select English, French, German,
Japanese, and Spanish language versions of the installation program.
After the extraction process unpacks the
LDAPConfigurationManager.exe executable, the LDAP for StreetTalk
software installation starts automatically.
3. The Welcome screen appears. Read the
Welcome screen and, if you have no other Windows programs running,
click Next to continue.
4. The Software License Agreement appears.
Read the license agreement and click Yes to accept the conditions.
The User Information screen appears.
5. Enter your name and the name of your
company. If this information is in the Windows NT Registry, it
appears in the screen. You can change it in the screen but it
will not change what is in the Registry.
Click Next to continue.
6. The LDAP Configuration Manager screen
appears. Click Browse if you wish to change the destination folder
for the LDAP Configuration Manager. Click Next to accept the
default destination folder or to continue.
If this is a new installation, the default
path is C:\Program Files\Banyan Applications\LDAP Configuration
Manager.
If you have an existing 3.0 or 3.5 LDAP
Configuration Manager in C:\Program Files\Banyan Applications\LDAP
for StreetTalk\Configuration Manager, you may wish to browse
to that folder and put the 3.6 version there to avoid having
more than one version. In addition, you may want to select the
existing LDAP for StreetTalk Program Folder in step 7 rather
than using the default.
Note: Because the version 3.x LDAP Configuration Manager
executable has a different filename than the version 1.0 LDAP
Configuration Manager, the old version remains on the disk after
this installation. You can put the new LDAP Configuration Manager
in the default folder, C:\Program Files\Banyan Applications\LDAP
Configuration Manager, and delete the old version and its associated
files from C:\Program Files\Banyan\bin if you will not have a
version 1.0 LDAP service. The version 1.0 Configuration Manager
files all have ldapconf as the filename with an appropriate extension.
Accept the default folder, select a folder
from the Existing Folders list, or enter a new Program Folder
name to store the program icons in. Click Next to continue.
8. The Start Copying Files screen appears
and presents a summary of the selections you made and the components
that you will install. You can scroll this screen to review your
selections.
To change any of the settings listed in
the Current Settings window, click Back until you get to the
appropriate screen and go back to that step. If you are satisfied
with the current settings, click Next to start copying files
to their appropriate directories.
9. When file copying completes, the Setup
Complete screen appears displaying the components you installed
during this installation. Click Finish to complete the installation.
Creating and Configuring Services
You use StreetTalk Explorer to:
To
Create an STDA Service
1. Select StreetTalk, New,
Service or click the New Service icon.
2. In the New Service dialog box, enter
the StreetTalk name of the service, for example, STDA@servername@Servers.
3. Tab to the New description text box
and enter a description of the service.
4. Click Next. The Select a Service dialog
box appears.
5. Click Server Based Service and click
Next. The Select a Server dialog box appears.
6. In the Select a server drop-down box,
select the server that will maintain the service and configuration
data, and click Next. The Select a Service Type dialog box appears.
7. In the Select a Service Type dialog
box, select StreetTalk Directory Assistance and click Next. The
Select a Drive dialog box appears.
8. In the Drives dialog box select the
disk drive to store the service data and click Next. The STDA
Configuration dialog box appears.
9. Select Satellite or Master service and
click Next. The Create and Start dialog box appears.
If you select Satellite, the Satellite
Downloads drop-down box appears. Select each server to download
from in the Servers list box, click Add, click the type of information
to download from the Modify Download Information dialog box and
click OK. When done, click Next.
10. In the Create and Start dialog box,
read the Status window. You can click Back to make any changes.
If the data is satisfactory, click the Start after creation checkbox
to have the service start immediately after creation. Click Next
to complete creating and starting the StreetTalk Directory Assistance
(STDA) service.
11. Click Done.
To Set Attribute 5:34
You must set attribute 5:34 to get the full
LDAP functionality.
1. Right-click the STDA service in StreetTalk
Explorer and select Attributes. The StreetTalk Attribute Editor
Open attribute window appears.
2. In the Vendor/Attribute pane, enter
the Vendor number (5) and Attribute number (34).
3. In the Open attribute as drop-down list,
select String attribute.
4. Click Open.
5. In the String attribute text window,
enter LdapConfig=On with no spaces in this string and
no carriage returns after the string.
6. Select Attribute, Save in the StreetTalk
Attribute Editor window.
7. Select Attribute, Exit.
To Set the List of Attributes that STDA Collects
1. Right-click the STDA service and select
Properties.
2. Select the Attribute Collection tab.
3. Click the Read from File button.
4. Click Collection, display, and indexing,
and click OK.
5. In the Open dialog box, navigate to
Program Files\Banyan\Data\STDA or to the folder where you installed
StreetTalk for Windows NT and select attrs.cfg. Select All Files
from the Files of type drop-down box to see the files in this
directory.
6. Click Open. Attributes and their characteristics
appear in the upper text box of the Attribute Collection property
sheet.
7. In the Class drop-down box, select All.
8. Click Apply or OK.
If you see a message about failure to notify
the service, that is because the service is not running. The
STDA service gets the new configuration information when you
start it.
See the LDAP
for StreetTalk Administrator's Guide for information about
the attrs.cfg file and attribute collection.
To Set STDA to Rebuild the Database
1. Right-click the STDA service and select
Properties.
2. Select the Rebuild/Schedule tab.
3. Under Rebuild options, select Rebuild
database and delete display.
4. Click Rebuild Now.
To
Create the LDAP for StreetTalk Service
1. Select StreetTalk, New, Service or click
the New Service icon.
2. In the New Service dialog box, enter
the StreetTalk name of the service, for example, LDAP@servername@Servers.
3. Tab to the New description dialog box
and enter a description of the service.
4. Click Next.
5. In the Select a Service dialog box,
select Server Based Service and click Next.
6. In the Select a Server dialog box, select
the server that will maintain the service and configuration data,
and click Next.
7. In the Select a Service Type dialog
box, select StreetTalk LDAP Service and click Next.
8. In the Select a Drive dialog box select
the disk drive to store the service data and click Next.
9. Leave the Configuration dialog box blank
and click Next.
10. In the Create and Start dialog box,
read the Status window. You can click Back to make any changes.
If the data is satisfactory, click the Start after creation checkbox
to have the LDAP for StreetTalk service start immediately after
creation. Click Next to complete creating and starting the LDAP
for StreetTalk service.
11. Click Done.
Note: You may have to refresh the StreetTalk Explorer
pane to see the service listed.
Using
LDAP Configuration Manager
You run LDAP Configuration Manager to set
the LDAP directory suffix, which defines the location of the STDA
service within the LDAP directory information tree. The suffix
string is a comma-separated list of three values beginning with
the lowest LDAP entry and ending with the highest. Refer to the
LDAP for StreetTalk
Administrator's Guide for details about LDAP names. See
the LDAP Configuration Manager Help system for help in configuration.
There are two types of configuration:
|
|
Local for setting the configuration of the
current server |
|
|
Network for setting the configuration of a
server on your network |
You must first set the configuration type
to Local Configuration and then set the Path to Configuration
Files to the local directory containing ldap.cnf:
1. Right-click the LDAP service in StreetTalk
Explorer and select Manage LDAP. The LDAP Configuration Manager
appears.
2. From the Open LDAP Configuration Files
dialog box, select the Local file radio button and click OK.
The Open dialog box appears.
3. Navigate to Program Files\Banyan\Data\LDAP\Config
(the default) or to the folder where StreetTalk for Windows NT
is installed.
4. Select LDAP Config Files in the Files
of type drop-down window.
5. Select the ldap.cnf file and click Open.
The configuration property sheets appear.
6. Click the Service Control tab.
7. In the Suffix text box, enter your suffix,
for example, l=Chicago,o=WCTUS,c=US, or any valid LDAP DN that
you choose to represent your directory subtree to the global
LDAP environment.
8. In the Default Database Access drop-down
window, select the appropriate type of access. Access is cumulative,
that is, Read/Write includes Read and Compare, Read includes
Compare.
Leave other settings at their default values
until you peruse the LDAP for StreetTalk Administrator's Guide.
9. Select Configure, Save As
and in the Save files to a local directory dialog box, click
OK.
10. In the Save As window, Navigate to
Program Files\Banyan\Data\LDAP\Config if not already there, click
Save and click Yes at the Save As message to update the existing
local configuration file.
Before you make any other configuration
changes, read the LDAP for StreetTalk Administrator's Guide.
Starting
and Stopping STDA and LDAP for StreetTalk Services
To start and stop the services, use StreetTalk
Explorer:
|
|
To start or stop STDA, select the STDA service
in the Browse window of StreetTalk Explorer. Then either select
StreetTalk, Properties, or right-click the STDA
service in the Browse window, select Properties, and click the
Start or Stop button on the Summary page. |
|
|
To start or stop the LDAP for StreetTalk service,
select the LDAP for StreetTalk service in the StreetTalk Explorer
Browse window. Then either select StreetTalk, Properties,
or right-click the LDAP service in the Browse window, select
Properties, and click the Start or Stop button on the Summary
page. |
|
|
To start or stop StreetTalk for Windows NT
services (StreetTalk, StreetTalk Server Service, StreetTalk Security,
StreetTalk File, StreetTalk Print, StreetTalk Intelligent Messaging),
see your StreetTalk
for Windows NT documentation. |
Uninstalling the LDAP for StreetTalk Service
Before uninstalling the LDAP for StreetTalk
Service, use StreetTalk Explorer to first stop the LDAP for StreetTalk
service (see "Starting and Stopping
STDA and LDAP for StreetTalk Services" above) and then
to delete it from StreetTalk (right-click the service and select
Delete).
Caution: If you
do not delete the LDAP service from StreetTalk before running
the LDAP uninstall program, Server service (SS@servername@Servers)
will crash when you reinstall the LDAP product and leave the
server in an inconsistent state.
You can uninstall both the LDAP for StreetTalk
Service and the LDAP Configuration Manager. On a Windows 95/98
or Windows NT workstation, use the same procedure to uninstall
the LDAP Configuration Manager.
Use Control Panel to uninstall LDAP for
StreetTalk:
1. Click Start, Settings, Control Panel.
2. Double-click Add/Remove Programs.
3. Select the component you want to uninstall,
LDAP for StreetTalk or LDAP Configuration Manager, and click
Add/Remove.
4. Follow the prompts to uninstall the
software. The server must be rebooted at the completion of the
removal process.
Note: If you see messages about removing shared files,
respond Yes to All to remove all LDAP shared files.
