Summary of Contents for Adobe 65015459 - Contribute CS4
Page 1
DEPLOYING CONTRIBUTE AND CONTRIBUTE PUBLISHING SERVER...
Page 2
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 Incor- porated.
Chapter 1: Overview Adobe® Contribute® CS3 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.
Page 5
To use CPS, you must have a J2EE application server such as Adobe® JRun™ 4 installed. To learn about other CPS functionality, see “Using Contribute Publishing Server with Contribute” on page 2. For more information about getting CPS for your organization, see the CPS website at www.adobe.com/products/contribute/server/.
Page 6
ADOBE CONTRIBUTE CS3 User Guide 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.
ADOBE CONTRIBUTE CS3 User Guide Common website configurations Before you deploy Contribute, consider various scenarios for setting up Contribute for large or multi-team organi- zations. This section describes three primary configurations for you to consider as you set up a Contribute site.
Page 8
ADOBE CONTRIBUTE CS3 User Guide It is important that the Templates folder, which is located at the same level as the Contribute shared settings folder (_mm), is accessible by all users, and the site’s CSS (CSS folder), and server side includes (SSI folder) are protected by role settings that restrict access to those folders.
Page 9
ADOBE CONTRIBUTE CS3 User Guide Users can browse the entire site but are restricted to editing in their department’s folder. By restricting user’s editing privileges to their department’s web pages, each group can maintain control over their web content and can act more independently with the content they make available to the entire organization.
Page 10
ADOBE CONTRIBUTE CS3 User Guide By configuring Contribute to work with content on your staging server, you can provide an extra measure of security by not copying Contribute’s administrative files and folders to your production server. This also lets you eliminate the presence of unnecessary files from a server with public access.
These roles vary from organization to organization. In smaller organizations and workgroups, a single person may handle the job of administering Contribute and determining the design of the website. Larger workgroups and departments may have a team of people involved in maintaining their website. ADOBE CONTRIBUTE CS3 User Guide...
Configure the log file and e-mail settings that CPS should use. You can configure mail services (optional) these CPS services now, or you can do it later. For more information, see “Configuring Contribute Publishing Server (CPS only)” on page 37. ADOBE CONTRIBUTE CS3 User Guide...
Page 13
46. In addition to the basic tasks described in the preceding table, you can further enhance your website by designing it to be more easily maintainable or by adding additional functionality by using CPS. ADOBE CONTRIBUTE CS3 User Guide...
Chapter 2: Setting up your Contribute Server Environment After you have given some consideration to what is involved in deploying Adobe® Contribute® and Contribute Publishing Server (CPS), you are ready to begin. First you need to prepare your network, then you can install the software.
Page 15
In particular, you might want to block HTTP access to the MMWIP folder. The MMWIP folder contains interim drafts of files (works in progress) that you might want to protect. Adobe recommends that you restrict access to the MMWIP folder so that only members of your organization can browse files in that folder.
Page 16
ADOBE CONTRIBUTE CS3 User Guide If you’re not sure how to edit the Apache httpd.conf file or don’t have permission to do so, ask your system admin- istrator or Internet service provider (ISP) to do it for you. To learn more about limiting access to files and folders, and other security issues relevant to the Apache web server, see the documentation supplied with your Apache distri- bution.
Page 17
ADOBE CONTRIBUTE CS3 User Guide The following figure shows an example of a file sent for review, and the files and folders that are created when you send a user of your website a page for review. This figure shows the main folders and files that are created when you enable the draft review process for a given site and a user sends a page for review.
Or, you can establish a connection to a lower-level folder, depending on the access you and your users require. Adobe recommends that you create a connection at the root of your website (www.mysite.com/intranet/, for example), and use the Contribute Permissions settings to limit user access to specific folders in the site.
Page 19
In this case, the connection paths overlap, and the second connection is a child website of the first connection, which is the parent website. Adobe recommends that, if you create child sites, you make any users who are connected to a parent site, also connect to any child sites.
Page 20
Writer group for the marketing website. In this case, the marketing Writer group would not receive the draft from User 1. Reviewers might not be able to take action on a draft. Now, consider the following website connections: ADOBE CONTRIBUTE CS3 User Guide...
Page 21
If you cannot connect to the server, make certain you are using a fully qualified path. To learn how to check your server’s network and folder permissions, see the documentation supplied with your server operating system. ADOBE CONTRIBUTE CS3 User Guide...
Page 22
If you will use FTP to connect to a website, Adobe recommends that you use SFTP. In addition to providing a secure connection when you transfer files to and from Contribute and your website, SFTP is a more reliable connection protocol.
Page 23
ADOBE CONTRIBUTE CS3 User Guide FTP and SFTP file permissions Typically, FTP servers are configured so that when they create (or write) a new file, the permissions created for the file give the person uploading the file read/write permission and give members in the permission group read-only access.
The user name and e-mail address identify users and the web pages they are working on. Contribute prevents multiple users from simultaneously editing the same web page. (Contribute uses a system much like the Dream- weaver check in/check out system to avoid editing conflicts.) ADOBE CONTRIBUTE CS3 User Guide...
Select Edit > My Connections (Windows) or Contribute > My Connections (Macintosh). The My Connections dialog box appears. The options in this dialog box let you create and manage your Contribute connections. Click Create. The Connection Wizard (Windows) or Connection Assistant (Macintosh) appears. ADOBE CONTRIBUTE CS3 User Guide...
Contribute Publishing Server (CPS) is a J2EE web application that you can install as a Web Application Archive (WAR) file onto any supported Java Application Server. You can install CPS as an integrated Java application server that includes Adobe® JRun™ 4.0, or as a WAR file that you deploy onto an existing Java application server.
Page 27
At the command prompt, enter the following command to set execute permissions for the JRun installation shell script: chmod +x cps-linux.bin Note: If you are installing on the Solaris™ platform, substitute Enter the following command to run the JRun installation script: sh ./cps-linux.bin in the command. solaris linux ADOBE CONTRIBUTE CS3 User Guide...
Page 28
Note: If your platform doesn’t have an installer, and you need to perform the WAR File Installation but do not have a Java application server, you can download a trial version of the JRun 4 server with limited licensing capabilities. For more information, see the Adobe website at www.adobe.com. The WAR File installation process involves the following steps: Generate the WAR file.
Page 29
For information, see “Deploying the WAR file” on page 26. Deploying the WAR file After you have the WAR file, you are ready to deploy it to your J2EE application server. in the command. solaris linux in the command. solaris linux ADOBE CONTRIBUTE CS3 User Guide...
Page 30
The JRun Administration Console appears in your web browser. Enter the JRun administrator’s user name and password. Expand the Default server icon in the left pane, and then click the J2EE Components icon. Click Add on the Web Applications panel. ADOBE CONTRIBUTE CS3 User Guide...
Page 31
Deploying CPS on JBoss (Macintosh) application servers JBoss is an open source, Java-based application server commonly deployed on Macintosh OS X servers. Adobe recommends that you manually expand the pubserver.war file in the installation folder, and copy the expanded WAR file to the folder: <JBoss_home>/server/default/deploy.
Page 32
3 to store user and connection to indicate where you want to store CPS error and output logs. script in a terminal window. variables with the domain name (or IP address) of your server, and the ADOBE CONTRIBUTE CS3 User Guide...
Page 33
For information, see “Configuring Contribute Publishing Server (CPS only)” on page 37. to indicate where you want to store user and connection infor- to indicate where you want to store CPS error and output logs. ADOBE CONTRIBUTE CS3 User Guide...
Chapter 3: Configuring Contribute After you install Adobe® Contribute® and connect to your website (see “Setting up your Contribute Server Environment” on page 11), you are ready to configure Contribute and Contribute Publishing Server (CPS) to meet your needs. If you are using CPS, you need to enable your website to work with the server and add users to the server. Finally, you can deploy Contribute to your user and give them website connection information.
Page 35
If prompted, enter the Administrator password, and then click OK. Assigning an administrator to a site and assigning a password for the administrative account are optional. For more information about becoming an administrator, see Contribute Help. ADOBE CONTRIBUTE CS3 User Guide...
ADOBE CONTRIBUTE CS3 User Guide The Administer Website dialog box appears. Select the administrative settings category you want to modify from the list on the left side of the dialog box. Click the Help button in the dialog or see Using and Administering Contribute for information about options in this...
Page 37
Shared Assets from Adobe library items) that users can add to web pages. You can restrict access to shared assets to specific users or let any Contribute user accessing the website add the assets to their pages. For more information about setting options for shared assets, see Contribute Help.
The designer creates new CSS styles and web page templates to accom- modate changing site designs, inserts images and Flash content into pages, and adds assets to the shared asset library for writers to insert into pages. ADOBE CONTRIBUTE CS3 User Guide...
Page 39
Select the role name, and then click Edit Role Settings. The Edit Role dialog box appears. The Edit Role dialog box lets you modify the user settings associated with each role. Modify the settings for the role. ADOBE CONTRIBUTE CS3 User Guide...
Note: Windows domain authentication uses the winNT.dll library for authentication. You must ensure that this file’s path (usually c:\windows\system32) is placed in the java.library.path environment variable. User directory service-based authentication Lightweight Directory Access Protocol (LDAP) or Active Directory. lets you integrate Contribute with user directory services such as ADOBE CONTRIBUTE CS3 User Guide...
Page 41
Contribute reads when first connecting to a website. Contribute then conforms to these settings during the editing process. Contribute administrators can specify access to certain folders for different user roles. Integrating your company LDAP directory with CPS adds another ADOBE CONTRIBUTE CS3 User Guide...
Page 42
The LDAP server attempts to validate the credentials and sends the resulting confirmation or rejection to CPS. If the authentication was successful, CPS sends a connection key to the Contribute client for each website that you have access to. ADOBE CONTRIBUTE CS3 prefix + <username> + suffix prefix + <username> + suffix User Guide pattern.
Page 43
CPS as a WAR file in an existing Java application server, the port number varies with your application server’s configuration. The following table lists the port numbers that CPS uses on some of the more popular Java application servers: Java Application Server BEA Weblogic Port number 7001 ADOBE CONTRIBUTE CS3 User Guide...
Page 44
CPS for your website next, and then configure Website Settings. Enter all the settings to configure the User Directory service. For more information about any of the settings, click the Help link to show online help. Port number 9080 8900 8080 ADOBE CONTRIBUTE CS3 User Guide...
Note: If you haven’t created a connection to your website, do so before you proceed with these instructions. For infor- mation, see “Creating a Contribute website connection” on page 22. is the name and location of your LDAP SSL certificate. ADOBE CONTRIBUTE CS3 User Guide...
Page 46
Contribute establishes a connection to CPS. In the Administer Website dialog box, click the Publishing Server Console link. The CPS Login dialog box appears. Enter the CPS administrator password, and then click Login to log in to the CPS Console. ADOBE CONTRIBUTE CS3 User Guide...
Users cannot connect to a CPS-managed website unless you have added them as users. This differs from using Contribute without CPS, where anyone with a connection key and connection information can connect. In Contribute, select Edit > Administer Websites > Website Name. The Administer Website dialog box appears. ADOBE CONTRIBUTE CS3 User Guide...
Page 48
Add users to the role you selected. The Search Results panel lets you locate users in your organization’s user directory and add them to the list of users for the role you’ve selected. Do the following to find and add user names to a role: ADOBE CONTRIBUTE CS3 User Guide...
To set up Contribute users, you need to make sure that every user has Contribute installed on their machine. Then, you need to provide them with the basic site connection information for the web server. You do this by sending them a connection key. ADOBE CONTRIBUTE CS3 User Guide...
If the website has no administrator, click Yes when a dialog box asks whether you want to become the website administrator. Then enter and confirm an administrator password for the website, and click OK. ADOBE CONTRIBUTE CS3 User Guide...
Page 51
Send Connection Key. The Send Connection Key Wizard (Windows) or Export Connection Key Assistant (Macintosh) appears. Follow the instructions in the wizard or assistant, and click Next (Windows) or Continue (Macintosh) to proceed to the next screen. ADOBE CONTRIBUTE CS3 User Guide...
Deploying Contribute across an organization Adobe uses an extensible installation application called the Microsoft Windows Installer (MSI) that lets you install Contribute to multiple Windows computers in your organization. The Contribute MSI installer can interface with Microsoft Active Directory that lets multiple users in your organization use the application based on the organi- zation’s group policies.
Page 53
If you are creating a package from the SMS Installer, the installer creates an executable file that has all the infor- mation and the commands necessary for deployment. To create the package that SMS uses for distribution: Open the Systems Management Server console, right-click Packages, and then select New/Package. The Package Properties dialog box appears. ADOBE CONTRIBUTE CS3 User Guide...
Page 54
Type one of the following commands to run the installer: • To run the installer by using the msiexec program (Typical Install), enter the following command: 00MSIEXEC /I "<PATH>Adobe Contribute 4.msi" /passive /norestart /log <Path for the Log file and log file name>.log Note: Use the Typical Install option only if all the client computers have the MSI 2.0 engine installed.
Page 55
You can also customize these commands based on your preferences. For example, if you do not want the Contribute desktop shortcut and the Internet Explorer plug-in to be installed, you can use the following command: 00MSIEXEC /I "<PATH>Adobe Contribute 4.msi" CREATEDESKTOPSHORTCUT=”0” INSTALLIEPLUGIN ="0" /passive /norestart /log <Path for the log file and log file name>.log On the Environment tab, clear the User Input Required option, and then click Run with administrative rights.
Page 56
To use SMS to remove Contribute, follow the installation steps for preparing the package for deployment. Instead of preparing a package, use the following command on the General tab of the Program Properties dialog box: msiexec /x " Adobe Contribute 4.msi " [DELETEUSERPREFS ="1"|"0"] /passive /log d:\uninstall.log Note: DELETEUSERPREFS ="1"...
Index about CPS 2 deploying Add Users dialog box 45 Administer Website dialog box 43, 44 administration settings, about 31 sitewide settings 32 E-mail Notification, about 2 administrator, responsibilities 8 Enable Publishing Server dialog expanded WAR archive 27 child website 16 compressed WAR archive 27 FTP, connection information 22 connecting to a website that CPS...
Need help?
Do you have a question about the 65015459 - Contribute CS4 and is the answer not in the manual?
Questions and answers