Setting up Domino Web Access with Sametime

Setting up Domino Web Access with Sametime

Domino Web Access integrates Sametime® so that users can send and receive instant messages, and maintain a Sametime contacts list. Sametime functionality is available through the "Chat" and "Instant Messaging" features within Domino Web Access. Using the Chat feature, users can maintain an Instant Messaging list that they can check to see the online status of other users and to initiate chats. The Instant Messaging Awareness feature displays the names of people in mail messages, views and folders as "online aware." That is, online status icons are displayed near names to show whether users can use instant messaging to chat with people or include them in instant meetings.

For Mozilla, you must have Sametime 3.1 to run Chat and Instant Messaging (Sametime) integration. Previous versions of Sametime are not supported in Domino Web Access on Mozilla.

For complete information on installing Sametime, see the Sametime Installation Guide and the Sametime Administrator's Guide. To view or download the Sametime documentation, go to http://www.lotus.com/LDD/doc.

Part 1 - Set up Domino Web Access on a Domino server 1. (1)Set up Domino Web Access on a server by making the appropriate selections during

Server Setup.

2. Register users with the Domino Web Access (iNOTES6.NTF) mail template.

Part 2 - Create a Connection document on the Domino Web Access server 1. From the Domino Administrator, click the Configuration tab.

2. Select the Domino Web Access server's Domino Directory in the "Use Directory on" field.

3. Click Server, and then click Connections.

4. Click Add Connection.

5. Select Local Area Network in the "Connection type" field.

6. Enter the Sametime server's name in the "Destination server" field. For example: Sametime/Acme.

7. Enter the source domain of the Domino Web Access server and the destination domain of the Sametime server. The domain must be the same in both fields.

8. Click "Save & Close."

For more information on Connection documents, see the topic (2)Creating a LAN Connection.

Part 3 - Edit each user's Person document and specify the Sametime server in the "Sametime server" field 1. From the Domino Administrator, click the People & Groups tab.

2. Select the Domino Web Access Domino directory, then click People.

3. Double-click a name to open the user's Person document.

4. Click Edit.

5. Enter the name of the Sametime server in the "Sametime server" field. For example, Sametime/Sales/Acme/UK.


7. Repeat Steps 3 though 6 for each person.

Part 4 - Set up the Sametime serverFollow the instructions in the Sametime Installation Guide for installing Sametime in a Domino domain on a dedicated server. Make sure that the installation uses the same Domino domain in which the Domino Web Access server resides.

Part 5 - Create a Connection Document on the Sametime server

1. From the Domino Administrator, click the Configuration tab.

2. Select the Sametime server's Domino Directory in the "Use Directory on" field.

3. Click Server, and then click Connections.

4. Click Add Connection.

5. Select Local Area Network in the "Connection type" field.

6. Enter the Domino Web Access server's name in the "Destination server" field.

7. Enter the source domain of the Sametime server and the destination domain of the Domino Web Access server.


Part 6 - Create a one-time replica of the Tokens database on the Domino Web Access serverThe Sametime server implements a security policy to ensure Sametime clients that establish connections to the Sametime services are authenticated. This security policy involves the Secrets (stauths.nsf) database on the Sametime server.

1. Using a Notes client, choose File - Database - Open.

2. Enter the name of the Sametime server (for example, Sametime/Acme).

3. Enter the Secrets database filename: stauths.nsf

4. Click Open.

5. Choose File -Replication - New Replica.

6. Enter the name of the Domino Web Access server (for example, iNotes/Acme)

7. Ensure that the database is replicated to the data directory: ...\domino\data\stauths.nsf.

8. Click OK to create the replica.

Part 7 - Push replication changes from the Domino Web Access server to the Sametime server 1. From the Domino Administrator, click the Server tab.

2. Click the Server Console.

3. Enter a push command to replicate the Domino directory to the Sametime server.

For example: push Sametime/Acme names.nsf

4. Click Send.

5. Enter a push command to replicate the Secrets database to the Sametime server.

For example: push Sametime/Acme stauths.nsf

6. Click Send.

Part 8 - Copy the Sametime server related files between Sametime servers and Domino serversIn Domino 6.5 for a mixed environment using Forms5.nsf and Forms6.nsf, use the following steps for Forms5.nsf (not supported on Mozilla):

1. Copy the contents from the Sametime applets folder on the Domino Web Access server to the Sametime server. On the Domino Web Access server, the applets are located in the "SametimeApplet" directory:

<data directory>\domino\html\SametimeApplet

2. Create a folder on the Sametime server in which to copy the Domino Web Access Sametime applet files. At a DOS prompt on the Sametime server, create the following folder. The folder name is case-sensitive and must be named "SametimeApplet".

>mkdir <data directory>\domino\html\SametimeApplet

Use the following steps to set up Forms6.nsf:

3. Create a Sametime folder under your Domino server directory (if one does not exist):

<data directory>\domino\html\Sametime\stlinks\

4. Copy the contents of the Sametime server stlinks folder to the stlinks folder you just created.

5. (Mozilla only) If the stlinks.jar file in the stlinks directory is not a signed version, replace it with a signed stlinks.jar file from the Toolkit\stlinksignedapplet directory on the Sametime installation CD 2.

Part 9 - Verify that Sametime works with Domino Web Access 1. Make sure that replication is complete and the Person documents exist on the Sametime

server.

2. Following the instructions in the Sametime Installation Guide for logging into the Sametime server using the Sametime Connect Client. Sametime must be functioning properly before you can test whether it is working with Domino Web Access clients.

3. Launch Domino Web Access in a browser and click "Chat" to test the Sametime connection.

Note If the chat link does not appear in Domino Web Access, check the user's Person document in the Domino directory. Verify that the name of the Sametime server in the Sametime server field is correct.

For a list of configuration settings you can use to modify the default Sametime setup, see the topic (3)NOTES.INI settings for Domino Web Access with Sametime.

See also(4)Domino Web Access(5)Registering Domino Web Access users (6)Using Domino Off-Line Services (DOLS) and Domino Web Access

Glossary Feedback on Help or Product Usability?

--------------------------------------------------------------------------------

NOTES.INI settings for Domino Web Access with Sametime

NOTES.INI Setting Description

(1)iNotes_WA_Chat Turns off chat and live names for all users.

(2)iNotes_WA_LiveNames Turns off live names for all users.

(3)iNotes_WA_SametimeJavaConnect Turns on the Sametime Connect for browsers user interface instead of using the Domino Web Access chat user interface.

(4)iNotes_WA_SametimeServer=hostname Sets a Sametime hostname for all Domino Web Access users.

(5)iNotes_WA_SametimeToken Turns off secrets and tokens authentication.

(6)iNotes_WA_STLinksCodebase=URL Specifies a different first parameter to a STLinksURL API call.

(7)iNotes_WA_STLinksLocal Turns off lading \stlinks from the Domino application server. Loads the \stlinks directory from the Sametime server set up in the user's Person document.

See also(8)Setting up Domino Web Access on a server

--------------------------------------------------------------------------------

For information on creating a Sametime Connection document, see the book Lotus Sametime Administrator's Guide. You use a Sametime Connection document to enable a meeting started on one Sametime server to be active simultaneously on the connected Sametime server.

Instant Messaging and client installation and setup

Instant Messaging (IM) allows users to see their co-workers online and to send them instant messages. They can also start instant online meetings among three or more co-workers.

Instant Messaging is included in the Notes client installation, and is installed when you install the Notes client. During the Notes client configuration, the Lotus Notes Client Configuration dialog box displays the check box "Setup Instant Messaging" that allows you to specify whether to set up IM during Notes client setup. By default, the check box is selected to enable the setup of IM. You can deselect that check box to prevent IM from being set up for users.

Enabling Single Sign-On for Instant Messaging

As an administrator, you can include IM in single sign-on with Lotus Notes and push this feature down to users through dynamic configuration. To enable IM with single sign-on for users, use the NOTES.INI variable, IM_ENABLE_SSO=1. If this variable is set to 1, IM with single sign-on is enabled; if this variable is set to 0 (zero), IM with single sign-on is disabled and the user must enter their IBM Lotus Instant Messaging password. There is also a setting on the User Preferences dialog box that users can set to designate whether they want to use the single sign-on feature, allowing then to log on once and still connect to multiple applications and servers.

For more information on the NOTES.INI variable, see (1)IM_Enable_SSO.

Scriptable Setup and Instant Messaging

If you are using scriptable setup to configure newly installed clients, IM can be included in the scriptable setup. There are several variables that you use to define the IM settings for users.

For more information about using scriptable setup with IM, see the topic (2)Setting up Notes with a scriptable setup.

Name awareness in view columns and names fields

When Notes displays the online status for a name, it passes that name as displayed, to the Sametime server for lookup in the Sametime server's directory. Usually this is the Notes abbreviated format (for example, John Smith/Austin/Acme), although exceptions can be found in email because email names can be received from the Internet. In order for the name to be found in the directory that the Sametime server uses, the directory needs to support a lookup of a Notes abbreviated name. If the directory that the Sametime server uses is a Domino directory, this occurs by default. However, if the directory that the Sametime server uses is an LDAP directory, you may need to configure how the Sametime server performs a name lookup with the LDAP server. You may also need to ensure that the LDAP directory has a Notes abbreviated name attribute for each of its entries.

For information about using LDAP with a Sametime server, see the Lotus Sametime Administrator's Guide on the Lotus Developer Domain Web site. Reference the chapter "Using LDAP with the Sametime Server." In particular, you need to reference the "Configuring the LDAP Searching Setting" portion of the chapter.

Instant Messaging and policies

Use the desktop policy settings document or the setup policy settings document to specify an IBM Lotus Instant Messaging server for users. Enter the server name in the Sametime server field. When pushed down to the users, this setting populates the field "IBM Lotus IM server" in the users' Location documents. The user can, however, enter a different server name in that field on the Location document to override the setting from the policy document. The server specified in the "IBM Lotus IM server" field is the server that the user will access for Instant Messaging. If no server name is entered in this field, the user is unable to log on to IM. The user would then have to review the settings on the Instant Messaging tab of their Location document, and make the necessary corrections.

For more information on the desktop and setup policy documents see (3)Creating a desktop policy settings document and (4)Creating a setup policy settings document. For more information on using policies, see the topic (5)Organizational and explicit policies.

See also(6)Setting up client installation for users(7)Automating client installation


--------------------------------------------------------------------------------

(Syntax: iNotes_WA_SametimeServer=hostname

Description: Provides a way of setting a Sametime hostname (messaging.ibm.com for example) for all Domino Web Access users (useful for clustered configurations). If not specified, the Sametime server is looked up on an individual user basis, by looking within the current user's Directory entry for a "SametimeServer" field. This Domino server name is then looked up within the ($Servers) view to determine the Internet hostname of the Sametime server.

Applies to: All Domino Web Access clients

Default: none

UI equivalent: None

Creating Site Profile and Resource documents

A Site Profile document defines a particular site where a resource exists and associates that site with a Resource Reservations database and the Domino Directory. You must create at least one Site Profile document before you can create Resource documents.

When you create a Resource document, you define the resource name, type, and availability; and you specify who can reserve the resource. There are three types of resources:

• Room -- Typically a conference room that you want to allow users to reserve for meetings. When you set up this resource, you must enter the seating capacity of the room.

• Online Meeting Place -- Meeting held "online" via Sametime 3.0 running with Domino Release 6.

• Other -- Resources that are not rooms or online meetings, but that you want to make available for users to reserve

After you set up resources, users can search for the free time of a resource and schedule the resource for a meeting while searching for free time and inviting users to the meeting. For each Resource document you create, the Administration Process creates a corresponding Resource document in the Domino Directory. During a free-time query, the Free Time system searches the Free Time database to find the location of these resources and returns information on the availability of both the resource and the invitees.

When setting up rooms as resources, enter the room information in a consistent format, either by name or by number. Doing so will limit the number of errors caused when a room cannot be located in the database.

When a user reserves a conference room with type-ahead enabled, Lotus Domino 6 searches for the conference room by room number or by room name, but not by both. Lotus Domino 6 looks up rooms according to how they have been added to the Resource Reservations database -- either by name or by number. If a user enters a room name and the room resource is set up by room number, an error is generated and the room is not located. Setting up all room resources by room name or by room number helps eliminate this type of error.

When you create a Site Profile or Resource document, the new resource is not available for users to schedule until the Administration Process adds the resource to the Domino Directory and the addition replicates to all replicas that are on servers used for scheduling resources of the Domino Directory.

To create a Site Profile document

1. Make sure that you have Manager access and the [CreateResource] role in the ACL of the Resource Reservations database.

2. From the Domino Administrator, click the Files tab.

3. From the Servers pane, select the server from which you want to work.

4. Open the Resource Reservations database, and select any view except Calendar, My Reservations, and Reservations Waiting for Approval.

5. Click New Site.

6. Complete these fields:

Field Enter

Site name The name of the site where the resource exists -- for example, 50 West Lincoln Building.

Domain name The name of the domain where the Resource Reservations database resides. By default, your current Domino domain is entered in this field.

7. Click Save and Close.

To create a Resource document

1. Make sure that you have the [CreateResource] role in the ACL of the Resource Reservations database and that at least one Site Profile document has already been created.

2. From the Domino Administrator, click the Files tab.

3. From the Servers pane, select the server from which you want to work.

4. Open the Resource Reservations database.

5. Click New Resource.

6. Choose one of these Resource Types:

• Room -- if the resource is a room

• Other -- if the resource is not a room

• Online Meeting Place -- if you will be meeting via Sametime server.

7. Click the Resource Information tab, and complete these fields:

Field Enter

Name A unique name that identifies the resource -- for example, a room number.

Site Click to display a list of available sites, and then choose one.

Category

(Appears when you select Other as Resource Type)

Name for category of Resource -- for example, Electronic or AV. This field also displays names of all previously entered Category values, from which you can choose.

Capacity

(Appears when you select Room as Resource Type)

The capacity of the resource, for example, the seating capacity of a room.

Description A description of the resource -- for example, large conference room with a video monitor.

Internet address An Internet address that iCalendar users can use to reserve the resource.

The Internet Address field is not visible for Online Meeting Place.

8. Enter the following Owner Options for resources of type Room or Other. If you chose a resource type of Online Meeting Place, go to Step 9.

Field Enter

Owner restrictions Choose one:

• None -- Click if no owner is assigned to the resource and anyone can reserve the resource.

• Owner only -- Click to assign a Resource owner. Only the Resource owner can process Resource requests without special approval. Enter the name of the resource owner in the Owner’s name field. The owner is the person or group to whom requests from other users (those not listed in the List of names field) are forwarded for approval and processing.

• Specific people -- Click to allow only specified users access to the resource. Enter the names of users allowed to reserve this resource in the List of names field.

• Autoprocessing -- Click to allow only specified users and groups access to the resource and to assign a resource owner. Enter the name of the resource owner in the Owner’s name field. The owner is the person or group to whom requests from other users (those not listed in List of names field) are forwarded for approval and processing. Enter the names of users allowed to reserve this resource in the List of names field.

• Disable reservations -- Click to prevent users from reserving a resource from a meeting notice and directly from the Resource Reservations database.

Availability settings Choose one of these:

• 24 hours everyday -- The resource is available 24 hours each day. When you select this availability setting, other availability settings are disabled.

• Time zone -- Specify the time zone for the resource. The default is Local Time, but you can specify others as applicable, such as Eastern Time.

• Days of week and hours of days -- Select the days of the week that the resource is available. Specify availability start time and end time for each available day selected.

Other comments (Optional) Enter additional comments as necessary.

9. Enter the following Online Resource data for resources of type Online Meeting Place. If you chose a resource type of Room or Other, complete step 8 and then Step 10. Do not complete Step 9.

Field Enter

Online meeting database

The default Sametime Conference database, STCONF.NSF, is entered by default. If the Sametime server is a UNIX server, the Sametime setup may be customized and a name other than STCONF.NSF may be used for the Sametime Conference database. If the database name has been changed, enter the name of that database.

External address Name of the Sametime mail-in database on the Sametime server. This database, STCS.NSF, is created during Sametime installation. The default name is Sametime Reservations. It must be manually added to the Domino Directory as a mail-in database. The name that you specify for the mail-in database, is the name that is added to this External address field. For information on how to manually add a mail in database to the Domino Directory, see the topic "Creating a Mail-in Database document for a new database" in the Domino Administrator online documentation.

Sametime server The name of the Domino server on which Sametime is running. The mail server must have mail connectivity to the Sametime server to deliver the invitations that cause the meetings to be scheduled.

Audio Video Support Choose one:

• Audio -- Voice only• Audio and Video support -- Voice and video display

10. Click Save and Close.

See also(1)Editing and deleting Resource documents(2)Setting up the Resource Reservations database(3)Creating a Mail-In Database document for a new database

Syntax: iNotes_WA_STLinksLocal

Description: For Internet Explorer only, use this setting to turn off loading \stlinks from the Domino application server. If you set this value to 0, \stlinks is loaded from a Sametime server set up in the user's Person document instead. This is useful if different releases of Sametime server are running in an organization.

0= off

1= on


Default: 1

UI equivalent: None

Syntax: iNotes_WA_STLinksCodebase=URL

Description: Provides a way of specifying a different first parameter to the STLinksURL API call. Use this setting to set the path to https, to specify a port to the Sametime server, or to specify another reverse proxy path. For example:

http://proxy.iris.com/messaging/sametime/stlinks


Default: None

UI equivalent: None


Syntax: iNotes_WA_Chat=value

Description: Use this setting to turn off instant messaging and live names for all users. By default, instant messaging is enabled for anyone that Domino Web Access determines has a Sametime token or Lightweight Third Party Authentication (LTPA) token and a Sametime Server assigned.

0= off

1= on


Default: 1

UI equivalent: None

The scriptable setup option uses a setting in the NOTES.INI file to provide information to the client setup wizard. During installation, the wizard displays only those panels that users need to set up the Notes client. The NOTES.INI setting ConfigFile= points to a text (.TXT) file that contains the parameters that the wizard needs. The wizard reads the text file and completes the setup. The user is able to bypass the wizard screens for which parameters have been provided by the text file.

The settings and parameters that you can use in the text file are listed in this table:

Setting Description

Username User's hierarchical name -- for example, John Smith/Acme

KeyfileName Directory path to the user's ID file name --for example, c:\program files\lotus\notes\data\jsmith.id

Domino.Name Domino server in the same domain as the user name. You do not need to enter a hierarchical name.

Domino.Address An address for the Domino server, such as the IP address of the server, if needed, to connect to the server. For example, server.acme.com or 123.124.xxx.xxx

Domino.Port Port type, such as TCPIP

Domino.Server 1 to connect to the Domino server, 0 for no connection

AdditionalServices 1 forces display of the "Additional Services" panel even if sufficient information is provided for these services; the Additional Services panel lists Internet, proxy, and replication settings.

AdditionalServices.NetworkDial To configure a network dialup connection to Internet accounts created via Additional Services dialog box

Mail.Incoming.Name Incoming mail account name, a friendly name used to refer to these settings

Mail.Incoming.Server Incoming mail (POP or IMAP) server name

Mail.Incoming.Protocol 1 for POP; 2 for IMAP

Mail.Incoming.Username Mail account user name or login name

Mail.Incoming.Password Mail account password

Mail.Incoming.SSL 0 to disable; 1 to enable the SSL protocol for incoming Internet mail

Mail.Outgoing.Name Outgoing mail account name, a friendly name used to refer to these settings

Mail.Outgoing.Server Outgoing mail (SMTP) server name

Mail.Outgoing.Address User's Internet mail address, such as

[email protected]

Mail.InternetDomain Internet Mail domain name such as isp.com

Directory.Name Directory account name, a friendly name used to refer to these settings

Directory.Server Directory (LDAP) server name

News.Name News account name, a friendly name used to refer to these settings

News.Server News (NNTP) server name

NetworkDial.EntryName Name of remote network dialup phone book entry

NetworkDial.Phonenumber Dial-in number

NetworkDial.Username Remote network user name

NetworkDial.Password Remote network password

NetworkDial.Domain Remote network domain

DirectDial.Phonenumber Phone number of Domino server

DirectDial.Prefix Dialup prefix, if required. For example, 9 to access an outside line.

DirectDial.Port COM port to which the modem is connected

DirectDial.Modem File specification of modem file

Proxy.HTTP HTTP proxy server and port -- for example, proxy.isp.com:8080

Proxy.FTP FTP proxy server and port -- for example, proxy.isp.com:8080

Proxy.Gopher Gopher proxy server and port -- for example, proxy.isp.com:8080

Proxy.SSL SSL proxy server and port -- for example, proxy.isp.com:8080

Proxy.HTTPTunnel HTTP tunnel proxy server and port -- for example, proxy.isp.com:8080

Proxy.SOCKS Socks proxy server and port -- for example, proxy.isp.com:8080

Proxy.None No proxy for these hosts or domains

Proxy.UseHTTP Use the HTTP proxy server for FTP, Gopher, and SSL security proxies

Proxy.Username User name if logon is required

Proxy.Password User password

Replication.Threshold Transfer outgoing mail if this number of messages held in local mailbox

Replication.Schedule Enable replication schedule

IM.Server Sametime server name required unless you have set the NOTES.INI variable IM_NO_SETUP= 1. When this variable is set to 1, the IM Configuration dialog box does not display during new client setup or client upgrade, and all IM variables in a scriptable client setup are ignored. If the user wants to configure IM, they can leave the NOTES.INI variable out of their NOTES.INI file or set it to 0 (IM_NO_SETUP=0).

IM.Port Sametime server port (any positive number)

IM.ConnectWhen (Optional setting) Defines when to connect to Sametime:

• 0 -- At Notes login (default)• 2 -- Manually

IM.Protocol Use one of these:

• 0 -- Directly to Sametime server• 1 -- Directly to Sametime server using

HTTP protocol• 2 -- Directly to Sametime server using IE

HTTP settings• 3 -- Use a proxy

IM.ProxyType Required if IM.Protocol is set to 3. Use one of these:

• 0 -- SOCKS4 Proxy• 1 -- SOCKS5 Proxy• 2 -- HTTPS Proxy• 3 -- HTTP Proxy

IM.ProxyServer Required if IM.Protocol is set to 3. Name of Sametime proxy server

IM.ProxyPort Required if IM.Protocol is set to 3. Port of Sametime proxy server (any positive number)

IM.ServerNameResolve Only used if IM.ProxyType is 1 (SOCKS5) but it is not required. Use one of these values:

• 0 -- Disable IM.ServerNameResolve• 1 -- Enable IM.ServerNameResolve

IM.ProxyUsername Required if IM.Protocol is set to 3 and IM.ProxyType is not SOCKS4

Lotus Notes 6 automatically converts the Lotus Notes 4.6 workspace into bookmarks. You can still access the workspace if you want, but it is not necessary because the workspace pages convert to bookmark icons, which are located on the left side of the client screen.

Notes provides the following bookmark icons or folders initially:

Bookmark icon or folder Description

Welcome Displays your home page, where you can perform tasks and browse and search the Web.

Mail Displays your mail file.

Calendar Displays your calendar.

Address Book Displays your Personal Address Book.

To Do Displays your To Do list of tasks.

Replication Displays your Replicator page. This entry appears only if you have local replicas with replication enabled.

Sametime Connect Opens the Sametime Connect client.

Note This bookmark appears only if you installed Sametime Connect.

Domino Administrator Opens the Domino Administrator for administering Domino servers.

Note This bookmark appears only if you installed the Domino Administrator.

Domino Designer Opens the Domino Designer for designing Domino applications.

Note This bookmark appears only if you installed the Domino Designer.

Favorite Bookmarks folder Displays a bookmark list of the databases you used most recently.

Databases folder Displays bookmarks organized as they are on your workspace.

More Bookmarks folder Displays bookmarks for searching Notes databases and the Web.

History folder Displays databases that you opened in the last four days.

Internet Explorer Links folder

Contains bookmarks from your Microsoft Internet Explorer Favorites links

Navigator Links folder Contains bookmarks from your Netscape Navigator Bookmarks links

You can add a bookmark to any Bookmark folder by dragging it to that folder.

For more information on using bookmarks, see Lotus Notes 6 Help.

See also(1)Upgrading Notes clients

Documents

Setting up Domino Web Access with Sametime