IBM Lotus Web Conferencing Audio Adapter for Premiere Conferencing 6.5.1 Installation Guide


New in IBM(R) Lotus(R) Instant Messaging and Web Conferencing 6.5.1 is the ability to integrate Web-based teleconferences as a meeting type through the Meeting Room. This installation guide tells you how to install and configure the Web Conferencing Audio Adapter for Premiere Conferencing 6.5.1 so you can enable this capability for your Lotus Instant Messaging and Web Conferencing servers using the services of Premiere Conferencing. You should be familiar with the features and functions of IBM Lotus Web Conferencing, and with the conferencing features of Premiere Conferencing.

For more information on Premiere Conferencing or to get a free trial, see their Web site at https://ww1.premconf.com/ibmfreetrial

For information on how to use the Web-based teleconferencing features from Lotus Instant Messaging and Web Conferencing, see the online help for IBM Lotus Sametime(R) 6.5.1.

Note: For the rest of this document, the Lotus Instant Messaging and Web Conferencing Server is referred to as the Sametime server.

This document contains the following sections:

Before you install

Before installing the Audio Adapter, complete the following steps:

  1. Contract for conferencing support from Premiere Conferencing. You will need a client ID and password and the name of the Premiere host server in order to install the audio adapter.
  2. If you are running Sametime on an iSeries server, you must install the following software product: Cryptographic Access Provider 128-bit for iSeries, 5722AC3. Use the Display Software Resource (DSPSFWRSC) command to determine if the product is already installed. There is no charge for this product but you must order it.
  3. The Connect client Telephony extension which became available with Sametime 3.1 is not compatible with the Web Conferencing Audio Adapter. If you have enabled the Telephony extension, you must disable it by shuting down the Telephony server before you install and deploy the audio adapter. All client Telephony features will disappear. For more information about the Telephony extension, see: http://www.ibm.com/developerworks/lotus/library/article/st-telephony/
  4. If the Sametime server where you plan to enable the audio adapter is not already using the Secure Sockets Layer (SSL) protocol to encrypt Web browser connections, you can skip this step and proceed with the installation. SSL will be configured automatically when you install the audio adapter and a key store token called stkeys.pfx will be created that contains the necessary certificate.
  5. If your Sametime server is already using SSL, you must modify your current configuration. Open your existing key store token in the Sametime server data directory (default name is stkeys.pfx) and import the following publicly available certificate from Verisign:

    VeriSign Class 3 Public Primary CA
    
  6. The Audio Adapter support includes an updated version of the Sametime Meeting Center database template (stconf651.ntf). If you have customized this database, you should back up the database template before installing the Audio Adapter support and reapply your customizations after installation.
  7. The Audio Adapter support contains an updated version of the Meeting Room Client (MRC). Normally, new versions of the MRC are downloaded automatically when a user joins a meeting. However, if your company's users do not have administrator privileges for their computers, they will be unable to install the MRC themselves. For information about using the Sametime Installer for Secure Desktops (SISD) to update your Windows client workstations, see the securedesktop_readme.txt file in the SecureDesktop folder.

For more information about properly configuring SSL and working with key store tokens:

Installing the IBM Lotus Web Conferencing Audio Adapter for Windows

After downloading the self-extracting zip file to your workstation and extracting the contents, you will find the following:

  1. Stop the Sametime Server
  2. The autorun utility will run after the files have been extracted. To launch the installation program, click on the 'Install IBM Lotus Web Conferencing Audio Adapter' button.
  3. Note: If the autorun utility does not start up or if you want to install the Audio Adapter at a later time then you can launch the installation program from Audiobridge\setup.exe

  4. Follow the installation screens. When prompted, supply the Web conferencing server host name, the Client ID, and password that were provided to you by Premiere.
  5. Click Finish to complete the installation.
  6. (Optional) To specify a static URL that will be launched from the meeting create page -- for example to provide some customized help for those creating conferences -- edit the Premiere.properties file and add the key:
  7. HelpURL
    

    For example:

    HelpURL=http://servername/sametime/mynewhelppage.html
    

    Note: Place your customized help page in the /domino/html/sametime subdirectory of the Sametime server data directory.

  8. Restart the Sametime Server.
  9. The Audio Adapter support includes an updated version of the Sametime Meeting Center database template (stconf651.ntf). If necessary, you can reapply any database customizations to the template at this time. Normally, the design of the database is refreshed by the nightly Design server task. Alternatively, you can force an immediate database design refresh by running the following command from your Domino server console:
  10. load design
    
  11. If your users do not have administrator privileges for their Windows client computers, use the Sametime Installer for Secure Desktops (SISD) to update the Meeting Room Client on their workstations.

Installing the IBM Lotus Web Conferencing Audio Adapter for AIX and Solaris

  1. Download the tar file to your Unix server and extract the contents, using the following command:
  2. tar -xvf
    

    You will find the following:

  3. Stop the Sametime Server
  4. Launch the installation program from install file. Type ./install
  5. Follow the installation screens. When prompted, supply the Web conferencing server host name, the Client ID, and password that were provided to you by Premiere.
  6. Click Finish to complete the installation.
  7. (Optional) To specify a static URL that will be launched from the meeting create page -- for example to provide some customized help for those creating conferences -- edit the Premiere.properties file and add the key:
  8. HelpURL
    

    For example:

    HelpURL=http://servername/sametime/mynewhelppage.html
    

    Note: Place your customized help page in the /domino/html/sametime subdirectory of the Sametime server data directory.

  9. Restart the Sametime Server.
  10. The Audio Adapter support includes an updated version of the Sametime Meeting Center database template (stconf651.ntf). If necessary, you can reapply any database customizations to the template at this time. Normally, the design of the database is refreshed by the nightly Design server task. Alternatively, you can force an immediate database design refresh by running the following command from your Domino server console:
  11. load design
    
  12. If your users do not have administrator privileges for their computers, use the Sametime Installer for Secure Desktops (SISD) to update the Meeting Room Client on their Windows client workstations.

Note: If you have multiple Sametime servers installed, the Audio Adapter is installed on all of them. If you do not want to make the Audio Adapter available on all of the Sametime servers, follow the instructions later in this document for disabling it on selected servers.

Installing the Audio Adapter for iSeries

After downloading the self-extracting zip file to your workstation and extracting the contents, you will find the following:

The binary save file is built and installed as an iSeries PTF. Complete the following steps to install the PTF on your iSeries server and configure the Audio Adapter for Premiere Conferencing:

Note: You must have a user profile with command line capabilities, and a user class of *SECOFR.

Note: The Audio Adapter for Premiere Conferencing is offered in English only. The Audio Adapter support is not compatible with the installation of an Instant Messaging and Web Conferencing language pack on your iSeries server.

  1. Establish a 5250 emulation session with the iSeries server and sign on with the appropriate user profile.
  2. From any OS/400 command line, run the following command to create a temporary library and the necessary Save file on your iSeries server:
  3. CRTLIB MYLIB
    
    CRTSAVF MYLIB/ST67000 TEXT('IMWC Premiere Conferencing ST67000')
  4. From a command prompt on your workstation, enter the following commands and responses to transfer the PTF save file from your workstation to the iSeries server:
  5. cd xxxx [change to the directory on your workstation that contains ST67000]
    
    ftp: [your OS/400 system name or IP address]
    Name: [Enter your OS/400 user profile name and press ENTER]
    Password: [Enter your OS/400 password and press ENTER]
    ftp>bin
    Representation type is binary IMAGE.
    ftp>put ST67000 mylib/ST67000
    ftp>quit
  6. Stop all of the Sametime servers on your iSeries server.
  7. From any OS/400 command line, run the following commands to install the Audio Adapter support:
  8. LODPTF LICPGM(5733LST) DEV(*SAVF) SAVF(MYLIB/ST67000) 
    
    APYPTF LICPGM(5733LST) SELECT(ST67000)

    Note: If you have multiple Sametime servers on your iSeries server, the Audio Adapter is installed on all of them when you install the PTF. If you do not want to make the Audio Adapter available on all of the Sametime servers, follow the instructions later in this document to disable it on selected servers.

  9. Locate the Premiere.properties file in the Sametime server data directory and update it with the Premiere conference server host name (Host), client id (WebID), and password (WebPassword) that were provided to you by Premiere. For example:
  10. 	Host=myserver.myprovider.com 
    
    Port=443
    ServiceCount=10
    WebID=myidfromprovider
    WebPassword=mypassword
  11. (Optional) To specify a static URL that will be launched from the meeting create page -- for example to provide some customized help for those creating conferences -- edit the Premiere.properties file and add the key:
  12. HelpURL
    

    For example:

    HelpURL=http://servername/sametime/mynewhelppage.html
    

    Note: Place your customized help page in the /domino/html/sametime subdirectory of the Sametime server data directory.

  13. Restart the Sametime server.
  14. The Audio Adapter support includes an updated version of the Sametime Meeting Center database template (stconf651.ntf). If necessary, you can reapply any database customizations to the template at this time. Normally, the design of the database is refreshed by the nightly Design server task. Alternatively, you can force an immediate database design refresh by running the following command from your Domino server console:
  15. load design
    
  16. If your users do not have administrator privileges for their Windows client computers, use the Sametime Installer for Secure Desktops (SISD) to update the Meeting Room Client on their workstations.

Disabling the Audio Adapter for Windows

  1. Open the stconfig.nsf database and edit the MeetingServices document. Set the Audio Bridge Services field value to "false."
  2. Run the "regedit" command and change the following registry setting to "0":
  3. HKLM\SOFTWARE\Lotus\Sametime\MeetingServer\ServiceAudioBridgeServer\Enabled
    

Disabling the Audio Adapter for iSeries, AIX and Solaris

  1. Open the stconfig.nsf database and edit the MeetingServices document.
  2. Set the Audio Bridge Services field value to "false" and save the file.
  3. Edit the AudioBridgeServer portion of the meetingserver.ini file in the Sametime server data directory to set the value of the Enabled parameter to 0 (zero):
  4. [SOFTWARE\Lotus\Sametime\MeetingServer\Services\AudioBridgeServer] 
    
    Path=com.lotus.sametime.audiobridge.service.AudioBridgeService
    Type=2
    Enabled=0
    StartOrderDependencies=JavaServiceManager;Logger
    RestartDependencies=JavaServiceManager;EventServer
    ArgString=
    Description=Audio Bridge Service
  5. Save the file.
  6. Restart the Sametime server so that the changes to the meetingserver.ini file take effect.

Known Problems and Workarounds

The following are some known Limitations in this release as well as workarounds, if available.

Cannot schedule a teleconference when Phone is the only tool selected for desktop client. SPR HYYG5XVBC8

If a user configures their Sametime Connect for the desktop client so that “Phone” is the only meeting tool selected and starts an instant Teleconferencing meeting, the dialog box to accept the call information and connect to the teleconference does not display.

Workaround: Make sure at least one other tool other than Phone is selected before creating a teleconference meeting.

Cannot schedule a teleconference when Phone or Phone and Chat are the only tools selected for browser client. SPR BWZU5XVBPM

If a user configures their Sametime Connect for the desktop client so that “Phone” or “Phone” and “Chat” are the only meeting tools selected and starts an instant Teleconferencing meeting, the dialog box to accept meeting information is presented, but the teleconference meeting will fail with an error that the audiobridge adapter is not connected.

Workaround: Make sure at least one other tool other than “Phone” and “Chat” is selected before creating a teleconference meeting.

Note: when a fix for this is available, it will be delivered as a hot fix.

Client ID/Passcode won't be saved if user has no entry in vpuserinfo.nsf - SPR THSE5VPQYU

If the user has not logged on using a Sametime Connect client, the user will have no entry in the vpuserinfo.nsf file. Therefore, the ClientID/Passcode the user enters when scheduling a teleconference call will not be saved for use scheduling future calls. There is no alert notifying the user that the information will not be stored.

Workaround: Log on to Sametime using a Connect client before scheduling a teleconference meeting.

Mute All feature does not apply to users who dial in afterwards - SPR THSE5VLLSP

If a phone meeting moderator applies the Mute All function, all phone users are muted. However, users who dial in after the moderator applied the Mute All function will still be able to talk in the teleconference.

Audio bridge currently can only handle direct line dials

The Call Me feature, where a call is placed from the teleconference to an invited guest, requires a direct line. Audio bridge currently does not handle dialing numbers with extension.

Workaround: Users with extensions will have to dial into the conference.

Do not enable the Audio Bridge service before installing the Audio Bridge Adapter component - THSE5W5PPY

There is no alert to warn you, but the installation and enablement must follow the steps in the order outlined above.

Teleconference tool / activities can not be recorded

The record option does not work for a teleconference meeting.

Problems dismissing Dial Out dialog box

When using a 1.4.1 Java VM from Sun with either Internet Explorer or Mozilla, a user cannot use the "OK" button to close the error dialog box that appears when a "Dial Out" request has failed. The user must click the red "X" at the top of the dialog to close it. Upgrading to a more recent Java VM such as 1.4.2 fixes this problem.


Copyright and Trademark Information


Disclaimer

THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS DOCUMENTATION, IT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE. IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS DOCUMENTATION OR ANY OTHER DOCUMENTATION. NOTHING CONTAINED IN THIS DOCUMENTATION IS INTENDED TO, NOR SHALL HAVE THE EFFECT OF, CREATING ANY WARRANTIES OR REPRESENTATIONS FROM IBM (OR ITS SUPPLIERS OR LICENSORS), OR ALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENT GOVERNING THE USE OF IBM SOFTWARE.

Licensed Materials - Property of IBM

©Copyright IBM Corporation 1985, 2004 All rights reserved.

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GS ADP Schedule Contract with IBM Corp.

Lotus Software
IBM Software Group
One Rogers Street
Cambridge, MA 02142

List of Trademarks

IBM, the IBM logo, IBM, WebSphere, Domino, Lotus, Lotus Notes, Notes, and Sametime are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.