Page 2
Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally.
INTRODUCTION Breeze Installation Overview Macromedia Breeze consists of Breeze Server and its applications: Macromedia Breeze Meeting, Macromedia Breeze Presenter, Macromedia Breeze Manager, Breeze Events, and Breeze Training. Depending on the configuration purchased and the terms of your license, you may be installing one, two, or all of these applications.
Guide to documentation and additional resources Macromedia Breeze contains a variety of media to help you quickly learn how to use the Breeze applications. This section describes the variety of resources available to ensure the successful deployment of the Breeze applications within your organization.
Page 7
Breeze applications on multiple networked computers, which is called a cluster. For information about specialized topics not discussed in this installation manual, visit the Macromedia Breeze Licensed Support website at www.macromedia.com/go/ breeze_licensed_support. To access the licensed support website, you will need to have available the Breeze License Certificate from Macromedia.
• TechNotes on the Breeze Support Center website at www.macromedia.com/support/breeze • Macromedia Support You will need to provide your Macromedia license number to the representative. • Macromedia Online Forums at www.macromedia.com/support/forums. Introduction: Breeze Installation Overview...
CHAPTER 1 Before You Begin For a successful installation of Macromedia Breeze, read the information provided in this chapter. It contains the following sections: • “Basics of Breeze Server technology” on page 9 • “Planning for bandwidth requirements” on page 11 •...
Page 10
The web browser interacts primarily with the Breeze Server applications. When a user starts a meeting, Flash Player interacts primarily with Breeze Meeting, although there is still some interaction with Breeze Presenter. The following figure illustrates how the server hosting Breeze interacts with the user’s computer, sometimes called the client.
Starting a meeting Tracing the sequence in which Breeze applications execute when users start a meeting can help you understand the primary system applications. The following list explains the typical order in which Breeze calls upon applications to place users successfully in a meeting: The web browser collects the login credentials and communicates the credentials to Breeze Server.
Page 12
Calculating bandwidth usage Here are some bandwidth calculations based on a meeting with audio, video, and slides. Calculations are based on 1024x768 full screen. • Room bandwidth: Modem setting One Presenter can generate about 26 Kbits/sec of data. Viewers need about 29 Kbits/sec of downstream bandwidth to have a good experience. Having more than one Presenter on a modem room setting is not recommended.
Planning for directory services integration Directory services integration lets the Breeze administrator synchronize the Breeze internal directory of users and groups with an external source such as an organization’s LDAP (Lightweight Directory Access Protocol) server. The Breeze administrator can synchronize the internal and external directories on demand or at scheduled intervals.
Directory services integration In an LDAP schema, all directory entries are arranged in a hierarchical tree-like structure that reflects the organization’s political, geographic, or administrative regions. For example, the IT administrator at a company with multiple worksites wants to let everybody in the organization use Breeze.
Any application run over a network, especially the Internet, has security risks associated with it. Macromedia Breeze is no different. However, these security threats can be minimized if you give careful consideration to implementing a security plan for Macromedia Breeze.
Page 16
The discussion on security is divided into the following sections: • Security levels • Solutions for a secure infrastructure • Best practices • Additional references Security levels When planning a security strategy, it is important to consider the various layers in a deployed server environment, and devise a security plan for each layer.
Page 17
Breeze comes with its own built-in, high-performance, secure web server. This web server is based in part on Macromedia JRun Enterprise Server and has been designed specifically to serve dynamic content for Breeze, including Breeze Meetings, Breeze Presentations, Breeze Seminars, and other rich media content.
Page 18
Single-server configuration The easiest solution for a dedicated, single-server Breeze system is to block all ports on the server except 80, 1935, and 443 for SSL-enabled traffic. An external hardware firewall appliance provides a layer of protection against gaps in the operating system. Some organization configure layers of hardware-based firewalls to form DMZs.
Page 19
It is very important that you understand how to secure a multiserver installation. The following are suggestions for securing multiserver solutions. • Private networks The simplest solution for multiserver solutions in a single location is to create an extra subnet for the Breeze system.
Page 20
• Authors Members of the Account Authors group have access to publishing features. They can publish content to the Breeze system. • Events Administrators This group includes anyone who organizes events. An event can be any meeting, presentation, course, curriculum, or seminar that requires registration and generates reports with participant tracking information.
Page 21
Best practices The following is a checklist of best practices that will assist you in securing Breeze. • Protect your servers with firewalls. You should place the Breeze server behind a firewall, especially if Breeze is accessed through the Internet. If you do not place Breeze behind a firewall, you are leaving the server open for attacks.
Macromedia Breeze software is not intended to provide security against any unauthorized access to, or unintended or intended disruptions or harm against, your servers or any information stored or deployed by you on any computer, including servers.
Breeze in a multiserver configuration. You will need a special Breeze license file to run a Breeze cluster. If your Macromedia Breeze license permits, you can install Breeze Server on two or more computers and then cluster the computers with load balancing and failover.
• Clustering Breeze allows the computers in a cluster to share session data with each other for effective load balancing and failover. Planning for a Breeze Server cluster In a Breeze Server cluster, an identical copy of Breeze is installed on each server in the cluster. Each server must be able to access the Breeze database of users and groups.
You configure Breeze on the clustered servers during the installation and post-installation by performing the following: • Installing Breeze on each server in the cluster. • Setting the values in the Breeze custom.ini configuration file on one server in the cluster. •...
Page 26
The embedded database engine installed with Breeze is suitable for testing and development environments, and for workgroups. The embedded database engine is shipped with Macromedia Breeze. This engine is built and based on core SQL Server technology. The common technology base shared between SQL Server and the embedded database engine enables developers to build applications that can scale seamlessly from portable computers to a cluster of computers.
Properties from the Context menu. In the General tab of the Local Disk Properties dialog box, the File System area should specify NTFS. For updated Breeze system requirements and recommendations, see www.macromedia.com/go/ breeze_sysreqs. Breeze user requirements Every user’s computer must meet the following software and hardware requirements, which vary according to the user’s role.
Page 28
Macromedia Flash Player 6.0.65 or later • Web camera and microphone (optional) For additional information, please visit the Breeze Resource Center at www.macromedia.com/ resources/breeze/. Authors and training managers The following software and hardware must be installed on these users’ computers.
SQL Server 2000. The Breeze database stores information about users, content, courses, meetings, and reports. • The embedded database engine comes with Macromedia Breeze. You install it at the same time that you install Breeze Server. • Breeze Server deployed in a configuration with multiple computers (a cluster, for example) or with multiprocessor computers with HyperThreading requires SQL Server 2000.
Preparing to Upgrade This chapter provides instructions about the preparatory tasks you need to complete before you start the upgrade process from Macromedia Breeze version 4.1 to version 5. This chapter provides detailed information about the following phases of the upgrade process: •...
Backing up your Breeze files To back up your Breeze files: Stop all Breeze services. From your Windows desktop, select Start > Programs > Macromedia > Macromedia Breeze > Stop Breeze Server. Make a copy of the content directory within the Breeze installation path. The default location is C:\breeze\content.
Backing up the Breeze database The Breeze database includes the collected records of Breeze users and groups. To back up the Breeze database: Restart your database: From your Windows desktop, select Start > Settings > Control Panel > Administrative Tools > Services. In the Services window, right-click MSSQLSERVER and select Start from the context menu.
Preparing for the upgrade To prepare your system for the Breeze upgrade: Stop the Macromedia Breeze Application Service, which stops Breeze Presenter and Breeze Training: From your Windows desktop, select Start > Settings > Control Panel > Administrative Tools > Services.
Before you begin the installation process, check that all the requirements listed in “Before You Begin” on page 9 are satisfied. In addition, verify that your system meets the following requirements, which are critical for a successful Macromedia Breeze installation: •...
Flash Player 7 version. You can also download Flash Player from www.macromedia.com/go/getflashplayer. You also need the Breeze License Certificate from Macromedia. The certificate shipped with the installation CD and contains a unique serial number for your installation. Enter this serial number when prompted.
Using the Breeze installer Use the procedures described in this section to install Breeze. Macromedia recommends that you close all other applications before you start to install Breeze. To install and configure Breeze: Insert the Breeze installation CD into the CD-ROM drive.
Page 38
Read the agreement, click Accept, and click Next to continue. The Select Destination Location screen appears. Click Next to accept the default installation (c:\breeze) location, or click Browse to select a different location, and then click Next. If the default location already exists, the Folder Exists dialog box appears. Chapter 3: Installing and Upgrading Breeze...
Page 39
Click Yes to continue. The Company Information screen appears and asks you to enter your serial number. The License Certificate that comes with the installation CD contains the serial number. Enter the serial number and click Next to continue. If the installer determines that a SQL database server is present on your system, the following notice appears.
Page 40
The Ready to Install screen alerts you that the Breeze installation is about to begin. Review the choices for the destination folder where Breeze will be installed and for adding Macromedia Breeze to the Start Menu folder. Chapter 3: Installing and Upgrading Breeze...
Page 41
Click Back to review or change these settings or click Install to continue. The Installing screen appears. The installer is extracting Breeze Server files on the installation CD and installing them. This process takes approximately two minutes. Click Cancel at any time to terminate or cancel the installation. You may also see the following message.
Page 42
Select the option to start Breeze and press Next to continue. A message appears that the Macromedia Breeze Application Service service is starting. Breeze runs as a Windows service. Breeze is defined as the Macromedia Breeze Application service and the Flash Communication Server service in the Services screen. The Breeze Application Service is one of the services that Breeze uses.
Upgrading Breeze from a previous release • Uploading the Breeze license file You can also access the Console Manager through Start > Programs > Macromedia Breeze. Welcome The Welcome screen is the first screen of the Application Management Console. Press Next to continue.
Page 44
Configure the database settings The Breeze administrator uses the Database Settings screen to configure the following variables for the Breeze database: Variable Default value Description DB_HOST localhost Name of the Microsoft SQL Server 2000 host computer. DB_NAME breeze Name of the Breeze database. User name for Breeze Server employed when creating and DB_USER accessing the Breeze database.
Page 45
Database creation If the Breeze database whose name appears on the Database Settings screen (the variable DB_NAME in the custom.ini file) was not created, the administrator sees a confirmation screen. The administrator is asked to confirm whether to create the database or not. Upgrade confirmation The Upgrade Confirmation screen asks the administrator to confirm that they want to upgrade Breeze 4.1 to Breeze 5, and if the following backup procedures are completed:...
Page 46
The administrator must confirm that these procedures are complete before the Console can proceed with the upgrade to Breeze 5. The Console creates a new Breeze 5 database. The data from the existing Breeze database is copied and migrated to a Breeze 5 database. You must specify a new name for the new database. Do not use the name of an existing database.
Page 47
Before you contact Breeze Technical Support, have the Breeze License Certificate from Macromedia available. The certificate contains the unique serial number required for your installation. Upgrade in progress screen The Console displays an upgrade in progress screen informing the administrator of the status of the upgrade.
Page 48
Breeze Server settings The Breeze administrator defines the settings for the Breeze Server on the Breeze Server Settings screen. Click Next to continue. Chapter 3: Installing and Upgrading Breeze...
Page 49
[none] Host name and external name (the fully qualified domain Host Mapping [ADMIN_HOST] name) of the Macromedia Breeze site. Breeze supplies the values for these fields. The default port for HTTP is port 80. If your Breeze Server HTTP Port...
Page 50
The Upload License File window appears. An Internet connection is required at this point. The Breeze license file identifies those Macromedia Breeze applications that you are authorized to use. Have the Breeze License Certificate from Macromedia available. The license contains a unique serial number for your installation.
Page 51
The File Download window appears. Check the Close This Dialog Box When Download Completes check box. The Create Administrator window appears. This step is mandatory. You must create an administrator for Breeze now. Administrative privileges are required for configuring and maintaining Breeze.
Page 52
The Application Settings summary screen displays the settings you configured with the Console, and the Breeze features that the license file enables. To return to the Console, select Start > Programs > Macromedia Breeze. Chapter 3: Installing and Upgrading Breeze...
Restart the server. In Windows, open the Control Panel and double-click Add/Remove Programs. In the Add or Remove Programs dialog box, select Macromedia Breeze Server, and then select Change or Remove Programs on the left of the dialog box. Click Change/Remove.
To uninstall these elements, delete the folder that you installed Breeze in. By default, it is c:\breeze. Troubleshooting If you encounter unexpected results after you install Macromedia Breeze either on a single server or on a cluster of servers, the following helpful resources are available to you: •...
ASP system. Macromedia online forums Macromedia online forums are the Macromedia community’s peer-to-peer discussions of Macromedia products. The forums are a useful source of information, user tips, and best practices. Note: These forums are not an official customer-support channel for Macromedia.
Page 56
Chapter 3: Installing and Upgrading Breeze...
CHAPTER 4 Post-installation This chapter describes the series of configuration and deployment tasks that you need to complete after you install the Macromedia Breeze applications and complete the first phase of configuring Breeze with the Application Management Console. • “Deploying Breeze to your organization” on page 57 •...
Page 58
• Will some users interact with the servers by communicating through a firewall or proxy? Verify that your firewall or proxy server configuration allows end users to interact with the servers. You must also use the proper configuration of servers. •...
Page 59
If you are installing Breeze in large organizations where there may be more demands on system resources, you might consider the following strategies: • Clustering Breeze Servers Creating a cluster of servers lets you distribute end-user traffic across multiple servers. Use this configuration if you have many users and are concerned about the load on a single server, or when you want to have more than one server as a redundant system, in case a single server experiences hardware failure.
Page 60
• Firewalls and proxy servers Firewalls and proxy servers can cause problems for a single-server Breeze configuration. Breeze Server uses port 80 by default, which most firewalls and proxy servers allow. Breeze Meeting uses port 1935 by default, and reverts to port 443 if port 1935 is not successful. Ports 443 and 1935 are not as common to firewalls and proxy servers;...
Integrating Breeze with learning management systems All LMS integration occurs through Breeze Presenter. For more information, see Breeze Presenter User Guide. Implementing single sign-on Single sign-on (SSO) is a mechanism whereby a single action of user authentication allows a user to access all computers and applications where they have access permission without the need to enter multiple passwords.
Reconciling login policies Breeze and the Microsoft NTLM have different login policies for authenticating users. These policies must be reconciled before the user can employ a single login to access Breeze and other applications. The organization’s login and password policy determines what the external login looks like.
Page 63
Configure the connection settings On this screen the administrator provides the location of the organization’s Directory Service and the authorization to access it. Breeze uses this information to connect to the Directory Service. The following table provides the field names and descriptions for the Connection Settings screen: Field Default Value Description...
Page 64
The following example shows connections settings in one LDAP syntax: URL: ldap://mycompany.com:636 Username: MYCOMPANY\jdoe Password: password123 Query timeout: (empty) Authentication mechanism: Simple Note: This is an example. Consult your local LDAP admin for the appropriate settings and syntax. Chapter 4: Post-installation...
Page 65
Map the Breeze user profile to the Directory Service The administrator uses the User Profile Mapping screens to provide the information that Breeze uses to map the fields in its user profiles to their equivalent LDAP attributes when the organization’s Directory Service and the Breeze directory of users are synchronized. Configuring the Breeze Directory Service Integration...
Page 66
The following table describes the field names in the User Profile Mapping screen: Field Default Value LDAP attribute/Notes First Name Required field. givenName No default. Last Name Required field. No default. Email Required field. UserPrincipalName No default. Custom Field 1 Optional field.
Page 67
Adding user branches Each branch in the organization is defined by its own DN (distinguished name) attribute. When you click Add in the User Profile Mapping screen to add the user information for other branches of the organization when the directories are synchronized, the following screen is displayed. The following table describes the fields in the User Profile Mapping screen.
Page 68
Note: This is an example. Consult your local LDAP admin for the appropriate settings and syntax. The same information is used for mapping group branches. Map the Breeze group profile to the Directory Service On the Group Profile Mapping screen, the administrator provides the information that Breeze uses to map the fields in its group profiles to their equivalent LDAP group entries when the organization’s Directory Service and the Breeze directory of groups are synchronized.
Page 69
The following example shows one LDAP syntax of how to map a group profile: Name: sAMAccountName Membership attribute: member Note: This is an example. Consult your local LDAP admin for the appropriate settings and syntax. To map additional groups, click Add to display the Group Branch screen. Adding group branches Each group in the organization is defined by its own DN attribute on the following screen.
Page 70
The following example shows one LDAP syntax for how to add a branch of the organization and define its groups: Add branch: DN: cn=USERS,DC=myteam,DC=mycompany,DC=com Filter: (objectClass=group) Subtree search: True Note: This is an example. Consult your local LDAP admin for the appropriate settings and syntax. The same information is used for mapping user branches.
Page 71
• Manual synchronization immediately synchronizes the Breeze directory and the organization’s directory service. • Preview synchronization is similar to a manual synchronization, but no changes are made to the Breeze directory. The log file assists the administrator in diagnosing any problems that might occur during the synchronization.
Page 72
View the synchronization log files Each synchronization generates a log file that describes each principal processed and the result. In the case of a preview synchronization, the log describes the action that would be taken if this were a manual synchronization. Logs consist of events with one line per event.
Page 73
Log file format The log is in comma-separated value format and demarcates the following values: Field Description Date Formatted date-time value to the millisecond. The format is yyyyMMdd'T'HHmmss.SSS. Principal ID Breeze login or group name. Principal Type A single character: U for user, G for group.
Page 74
Synchronization events and details The following table describes the events found in the synchronization log files: Event Description Detail Principal added to Abbreviated XML packet that describes the updated Breeze fields. A series of <fieldname>value</fieldname>. The parent node and non-updated fields are omitted. For example: update The principal exists as <first-name>Joe</first-name>...
Page 75
Define the password policies The Breeze administrator uses the Policy Setting screen to define the password setup policy for the synchronization. Passwords are pieces of user data that are dealt with separately from the other data in an external directory. Passwords are rarely available in clear text form, if they are available at all.
Page 76
The administrator chooses one of the following options for how the synchronization should set the passwords for new users. The administrator determines the password policy on the Password Setup Policy screen of the Console. • Do nothing. If you have integrated Breeze with an external authentication system, there is no need for the synchronization to create new passwords just for Breeze.
Not integrating the internal and external logins means that users keep their existing network logins and Breeze passwords. IT administrators have to retain separate Breeze passwords for all users. Macromedia does not recommend this option because it is laborious for a directory service of any appreciable size.
You can deploy Breeze with an SSL layer in one of the following ways: • A software-based solution by configuring the native support for SSL in Flash Communication Server (FCS). Use this option if you want to secure only Breeze and not the web application. You will need 2 IP addresses (2 DNS entries for the IP addresses) and 1 SSL certificate.
Page 79
Locating the required SSL tags in the Server.xml file The SSL-enabling tags in the Server.xml file occur in the following sequence: • SSLEngine • SSLRandomSeed • SSLSessionCacheGC • SSLVerifyCertificate • SSLCACertificatePath • SSLCACertificateFile • SSLVerifyDepth • SSLCipherSuite Defining the SSL tags in FCS The following table lists the tags in the Adaptor.xml and Server.xml files that configure FCS for SSL.
Page 80
FCS File XML Tag Default Description Adaptor.xml SSLCipherSuite Specifies the ciphers to use. This is a list of colon- delimited components. A component can be a key exchange algorithm, authentication method, encryption method, digest type, or one of a selected number of aliases for common groupings.
Page 81
FCS File XML Tag Default Description Server.xml SSLCACertificatePath [none] Specifies the name of a directory containing CA certificates. Each file in the directory must contain only a single CA certificate, and the files must be named by the subject name's hash, and an extension of ".0".
Page 82
# breeze external DNS, which is the SSL Certificate A. Certificate-ns.macromedia.com # SSL Configuration Begins ADMIN_PROTOCOL=https:// SSL_ONLY=yes DEFAULT_FCS_HOSTPORT=:1935 # ps-breezewin1 is the Breeze server name; ps-breezewin4.macromedia.com is Meeting’s External DNS AND the SSL Certificate B. USE_HOST_MAPPINGS=yes shost.ps-breezewin1=ps-breezewin4.macromedia.com host.ps-breezewin1=ps-breezewin4.macromedia.com . Bind one IP address to Breeze Server.
Page 83
Variable Default value Description ADMIN_HOST [none] Host name to use in a URL for accessing Breeze. This is the host name that users enter directly in their browsers. For example, for the URL http://aserver.mybreeze.com, you as shown in the following example: ADMIN_HOST ADMIN_HOST=aserver.mybreeze.com If your web server uses a port other than port 80 for receiving...
Install and configure the first Breeze Server. Use the same serial number and license file each time you install Breeze Server. Note: A special cluster license file is required. For more information, contact your Macromedia rep. Confirm that Breeze Server is working correctly.
Page 85
The following procedure assumes that the cluster contains two computers: Computer1 and Computer2. To demonstrate failover: Make sure Microsoft SQL Server 2000 is running. Start Breeze Server on Computer1. Select Start > Programs > Macromedia > Macromedia Breeze 5 > Start Breeze Server. Configuring a Breeze Server cluster...
Page 86
Stop Breeze Server on Computer2. Select Start > Programs > Macromedia > Macromedia Breeze 5 > Stop Breeze Server. Log in to the Breeze Manager. You can log in to the Breeze Manager from the following URL: http://admin_host/servlet/admin where admin_host is the host name you entered as the value of the...
Upload a JPEG image or other content to Breeze Server on Computer1: Make sure that you are a member of the Account Authors user group. To upload content, even if you are an account administrator, you must also be a member of the Account Authors user group.
Page 88
For example, you can overwrite outdated backups, or you can append new backups to the backup media. Best practices for backups When working with database backups, Macromedia recommends the following best practices: • Schedule a nightly backup of the Breeze database.
Page 89
• Select Tools > Backup Database. Macromedia recommends a nightly backup of the Breeze database. Complete instructions for SQL Server database backup and recovery are available at the Microsoft Support site. Backing up the Breeze database with the embedded database engine If you are using the embedded database engine, use the following procedure to create a backup of the Breeze database.
Page 90
To back up your Breeze files: Stop all Breeze services. In Windows, select Start > Programs > Macromedia Breeze > Stop Breeze Server. Make a copy of the content directory within the Breeze installation path. The default location is c:\breeze\content.
If you purchased Macromedia Breeze Training, verify that you can use it (see “Verifying that you can use Breeze Training” on page 95). If you purchased Macromedia Breeze Meeting, verify that you can use it (see “Verifying that you can use Breeze Meeting” on page 95).
The Getting Started page for Macromedia Breeze appears. Under the Publish Presentations heading, there is a link for installing Macromedia Breeze Presenter and a link for logging in to Breeze Manager. You will download Breeze Presenter in a later step (see “Verifying that you can use Breeze Server”...
Page 93
Here is a sample new user e-mail message. Hello John Smythe, Welcome! A user account has been created for you on Macromedia Breeze by Ingrid Jones (ijones). Macromedia Breeze is an integrated web communication solution for real- time meetings, eLearning, and online presentations that audiences can see and hear anytime, anywhere, through any standard web browser.
To verify that you can use Breeze Server, send a Microsoft PowerPoint presentation to the Breeze server for compilation into a Macromedia Flash presentation and then view it. Before you can send a PowerPoint presentation to the Breeze server, you must install Breeze Presenter on a computer on which PowerPoint is already installed.
When the compilation is complete, go to the Content tab in Breeze Manager and search for your presentation. Open your presentation to view it. Verifying that you can use Breeze Training To verify that Breeze Training is functional, go to the Training tab in Breeze Manager. If the Training tab is visible and accessible, Breeze Training is functioning.
Verifying that you can use the Breeze seminar feature To verify that the Breeze seminar feature is functional, you create a Breeze seminar in Breeze Manager and then enter (log in to) the seminar room. Make sure that you are enrolled in the Seminar Hosts group.
Need help?
Do you have a question about the BREEZE 5 and is the answer not in the manual?
Questions and answers