Quick Installation and Deployment Guide for
Broadcast Agent Publisher
Quick Installation and Deployment Guide for
Broadcast Agent Publisher
2 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Copyright
Trademarks
Use restrictions
Patents
Copyright © 2004 Business Objects. All rights reserved.
If you find any problems with this documentation, please report them to Business Objects in
writing at documentation@businessobjects.com.
Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise are
trademarks or registered trademarks of Business Objects SA or its affiliated companies in the
United States and other countries. All other names mentioned herein may be trademarks of
their respective owners.
Contains IBM Runtime Environment for AIX(R), Java(TM) 2 Technology Edition Runtime
Modules (c) Copyright IBM Corporation 1999, 2000. All Rights Reserved.
Contains ICU libraries (c) 1995-2003 International Business Machines Corporation and others.
All rights reserved.
This software and documentation is commercial computer software under Federal Acquisition
regulations, and is provided only under the Restricted Rights of the Federal Acquisition
Regulations applicable to commercial computer software provided at private expense. The use,
duplication, or disclosure by the U.S. Government is subject to restrictions set forth in
subdivision (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-
7013.
Business Objects owns the following U.S. patents, which may cover products that are offered
and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2, 6,490,593 and
6,289,352.
Overview
This guide is a checklist of the steps required to quickly install and deploy
Broadcast Agent Publisher on Windows and UNIX.
It does not describe how to install other Business Objects components, nor does
it describe how to set up your repository and universes.
There are a number of prerequisites that must be installed on client and server
machines before you begin installation of Broadcast Agent Publisher. Please
read this Quick Installation guide before you begin installation.
For detailed information on installing and deploying Broadcast Agent Publisher,
refer to the Broadcast Agent Publisher Installation and Deployment Guide.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 3
4 Quick Installation and Deployment Guide for Broadcast Agent Publisher
General system requirements
Platforms
BCA Publisher is supported on Windows and UNIX. The following components
are not available on UNIX:
• BCA Publisher Addin
• Demo Kit
• Recipient Manager
• Repository Manager
For information about which versions of each platform are supported, refer to the
Product Availability Report (PAR).
Databases
The database middleware required for Broadcast Agent Publisher to access the
Business Objects repository must be installed on the same machine as the
Broadcast Agent Publisher Recipient Manager, the InfoView E service, and the
BCA Publisher Addin.
Refer to the Business Objects
Business Objects
The current version of Broadcast Agent Publisher supports:
• Oracle
• Microsoft SQL Server
• IBM DB2 UDB
• Sybase ASE (Adaptive Server Enterprise)
For information about which versions of each database are supported, refer to
the PAR.
Deployment Guide for more information.
Installation and Configuration Guide and the
MDAC
All databases require Microsoft Data Access Components. These provide the
necessary database drivers.
For all databases, the user account that is used to create the Broadcast Agent
Publisher tables in the repository must also have the rights to create database
objects, namely:
• tables
• views
• stored procedures
Quick Installation and Deployment Guide for Broadcast Agent Publisher 5
Your email server configuration depends on the mailing system you want to use
to broadcast publications.
Microsoft Exchange
To use the SMAPI mailer component with Microsoft Exchange as your mailing
system, you must:
• Install Microsoft Outlook on the same machine as Recipient Manager.
• Define an Exchange profile to be used in Recipient Manager.
• Install Microsoft Outlook on each cluster node that may be used for
broadcasting.
• Define an Exchange profile with the same name as defined above to be used
on every cluster node.
This profile must use the same Windows account as the one that identifies the
BusObj.exe Automation Server on the cluster nodes. (You can find this using
the Service Parameters in the Configuration tool.)
CDO Component for Microsoft Exchange
To collect email addresses using Microsoft Exchange, you must have the CDO
(Collaboration Data Objects) component installed. CDO is a scripting interface
that enables Recipient Manager to communicate with Exchange.
If you are using Windows 2000, you may find that you need to re-install the
component on your computer.
Lotus Domino
To use the Domino mailer component with Lotus Domino as your mailing system,
you must:
• Install Lotus Notes on the same machine as Recipient Manager.
• Define a Domino profile to be used in Recipient Manager.
• Install Lotus Notes with a valid user on each cluster node that may be used
for broadcasting.
The Notes user you use on the machine running Recipient Manager does not
need to be the same as the user defined on the nodes that execute the
publications. A valid user is sufficient., however, Business Objects recommends
you use the same user to simplify your deployment.
General system requirements
6 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Business Objects Prerequisites
Broadcast Agent Publisher 6.5 requires BusinessObjects6.5 and
WebIntelligence 6.5.
An administrator of Broadcast Agent Publisher must have the following Business
Objects components installed. This is a minimum requirement:
Administration products
• Designer
• Supervisor
• Configuration Tool
• Administration Console
• Broadcast Agent Console
Server products
• Business Objects Server
• InfoView
• WebIntelligence
• Broadcast Agent Scheduler
Desktop products
• BusinessObjects
Quick Installation and Deployment Guide for Broadcast Agent Publisher 7
Windows and UNIX Prerequisites
Windows
Before you can install Broadcast Agent Publisher on Windows you must install:
• Windows Scripting
• Microsoft XML parser
These are available on the Broadcast Agent Publisher installation CD.
• MDAC
UNIX
Before you can install Broadcast Agent Publisher on UNIX, you must have
installed:
• The JDBC drivers appropriate for your database platform.
Refer to your database documentation for more information.
• Tomcat or another application server.
Refer to the WebIntelligence Administrator’s Guide and Installing and
Configuring Application Servers for more information.
• JDK
You can download this from http://java.sun.com
Additional requirements:
• Business Objects recommends using the BASH shell
• JAVA_HOME must be set as an environment variable as shown in this
example: export JAVA_HOME=/usr/u/qaunix/jdk1.4.2
Windows and UNIX Prerequisites
8 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Broadcast Agent Publisher components
The following is a list of the Broadcast Agent Publisher components in the order
in which they appear in the installation wizard:
• BCA Publisher Addin
• Demo Kits
• InfoView E Service
• Online Guides
• Recipient Manager
• Repository Manager
• InfoView E web site
• Publication Manager
The following components are not displayed in the wizard. You install them using
the Repository Manager:
• The Broadcast Agent Publisher tables
• Broadcast Agent Publisher universe and document
• A bomain.mkey file
Prerequisites for the components
BCA Publisher Addin
The BCA Publisher Addin must be installed on all Broadcast Agent nodes on
which the BOManager is enabled for batch processing.
All servers on which the addin is installed must also have the following installed:
• Broadcast Agent
• prerequisites,
InfoView E Service
For a Windows installation, the InfoView E Service requires the standard
prerequisites.
For a UNIX installation, the InfoView E Service does not require any of the
prerequisites listed above for Windows. Instead, it requires the following:
• JDK
• The appropriate JDBC driver for the repository platform
Quick Installation and Deployment Guide for Broadcast Agent Publisher 9
HTML storage service
The HTML storage service is part of the InfoView E service, and should be
installed as follows:
• If you are upgrading from a previous version of Broadcast Agent Publisher,
install it on your web server, because this is where the HTML is stored.
• If your Broadcast Agent Publisher deployment is in an extranet environment,
this service should be installed inside the firewall for security reasons.
Business Objects strongly recommends deploying your extranet inside a
firewall.
• If you are installing for the first time, and are not using an extranet
deployment, there are no restrictions for where you can install it.
By default, the HTML storage service is installed as part of the InfoView E
service.
Recipient Manager
Broadcast Agent Publisher Recipient Manager must be installed on a Windows
machine that already has BusinessObjects installed, as it uses the
BusinessObjects login.
Repository Manager
Broadcast Agent Publisher Repository Manager must be installed on a Windows
machine that already has the following Business Objects products installed:
• BusinessObjects, to enable Repository Manager to export the Broadcast
Agent Publisher document
• Designer, to enable Repository Manager to export the Broadcast Agent
Publisher universe
InfoView E web site
The InfoView E web site is available in both ASP and JSP. It can be installed in
either a stand-alone or a clustered environment. If it is installed in a clustered
environment, typically it is installed on all cluster nodes. Each node on which it is
installed must also have the following installed:
ASP:
• IIS (for supported versions, refer to the PAR)
• Windows prerequisites
Broadcast Agent Publisher components
10 Quick Installation and Deployment Guide for Broadcast Agent Publisher
JSP:
• an HTTP server
• an application server
• JDK
• prerequisites
Additional requirements for Windows JSP:
• Set the CATALINA_HOME environment variable to c:\tomcat for example
• Set the JAVA_HOME environment variable to c:\jdk for example
• Open http.conf in apache/conf folder and at the end of these files add:
- JkMount /BCAPublisher/* ajp13
- JkMount /BCAPublisherWILink/* ajp13
Both ASP and JSP versions require:
• Microsoft Internet Explorer (refer to the PAR for version information)
• Sun JVM
For a UNIX installation, the storage service requires the following:
• JDK
• The appropriate JDBC driver for the repository platform
Supervisor
NOTE
You use the Administration Setup wizard in Supervisor to create repositories and
define supervisors who are authorized to create users and to control their access
to the repository’s domains and resources.
A repository connection in Supervisor is defined in a .key file. You must define
a repository connection before installing Broadcast Agent Publisher.
Use Repository Manager to connect to a repository, creating an .mkey file. The
.mkey is an encrypted file that provides a database connection string to the
repository; the .mkey file takes the same name as the .key file you selected,
and is stored in the following directory:
$INSTALLDIR\broadcast agent publisher\Shared\LocData
Publication Manager
Publication Manager is availale in both ASP and JSP. In addition to the
rezrequisites listed for the InfoView E website, it must be installed on the same
server as InfoView.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 11
Pre-installation checklist
Before you install Broadcast Agent Publisher ensure that:
• your system meets the necessary hardware and software requirements.
• you have access to an administrator account on each server where you want
to install Broadcast Agent Publisher.
• the prerequisites are installed on each server. Servers may have different
requirements, depending on where you install the Broadcast Agent Publisher
components.
• Microsoft CDO is correctly installed.
• a Business Objects repository is installed, and is accessible from each server.
• you have installed and configured the database middleware required to
connect to the repository.
• Broadcast Agent and WebIntelligence are installed and working, and that you
have one—and only one—node configured.
• you have uninstalled any previous versions of Broadcast Agent Publisher.
• If you intend to use Broadcast Agent Publisher for broadcasting emails, your
email server(s) and client(s) are installed and configured.
• your web server software is installed and configured.
Refer to the Product Availability Report (PAR) for more information on
supported web server versions.
• you have a valid Broadcast Agent Publisher license key.
• you have General Supervisor rights.
• you have created a backup of your repository.
Pre-installation checklist
12 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Installation
To begin installation of Broadcast Agent Publisher:
• Log in using the Windows user account that you used to install
BusinessObjects.
• Stop WebIntelligence.
• Ensure the Microsoft Services window is not open on your desktop.
• Insert the Broadcast Agent Publisher CD
You install and configure Broadcast Agent Publisher in a series of steps that are
described in the next sections of the guide. Refer to the individual procedures for
each step of the installation:
• Installing from the CD
• Creating the database tables
• Creating the BCA Publisher group in Supervisor
• Selecting and publication and exporting method
• Selecting the universe connection
• Publishing the universe and documents
• Setting the global and host parameters
• Configuring Windows authentication
• Starting the services
Windows installation
To begin the installation of Broadcast Agent Publisher:
1. Double click the file setup.exe.
2. Select the language you require, then Click OK.
The instructions that follow are for the English language version of the
installation process.
The Broadcast Agent Publisher Installation Wizard appears:
3. Click Next.
The Business Objects license agreement appears
4. Select I accept the license agreement then click Next.
5. In the next window click Change to locate the folder that contains your
Business Objects license key.
6. Locate your license key folder and click OK.
7. In the Broadcast Agent Publisher Setup dialog box click Next.
The Broadcast Agent Publisher Setup dialog box is displayed.
In the next steps you select the Broadcast Agent Publisher components that you
want to install..
Quick Installation and Deployment Guide for Broadcast Agent Publisher 13
1. Select the components.
2. Click Browse to change the installation location if required, then click Next to
Windows installation
14 Quick Installation and Deployment Guide for Broadcast Agent Publisher
continue to the Select Deployment dialog box.
3. Select the type of deployment, either ASP or JSP.
4. If you want to modify the virtual directory and/or the port, select the option(s).
If your Business Objects server is not installed with the default wiasp or wijsp,
use this option.
5. In the box that appears in the dialog, enter the virtual directory and the port
number.
6. Click Next.
The Updating System window displays the progress of the installation.
The installation is complete.
7. Click Finish.
NOTE
You must restart your computer after installation.
Once Broadcast Agent Publisher has been successfully installed, the name of
the application appears on the Windows menu under Broadcast Agent Publisher.
UNIX Installation
Before you begin your installation of Broadcast Agent Publisher on UNIX:
1. Set JAVA_HOME as an environment variable. For example:
export JAVA_HOME=/usr/u/qaunix/jdk1.4.2
2. Upload the setup program to UNIX.
When you do so, ensure that the transfer type is set to binary.
3. Log into UNIX.
4. Change directory to the location of the setup program by typing:
cd /publisher
NOTE
We recommend using the BASH shell to execute the commands described in this
section.
5. Ensure that the setup program has execute rights using the following
command:
chmod +x setup.bin
To being your installation of Broadcast Agent Publisher on UNIX:
1. Run the UNIX installer by typing:
./setup.bin
The license agreement is displayed.
2. Enter yes to accept the terms.
3. Enter the path to your Business Objects installation directory. For example:
/bo6
The setup program uses this information to determine the location of the
nodes folder. Broadcast Agent Publisher files that are generated as part of
the installation process are created in the bcap folder.
4. Enter your cluster name. For example:
mycluster
The setup program uses this to determine which orb configuration file to use.
5. Enter the classpath for your JDBC driver. For example:
/new/BD/oracle/product/9.2.0/jdbc/lib/classes12.jar
This is the classpath for the JDBC driver to connect to the Broadcast Agent
Quick Installation and Deployment Guide for Broadcast Agent Publisher 15
UNIX Installation
16 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Publisher repository.
6. Enter the location of the .war files.
The default location is /appservers/tomcat/webapps
NOTE
This is the webapps folder for your application server. For other application
servers the webapps folder may be different.
The installation process unzips the war files, incorporates the configuration
information you entered, re-creates the war files, and deploys them to the
location you specified.
The next steps in the installation process require configuring the connection to
the Broadcast Agent Publisher repository and establishing a connection to the
database.
1. Configure the connection for the Broadcast Agent Publisher repository by
running the bcap_mkey shell script from the bcap folder within your Business
Objects installation folder, as follows:
cd /bo6/bcap
./bcap_mkey.sh
2. Enter the classname of the JDBC driver. The table below gives some
examples.
Database type Example classname
Oracle oracle.jdbc.driver.OracleDriver
SQL*Server com.microsoft.jdbc.sqlserver.SQLServerDriver
IBM DB2 com.ibm.db2.jdbc.app.DB2Driver
Sybase com.sybase.jdbc.SybDriver
Quick Installation and Deployment Guide for Broadcast Agent Publisher 17
3. Enter the connection URL for your Broadcast Agent Publisher repository. ..
Database type Example URLs
Oracle
jdbc:oracle:thin:<user>/
<password>@<hostname>:<port>:<ser
vicename>
SQL*Server jdbc:microsoft:sqlserver://
<server>:1433;User=<user>;Password=<password>;DatabaseName=<database>;SelectMethod=curs
or
IBM DB2 jdbc:db2:yourdatabase
Sybase jdbc:sybase:tds:<hostname>:<port>
/<database>
If you are using IBM DB2, enter your username and password for the
Business Objects repository.
If you are using another database, these fields are not required. Press Enter
to skip to the next step
4. At the prompt, enter Yes to test your database connection.
If your connection details are incorrect, you can re-run the bcap_mkey.sh
script from the bcap folder of your Business Objects installation.
If you specified an incorrect path for your JDBC driver, you must edit the
bcap_env.sh script in the bcap folder.
The installation is now complete.
UNIX Installation
18 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Creating the Broadcast Agent Publisher tables
The Broadcast Agent Publisher tables contain all the Broadcast Agent Publisherspecific information. To create these tables, you use the Windows-based
Broadcast Agent Publisher Repository Manager.
Before you create your Broadcast Agent Publisher tables, you must ensure that:
• Repository Manager is installed on the computer you are using.
• You have general supervisor login rights.
• You know the location of the Business Objects repository and how to connect
to it.
To create the Broadcast Agent Publisher tables:
1. Select Start > Programs > Business Objects > Broadcast Agent Publisher >
Repository Manager.
2. In the Repository Manager login window, enter your BusinessObjects user
name and password.
You must have a general supervisor profile to create the Broadcast Agent
Publisher tables.
3. Select the domain you want to access.
When you use the wizard, you create an .mkey file that enables Broadcast
Agent Publisher to access the repository. The .mkey files are stored in
$INSTALLDIR\broacast agent publisher\Shared\LocData
4. Click OK.
Step 1 of the Repository Management wizard appears:
This window describes the main steps you can perform using the wizard.
5. Click Begin.
Step 2 of the wizard appears. In this window you define the database type.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 19
The name of the .mkey file used for this connection is shown, if created. This
variation of the bomain.key is used to connect to the repository.
This field is blank if:
• You have not yet created the .mkey file for the repository connection (.key
file) you chose in the Login window.
• Changes have been made to the corresponding .key file in Supervisor since
you created the .mkey file.
If this is the case, you must use this wizard to create a new .mkey file to
match the updated .key file.
Defining the database
This part of the wizard allows you to define a connection to the database in which
the wizard creates the Broadcast Agent Publisher tables.
1. Select the type of database you want to use from the drop-down list.
This must be the same type of database that you have used to create your
Business Objects repository, and can be:
- Oracle
- Microsoft SQL Server
- IBM CAE 7.1 (DB2)
- Sybase
2. Perform the connection procedure appropriate to your database.
Creating the Broadcast Agent Publisher tables
20 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Testing the connection
1. In the Repository Connection window, click Test to check that the connection
with the server on which the Business Objects repository resides is working.
If the connection is working, a status message displays information about the
repositories found.
If the connection is not valid, an error message appears. You must correct the
connection before proceeding.
2. Click OK to return to the Repository Connection window, and OK again to
return to the Repository Management wizard.
3. Click Next.
The wizard is now ready to create the Broadcast Agent Publisher tables.
Creating the tables
Business Objects recommends that you create a backup of your existing
database before you create the database tables. If the table creation process fails
part way through, the easiest course of action for recovering your data is to
restore your backup and re-run this process.
1. Click Next.
- If your database is IBM DB2, you must copy the file BCAPub.jar to the
database server.
- If your database is either Oracle or Microsoft SQL Server, or Sybase, the
Repository Manager starts creating the tables.
Broadcast Agent Publisher creates the .mkey file needed to connect to the
repository, and displays the progress of the script that is executed to create
the Broadcast Agent Publisher tables.
NOTE
Once the creation process has begun, you cannot interrupt it.
When the script has finished processing, a window informing you that the tables
have been created successfully.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 21
Installing the BCAPub.jar file for IBM DB2
If your database is IBM DB2, you must install the stored procedures. You can
install the stored procedures manually, via FTP, or via a shared directory.
To be able to create Java stored procedures on IBM DB2, you must first copy the
file BCAPub.jar to a location from which the file can be installed.
Repository Manager will then install the file BCAPub.jar on the database server
using the swlj.install_jap procedure:
call sqlj.install_jar('file:///c:\db2\BCAPub.jar','BCAPub',0)
1. Select Install manually
2. In the Local save path box, enter the URL for the location on this computer to
which the BCAPub.jar file will be extracted.
3. In the Server File URL box, enter the URL for the location from which the
BCAPub.jar file will be installed. This URL can take the following forms:
file:///c:\mydir\ on Windows
file:/mydir/ on UNIX
4. Copy the file from the installation CD to the location on the database server
Creating the Broadcast Agent Publisher tables
22 Quick Installation and Deployment Guide for Broadcast Agent Publisher
that you specified in the previous step.
5. Click OK.
Broadcast Agent Publisher creates the stored procedures.
Once you havesuccessfully created the database repository, you must perform
the following tasks before you can use Broadcast Agent Publisher for the first
time:
• create a dedicated Recipient Manager group in Supervisor
• export a dedicated universe, BCAPub.unv (mail publishing only)
• publish a dedicated document, BCAPub.rep (mail publishing only)
You can perform these tasks either by continuing with the wizard, or by exiting
the wizard and performing them manually. You can also re-run the first four steps
of the wizard once you are using Broadcast Agent Publisher to create the
Broadcast Agent Publisher tables in another domain. To do so, exit the wizard at
this point.
• To leave the wizard at this point, click Finish.
• To continue, click Next.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 23
Creating the Broadcast Agent Publisher group in Supervisor
The next dialog allows you to create automatically in Supervisor the group
required by Broadcast Agent Publisher. You do not need to use the wizard to
create this group; you can create it manually if you prefer. The wizard is provided
because the group requires a specific name and it is case sensitive
NOTE
You must have Supervisor installed on your machine.You must open Supervisor
to verify that the Recipient Manager group has been created. This option only
ensures that the group name is correctly spelled.
• Click Create Broadcast Agent Publisher group to create the group
automatically.
The wizard opens Supervisor, creates the group, and closes Supervisor
again. Click Next to proceed to the next step in the wizard.
Creating the Broadcast Agent Publisher group in Supervisor
24 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Choosing a publishing and exporting method
The Publishing and Exporting window allows you to choose how to publish the
Broadcast Agent Publisher document and export the Broadcast Agent Publisher
universe.
NOTE
You can allow the wizard to automatically publish the document and export the
universe
1. In the Publishing and Exporting section of Repository Manager, select Let the
wizard perform the operations automatically.
2. Click Next to continue.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 25
Selecting the universe connection
In this window you to define the connection from the Broadcast Agent Publisher
universe to the repository.
1. If the connection you require is already displayed in the connection panel,
select it. Check that the Database name shown in the information panel on
the right is correct; it should be the same as the name you entered when you
defined your database in Step 2 of the wizard.
2. If a suitable connection is not shown:
- Define a new connection in Supervisor.
- Click Refresh Connection List in the Broadcast Agent Publisher
Repository Management Wizard to display the new connection in the window
above.
- Click the connection to select it.
3. Click Next.
Selecting the universe connection
26 Quick Installation and Deployment Guide for Broadcast Agent Publisher
NOTE
If you selected a Microsoft SQL Server connection and the name of the database
owner you are using is not dbo, the following dialog appears:
Enter the correct table owner name and click OK.
The wizard checks the structure of the universe using the connection you have
chosen. If the tables have not been created, or if a problem has occurred during
creation, an error message appears and you must choose another connection.
Once the universe structure has been verified, the next step of the wizard
appears.
Quick Installation and Deployment Guide for Broadcast Agent Publisher 27
Publishing the universe and document
This window allows you to specify where you want to export the universe and
publish the document for Broadcast Agent Publisher.
1. Select the universe domain and group name, and the document domain and
group name from the drop-down lists.
The information you select in these fields can be found in the Repository tab
of Supervisor; by selecting them in this window, you identify them for use by
Broadcast Agent Publisher.
The Universe Domain list box refers to the domain name of type Universe. For
example, using the information from Supervisor as shown in the image, you
would select Universe from the Universe Domain list box in the wizard.
The Group Name list box refers to the location within Supervisor in which all
the BusinessObjects account names are stored. The Document Domain list
box refers to the domain name of type Document.
The second Group Name list box allows you to select a different group for
your document domain.
2. Click Finish.
The universe and documents are exported.
Publishing the universe and document
28 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Setting the global and host parameters
In the last window of the Repository Management Wizard, click Parameter
Admin to launch the Parameter Administrator.
To configure system parameters:
1. In the Parameter Administrator, click the + symbol to display the complete list
of all the global parameters and host-specific parameters in the tree structure
on the left.
2. Select a parameter in the tree to see a brief description of its function.
3. Edit the value of the parameter if required.
4. Click Apply to store the changed parameter value.
5. Click Finish when you have completed configuring your system parameters.
To configure host parameters:
1. In the Parameter Administrator, click <Add Host>.
The following appears:
Quick Installation and Deployment Guide for Broadcast Agent Publisher 29
2. Enter the host server name in the Host Name field.
3. Enter the IP address of the host in the IP Address field.
4. Select the server roles for this server to perform.
These are different for each server, according to the server components
installed.
5. Click Add.
Broadcast Agent Publisher adds the host information which is required by
InfoView E and other web publishing web sites.
Setting the global and host parameters
30 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Configuring Windows Authentication
To enable Windows authentication for web component external users, you must:
• Set Windows authentication in Internet Services Manager.
• Set Windows authentication in Recipient Manager.
Setting Windows Authentication in Internet Services Manager
1. From the Windows Start menu and Control Panel, launch Internet Services
Manager. In some versions of Windows you access this window from the
Computer Management window.
2. In the Tree panel, select Default Web Site > BCAPublisher.
A list of files and folders for this web site appears in the right panel:
3. Right-click the file BCAPController.dll and select Properties.
4. Click the File Security tab.
5. Click Edit in the Anonymous access and authentication control section.
6. In the Authentication Methods window, clear the Anonymous access check
Quick Installation and Deployment Guide for Broadcast Agent Publisher 31
box.
This leaves Integrated Windows authentication as the only selected option.
7. Click OK.
You are returned to the Properties window.
8. Click OK again.
Setting Windows Authentication in Recipient Manager
In Recipient Manager, for each external user:
1. Set the Logon Type to Windows.
2. Define the appropriate User Domain.
Configuring Windows Authentication
32 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Starting the Broadcast Agent Publisher services
Before you can use Broadcast Agent Publisher for web publishing, you must start
one or both of two Windows services, depending on your system configuration
and the components installed.
If you have installed on UNIX as well, you must also start a UNIX service.
On Windows
To start the services from your Windows desktop:
1. Select Start > Settings > Control Panel, and double-click Administrative
Tools.
2. Click Services.
A window similar to the following is displayed.
There are two Broadcast Agent Publisher web publishing services:
- BCA Publisher Web Application
- BCA Publisher Web Support
Each computer on which you installed InfoView E has the BCA Publisher Web
On UNIX
Quick Installation and Deployment Guide for Broadcast Agent Publisher 33
Application service.
Each computer on which you installed the BCAP Addin has the BCA
Publisher Web Support service.
If these services are not displayed on your computer, check the installation of
InfoView E and the BCAP Addin.
3. Start both services.
NOTE
Both services need to be running in order to refresh documents for web
publishing and provide InfoView E for users to view their documents.
You can set both services to Automatic in order to start them automatically every
time the system reboots.
For further information about controlling Windows services, see your Microsoft
Windows documentation.
You must run the bcap_mkey.sh from the $INSTALLDIR to complete the
creation of the .mkey file (chmod + x bcap_mkey.sh). Then launch
bcap.sh (chmod + x bcap.sh).
NOTE
You must also ensure that your web and application servers are running.
Starting the Broadcast Agent Publisher services
34 Quick Installation and Deployment Guide for Broadcast Agent Publisher
Loading...