MACROMEDIA CONTRIBUTE 3 - DEPLOYING AND PUBLISHING..., Manual

Page 1: ...CONTRIBUTE 3 Deploying Contribute and Contribute Publishing Server...

Page 2: ...the link does not imply that Adobe Systems Incorporated endorses or accepts any responsibility for the content on those third party sites Opera browser Copyright 1995 2002 Opera Software ASA and its s...

Page 3: ...3 Contents Chapter 1 Overview 5 Chapter 2 Preparing Your Network and Installing Contribute 17 Chapter 3 Configuring Contribute and Contribute Publishing Server to work with your website 41...

Page 4: ...4 Contents...

Page 5: ...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 T...

Page 6: ...ut 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 macromedia com go cp...

Page 7: ...d 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...

Page 8: ...es for scheduling and for providing product specifications marketing launch plans and sales projections to name a few Laura also collaborates with Jah Wobble the Contribute administrator to help deter...

Page 9: ...in addition to Contribute roles to restrict user access to sections of a site If this applies to your site see Deploying Contribute for multiple websites on one webserver on page 12 Website on a stagi...

Page 10: ...le websites on one webserver on page 12 then only the users with access to that folder could receive and edit drafts sent to them for review It is important that the Templates folder which is located...

Page 11: ...sites In addition each department has its own set of Dreamweaver templates on which to base new pages When connecting users to their respective sites the administrator will create and distribute a con...

Page 12: ...aborate on pages Each department must work independently Deploying Contribute to a staging server and a live server Many organizations use a staging web server with their production web server A stagi...

Page 13: ...uring 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 al...

Page 14: ...t security measure is to keep them on a server protected by your network s firewall In addition you should consider using ACLs to secure these folders further by restricting access to network addresse...

Page 15: ...he site s content Web developer Develops web based applications such as for absence reporting and financial reporting distributed to users over the web Contribute user Contribute users range widely in...

Page 16: ...ice optional If you use CPS you need to configure the User Directory service you must specify the user directory type and either configure CPS to access your LDAP or Active Directory server or enter u...

Page 17: ...ow Contribute will impact your network and prepare for it by setting permissions access and securing special files and folders on your web server This section covers the following topics Understanding...

Page 18: ...PS This is a best practice and the default option The alternative is to use a shared FTP SFTP or WebDAV account for a website connection managed by CPS Requiring users to log in with their own account...

Page 19: ...organization can browse files within that folder Note In addition to using the computer s operating system and web server software configuration settings you might consider using a third party URL sca...

Page 20: ...ft com Other web servers If you are using another vendor s web server refer to the documentation supplied with your web server software to learn how to prevent users from accessing specific folders an...

Page 21: ...files and folders that are created when you send a user of your website a page for review _notes index html notifyWIP jr615v2v4p csi index html index html wipMeta mje1d0lzk4vxc fre wipMeta mje1d0lzk4...

Page 22: ...e as it progresses through the draft review process When the recipient of the page requiring review chooses to view it Contribute creates a LCK lock file for the page within the website and a CHK chec...

Page 23: ...connection For example connection1 www mysite com intranet connection2 www mysite com intranet marketing In this case the connection paths overlap and the second connection is a child website of the...

Page 24: ...n overlapping websites Contribute creates a special administrative folder labeled _mm that contains a shared settings file in each website you create a connection to The shared settings file contains...

Page 25: ...that User 1 has website connections to both websites www mysite com intranet and www mysite com intranet marketing and User 2 has a connection to the marketing website only www mysite com intranet mar...

Page 26: ...n the role the website administrator assigned to them for that website When you have overlapping website connections within your website you might have users who have multiple connections to different...

Page 27: ...o connect to a website Macromedia recommends using SFTP In addition to providing a secure connection when transferring files to and from Contribute and your website SFTP is a more reliable connection...

Page 28: ...erver s operating system and SFTP server To learn more about SSH2 see the SSH Communications Security website at www ssh com Note Contribute supports only password based authentication Other authentic...

Page 29: ...port number used by the WebDAV site For example suppose that this is the URL of your site www mysite com This might be the WebDAV URL www mysite com 81 Appending the port number 81 to the site s doma...

Page 30: ...he FTP Host folder you must provide an absolute path to the folder Installing Contribute and creating an administrative connection After you plan your website infrastructure and configure the network...

Page 31: ...ote location across the Internet to your website for example if you don t have a local network connection to the website If you or your users will connect to your website using FTP or SFTP you must kn...

Page 32: ...n is for systems that do not already have a Java application server installed This installation includes a Java Runtime Environment JRE and JRun 4 server for use with CPS For more information see Inst...

Page 33: ...ation The default location is C Program Files Macromedia Contribute Publishing Server 6 When prompted enter an administrative password to restrict access to the CPS Console Tip This is not the same pa...

Page 34: ...ation files and then runs the install script 4 View each screen of the license agreement and then accept the agreement to continue with the installation 5 In the Installation Method screen select the...

Page 35: ...oying the WAR file on page 41 Generating the WAR file using an installer The first step in the WAR File Installation for CPS is using an installer to generate a WAR file and associated data files in a...

Page 36: ...Tip This is not the same password used to protect the Contribute administrator role so you might want to make a note of it 8 Review the Summary screen and then press Enter when you are ready to begin...

Page 37: ...ssumes that you have a preexisting version of JRun 4 installed To deploy the WAR file on a JRun 4 server 1 Manually expand the pubserver war file in the installation folder a At a command prompt chang...

Page 38: ...S on JBoss Macintosh application servers JBoss is an open source Java based application server commonly deployed on Macintosh OS X servers Macromedia recommends that you manually expand the pubserver...

Page 39: ...lication server To restart JBoss execute the run sh script in a terminal window JBoss_home server bin run sh 9 Now you are ready to log in to the CPS Console and configure CPS Using a web browser brow...

Page 40: ...tput logs For example out file C Contribute Publishing Server logs out log file out err file C Contribute Publishing Server err log file err 5 Save and close ckm xml and then restart your J2EE server...

Page 41: ...following sections Configuring Contribute on page 47 Configuring Contribute Publishing Server CPS only on page 54 Enabling Contribute websites to work with CPS CPS only on page 61 Adding users to your...

Page 42: ...nd any connection keys you might have sent to users become disabled To learn more about CPS see Understanding Contribute user management models on page 5 Web Server lets you configure Contribute to wo...

Page 43: ...s on page 48 To open the Administer Website dialog box 1 Select Edit Administer Websites Windows or Contribute Administer Websites Macintosh and select the website you want to set options for 2 If pro...

Page 44: ...one person assigned to the administrative role Publisher identifies users who can create and edit pages as well as publish pages to the website Writer identifies users who can create and edit pages bu...

Page 45: ...o restrict users so that they can use images only from a shared asset library that you create or you can allow them to add any image to a web page For more information see Setting options for new imag...

Page 46: ...alog box appears Job Title Contribute Role Privileges System administrator Administrator Installs Contribute creates connections to the website and defines Contribute roles appropriate to the magazine...

Page 47: ...Select an existing role from the Create new role from copy of list box Selecting an existing role as a base for a new role lets you reuse the selected role s settings You can modify the new role s set...

Page 48: ...x Next you will configure CPS If you are not using CPS to manage your website then you are ready for user to install Contribute and connect to the website For more information see Deploy Contribute an...

Page 49: ...omputer You can integrate the User Directory service of CPS with your directory service The User Directory is an application service that enables you to centrally manage users When you integrate with...

Page 50: ...CPS to authenticate a user the LDAP server must verify the user s display name This is usually a unique name in the LDAP tree that is associated with the user CPS receives only a user name so it must...

Page 51: ...onnection Note When sending SOAP requests to CPS Contribute sends the request over an SSL encrypted network connection and uses port 8900 by default The message timeout is 20 seconds 3 CPS requests au...

Page 52: ...rvices You should configure CPS User Directory services when you deploy CPS You can also configure the E mail Notification and Log services at the same time or you can wait until later Note For more i...

Page 53: ...ervers Tip If you select the Simple Installation for installing CPS see Installing Contribute Publishing Server using the Simple Installation on page 38 the URL for the CPS Console is https localhost...

Page 54: ...xt and then configure Website Settings 5 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 6 Click S...

Page 55: ...fault location C Program Files Macromedia Contribute Publishing Server jre bin 2 Enter the following command keytool Depending on your configuration you might need to include more information The comp...

Page 56: ...If you plan to use the User Directory service to manage users see Adding users to your website CPS only on page 63 to learn how to add users to your website For information about options in this dial...

Page 57: ...Contribute to work with CPS see Enabling Contribute websites to work with CPS CPS only on page 61 you must add users to the website from your LDAP Active Directory or file based user database Note Any...

Page 58: ...in the Search text box and then click Search Contribute shows the closest matches it finds in the Search Results list b Select the name of the user you want to add to the role and click Add to move t...

Page 59: ...ure 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 C...

Page 60: ...ame where server domain name is the name of the server where CPS is installed in the Contribute browser address bar to connect to the website The procedure for sending a connection key varies dependin...

Page 61: ...ant to administer from the submenu 2 Do one of the following If the website has no administrator click Yes when a dialog box asks whether you want to become the website administrator Then enter and co...

Page 62: ...Windows or Continue Macintosh to proceed to the next screen 6 After completing the wizard or assistant a new connection key file is created for the user assigning them to a new role You can e mail the...

Page 63: ...ntosh and select the website you want to administer from the submenu If the website has no administrator click Yes when a dialog box asks whether you want to become the website administrator Then ente...

Page 64: ...70 Configuring Contribute and Contribute Publishing Server to work with your website...

Page 65: ...7 Enable Publishing Server dialog box 56 Log service 6 Publishing Server enabling 55 User Directory enabling 56 Contribute Publishing Server case study 6 overview 6 Simple Installation 32 33 using sec...

Page 66: ...rectory 54 server permissions 18 services E mail Notification 6 Log 6 User Directory 6 SFTP connection information 27 31 Simple Installation Contribute Publishing Server 32 33 Sitewide Settings dialog...