- DL manuals
- MACROMEDIA
- Server
- BREEZE 5
- Installation And Configuration Manual
MACROMEDIA BREEZE 5 Installation And Configuration Manual
Summary of BREEZE 5
Page 1
Installation and configuration guide.
Page 2
Trademarks 1 step robopdf, activeedit, activetest, authorware, blue sky software, blue sky, breeze, breezo, captivate, central, coldfusion, contribute, database explorer, director, dreamweaver, fireworks, flash, flashcast, flashhelp, flash lite, flashpaper, flex, flex builder, fontographer, freehand...
Page 3: Contents
3 contents introduction: breeze installation overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 guide to documentation and additional resources. . . . . . . . . . . . . . . . . . . . . . . . . . 6 troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ....
Page 4
4 contents chapter 4: post-installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 deploying breeze to your organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 implementing single sign-on . . . . . . . . . . . . . . . . . . . . . ...
Page 5: Introduction
5 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,...
Page 6
6 introduction: breeze installation overview breeze presenter lets you rapidly create e-learning content and high-quality multimedia presentations. Breeze presenter is a plug-in for microsoft powerpoint. Finished presentations are in macromedia flash (swf file) format and are scorm and aicc complian...
Page 7
Guide to documentation and additional resources 7 to help you determine what documentation is relevant to your needs, see the following table: information about specialized topics this manual primarily provides information for a basic installation of breeze applications in which no more than one ins...
Page 8
8 introduction: breeze installation overview breeze documentation center this site, at www.Macromedia.Com/go/ breeze_documentation, contains documentation for all breeze products, answers to frequently asked questions, articles about specialized topics, and breeze presentations. Breeze support cente...
Page 9: Chapter 1
9 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 • “planning for directory services i...
Page 10
10 chapter 1: before you begin 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 ...
Page 11
Planning for bandwidth requirements 11 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...
Page 12
12 chapter 1: before you begin 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 ab...
Page 13
Planning for directory services integration 13 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 p...
Page 14
14 chapter 1: before you begin 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 wo...
Page 15
Planning for security 15 implementing ssl for breeze there are two options available for implementing ssl-based authentication with breeze: • using the native support in flash communication server’s (fcs) for ssl. Use this option if you want to secure only breeze and not the web application. You wil...
Page 16
16 chapter 1: before you begin 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 ...
Page 17
Planning for security 17 breeze web server 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 presenta...
Page 18
18 chapter 1: before you begin 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 th...
Page 19
Planning for security 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 b...
Page 20
20 chapter 1: before you begin • 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 ...
Page 21
Planning for security 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 bree...
Page 22
22 chapter 1: before you begin security resources and references the following are sources of information and software that may aid the process of securing the breeze server(s). • network security sans institute (www.Sans.Org) the sans (system administration, networking, and security) institute is a...
Page 23
Available breeze configurations 23 available breeze configurations you can install breeze on one server or on a group of connected servers, usually called a cluster. The terms in your breeze license determine which configuration is allowed. The single-server configuration is easier to administer. De...
Page 24
24 chapter 1: before you begin • 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 cluste...
Page 25
Installation requirements 25 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. • ma...
Page 26
26 chapter 1: before you begin • minimum requirements: ■ pentium 4, 2-ghz processor ■ 1 gb of ram ■ 80 gb hard disk ■ cd-rom drive ■ 1.5mb network connection (t1) • for breeze deployment with encrypted ssl enabled: ■ ssl hardware accelerator (optional) • communication ports ■ port1935 for rtmp ■ por...
Page 27
Breeze user requirements 27 additional software requirements the computers hosting breeze server also require the following software: • an smtp e-mail server breeze server requires an smtp e-mail server for sending e-mail notifications. The smtp server can be on the same computer or can be relayed t...
Page 28
28 chapter 1: before you begin additional requirements: • macromedia flash player 6.0.79 or later • minimum bandwidth requirements: 56 kb/sec breeze meeting presenters the following software must be installed on these users’ computers: • windows 98se, me, xp, nt 4.0, 2000, 2002, or 2003 • supported ...
Page 29
The breeze database 29 the breeze database breeze server requires a database created with either the embedded database engine or microsoft sql server 2000. The breeze database stores information about users, content, courses, meetings, and reports. • the embedded database engine comes with macromedi...
Page 30
30 chapter 1: before you begin.
Page 31: Chapter 2
31 chapter 2 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 chapterprovides detailed information about the following phases of the upgrade process: • “...
Page 32
32 chapter 2: preparing to upgrade before you begin as with any software upgrade project—especially one that affects a workgroup—communication and planning are very important. Before you begin upgrading or adding modules to your breeze installation, macromedia suggests that you do the following: • a...
Page 33
Backing up the breeze database 33 backing up the breeze database the breeze database includes the collected records of breeze users and groups. To back up the breeze database: 1. Restart your database: ■ from your windows desktop, select start > settings > control panel > administrative tools > serv...
Page 34
34 chapter 2: preparing to upgrade preparing for the upgrade to prepare your system for the breeze upgrade: 1. Stop the macromedia breeze application service, which stops breeze presenter and breeze training: a from your windows desktop, select start > settings > control panel > administrative tools...
Page 35: Chapter 3
35 chapter 3 installing and upgrading breeze this chapter presents information on the following topics: • “installation checklist” on page 35 • “installation and configuration overview” on page 36 • “using the breeze installer” on page 37 • “the application management console” on page 43 • “starting...
Page 36
36 chapter 3: installing and upgrading breeze to verify that the system employs ntfs: 1. On your microsoft windows desktop, double-click my computer. 2. In the my computer window, right-click the drive where breeze is installed and select properties from the context menu. In the general tab of the l...
Page 37
Using the breeze installer 37 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: 1. Insert the breeze installation cd into the cd-r...
Page 38
38 chapter 3: installing and upgrading breeze 3. Read the agreement, click accept, and click next to continue. The select destination location screen appears. 4. Click next to accept the default installation (c:\breeze) location, or click browse to select a different location, and then click next. I...
Page 39
Using the breeze installer 39 5. 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. 6. Enter the serial number and click next to continue. If the installer det...
Page 40
40 chapter 3: installing and upgrading breeze 7. Click next to continue. The select start menu folder screen appears. 8. Accept the default shortcut, or click browse to select a different location, and then click next. The ready to install screen alerts you that the breeze installation is about to b...
Page 41
Using the breeze installer 41 10. 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. 11. Click cancel at a...
Page 42
42 chapter 3: installing and upgrading breeze 12. Click ok to continue. You can reboot the server after the breeze installation and configuration is complete. The initializing macromedia breeze service screen appears. 13. Select the option to start breeze and press next to continue. A message appear...
Page 43
The application management console 43 click finish to complete the installation process. The application management console opens to guide you through the tasks to configure breeze server. The application management console after installing the software, the breeze installer automatically starts the...
Page 44
44 chapter 3: installing and upgrading breeze configure the database settings the breeze administrator uses the database settings screen to configure the following variables for the breeze database: click next to continue. The console detects the release number of any breeze software installed on yo...
Page 45
The application management console 45 database creation if the breeze database whose name appears on the database settings screen (the db_name variable in the custom.Ini file) was not created, the administrator sees a confirmation screen. The administrator is asked to confirm whether to create the d...
Page 46
46 chapter 3: installing and upgrading breeze 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 da...
Page 47
The application management console 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 s...
Page 48
48 chapter 3: installing and upgrading breeze breeze server settings the breeze administrator defines the settings for the breeze server on the breeze server settings screen. Click next to continue..
Page 49
The application management console 49 the following table describes the fields on the breeze server settings screen: field default value description account name [none] enter a name that readily identifies the breeze account, such as “enterprise account” or “my breeze 5 account.” bcc_email [none] bl...
Page 50
50 chapter 3: installing and upgrading breeze upload the breeze license file 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 certi...
Page 51
The application management console 51 the file download window appears. 4. 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 c...
Page 52
52 chapter 3: installing and upgrading breeze 5. Click finish. The configuration complete screen appears. At this point you can do the following: ■ log in to breeze ■ return to the console to change the breeze configuration. ■ view the online getting started guide. Application settings summary the a...
Page 53
Starting and stopping breeze components 53 completing a terminated installation if the installer terminates during the installation of any breeze component that includes the embedded database engine, use the following procedure to complete the installation. Note: if you were installing breeze and th...
Page 54
54 chapter 3: installing and upgrading breeze to start breeze meeting: 1. Select start > programs > macromedia breeze > start breeze meeting server. 2. To verify that the following services are running, select start > settings > control panel > administrative tools > services. Confirm that the follo...
Page 55
Macromedia online forums 55 breeze technical support for security and privacy reasons, breeze product support cannot assist breeze meeting customers in gaining access to private meetings, events, or seminars. Only the meeting manager or breeze administrator can register users or grant access to meet...
Page 56
56 chapter 3: installing and upgrading breeze.
Page 57: Chapter 4
57 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 you...
Page 58
58 chapter 4: post-installation • 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. • are you adding a s...
Page 59
Deploying breeze to your organization 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 multipl...
Page 60
60 chapter 4: post-installation • 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 44...
Page 61
Implementing single sign-on 61 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 authenticatio...
Page 62
62 chapter 4: post-installation 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 ...
Page 63
Configuring the breeze directory service integration 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...
Page 64
64 chapter 4: post-installation 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 ap...
Page 65
Configuring the breeze directory service integration 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 organiz...
Page 66
66 chapter 4: post-installation the following table describes the field names in the user profile mapping screen: the required fields are: login, first name, last name, and email. If you have defined any custom fields (breeze administration > users and groups > customize user profile), these fields ...
Page 67
Configuring the breeze directory service integration 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 dire...
Page 68
68 chapter 4: post-installation 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 provi...
Page 69
Configuring the breeze directory service integration 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 grou...
Page 70
70 chapter 4: post-installation 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 adm...
Page 71
Configuring the breeze directory service integration 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 ass...
Page 72
72 chapter 4: post-installation 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 ...
Page 73
Configuring the breeze directory service integration 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. P...
Page 74
74 chapter 4: post-installation synchronization events and details the following table describes the events found in the synchronization log files: event description detail add principal added to breeze abbreviated xml packet that describes the updated fields. A series of value. The parent node and ...
Page 75
Configuring the breeze directory service integration 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 externa...
Page 76
76 chapter 4: post-installation 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 ...
Page 77
Configuring ssl support for breeze 77 user authentication organizations need to authenticate users of applications such as email. The following strategies use the breeze authentication mechanism to validate users: • no external authentication integration breeze users keep separate passwords. Applica...
Page 78
78 chapter 4: post-installation 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 nee...
Page 79
Configuring fcs for ssl 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 • sslci...
Page 80
80 chapter 4: post-installation 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. For...
Page 81
Configuring fcs for ssl 81 to configure fcs manually: 1. Stop all breeze services. 2. Open the adaptor.Xml file by using a text editor such as notepad. 3. Make a backup of the current adaptor.Xml configuration file by saving it as adaptor.Bak. 4. Search for the ssl> tag where the ssl schema is locat...
Page 82
82 chapter 4: post-installation implementing ssl-enabled breeze with an accelerator to implement breeze with an ssl-enabled accelerator, the following resources are required: • two external ip addresses and one internal ip address. • one nic card. • breeze server is configured to listen on port 443 ...
Page 83
Configuring fcs for ssl 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 set admin_host as shown in the following exampl...
Page 84
84 chapter 4: post-installation setting up the ssl hardware accelerator you perform the following tasks on the ssl hardware accelerator: • configure ssl certificate a and b to send the unencrypted data to the breeze ip address (breeze server) listening on port 443. In the preceding example, these ar...
Page 85
Configuring a breeze server cluster 85 5. Set up a fully-qualified client-visible domain name service (dns) name (the direct name) that routes traffic directly to breeze server. ■ the direct name for each breeze server in the cluster should route traffic to ports 80, 443, and 1935 to the correspondi...
Page 86
86 chapter 4: post-installation 3. Stop breeze server on computer2. Select start > programs > macromedia > macromedia breeze 5 > stop breeze server. 4. 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 h...
Page 87
Maintaining breeze reliability 87 4. Upload a jpeg image or other content to breeze server on computer1: a 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. As a...
Page 88
88 chapter 4: post-installation changing the breeze password the password for breeze server allows access to the breeze database. For the integrity of your system security, change the default password if you’re using the breeze database. Note: microsoft sql server 2000 users usually already have a p...
Page 89
Maintaining breeze reliability 89 • establish a system for overwriting backups, reusing the oldest backups first. • use expiration dates on backups to prevent premature overwriting. • label backup media to prevent overwriting critical backups. This allows for easy identification of the data stored o...
Page 90
90 chapter 4: post-installation backing up your breeze files you should create backups of the breeze configuration files and the breeze content folder: • back up the custom.Ini found in the breeze directory • back up the two config.Ini files found in: ■ c:\breeze\appserv\conf ■ c:\breeze\comserv\con...
Page 91: Chapter 5
91 chapter 5 verifying your installation after you install and configure macromedia breeze, verify that the installation was successful and that all features are functional. To verify a successful breeze installation: 1. Verify that the breeze database and breeze server work together (see “verifying...
Page 92
92 chapter 5: verifying your installation verifying that the breeze database and breeze server work together if you can log in to breeze manager (a web application within breeze server), the breeze database and breeze server can function together. To verify that the breeze database and breeze server...
Page 93
Verifying that you can use breeze manager and send e-mail notifications 93 3. Click new user. The new user information page appears and requires the following information: ■ first name ■ last name ■ e-mail ■ login (the new user’s e-mail address is usually his login name) ■ password (must be between ...
Page 94
94 chapter 5: verifying your installation in addition to the "getting started" guide, we recommend you visit the following resources to learn more about using macromedia breeze: macromedia breeze resource center (tutorials, best practices, and other resources): http://www.Macromedia.Com/resources/br...
Page 95
Verifying that you can use breeze meeting 95 7. When the compilation is complete, go to the content tab in breeze manager and search for your presentation. 8. Open your presentation to view it. Verifying that you can use breeze training to verify that breeze training is functional, go to the trainin...
Page 96
96 chapter 5: verifying your installation 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 gro...
Page 97: Index
97 index a accelerator hardware setup for ssl 84 adaptor.Xml file 78 application management console 43–52 configuring database settings 44 database creation confirmation 45 unsupported upgrades 46 upgrade confirmation 45 upgrade in progress 47 b backing up the breeze database 88 bandwidth calculatin...
Page 98
98 index directory service integration 62–77 configuring 62–71 connection settings 63 define the deletion policies 76 define the password policies 75 defining synchronization actions 70 events in synchronization log file 74 log file format 73 mapping breeze group profile 68 mapping breeze user profi...
Page 99
Index 99 backing up breeze files 90 backing up the breeze database 88 backups 88 best practices 21 breeze server 17 changing password 88 database server 17 infrastructure 16 network 16 planning 15 resources and references 22 single-server breeze 18 system 20 security considerations 15 server.Xml fil...
Page 100
100 index.