Adobe Contribute 4 ® TM Deploying Contribute and Contribute Publishing Server © 2006 Adobe Systems Incorporated. All rights reserved. ContributeTM 4 Deploying Contribute and Contribute Publishing Server If this guide is distributed with software that includes an end-user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end-user license agreement. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner. Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization. Adobe, the Adobe logo, Breeze, Contribute, Dreamweaver, Flash, Flash Player, JRun, and Reader are trademarks of Adobe Systems Incorporated. Mac OS is a trademark of Apple Computer, Inc., registered in the United States and other countries. Solaris is a trademark or registered trademark of Sun Microsystems, Inc. in the United States and other countries. Windows is either a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. All other trademarks are the property of their respective owners. Opera ® browser Copyright © 1995-2002 Opera Software ASA and its suppliers. All rights reserved. - Patents for product and any other Adobe products on CD, including tryout versions Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA Notice to U.S. government end users. The software and documentation are "Commercial Items," as that term is defined at 48 C.F.R. §2.101, consisting of "Commercial Computer Software" and "Commercial Computer Software Documentation," as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R.. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250 ,and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference. Contents Chapter 1: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Understanding Contribute user management models . . . . . . . . . . . . . . . 5 Common website configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Deployment roles and responsibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Deployment tasks checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Chapter 2: Preparing Your Network and Installing Contribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Preparing your web server before you deploy . . . . . . . . . . . . . . . . . . . . . 17 Planning your Contribute site structure and connection path. . . . . . . 22 Installing Contribute and creating an administrative connection . . . . 30 Installing Contribute Publishing Server (Optional) . . . . . . . . . . . . . . . . 32 Chapter 3: Configuring Contribute and Contribute Publishing Server to work with your website. . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Configuring Contribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Configuring Contribute Publishing Server (CPS only) . . . . . . . . . . . . . 48 Enabling Contribute websites to work with CPS (CPS only) . . . . . . . 55 Adding users to your website (CPS only) . . . . . . . . . . . . . . . . . . . . . . . . .57 Deploying Contribute and website connections . . . . . . . . . . . . . . . . . . 59 Deploying Contribute across an organization . . . . . . . . . . . . . . . . . . . . 63 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 3 4 Contents CHAPTER 1 Overview Adobe® ContributeTM is a website editor that lets people connect to departmental and other websites so that they can update web page content. Administrative assistants, product managers, human resource managers, and other people in an organization can use Contribute to update their team website without having to contact a web team or other departmental resources. For larger organizations, you can optionally use Adobe® ContributeTM Publishing Server (CPS) with Contribute. CPS is a user management and publishing solution that lets Contribute administrators manage large groups of Contribute users and monitor what those users do on the website. This chapter, intended for website administrators and IT professionals, gives you valuable information you need before you deploy Contribute, and optionally CPS, in an organization. It explains the Contribute user management models for using Contribute alone or with CPS, shows scenarios for setting up Contribute in a variety of IT environments, and lists the people and the various tasks involved in successfully deploying Contribute. This chapter contains the following sections: · · · · "Understanding Contribute user management models" on page 5 "Common website configurations" on page 9 "Deployment roles and responsibilities" on page 14 "Deployment tasks checklist" on page 15 Understanding Contribute user management models User management lets you add and remove user access to websites and create user roles that restrict editing privileges in a site. User management also provides a mechanism that lets users easily connect to a website. Contribute has two user management models: manual site connections using Contribute only and managed site connections using Contribute plus the CPS User Directory service. Manual connections let you communicate connection information to users, who then create their own connections, either by entering connection information in the Connection Wizard or by importing a connection-key file that you give them. 5 This user model works best for smaller workgroups and organizations. It allows you to quickly set up Contribute, create a connection to your website, define the necessary user roles, generate connection information for the website connection and user role, and send the information to users in the form of a connection-key file. Managed connections lets you use CPS to integrate Contribute with your organization's LDAP or Active Directory services, letting you add and remove user access to a website and modify user roles without having to resend connection-key files to users. You can also create a file-based database, using an XML file to manually enter user names and passwords. CPS is intended for larger organizations that have several Contribute users to manage. CPS lets you add and remove users from websites and roles without having to resend connection information. When you create a connection to a website that uses CPS, you add users to a list that grants access to a given website and user role. When users access the website, CPS prompts them for a user name and password. After they enter their user name and password, they are granted access to the website and the role you've assigned to them. To use CPS, you must have a J2EE application server such as Adobe® JRunTM 4.5 installed. To learn about other CPS functionality, see "Using Contribute Publishing Server with Contribute" on page 6. For more information about getting CPS for your organization, see the CPS website at www.adobe.com/products/contribute/server/. Using Contribute Publishing Server with Contribute Using Contribute Publishing Server (CPS) with Contribute creates a powerful solution for managing and maintaining your website. CPS is a J2EE-based server application that lets you centrally manage large groups of Contribute users. CPS includes the following services: User Directory service is a user management solution that lets you integrate Contribute with your organization's user directory to easily manage and authenticate users. lets you automatically notify users about changes to web pages in E-mail Notification service the draft review process. Log service lets you monitor website activity so that you can easily troubleshoot problems. enables you to easily move files from a staging or testing CPS also has two other services that you can extend to meet your needs or use as they are: Simple File Deployment service server to a live server. RSS Activity Feed service produces a syndication feed that lists changes that occur in any folder on your website. The biggest advantage to using CPS is the ability to integrate your organization's user directory services (such as LDAP or Active Directory) with Contribute. This gives you individual control over which user is granted access to a particular website and the role to which they are assigned. 6 Overview Consider a large organization with several decentralized websites. In addition to a public-facing site that provides information about the organization, several internal sites are in use by individual departments and workgroups. The organization uses LDAP as both a directory service that lets users look up other employees as well as an authentication service through which administrators set permissions that limit users' access to file-sharing servers and other network resources. Unlike sites that don't use CPS to manage users, when a user logs in to a CPS website, the User Directory service retrieves the connection information associated with that user, and provides access to the sites that the administrator assigned. By maintaining site connection information in the User Directory, administrators can add or remove access to websites without having to resend connection information. This example provides a partial listing of employees from an organization's user directory. The employees, their workgroup affiliations, and the sites they can access are listed in the following table: User John Lydon Malcolm McClaren Martin Atkins Keith Levine John Savage Laura Logic Jah Wobble Workgroup Product Management Product Management Marketing Sales Production Web Design Contribute Administrator Websites Sales, Production, Marketing Sales, Production, Marketing Marketing Sales Production Sales, Production, Marketing Sales, Production, Marketing Although this user list is oversimplified, it demonstrates one possible scenario for the way that users within an organization might be assigned access to websites. This scenario divides users according to their role within the organization, and assumes that they have full editing and publishing privileges in their respective sites. Certain users have access to all the sites. For example, the product managers, John Lydon and Malcolm McClaren, work with all the teams in developing and launching products, and need to contribute to all the sites. Likewise, web designer Laura Logic and Contribute administrator Jah Wobble have access to all sites. As the web designer, Laura provides templates that are easy to add content to and that fit the needs of users collaborating internally. The templates she maintains include those for taking meeting minutes, for scheduling, and for providing product specifications, marketing launch plans, and sales projections, to name a few. Laura ...