MACROMEDIA BREEZE-CLUSTERING BREEZE LIVE User manual

Clustering Breeze Live

Trademarks
Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver,
Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage
Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, Contribute, Design in Motion,
Director, Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000,
Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio,
Generator Dynamic Graphics Server, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects,
MacRecorder Logo and Design, Macromedia, Macromedia Contribute, Macromedia Coursebuilder for Dreamweaver,
Macromedia M Logo & Design, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC, Mediamaker,
Multimedia is the Message, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit,
ShockRave, Shockmachine, Shockwave, shockwave.com, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to
Power Your Ideas, Universal Media, Virtuoso, Web Design 101, Whirlwind and Xtra are trademarks of Macromedia, Inc. and
may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs,
titles, words or phrases mentioned within this publication may be trademarks, servicemarks, or tradenames of Macromedia, Inc.
or other entities and may be registered in certain jurisdictions including internationally.
This guide contains links to third-party Web sites that are not under the control of Macromedia, and Macromedia is not
responsible for the content on any linked site. If you access a third-party Web site mentioned in this guide, then you do so at your
own risk. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia
endorses or accepts any responsibility for the content on those third-party sites.
Apple Disclaimer
APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE
ENCLOSED COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY
PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES.
THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC
LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO
STATE.
Copyright © 2003 Macromedia, Inc. All rights reserved. This manual may not be copied, photocopied, reproduced,
translated, or converted to any electronic or machine-readable form in whole or in part without prior written approval of
Macromedia, Inc.
First Edition: October 2003
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103

3
Beta
CONTENTS
Clustering Breeze Live . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Setting up a Breeze Live cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Verifying failover for Breeze Live . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4 Contents
Beta

5
Clustering Breeze Live
If your Macromedia Breeze license permits, you can install Breeze Live on two or more computers
and then cluster the computers to provide load balancing and failover for Breeze Live.
This white paper explains how to create a Breeze Live cluster and verify that the cluster functions
successfully. It contains the following main sections:
•“Setting up a Breeze Live cluster”
•“Verifying failover for Breeze Live” on page 9
Setting up a Breeze Live cluster
When you create a Breeze Live cluster, Breeze Live on each computer must communicate with the
Breeze Presentation platform and with a file server that stores the files created by each Breeze Live.
The Breeze Presentation platform also needs access to the Breeze Live files on the file server. The
following figure illustrates a cluster with Breeze Live on three computers.
Note: If you are using Breeze Live as a stand-alone product, all references to the Breeze
Presentation platform in this white paper also apply to the Breeze application server.
Breeze Presentation platform
Breeze
Live
Breeze
Live
Breeze
Live
Breeze database
File server

6 Clustering Breeze Live
To set up a Breeze Live cluster for load balancing and failover:
1Install Breeze Live on each computer that will be in the cluster.
For information on installing Breeze Live, see the Macromedia Breeze Installation Guide.
2Create a user account on the domain that contains the Breeze Live and Breeze Presentation
platform computers, and give the user account administrative privileges to all the Breeze Live
and Presentation platform computers.
This is the Breeze user account. Each Breeze Live in the cluster and the Breeze Presentation
platform will use this account to run as services under the Windows operating system.
3On a file server, create a folder for Breeze, and immediately below the Breeze folder, create a
subfolder for the Breeze Live files that will be shared.
For example, the following is a possible path to the shared files: \\fileserver1\breeze\content.
For the remainder of this white paper, the examples assume that the Breeze folder is named
“breeze” and that the folder for shared files created by Breeze Live is “content.” In practice, you
can choose other names for the folders.
4On the file server, share the Breeze folder, giving the Breeze user you created in step 2 full
control over the folder.
To share the Breeze folder:
aRight-click the Breeze folder in the Windows Explorer Folders panel, and select Sharing
and Security.
The Properties window for the Breeze folder opens:
bClick Share this folder and enter a Share name, for example, “Breeze.”

Setting up a Breeze Live cluster 7
cClick Apply and then click the Permissions button.
The Permissions window opens.
dRemove the Everyone group, if you want to, and then click Add.
The Select Users or Groups window opens.
eClick the Locations button and select the domain in which you created the Breeze user.
fIn the object names text box, enter the name of the Breeze user, and then click Check
Names to verify that the name you entered is recognized, and click OK.
The Select Users or Groups window closes.
gIn the Permissions window, select the Breeze user and click Full Control, and then
click OK.
The Permissions window closes.
hIn the Properties window, click OK.

8 Clustering Breeze Live
5Set the FCS_CONTENT_PATH property in the Breeze Presentation platform custom.ini
configuration file to the location of the folder containing shared Breeze Live files.
For example, given \\fileserver1\breeze\content as the folder containing the shared files, you
would set the FCS_CONTENT_PATH property as shown in the following example:
FCS_CONTENT_PATH=\\fileserver1\breeze\content
For more information about the FCS_CONTENT_PATH configuration property, see the table of
configuration properties in Chapter 4, “Configuring the Breeze Presentation Platform,” in the
Macromedia Breeze Installation Guide.
The custom.ini configuration file on the Breeze Presentation platform computer resides in the
Breeze Presentation platform installation folder.
6Copy the custom.ini file to the Breeze Live installation folder on each of the Breeze
Live computers.
7On the Breeze Presentation platform computer, set the login properties for the Macromedia
Breeze Application Service so that the Breeze user account can start the service.
aDepending on your operating system, do one of the following:
For Windows 2000, select Start > Settings > Control Panel > Administrative
Tools > Services.
For Windows XP, select Start > Control Panel > Performance and Maintenance >
Administrative Tools > Services.
bIn the list of services, double-click Macromedia Breeze Application Service.
The Properties window for the Macromedia Breeze Application Service appears:

Verifying failover for Breeze Live 9
cClick the Log On tab.
The Log On dialog box appears:
dSelect This account and then enter the name of the Breeze user account you created,
followed by the account’s password and a confirmation of the password.
8Restart the Macromedia Breeze Application Service so that your changes take effect.
9On each Breeze Live computer, follow the procedure given in step 7, and set the login properties
for the Flash Communication Server and the Flash Communication Administration Server so
that the Breeze user account can start the services.
10 On each Breeze Live computer, restart the Flash Communication Server and the Flash
Communication Administration Server so that your changes take effect.
Verifying failover for Breeze Live
This section explains how to verify that your Breeze Live cluster can provide failover in the event
that one of the computers in the cluster fails. If failover is successful, you have configured the
cluster correctly and can expect that load balancing also functions successfully.
When a Breeze meeting is created, as soon as the first user enters the online meeting room in
which the meeting is held, the meeting and its meeting room are assigned to the Breeze Live on a
specific computer.
To verify that failover works, the basic strategy is to create a Breeze meeting, enter the online
meeting room for the meeting, and do something that changes the state of the meeting room,
such as entering a note in the meeting room’s Note pod. Then shut down the Breeze Live that is
responsible for the meeting and see if the meeting room is redisplayed in the same state as before.
The following procedure for verifying failover in a Breeze Live cluster assumes that there are two
computers in the cluster, Computer1 and Computer2. The procedure for verifying failover with
more than two computers is very similar.

10 Clustering Breeze Live
To verify failover in a Breeze Live cluster with two computers:
1Make sure that no Breeze meetings are currently open.
This ensures that if you create two meetings, load balancing assigns each meeting to a
different computer.
2Open the Breeze Manager and create a new meeting. Enter the meeting room for the meeting.
For information on opening the Breeze Manager and creating meetings, see “Verifying that the
Breeze database and Breeze Presentation platform work together” and “Verifying that you can
use Breeze Live” in Chapter 6 of the Macromedia Breeze Installation Guide.
When you create a meeting room, your browser displays a Meeting Information page with an
Enter Meeting Room button. You can click the button to immediately enter the
meeting room.
3In the meeting room’s Note pod, enter “Meeting room 1” or similar text for
identification purposes.
To enter text in the Note pod, simply place the cursor in the Note pod and start typing.
4Repeat steps 1 and 2 to create a new meeting and a Note pod entry such as “Meeting room 2.”
You can have two or more meeting rooms open in your browser at the same time.
Because of load balancing, each meeting you created should be assigned to a
different computer.
5Stop Breeze Live on Computer1 by selecting Start > Programs > Macromedia > Macromedia
Breeze 3 > Stop Breeze Live Server.
If failover is successful, the window for one of the meeting rooms goes blank for up to a minute
while failover is activated. Then the meeting room is displayed again, exactly as it was before.
If failover is successful for Computer1, the next step is to test failover for Computer2.
6To enable testing of failover for Computer2, restart Breeze Live on Computer1 by selecting To
Start > Programs > Macromedia > Macromedia Breeze 3 > Start Breeze Live Server.
7Stop Breeze Live on Computer2.
If failover takes place, as described in step 4, you have successfully configured your Breeze
Live cluster.