LotusLive_UnyteMeetingsPluginsFINAL

8/2/2019 LotusLive_UnyteMeetingsPluginsFINAL

1/30

IBM LotusLive and IBM Lotus Sametime

Unyte Meetings Plug-in

Vincenzo Caruso

Software DeveloperIBM Software Group

Dublin Software LabMulhuddart, Ireland

Kathleen MurraySoftware EngineerIBM Software GroupDublin Software LabMulhuddart, Ireland

May 2010

Copyright International Business Machines Corporation 2010. All rights reserved.

Summary: This white paper provides detailed information about the installation, configuration,

and usage of the IBM Lotus Sametime Unyte and IBM LotusLiveTM Meetings plug-insavailable to use with your IBM Lotus Notes and Lotus Sametime clients.

1


2/30

Contents

1 Introduction and overview ............................................................................................................ 32 Deploying the Meetings plug-in ...................................................................................................3

2.1 Customizing the base installer ............................................................................................... 42.2 Enterprise push-based installation .........................................................................................5

2.2.1 Expeditor Server management for Lotus Sametime .......................................................52.2.2 Using other distributed-deployment infrastructures .......................................................6

2.3 User-initiated manual installation .......................................................................................... 62.3.1 Add-on installer .............................................................................................................. 62.3.2 Drag to install ................................................................................................................. 72.3.3 Eclipse plug-in installation ............................................................................................. 72.3.4 Manual uninstall ........................................................................................................... 112.3.5 Upgrading an existing installation ................................................................................13............................................................................................................................................... 14

2.3.6 Refresh branding information without having to reinstall ............................................143 Plug-in branding .........................................................................................................................143.1 Meeting plug-in types ..........................................................................................................153.2 URL template mechanism ...................................................................................................163.3 GUI customization ...............................................................................................................17

4 Configuration settings .................................................................................................................195 Using the plug-in ........................................................................................................................20

5.1 Host ......................................................................................................................................205.1.1 Hosting using the Sametime Unyte plug-in ..................................................................205.1.2 Hosting using the LotusLive plug-in ............................................................................ 22

5.2 Invite ....................................................................................................................................23

5.2.1 Automatically open meeting room option .................................................................... 255.3 Join .......................................................................................................................................256 Troubleshooting and FAQ's ........................................................................................................267 Conclusion ..................................................................................................................................298 Resources ....................................................................................................................................29About the authors ...........................................................................................................................30

2


3/30

1 Introduction and overviewIn the past, holding a meeting with a person meant physically going to a location and speaking with him or

her. From a business perspective, this approach was both expensive and time consuming.

Online collaboration tools have greatly alleviated these issues, with IBM introducing Lotus SametimeUnyte and following on with the introduction of LotusLive incorporating LotusLive Meetings.

Lotus Sametime Unyte is a service that offers integrated Web and audio conferencing and provides the

capabilities to successfully manage an online business meeting, by adding advanced Web conferencing

features such as recording and application sharing.

Lotus Sametime Unyte users have the opportunity to host a Web meeting any time, any place, without a

reservation. Lotus Sametime Unyte functionality has now been introduced into the IBM LotusLive software

brand, known as LotusLive Meetings.

LotusLive is a portfolio of online services, hosted by IBM, that delivers scalable, security-rich email, Web

conferencing and collaboration solutions. For further information, refer to the developerWorks Lotusarticle, Introducing IBM LotusLive.

LotusLive Meetings, formerly known as IBM Lotus Sametime Unyte Meeting, generates a unique meeting

ID for every user when the LotusLive account is created. This ID can be used by customers, business

partners, and others, to join the meeting. Refer to the developerWorks Lotus article, Introducing IBM

LotusLive Meetings,for more information about LotusLive Meetings.

A plug-in was developed for the Lotus Expeditor platform, the base platform on which Lotus Notes and

Lotus Sametime clients are built, to allow users to host, invite, and join a meeting easily.

The goal of this white paper is to provide the information you need to install and use the meeting plug-in

on supported clients. We begin with a discussion of how to deploy the plug-in, detailing the different

approaches available to install this add-on, and examine the brand settings associated with this add-on.

We describe how to use the plug-in, from hosting and inviting a user to joining a meeting as a participant

from the plug-in UI. We conclude with a troubleshooting section to help with problems you may encounter

or questions you may have.

2 Deploying the Meetings plug-inThe LotusLive Meetings plug-In and the Sametime Unyte Meetings plug-in both come in the form of an

add-on for Lotus Expeditor, the base platform on which Lotus Sametime Connect and Lotus Notes 8 are

built.

The Lotus Expeditor platform offers several approaches for installing an add-on. These approaches are

mainly differentiated by the initiator of the deployment process, for example, the client user or the IT

administrator, and by the level of automatic deployment infrastructure available.

3
http://www.ibm.com/developerworks/lotus/library/lotuslive-intro/http://www.ibm.com/developerworks/lotus/library/lotuslive-meetingshttp://www.ibm.com/developerworks/lotus/library/lotuslive-meetingshttp://www.ibm.com/developerworks/lotus/library/lotuslive-meetingshttp://www.ibm.com/developerworks/lotus/library/lotuslive-intro/http://www.ibm.com/developerworks/lotus/library/lotuslive-meetingshttp://www.ibm.com/developerworks/lotus/library/lotuslive-meetings


4/30

Based on these criteria, we outline three categories of deployment:

1. Inclusion of the plug-in in the base installer

2. Centralized push-based enterprise deployment

3. User-initiated manual installation

The choice of installation approach must be made according to the environment in which the plug-in is to

be deployed. The variables that determine the installation environment are the number of deployment

targets and the availability of an enterprise distributed-deployment infrastructure, depicted in the flow chart

in figure 1.

Figure 1. Flow chart for installation choice

In the following sub-sections, we discuss each category of deployment in more detail and include pointers

to the relevant documentation for the deployment process.

2.1 Customizing the base installerThis method is available only to enterprise customers who are able to generate and customize the Lotus

Notes or Lotus Sametime base installer.

It is quite useful to make the LotusLive Meetings plug-in and Unyte Meetings plug-in part of the enterprise

base installation of Lotus Notes or Lotus Sametime. It can be used in conjunction with the enterprise

push-based techniques that push updates to the clients.

4


5/30

The following documentation addresses the customization of the Expeditor installation kit:

Lotus Notes

Lotus Sametime Connect

Base Expeditor 6.2

For additional information, refer to the Lotus Expeditor information center topic, Configuring deployment

settings.

2.2 Enterprise push-based installationThe deployment strategies discussed in this sub-section are most appropriate for large deployment

targets. Typically, large organizations that are using Lotus Notes or Lotus Sametime Connect will choose

one of the options described in this section.

2.2.1 Expeditor Server management for Lotus SametimeThe Lotus Expeditor Server is a central component of the Expeditor infrastructure and can manage all the

Expeditor Clients that are registered under it. As part of the available management features, there is aserver-side, push-based installation of add-ons.

The Expeditor Server supports the management of Lotus Sametime, whereas IBM Lotus Domino

provides the management of the Lotus Notes client and its embedded functionalities, for example,

Sametime and Lotus SymphonyTM.

In brief, the client management functions provided are:

Client enrolment registration of the client into the central database

Client configuration setting client parameters

Software distribution distributing, installing, and uninstalling software or data files to the client

Client inventory collection of software information about the client

In addition, the Expeditor server can:

Run a command on the client and retrieve the output

Control when a user is prompted to restart the client

Upload files from the client

Invoke IBM Support Assistant on the client to gather serviceability data

The Expeditor server is also able to classify the target of the installation, using the client information (client

version, operating system, system architecture, etc.).

The main drawback of the Expeditor server is there is no integration with Lotus Domino, so it is not able to

deploy add-ons to the Notes clients.

For more information on client management using the Expeditor Server, refer to the following

documentation:

5
http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_PROCESS_OVERVIEW_3511_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/sametime/v8r0/topic/com.ibm.help.sametime.imlu.doc/st_inst_optionalfeatures_t.htmlhttp://publib.boulder.ibm.com/infocenter/sametime/v8r0/topic/com.ibm.help.sametime.imlu.doc/st_inst_optionalfeatures_t.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/topic/com.ibm.rcp.tools.doc.admin/optionalfeatures.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/topic/com.ibm.rcp.tools.doc.admin/configuringprovisioning.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/topic/com.ibm.rcp.tools.doc.admin/configuringprovisioning.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_PROCESS_OVERVIEW_3511_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/sametime/v8r0/topic/com.ibm.help.sametime.imlu.doc/st_inst_optionalfeatures_t.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/topic/com.ibm.rcp.tools.doc.admin/optionalfeatures.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/topic/com.ibm.rcp.tools.doc.admin/configuringprovisioning.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/topic/com.ibm.rcp.tools.doc.admin/configuringprovisioning.html


6/30

IBM Lotus Expeditor 6.2 information center:

See Assembling and Deploying Lotus Expeditor Applications > Managing the client

runtime > Managing using a Client Management server

Lotus Expeditor wiki

2.2.2 Using other distributed-deployment infrastructuresAlternatively, you can do an enterprise push-based deployment of the feature without having the Expeditor

Server in place, by using other third-party Commercial off-the-Shelf (COTS) distributed-deployment

solutions. An example of this kind of technology is Microsoft Management Services (MMS) for

Windows.

Generally these deployment platforms are able to launch batch scripts on the various clients. In this

context they can then leverage the Expeditor client command-line feature installation capability. For more

information on this topic, refer to the Notes and Domino information center topic, Creating and using a

third-party installer.

For information on how to invoke the Expeditor provisioning from the command line, refer to theExpeditor information center topic, Using the Provisioning application.

2.3 User-initiated manual installationThe installation methods presented in this sub-section are intended to be triggered directly by the user of

the Notes or Sametime Connect clients. This kind of installation is suitable only for individual installations

or for deployments in small organizations because it requires user actions to be executed, and thus it

requires the distribution of the appropriate instructions to perform these steps.

However, even though the installation techniques described below may not be allowed in all scenarios,

they represent a quick and easy way to install and try out the feature.

2.3.1 Add-on installerAs mentioned in sub-section 2.2.2 above, the Expeditor client can be invoked from the command line for

the provisioning of new features. This technique can be exploited by a third-party installer, for example,

InstallShield or InstallAnywhere, to trigger the installation.

The LotusLive Meetings plug-in comes with a pre-packaged InstallShield-based Add-On Installer for Lotus

Notes, available at the following URL:

https://www.conferenceservers.com/brands///Plug-inInstaller.zip

Replace the and parameters with the appropriate values for your account.

If you need to build a more customized add-on installer, refer to the information center topic, Creating

and using a third-party installer.

6
http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://www.lotus.com/ldd/lewiki.nsfhttp://www.lotus.com/ldd/lewiki.nsfhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp?topic=/com.ibm.rcp.tools.doc.admin/provisioningappusingProvisioninginterfaces_usingProapp.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://www.lotus.com/ldd/lewiki.nsfhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp?topic=/com.ibm.rcp.tools.doc.admin/provisioningappusingProvisioninginterfaces_usingProapp.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin.doc/DOC/H_CREATING_A_TRADITIONAL_THIRD_PARTY_INSTALLER_5139_OVER.html


7/30

If you want to base your custom installer on an already available InstallShield template for the Expeditor

platform, refer to the Domino 8.5 information center topic, Creating a customised add-on installer.

2.3.2 Drag to installThis installation method is available only on Lotus Notes versions 8.0.1and later, and is supported only

when using the LotusLive Meetings service plug-in.

Before installing the plug-in, you must enable Lotus Notes for the widget drag-and-drop installation, as

follows:

1. From Notes, select File > Preferences > Widgets.

2. Select the check box next to "Show Widget Toolbar and the My Widgets Sidebar panel", as

shown in figure 2.

3. Click OK.

Figure 2. Enable Widget Toolbar

Then, once the drag-to-install feature is enabled, you just need to drag the widget download icon from the

Web page you are accessing into your Lotus Notes widget sidebar. To download the widget icon, refer to

LotusLive Engage wiki article, The LotusLive Meeting Plug-in for Sametime and Lotus Notes.

2.3.3 Eclipse plug-in installationThe installation procedures presented in this sub-section may not be supported in all the deployment

environments. Most Lotus Notes and Lotus Sametime enterprise customers will have this option disabled;

however, for those users who can manually install plug-ins on their clients, this is a quick and easy way to

start using the Meetings plug-ins.

The Meetings plug-ins can be installed on Sametime Connect Clients 7.5.1 and later, and on Notes Client

8.0 or later, if the Notes installation has the manual plug-in install capability enabled.

7
http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_CREATING_A_GENERIC_OR_ADD_ON_INSTALLER_OVER.htmlhttp://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_CREATING_A_GENERIC_OR_ADD_ON_INSTALLER_OVER.htmlhttp://www-10.lotus.com/ldd/bhwiki.nsf/dx/The_LotusLive_Meeting_Plug-in_for_Sametime_and_Lotus_Notes.http://www-10.lotus.com/ldd/bhwiki.nsf/dx/The_LotusLive_Meeting_Plug-in_for_Sametime_and_Lotus_Notes.http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_CREATING_A_GENERIC_OR_ADD_ON_INSTALLER_OVER.htmlhttp://www-10.lotus.com/ldd/bhwiki.nsf/dx/The_LotusLive_Meeting_Plug-in_for_Sametime_and_Lotus_Notes.


8/30

Let's now discuss how to install and to un-install the plug-in through the update site functionality.

To install the meetings plug-in in this way, follow these steps:

1. Open the installation window:

In Lotus Notes, select File > Application > Install.

NOTE: For Notes users who do not have the File > Application > Installcapability, refer to sub-

section 2.3.2, Drag to install, or to Section 6, Troubleshooting, for information on how to enable

this feature.

On the Sametime Client, select Tools > Plug-ins > Install Plug-ins.

2. Select the option Search for new features to install, as shown in figure 3; click Next.

Figure 3. Search for new features to install

3. In the next window, click the Add Remote Location button. A new window opens (see f igure 4),

prompting you for the name and URL of an update site.

8


9/30

Figure 4. Enter Update Site information

Enter the update site from which to install the plug-in; some sample URLs you can use are listed

below, depending on the plug-in type being used.

NOTE: The URL for the update site is taken from the default brand brand files page. Within the

brand files page, you can copy the URL from site.xml file.

For Unyte Meetings plug-in:

http:///brands///site.xml

For LotusLive Meetings plug-in:

http:// /brands///site.xml

4. Click OK and then select the name of the update site you just added; click Finish.

5. A new window displays with the features to install, as shown in figure 5. Select the plug-in versionto install and click Next.

9


10/30

Figure 5. Select plug-in to install

6. The licence agreement displays. Select I accept the terms in the license agreements and click

Next.

7. A summary of the install features is shown in the next window (see figure 6). Click Finish.

10


11/30

Figure 6. Install confirmation

After the installation, you will be prompted to restart your client. Do this before proceeding to use the tool.

You should now have a fully functional Meetings plug-in.

2.3.4 Manual uninstallFollow the steps below to uninstall the Meetings plug-in:

1. Open the Application Management window:

For Notes users, select File > Application > Application Management (see figure 7).

11


12/30

Figure 7. Notes Client path to un-install

For Sametime users, select Tools > Plug-ins > Manage Plug-ins, as shown in figure 8.

Figure 8. Sametime Client path to uninstall

12


13/30

NOTE: For some early versions of the Lotus Sametime Client 7.5.1, the Preference window may

open instead of the Product Configuration. To get to the Product Configuration, click "Advanced

Options" in the Preferences window.

2. In the next window that opens (see figure 9), select the meetings plug-in from the left-hand pane

and do either of the following actions:

Right-click and select Uninstall, or

Click the Uninstall link in the right-hand panel

Figure 9. Plug-in uninstall

3. Click OK to confirm the uninstall and then restart your client. The plug-in should now be

uninstalled.

2.3.5 Upgrading an existing installationThe Eclipse embedded plug-in management has an internal update mechanism that can be used to install

updates without your having to manually uninstall and then reinstall the plug-in.

To find updates for the Notes Client, select File > Application > Install, and select the option, Search for

updates of the currently installed features (see figure 10).

13


14/30

Figure 10. Feature Updates

To find updates for the Sametime Connect Client, select File > Tools > Plug-ins > Install Plug-ins, and

again, select Search for updates of the currently installed features (see figure 10 above).

2.3.6 Refresh branding information without having to reinstallThe brand information related to the plug-in offers a way to customize its look and feel. More information

about these brand settings are included in Section 3, Plug-in branding. The plug-in includes an option to

refresh these brand settings without having to reinstall.

To perform the refresh, follow these steps:

1. Go to the plug-ins Preference page and click the Set Meeting Preferences link.

2. Click the Configuration Settings link and then click the Refresh Now button, to perform the

refresh.

3. Apply the changes by clicking OK orApply.

4. Restart the client to see the changes.

You can also choose to perform the refresh every time the client restarts by selecting the "Refresh the

display every time the client restarts" box. Note, however, that this can slow down your client startup.

3 Plug-in brandingThe LotusLive Meetings and Sametime Unyte services offer a managed way to customize their look andfeel. Service Administrators are provided with credentials to a Web Admin application that's used to

manage all the settings for customizing the meeting service, according to the style and needs of their

organization.

14


15/30

You can also customize LotusLive and Sametime Unyte Meeting plug-ins by using the Web Admin

service. The remainder of this section is intended for Service Administrators who have access to the Web

Admin and wish to customize this aspect of the plug-in.

3.1 Meeting plug-in typesFor the plug-in to work correctly, it is necessary to know the type of service to work with. The associationbetween the plug-in and the type of service is set as part of the brand information.

Before installing the plug-in, you must ensure your brand files is set to use the correct type of plug-in. Note

that only one plug-in type can be associated with a brand.

The two types available are:

Unyte Meetings. Used by Sametime Unyte customers and resellers who directly use the

conferenceservers.com services

LotusLive. Used by LotusLive users

The type not only differentiates the look and feel of the plug-in but also the host and invite logic.

NOTE: Different plug-in types can be installed simultaneously on the client but not multiple instances of

the same type.

To set the plug-in type, go into the brand information page in the Web Admin client and edit the details

under the Sametime plug-in section, as shown in figure 11.

If the plug-in type needs to be updated, select the type and then click Update Brand. This action will

repackage the plug-in with the updated brand information.

Figure 11. Sametime plug-in brand details

15


16/30

3.2 URL template mechanism

The URL template mechanism simplifies the process of adapting the plug-in to other meeting URLs, such

as LotusLive. This feature is particularly useful to those enterprise customers who have their own

customized meeting URL. As shown above in Figure 11, the two URLs that can be customized are:

Host template URL. Used by the host to start a meeting Join template URL. Sent to the participant, via Instant Messaging (IM), to join the meeting

Both URLs can use a set of variables that are provided by the plug-in at runtime. The variables must be

surrounded by in order to be interpreted correctly. Table 1 contains the full list of variables

available.

Table 1. URL variables

Variable Description The conference server hostname, as

specified in the plug-ins preference page.

The Conference ID (or sometimes referred

to as passcode). The meeting password (or sometimes

referred to as SubscriberID).

The service provider code

The secondary service provider code

The brand code

Used only for the Sametime Unyte service.

The hosts name, as defined in the plug-ins

preference page.


The hosts email, as defined in the plug-ins

preference page.


The hosts phone number, as defined in the

plug-ins preference page.


The hosts company, as defined in the plug-

ins preference page.

The participants name, as defined in

Sametime directory service.

The participants email, as defined in


The participants phone number, as defined

in Sametime directory service. The participants company, as defined in


The option of starting a meeting right after

logging in.

16


17/30

NOTE: The special syntax adopted for the AUTOSTART Boolean value allows you to specify custom

values for the AUTOSTART Boolean option, which may vary according to the entry point interface.

The template mechanism lets you specify custom values that map to the true and false values of

AUTOSTART.

The default templates and corresponding plug-in type of service are as follows:

Sametime Unyte:

Host template: https:///webagent/webagent.asp?

UserName=&Password=&mode=online&cust=&

SecSvcProv=&brand=&fname=&email=&comp=&pnum=

Join template: https:///meetme/meetme.asp?

code=&cust=&SecSvcProv=&brand=&fname=&email=&comp=&pnum=

LotusLive Meetings:

Host template: https://apps.lotuslive.com/meetings/host

Join template: https://apps.lotuslive.com/meetings/join?

id=&fname=

3.3 GUI customizationPlug-in Icon.This field contains the URL of an image that's used as a shelf icon for the plug-in. The

name and the extension of the file are irrelevant. If not specified, a default icon will be used.

Plug-in Style. This is a .zip file that contains a CSS file called style.css and any resource referenced.

The style specified in the CSS file, a sample of which is shown in listing 1, will be applied to the plug-in UI

when it is installed; for example, a new logo can be applied as well as new fonts and color background.

17


18/30

Listing 1. Sample style.css code

JOIN Join Meeting

HOST Host Meeting IDXXXXXXX

Click here to set your meeting

preferences


19/30

If a brand-new style needs to be developed from scratch, the designer must respect the classes and divs

listed above; also, the resulting CSS file must be named style.css.

4 Configuration settings

Once the plug-in is installed, you are able to view the configuration settings (see figure 12). To view thesesettings, click the Set Meeting Preferences link and, in the resulting dialog box, select the Configuration

Settings link.

NOTE: No changes should be made by the user unless instructed by the administrator.

Figure 12. Configuration Settings window

All the configuration settings fields are described in table 2.

Table 2. Configuration Settings fields

Setting Description

Brand name The name of the brand to be used by the plug-in

Service provider code This should contain the name of your service provider

Secondary service provider

code (customer)

This should contain the name of your secondary service

provider/customer

Meetings server URL The URL to your meetings server

19


20/30

Host URL template The URL template to host meetings (refer to Section 3.2, URL

template mechanism, for more details)

Join URL template The URL template to join meetings (refer to Section 3.2, URL

template mechanism, for more details)

URL for creating newaccounts

The URL used to create new accounts

Refresh the display every time

the client starts

Enable this to download the brand information from meetings

service every time the client starts

Refresh now Click to download the brand information now

If you change a setting, click Apply to save the changes, then click OK. If you want to restore your default

settings, click the Restore Defaults button and any changes made will be lost.

NOTE: There are no setting differences between the Sametime Unyte meetings plug-in and the LotusLivemeetings plug-in.

5 Using the plug-inThe Meetings plug-in is used to host meetings directly from the plug-in, or a host can invite a Sametime

contact to a meeting simply by selecting the contact name. A participant can also use this plug-in to join a

meeting by entering the meeting ID only. This section describes the three uses of the plug-in.

5.1 Host

After installing the plug-in, you can now host meetings directly from the plug-in. Depending on the type ofplug-in installedeither Sametime Unyte or LotusLive Meetingsthere are a few differences in how this is

handled.

5.1.1 Hosting using the Sametime Unyte plug-inFor the Sametime Unyte Meetings plug-in, you must define details in the Preferences window prior to

hosting your first meeting (see figure 13). Select the Set Meeting Preferences link to add these details.

20


21/30

Figure 13. Sametime Unyte plug-in Preferences window

The following details can be entered when using the Sametime Unyte plug-in:

PIN#. This name depends on what the service administrator applies to the field: Term for

Guest Access Code value set in brand file (see Section 3, Plug-in branding, for more

information).

ID. This name depends on what the service administrator applies to the field: Term for

Subscriber ID value is set in the brand file. See Section 3 Plug-in Branding for more

information.

Your name. Automatically fills in from Sametime details.

Your email. Automatically fills in from Sametime details.

Your company. Optional

Your phone number. Optional

It is not possible to host a meeting or send invitations if the PIN and ID fields are left blank. Once these

details are entered, the host functionality becomes enabled.

To host a meeting, click the Host Meeting button (see figure 14).

Figure 14. Host Meeting button

21


22/30

By clicking this button, you launch the system's default browser, and the meeting is started automatically.

All the user details are already pre-populated by use of the values specified in the Preferences page.

5.1.2 Hosting using the LotusLive plug-inFor the LotusLive Meetings plug-in, you must first define the Meeting ID in the Preferences window before

hosting your first meeting (see figure 15). To define this ID, select the Set Meeting Preferences link.

Figure 15. LotusLive Meetings ID window

Once the meeting ID is entered, the host functionality is enabled. Remember to include the hyphen within

the meeting ID.

To host a meeting, once again, click the Host Meeting button (recall figure 14 above). By clicking thebutton, you launch the system's default browser, and the LotusLive log-in window displays, as shown in

figure 16. The user needs to have a registered LotusLive account in order to log in and host a meeting.

Figure 16. LotusLive log-in window

22


23/30

NOTE: The meeting ID within the Preferences page is not used when a meeting is being hosted with the

LotusLive meetings plug-in; instead, the LotusLive log-in credentials are used to authenticate and host.

The meeting ID is used when the host sends invites to Sametime contacts to join their meeting.

5.2 InviteThe Meetings plug-in allows the host to invite people to their meeting by simply selecting one or more

contacts from their Sametime Contacts list. The invitation is sent as an IM and contains the URL already

prepared to join the meeting.

Since the plug-in is sending a plain hyperlink, there is no need to have the plug-in installed on the invitee

side. The meeting ID set in the Preferences page is used when sending these invitations.

To send an invite, simply select a single contact or multiple contacts, right-click, and select Invite to a

Meeting, as shown in figure 17.

Figure 17. Invite multiple contacts

If you have a defined group in your list, you can invite the group by right-clicking on the group name and

selecting Invite to a Meeting (see figure 18).

23


24/30

Figure 18. Invite a group

A chat message is sent to all the selected contacts, as shown in figure 19. The message contains short

descriptive text and two links:

Join Now. Joins the Web meeting.

Test Your Browser. Tests the browser capabilities, a system check will run and results are

displayed in your default browser

Figure 19. Invitation message

When the invitee clicks the Join Now link, the machine's default browser launches, and the meeting will

load. The user joins without having to enter their details because the Join Now link is pre-populated with

the invitee's details retrieved from the directory services.

The host receives an announcement to the effect that the invitation was successfully sent (see figure 20).

24


25/30

Figure 20. Invitation successfully sent

5.2.1 Automatically open meeting room option

The host also has the option of automatically opening the meeting when they send an invitation to their

Sametime contacts. This option is set in the Preferences page, as shown in figure 21.

Figure 21. Automatically open meeting room option

Note that, if the host is using the Sametime Unyte plug-in, the meeting is automatically opened in their

default browser. If using the LotusLive plug-in, the LotusLive log-in screen opens, prompting the host to

enter their LotusLive log-in credentials before reaching the meeting window.

5.3 Join

The Meeting plug-in also allows you to join a meeting if you have the meeting ID. To do this, simply enter

the meeting ID in the Join field and then click the Join Meeting button (see figure 22).

Figure 22. Join Meeting button

25


26/30

The default system's browser launches, and you are brought into the meeting. For Sametime Unyte, all

your user details are pre-populated with the values specified in the Preferences page.

For LotusLive, if the user already has a LotusLive session open, the directory values stored in the

LotusLive account will override those specified in the plug-in's Preference page.

If the meeting has not yet started, the user will be placed in the waiting room.

6 Troubleshooting and FAQ's

1. What versions of Lotus Notes and Lotus Sametime Clients are supported?

The Meeting plug-ins are supported on the following client versions:

Lotus Notes Clients: 8.0, 8.01, 8.0.2, and 8.5

Lotus Sametime Clients: 7.5.1, 8, 8.0.1, and 8.0.2

2. Should you accept the security prompt after installing the Meetings plug-in when using Lotus

Notes 8.5?

Yes, this will appear the very first time you open the plug-in on Notes 8.5 after the installation (see

figure 23). Click the X to close it, and it should not appear again.

Figure 23. Security warning

26


27/30

3. Is it possible to install the two Meetings plug-in types on the same Notes or Sametime client?

Both Meeting plug-in types can be installed on the same client, but you cannot have more than one

instance of the same plug-in type installed; for example, you cannot install two instances of the

LotusLive plug-in on your Notes client.

4. For Notes users who do not have the File > Application > Install capability, you must enable

this feature prior to plug-in installation. To do this:

If your Lotus Notes client is running, exit the program by selecting File > Exit.

Using a text editor such as Notepad, add the following line to the file \framework\rcp\plug-

in_customization.inilocated in your Notes home folder:

com.ibm.notes.branding/enable.update.ui=true

Save the file and start the Notes client.

This configuration file change enables the Install function of the Applications menu, which is disabled

by default.

NOTE: If you do not know the path to your Notes home folder, you can find the file by selecting Start

> Search and searching forplugin_customization.ini. When the search results display, find the file that

ends in \framework\rcp\plugin_customization.ini, and open it.

(For Macintosh users, right-click the Notes application and choose Show package contents. The

plugin_customization.inifile is located in the Contents/MacOS/rcp/plugin_customization.ini folder.)

5. What happens if an invalid meeting ID is accidentally placed in the Join section or in themeeting preferences?

If a user wishing to join a meeting enters an incorrect Meeting ID, they will be placed in the waiting

room for the meeting ID entered. The user can click the Back button on the 'Waiting to Join

Conference' window.

If using the LotusLive Meetings plug-in, the user will then be directed to the LotusLive Join a Meeting

page as shown in figure 24.

27


28/30

Figure 24. Join a Meeting from LotusLive page

If using the Sametime Unyte plug-in, the user will see the Participant tab information, as shown in

figure 25, giving them another opportunity to enter the correct meeting ID.

Figure 25. Join a Meeting from Sametime Unyte plug-in page

6. What happens if you sign out from a LotusLive meeting but do not close the browser?

As a host, if you sign out of your meeting, you will be able to start a new meeting without re-

authenticating on LotusLive because the session is kept by the browser.

If you do close your browser after a meeting using LotusLive, you must re-authenticate each time.

28


29/30

7. What should you do if an error appears after you attempt to refresh brand information in the

configuration settings?

If the refresh operation returns an error, check the following:

Network connection: Check that you have access to the Internet.

Conference server: Check that the conference server specified in the configuration settings

can be reached.

Provider and brand: Check with Sametime Unyte/LotusLive Support to make sure that the

provider and brand in the configuration settings are valid.

7 ConclusionYou should now have the information you need to install and use LotusLive and Sametime Unyte Meeting

plug-ins. Our discussion included the following topics:

Various options available for installation

Brand information required Configuration settings

Using the plug-in to host, invite, and join a meeting using Lotus Notes and Sametime clients

We also pointed out any differences between the two plug-ins, where applicable and concluded with a

troubleshooting section to provide help/answers to any issues/questions you may have.

8 ResourcesdeveloperWorks article, Introducing LotusLive:

http://www.ibm.com/developerworks/lotus/library/lotuslive-intro/

developerWorks article, Introducing LotusLive Meetings:

https://www.ibm.com/developerworks/lotus/library/lotuslive-meetings/

LotusLive product page:

https://www.lotuslive.com/en/

Lotus Domino and Notes information center:

http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp

Lotus Sametime 8 information center:

http://publib.boulder.ibm.com/infocenter/sametime/v8r0/index.jsp

Lotus Expeditor 6.2 information center:

http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp

LotusLive Engage wiki:

http://www-10.lotus.com/ldd/bhwiki.nsf

29
http://www.ibm.com/developerworks/lotus/library/lotuslive-intro/https://www.ibm.com/developerworks/lotus/library/lotuslive-meetings/http://www.lotuslive.com/http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsphttp://publib.boulder.ibm.com/infocenter/sametime/v8r0/index.jsphttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://www-10.lotus.com/ldd/bhwiki.nsfhttp://www.ibm.com/developerworks/lotus/library/lotuslive-intro/https://www.ibm.com/developerworks/lotus/library/lotuslive-meetings/http://www.lotuslive.com/http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsphttp://publib.boulder.ibm.com/infocenter/sametime/v8r0/index.jsphttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://www-10.lotus.com/ldd/bhwiki.nsf


30/30

Lotus Sametime wiki:

http://www-10.lotus.com/ldd/stwiki.nsf

Lotus Notes wiki:

http://www-10.lotus.com/ldd/dominowiki.nsf/xpViewCategories.xsp?lookupName=Lotus%20Notes

About the authorsKathleen Murray is a Software Engineer at IBM's Dublin, Ireland, Software Lab. She joined IBM in 2003

working on Workplace Messaging 1.1; then joined the Collaborative Learning team, where she was one of

the lead testers for the past three releases of the product; and is currently on the LotusLive Meetings

team.

In 2006, Kathleen co-authored the IBM Redbooks publication, IBM Workplace Collaborative Learning

2.6, among many other Collaborative Learning publications. She holds a First Class Bsc (Hons) degree in

Computing Science and a Diploma in Industrial Studies. She has also attained certification in Java

Developer (SCJP).

Vincenzo Caruso is a Software Engineer at the Madison Tyler Limited, where he works on low-latency

and high-volume messaging systems. Prior to joining Madison Tyler, he worked at IBM for three years on

the LotusLive Meetings team, focusing on the back end of the system and leading the development of the

publishing feature. He was also the inventor and lead developer of the Meetings plug-In for Notes and

Sametime.

Vincenzo holds a Masters Degree with Hons in Distributed Systems from the University of Bologna and

attained certification in Java Developer (SCJP). He is also the author of various publications on the

domain of low-latency messaging middleware.

Trademarks

developerWorks, Domino, IBM, Lotus, LotusLive, Notes, Redbooks, Sametime, Symphony, and Unyte

are trademarks or registered trademarks of IBM Corporation in the United States, other countries, or

both.

Windows is a registered trademark of Microsoft Corporation in the United States, other countries, or

both.

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

30
http://www-10.lotus.com/ldd/stwiki.nsfhttp://www-10.lotus.com/ldd/dominowiki.nsf/xpViewCategories.xsp?lookupName=Lotus%20Noteshttp://www.redbooks.ibm.com/abstracts/SG247254.html?Openhttp://www.redbooks.ibm.com/abstracts/SG247254.html?Openhttp://www.redbooks.ibm.com/abstracts/SG247254.html?Openhttp://www-10.lotus.com/ldd/stwiki.nsfhttp://www-10.lotus.com/ldd/dominowiki.nsf/xpViewCategories.xsp?lookupName=Lotus%20Noteshttp://www.redbooks.ibm.com/abstracts/SG247254.html?Openhttp://www.redbooks.ibm.com/abstracts/SG247254.html?Openhttp://www.redbooks.ibm.com/abstracts/SG247254.html?Open

LotusLive_UnyteMeetingsPluginsFINAL

Documents

Transcript of LotusLive_UnyteMeetingsPluginsFINAL