Contents

Title and Copyright Information

Preface

Audience

Documentation Accessibility

Related Documents

Conventions

1 Introduction

1.1 Site Studio Software Suite

1.2 Site Studio Users

1.3 Site Studio Publishing Model

1.3.1 Step 1: Create the Site In Designer

1.3.2 Step 2: Manage the Site in Manager

1.3.3 Step 3: Add and Edit Content in Contributor

1.3.4 Step 4: Preview and Distribute the Completed Web Site

1.4 Site Studio Administration

2 Managing Web Sites

2.1 About Managing Web Sites

2.2 Viewing a Web Site

2.3 Updating Web Site Navigation

2.4 Viewing Web Site Objects Reports

2.5 Using Site Studio Manager

2.5.1 Launching Site Manager

2.5.2 Adding a Section

2.5.3 Removing a Section

2.5.4 Moving a Section

2.5.5 Editing Section Properties

2.5.6 Renaming a Section

2.5.7 Showing or Hiding a Section on the Web Site

2.5.8 Designating a Section as Contributor-Only

2.5.9 Designating a Section as an Error Handler

2.5.10 Changing the URL Associated With a Section or Page

2.5.11 Changing the Maximum Age of a Section

2.5.12 Changing Custom Properties

2.5.13 Previewing Page Templates

2.5.14 Assigning a Primary Page to a Section

2.5.15 Assigning an External URL to a Section

2.5.16 Assigning a Secondary Page to a Section

2.5.17 Removing a Page Template From a Section

2.5.18 Opening the Content Information Page for a Page Template

2.6 Starting and Stopping the Web Site

2.7 Reloading Web Sites

2.8 On-Demand Web Sites

2.8.1 Working with On-Demand Web Sites in the Oracle Content Server Interface.

2.8.2 Working with On-Demand Web Sites in Designer

3 Managing Web Site Addresses

3.1 About Web Site Addresses

3.2 Adding a Web Site Address

3.3 Selecting and Deselecting Default Web Addresses

3.4 Removing a Web Site Address

4 Managing Fragment Libraries

4.1 About Fragment Libraries

4.2 Deploying a Fragment Library on the Server

4.3 Configuring JSP Fragments on the Server

4.4 Compressing Contributor JavaScript

5 Setting Default Project Document Information

5.1 About Default Project Document Information

5.2 Setting Default Project Document Information

6 Managing Site Replication

6.1 About Site Replication

6.2 Replication Process

6.3 What Gets Replicated

6.4 Revisions Included

6.5 Additional Export Settings

6.6 Configuring the Target Server for Replication

6.7 Setting Up an Outgoing Provider on the Source Server

6.8 Setting Up the Import Archive on the Target Server

6.9 Setting Up the Export Archive on the Source Server

6.10 Starting the Site Replication

6.11 Setting Up "Ready to Replicate"

7 Backing Up and Restoring Web Sites

7.1 About Backup and Restore

7.2 Backing Up Your Site

7.3 Restoring Your Site

7.4 Viewing the Server Configuration Details

8 General Component Information

8.1 About General Component Information

8.2 Viewing General Component Information

8.3 Resetting the Install Number

A User Interface

A.1 Manage Web Sites Page

A.2 Manage Site Page (Site Studio Manager)

A.2.1 Section Tab

A.2.2 Page Template Tab

A.2.3 Secondary Page Template Tab

A.2.4 Custom Properties Tab

A.3 Manage On-Demand Web Sites Page

A.4 Web Site Objects Report Page

A.5 Web Site Addresses Page

A.6 Manage Fragment Libraries Page

A.7 Set Default Project Document Information Page

A.8 Set Default Web Asset Document Information Page

A.9 Manage Site Replication Page

A.10 Add Export Archive Page

A.11 Edit Export Archive Page

A.12 Add Import Archive Page

A.13 Edit Import Archive Page

A.14 General Component Information Page

A.15 Backup and Restore Page

A.16 Manage Archives Page

A.17 Backup Archive Information Page

A.18 Server Configuration Details Page

A.19 External Applications Administration page

B Miscellaneous Administration Tasks and Considerations

B.1 Changing the Default Contributor Keystroke Combination

B.2 Blocking Access to the Consumption Server

B.3 Changing the Default Contributor Editor

B.4 Updating Custom Elements

B.5 Using the Certificate Validation Applet

B.6 Configuring a Single Sign-On (SSO) Environment

B.7 Using Pre-10gR4 Site Studio Projects

Index

Oracle® WebCenter Content

Administrator and Manager's Guide for Site Studio

11g Release 1 (11.1.1)

E10614-02

November 2011

Oracle WebCenter Content Administrator and Manager's Guide for Site Studio, 11g Release 1 (11.1.1)

E10614-02

Copyright © 1996, 2011, Oracle and/or its affiliates. All rights reserved.

Primary Author:  Sean Cearley

Contributor:  Brian Cheyne, Ron van de Crommert

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications..

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Preface

The Oracle WebCenter Content Administrator and Manager's Guide for Site Studio contains information about all Site Studio tasks that can be performed from within the Content Server interface. They are administrative tasks (replicating sites, backing up sites, and so on) and tasks related to managing sites, as allowed by the site designer (adding sections, assigning primary and secondary pages, and so on).

Audience

This document is intended for those people identified in the organization who are responsible for the administration and management of Web sites controlled by Site Studio.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information, see the following documents in the Oracle Site Studio documentation set:

Oracle WebCenter Content User's Guide for Site Studio Contributor

Oracle WebCenter Content User's Guide for Site Studio Designer

Oracle WebCenter Content User's Guide for Site Studio Publisher

Oracle WebCenter Content Technical Reference Guide for Site Studio

Conventions

The following text conventions are used in this document:

Convention | Meaning
boldface | Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
italic | Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
monospace | Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Introduction

Site Studio is a powerful, flexible web development application suite that offers a comprehensive approach to designing, building, and maintaining enterprise-scale Web sites. It goes beyond conventional HTML and script editors by offering Web site creation and content management all in one.

Site Studio brings several concepts to the Web site development and management process including several applications geared to different site roles (designer, contributor, manager, administrator), manageable site hierarchies, reusable site assets and content, fragments, and editable site regions. When used together, you can create enterprise-scale Web sites without the publishing bottlenecks typically associated with such sites.

The following topics describe Site Studio in more detail:

"Site Studio Software Suite"

"Site Studio Users"

"Site Studio Publishing Model"

"Site Studio Administration"

1.1 Site Studio Software Suite

Site Studio has many parts to it, some of which operate on the content server and others that operate on client computers. The parts are used so that an organization can create, manage, and distribute a Web site in a timely and seamless fashion. The organization can create and change the roles for each individual responsible for the site.

To accommodate this, Site Studio comprises the following parts:

Site Studio Product
Description

Content Server component
The component must be installed on the content server before anything else. It is required for Web sites to function. The component provides numerous server-side functions, and it communicates with clients (like Designer) and other parts of the site.

The component also provides the Site Studio administration interface, which is used by site administrators to perform several administrative tasks for Web sites. See "Site Studio Administration".

Site Studio Designer
A client-side application that provides a development environment in which site designers can create and design Web sites, including defining page templates, setting up editable page regions, and so on. For more information, see the Oracle WebCenter Content User's Guide for Site Studio Designer.

Site Studio Manager
A web-based application that provides an environment in which site managers can make changes to the site hierarchy such as adding and removing sections, changing the page template assigned to a section, and modifying several site properties. For more information, see "Using Site Studio Manager".

Site Studio Contributor
A client-side application that provides an in-context editing environment in which site contributors can add and edit web pages on existing Web sites. For more information, see the Oracle WebCenter Content User's Guide for Site Studio Contributor.

While the applications are separate, they are tightly integrated. Tasks performed in Designer affect Manager and Contributor, and tasks performed in Manager affect Contributor. It is assumed that people using Manager also occasionally use Contributor.

1.2 Site Studio Users

Site Studio provides an environment where three types of users can create and maintain Web sites:

Designer: Possibly a webmaster or web developer, this individual is responsible for creating the site, designing page templates, adding and editing fragments, setting up editable or manageable site areas, and so on.

Manager: Possibly the head of a division or department, this individual is responsible for the structure of the site, modifying sections, creating areas, reassigning page templates, and so on.

Contributor: Possibly a member of the marketing or sales team, this individual is responsible for adding and editing the content that appears on the site.

Typically, one designer works with multiple managers, and each manager with one or more contributors. The designer may also choose to initially hand the site over to a manager, who builds the site hierarchy and determine where content should go. The manager could then notify contributors to start updating (or creating) the content of the site pages.

Note:

One person may have multiple roles, depending on the organization's size and structure.

In addition to these three Site Studio roles, there may also be separate site administrators, who could take on responsibility for assigning web addresses to the site, backing up the site, replicating the site, and so on. All these administrative tasks are performed on the content server.

1.3 Site Studio Publishing Model

Site Studio is designed around a three-user model: designer, manager, and contributor. The designer creates the site, the manager operates the site, and the contributor adds and edits content on the site. This model helps organizations get a site up and running quickly and efficiently, and it enables the users in the organization to update content quickly without any of the bottlenecks often associated with large Web sites.

Here is a summary of the tasks performed and the applications used to perform each task:

Step 1: Create the Site In Designer

Step 2: Manage the Site in Manager

Step 3: Add and Edit Content in Contributor

Step 4: Preview and Distribute the Completed Web Site

Note:

Your organization may choose to follow this model or come up with its own publishing model depending on its needs.

1.3.1 Step 1: Create the Site In Designer

The designer of the site starts the process by creating a site connection to the server hosting the site, a site name, and a site address. The designer then defines the site assets (placeholders, page templates, element definitions, and so on) and builds the site based on these assets, including creating the site hierarchy (unless this task is left to the manager). All of these tasks are performed in Site Studio Designer.

Figure 1-1 Designer Application

When finished, the designer notifies the site manager and site contributors that the site has been created and now must be managed and edited. To do this, the designer may place instructions in a contributor-only section of the site, or implement a more formal process using workflows or a different method in accordance with the organization's standard procedures.

Note:

For more information on the Site Studio Designer application, see the Oracle WebCenter Content User's Guide for Site Studio Designer.

1.3.2 Step 2: Manage the Site in Manager

When the manager enters the site, most of the site design should be complete (that is, the look-and-feel of the site pages). The manager can review and modify the defined site hierarchy (if the designer chose to set up a hierarchy), add and modify sections, assign templates to site pages, and set some site properties. All of these tasks are performed in Site Studio Manager.

Figure 1-2 Manager Application

Depending on how it was set up by the site designer, the Manager application may be available on every page of the site or only on a dedicated section of the site. It can also be opened from the Site Studio administration pages in the Content Server user interface.

When finished, the manager notifies one or more contributors to start adding and editing the content on the site. The manager may pass these instructions along in a contributor-only section of the site or implement a more formal process using workflows or a different method in accordance with the organization's standard procedures.

Note:

For more information on the Site Studio Manager application, see the Chapter 2, "Managing Web Sites."

1.3.3 Step 3: Add and Edit Content in Contributor

By the time a contributor starts work, the full site hierarchy should be ready for content. Contributors then add and edit the content that appears on each page on the site. This means working with text, graphics, lists, links to pages, and much more. All of these tasks are performed in Site Studio Contributor.

Figure 1-3 Contributor Application

Depending on how the site was set up by the designer and the manager, the contributor's experience varies from page to page and Web site to Web site. The contributors may be working exclusively in the Contributor application (when editing contributor data files) or third-party applications (when editing native documents). Additionally, several options might be enabled or disabled in Site Studio Contributor.

When finished, contributors may notify other contributors or reviewers that the page has been added or edited. They may communicate with one another in contributor-only sections or follow a formal review process using workflows or a different method in accordance with the organization's standard procedures.

Note:

For more information on the Site Studio Contributor application, see the Oracle WebCenter Content User's Guide for Site Studio Contributor.

1.3.4 Step 4: Preview and Distribute the Completed Web Site

With everyone's work complete, the final Web site can be made live. To distribute the site to the user, it may must be replicated to a server dedicated to site consumption.

Figure 1-4 Live Version of Web Page

1.4 Site Studio Administration

In addition to using the Designer, Manager, and Contributor applications to create and manage a site, you can also perform several administrative tasks from within the Oracle Content Server interface, including starting and stopping sites, assigning default metadata to project files, managing fragment libraries, replicating sites, and backing up and restoring sites.

You perform these tasks from the Site Studio Administration page in the Oracle Content Server interface. To open this page, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed. If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Figure 1-5 Site Studio Administration Page

The following options are available on the Site Studio Administration page:

Element
Description

Manage Web Sites
Opens the Manage Web Sites page (see "Manage Web Sites Page"), where you can view each site, update navigation, view a site report, stop and start the site, and reload a site.

See Chapter 2, "Managing Web Sites" for more information.

Manage Web Site Addresses
Opens the Manage Web Site Addresses page (see "Web Site Addresses Page"), where you can add domain addresses that point to your Web site.

See Chapter 3, "Managing Web Site Addresses" for more information.

Manage Fragment Libraries
Opens the Manage Fragment Libraries page (see "Manage Fragment Libraries Page"), where you can deploy fragment libraries and configure JSP support, if necessary.

See Chapter 4, "Managing Fragment Libraries" for more information.

Set Default Project Document Information
Opens the Set Project Default Document Information page (see "Set Default Project Document Information Page"), where you can specify the default metadata that is assigned to new project files (created in Designer).

See Chapter 5, "Setting Default Project Document Information" for more information.

Manage Site Replication
Opens the Manage Site Replication page (see "Manage Site Replication Page"), where you can replicate your site from one content server to another.

See Chapter 6, "Managing Site Replication" for more information.

Backup and Restore
Opens the Backup and Restore page (see "Backup and Restore Page"), where you can create a backup of your Web site and restore from a backup of your Web site.

See Chapter 7, "Backing Up and Restoring Web Sites" for more information.

General Component Information
Opens the General Component Information page (see "General Component Information Page"), where you can view useful information about your site, including the version, Site Studio-specific metadata, directory paths, and so on.

See Chapter 8, "General Component Information" for more information.

You can open the Site Studio Administration page from the Administration section in Content Server or using the preview icon menu (Figure 1-6) in Designer (Site Studio Admin option).

Figure 1-6 Preview Icon in Site Studio Designer

2 Managing Web Sites

Concepts

"About Managing Web Sites"

Tasks

"Viewing a Web Site"

"Updating Web Site Navigation"

"Viewing Web Site Objects Reports"

"Using Site Studio Manager"

"Starting and Stopping the Web Site"

"Reloading Web Sites"

"On-Demand Web Sites"

2.1 About Managing Web Sites

The Content Server interface offers several options that help you manage Site Studio Web sites. The management tasks are performed from the Manage Web Sites page on the content server (see "Manage Web Sites Page"). You can control the availability of the defined Web sites, update the navigation of these Web sites, start and stop the Web sites, and generate site reports. In addition, you can launch the Manager application from this page, which enables you to modify the site hierarchy, add and remove sections, assign templates to site pages, and set some site properties.

2.2 Viewing a Web Site

All Web sites listed on the Manage Web Sites page are available for loading and viewing in a web browser. To view a managed Web site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Sites.

The Manage Web Sites page is displayed (see "Manage Web Sites Page").

Select the Web site to view from the list, and click View Web Site.

The Web site opens in the same browser window or tab.

2.3 Updating Web Site Navigation

As a site manager, you can modify the structure of a Web site, including adding and removing directories and subdirectories, or moving directories into other areas of the Web site. If you alter the site structure, then all site navigation should be updated (rebuilt).

To update a Web site's navigation, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Sites.

The Manage Web Sites page is displayed (see "Manage Web Sites Page").

Select the Web site to update navigation for, and click Update Navigation.

The Web site navigation is updated. There is no progress indication, but the page automatically refreshes when the process is done.

2.4 Viewing Web Site Objects Reports

Web site objects reports detail the activity of use of each part of a Web site. When implemented by the designer, Web site reports are available to site managers.

To view the objects reports of a Web site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Sites.

The Manage Web Sites page is displayed (see "Manage Web Sites Page").

Select the Web site to view reports for, and click View Web Site Objects Report.

The Web Site Objects Report page is displayed (see "Web Site Objects Report Page").

Click any of the object categories to see the report specific to that category.

2.5 Using Site Studio Manager

The Site Studio Manager application is available to assigned individuals who can use it to perform several site management tasks:

"Adding a Section"

"Removing a Section"

"Moving a Section"

"Editing Section Properties"

"Renaming a Section"

"Showing or Hiding a Section on the Web Site"

"Designating a Section as Contributor-Only"

"Designating a Section as an Error Handler"

"Changing the URL Associated With a Section or Page"

"Changing the Maximum Age of a Section"

"Changing Custom Properties"

"Previewing Page Templates"

"Assigning a Primary Page to a Section"

"Assigning an External URL to a Section"

"Assigning a Secondary Page to a Section"

"Removing a Page Template From a Section"

"Opening the Content Information Page for a Page Template"

2.5.1 Launching Site Manager

The Site Studio Manager application is accessible from the Oracle Content Server interface, but the site designer may also provide access to the Manager application from a Web site. See the Oracle WebCenter Content User's Guide for Site Studio Designer for details on the latter option. To launch Site Manager from Oracle Content Server, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Sites.

The Manage Web Sites page is displayed (see "Manage Web Sites Page").

Select the Web site to manage, and click Manage Site.

The Manage Site page is displayed (see "Manage Site Page (Site Studio Manager)").

2.5.2 Adding a Section

You can add a section to your Web site from the site hierarchy or on the Section tab. To add a section to a Web site, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy where you want to add the section, and do either of the following:

With the mouse cursor on the selected section in the site hierarchy, right-click and choose Add New Section.

On the Section tab, click Add.

The Add New Section dialog is displayed (Figure 2-1).

Figure 2-1 Add New Section Dialog

Provide the information for the section:

Label: Enter the label for the section. The label is displayed in the site hierarchy and in the navigation menus on the Web site.

URL: The default URL is the section label minus any spaces. Enter a URL if you want it to be different from the one provided automatically. The URL value should not contain any spaces or special characters. The URL value is what represents this section in the web address (for example, in the address http://www.example.com/product1/index.htm, the URL value is "product1"). This value is also used in all path-based links to this section.

Section ID: Choose how the section should be identified by Site Studio:

Auto-generate section ID: The ID is automatically generated by Site Studio.

Manually enter section ID: You specify your own ID for the section. (The section ID should be unique in the content server.)

Note:

The section ID (also called node ID) is used in all ID-based links that target this section.

Click OK to close the dialog and add the section to the site hierarchy.

Once you add the section to the site hierarchy, you can make changes to its properties on the Section tab (see "Editing Section Properties"). The section you added to the site hierarchy does not appear on the Web site until you specifically select it for inclusion in the site navigation (see "Showing or Hiding a Section on the Web Site").

2.5.3 Removing a Section

You can remove a section from the site hierarchy so that it no longer appears on the Web site. To remove a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to remove, and do either of the following:

With the mouse cursor on the selected section in the site hierarchy, right-click and choose Remove this section.

On the Section tab, click Remove.

Click OK to the confirmation message.

After a short delay, the section is removed from the site hierarchy.

Note:

Even though you remove a section, the content associated with that section (page templates, fragments, graphics, and so on) remains in the content server and associated with your Web site.

2.5.4 Moving a Section

You can change the order of the sections in the site hierarchy, which affects how they appear on the Web site. There are two ways to move a section: by dragging and dropping in the site hierarchy, or using the Move command.

Moving Sections By Dragging and Dropping

To move a section by dragging and dropping it in the site hierarchy, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Click the section in the site hierarchy and drag it to the part of the site hierarchy where you want to move it.

When you let go of the left mouse button, a context menu appears asking where you want to put the section:

Move Before section [name]

Move After section [name]

Move Into section [name]

Select the appropriate relative location. If you choose "Move Into section...," the section becomes a sub-section of the selected section.

After a short delay, the section is shown in the site hierarchy.

Moving Sections Using the Move Command

To move a section using the Move command, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to move, and do either of the following:

With the mouse cursor on the selected section in the site hierarchy, right-click and choose Move this section.

On the Section tab, click Move.

The Move Section dialog is displayed.

Select the location in the site hierarchy to move the section to, and select the appropriate relative location:

Before

After

As child of

If you choose "As child of," the section becomes a sub-section of the selected section.

Click OK when you have finished.

After a short delay, the section is shown in the site hierarchy.

2.5.5 Editing Section Properties

You can view and edit the properties of a selected section in the site hierarchy on the Section tab. You can view or modify the following properties:

Section ID: This is the section ID that uniquely identifies the section in the site hierarchy (and the content server). This field is typically disabled because changing it can break links that target this section.

Section Label: This is the name of the section. The name is displayed in the site hierarchy and in the navigation menus on the Web site (but not necessarily in the URL). You can change the section label if you want. See "Renaming a Section" for further details.

Include in Navigation: If this check box is selected, the section displays as a link in the navigation menus on the Web site. See "Showing or Hiding a Section on the Web Site" for further details.

Contributor Only: If this check box is selected, the section appears only when the site is viewed in contribution mode. This may be useful, for example, to communicate directly with contributors or to preview content before making it publicly available. See "Designating a Section as Contributor-Only" for further details.

Url Directory Name: This is the directory name of the section as it appears in the site URLs. For example, in the address http://www.example.com/product1/index.htm, the URL directory name is "product1." This value is also used in all path-based links to this section. By default, the URL directory name is identical to the section label, but you can use a different value if you want. The name should not contain any spaces or special characters. See "Changing the URL Associated With a Section or Page" for further details.

Url Page Name: This is the URL that represents the primary page (associated with this section) in the Web site address. If you do not specify a URL page name, then "index.htm" is used to represent the primary page. See "Changing the URL Associated With a Section or Page" for further details.

Maximum Age: This is the maximum amount of time (in seconds) that a Web site page in this section remains in cache. This improves the performance and security of a Site Studio Web site. See "Changing the Maximum Age of a Section" for further details.

2.5.6 Renaming a Section

You can rename a section in the site hierarchy by changing its label and other relevant information. These settings can be changed under Section properties.

To rename a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy whose name and/or URL you want to change.

On the Section tab, enter a value for Section Label. This label is displayed in the site hierarchy and in the navigation menus on the Web site.

To change the path used for the section, enter a Url Directory Name. The name should not contain any spaces or special characters. See "Changing the URL Associated With a Section or Page".

Press <Enter> on your keyboard or click elsewhere in Manager.

2.5.7 Showing or Hiding a Section on the Web Site

Each section in the site hierarchy displays as a link in the navigation menus on your Web site, unless you specifically choose not to include it. Here are some reasons why you may not want a section to appear in your site navigation:

Introducing new content: When introducing a section or page template to the Web site, you may want to prevent it from being viewed publicly until it has been edited and tested. One way to do this is to not include it in the site navigation.

Another way to hide content is to make the section viewable only in contribution mode (see "Designating a Section as Contributor-Only"), or use workflow.

Search results page: When using search functionality on a Site Studio Web site, the designer designates a section where the search results page is displayed. This section, however, is not intended for viewing out of the context of a search and therefore should be hidden from the site navigation.

Custom error page: To use a custom error feature in Site Studio, the designer designates a section where the custom error page is displayed. This section, however, is not intended for viewing out of the context of receiving an error message and therefore should be hidden from the site navigation. See "Designating a Section as an Error Handler" for further details.

By default, sections that you create are not included in the site navigation, and are therefore not automatically added as links to the Web site. You must specifically mark them for inclusion in the site navigation. The visibility status of a section in the site hierarchy is indicated by its icon (Figure 2-2).

Figure 2-2 Show and Hide Section Icons

To show or hide a section on the Web site, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to show or hide, and do either of the following:

With the mouse cursor on the selected section in the site hierarchy, right-click and select or clear the Include section in navigation check box.

On the Section tab, select or clear the Include in Navigation check box.

After a short delay, the section icon in the site hierarchy is updated to reflect its visibility status (Figure 2-2).

2.5.8 Designating a Section as Contributor-Only

You can designate a section of the site to only appear when the site is viewed in contribution mode. Creating a contributor-only section can be useful, for example, to communicate directly with contributors or to preview content before making it publicly available.

To designate a section as contributor-only, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to designate as contributor-only.

On the Section tab, select the Contributor Only check box.

You want to be sure to include the section in your site navigation even if it is to appear only in contribution mode (see "Showing or Hiding a Section on the Web Site").

2.5.9 Designating a Section as an Error Handler

There are several circumstances in which a visitor or contributor to the site may encounter an error message generated by the content server. Examples of when users usually encounter error messages include situations when a secondary page is missing in the section where a file is being requested, or when a file (contributor data file or native document) has been removed from the site but still has a hyperlink pointing to it. To prevent users from encountering these types of errors, the designer of the site can create a custom error page. The manager (or the designer) can designate a section of the site to serve as an error handler and then assign the error page to that section.

To designate a section as an error handler, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to designate as an error handler, and do either of the following:

With the mouse cursor on the selected section in the site hierarchy, right-click and select the Set section as error handler check box.

On the Section tab, click the error handler link.

After a short delay, the section icon in the site hierarchy is updated to reflect its status as the error handler (Figure 2-3).

Figure 2-3 Error Handler Icon

Make sure that the designated error-handler section is selected in the site hierarchy, and open the Page Template tab.

Beside Preview page template, select the page template for the custom error page, and click Apply.

When you designate a section as an error handler, do not include that section in your site navigation (see "Showing or Hiding a Section on the Web Site").

Caution:

It is possible in Manager to set the home page as the error handler page. This is not possible in Designer, and cannot be undone through Designer.

2.5.10 Changing the URL Associated With a Section or Page

The URL associated with a section (or page) is what represents this section in the complete web address. For example, in the address http://www.example.com/product1/index.htm, the URL associated with the section is "product1" and the URL associated with the page is "index.htm". This value is also used in all path-based links to this section, and should not contain any spaces or special characters.

To change the URL associated with a section or a page, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy whose name and/or URL you want to change.

Make sure the Section tab is open.

To change the URL that represents this section in the Web site address, enter a Url Directory Name. By default, the URL directory name is identical to the section label, but you can use a different value if you want.

To change the URL that represents the primary page (associated with this section) in the Web site address, enter a Url Page Name. If you do not specify a URL page name, then "index.htm" is used to represent the primary page.

Press <Enter> on your keyboard or click elsewhere in Manager.

Note:

The name used for secondary pages is the content ID (dDocName) of the file (contributor data file or native document) appearing there. Contact the site designer for information on changing this value.

2.5.11 Changing the Maximum Age of a Section

One way to improve the performance and security of a Site Studio Web site is to implement a reverse proxy cache on the server. By placing a cache between the server and the user, you reduce the load put on a potentially busy server. If you have such a setup in your organization, you can use Manager to specify the maximum amount of time that a given page remains in cache.

To change the maximum age of a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy whose maximum age you want to change.

Make sure the Section tab is open.

Enter a value (in seconds) for Maximum Age. If you do not specify a maximum age, the file remains in cache indefinitely.

Press <Enter> on your keyboard or click elsewhere in Manager.

2.5.12 Changing Custom Properties

If your site contains custom properties, you see an additional Custom Properties tab in Manager. These properties are created by the designer of the site and they typically apply to this particular site or related sites on the content server. Section properties cannot be added or removed by a site manager; only their values can be edited.

Using a custom property, you can specify a different value for each section of the site and therefore affect how that section appears or functions on the site (designers can create fragments that read those values and then execute certain commands).

To change a custom property, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy whose custom properties you want to view or change.

Open the Custom Properties tab.

Enter the desired value for each custom property.

Press <Enter> on your keyboard or click elsewhere in Manager.

Note:

Contact your site designer regarding the proper use of the custom properties.

2.5.13 Previewing Page Templates

As you manage your site, a task you perform frequently is preview page templates. Previewing page templates is useful to determine the best page template for a section, preview your changes to the site hierarchy or section properties, and so on.

To preview page templates, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

To preview a primary page, open the Page Template tab.

To preview a secondary page, open the Secondary Page Template tab.

Beside Preview page template, click the menu and select the desired page template.

The page template that you selected is displayed in the preview area.

2.5.14 Assigning a Primary Page to a Section

Each section in the site hierarchy should contain a primary page (or external URL), which serves as the default page (or landing page) for that section. You can assign a unique page template to each section or reuse the same page template in multiple sections.

To assign a primary page to a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to assign a primary page to.

Open the Page Template tab.

Beside Preview page template, click the menu and select the desired page template from the list.

Click Apply.

The page template that you selected is displayed in the preview area.

To add a home page to your site, select the root of the site in the site hierarchy ("Home") and assign a primary page to it. As an alternative to using a primary page, you can specify an external URL to use for the section (see "Assigning an External URL to a Section").

2.5.15 Assigning an External URL to a Section

Instead of assigning a primary page to a section, you can also assign an external URL. The section then uses the web page of another Web site instead of a page template. Visitors coming to the section are directed to the web page URL that you specify.

To assign an external URL to a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to assign an external URL to.

Open the Page Template tab.

Beside Preview page template, click the menu and select Choose External URL....

The Choose External URL dialog is displayed.

Specify the web address that you would like to use for this section of the site.

Click OK.

The web page that you specified is displayed in the preview area.

Using an external URL can be useful for linking to partner sites or department-level sites within the same organization. External URLs can be assigned for primary pages, but not secondary pages.

2.5.16 Assigning a Secondary Page to a Section

Each section in the site hierarchy should have a secondary page if contributors are adding files (contributor data files or native documents) to that part of the Web site. The secondary page acts like a backdrop for these files and ultimately enables contributors to add more pages to the Web site. You can assign a unique page template to each section or reuse the same page template in multiple sections.

To assign a secondary page to a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy to assign a secondary page to.

Open the Secondary Page Template tab.

Beside Preview page template, click the menu and select the desired page template from the list.

Click Apply.

The page template that you selected is displayed in the preview area.

Note:

You can add a secondary page to the root of the site hierarchy (beside the home page). To do this, select the root of the site in the Site Hierarchy pane ("Home") and assign a secondary page to it.

2.5.17 Removing a Page Template From a Section

You can remove the page templates assigned to a section. Removing the page template removes its assignment to the section, but does not remove it from other sections or from the content server in general.

To remove the page template from a section, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

Select the section in the site hierarchy whose page templates you want to remove.

To remove a primary page, open the Page Template tab.

To remove a secondary page, open the Secondary Page Template tab.

Beside the page template, click clear.

The page refreshes without the assigned page template.

2.5.18 Opening the Content Information Page for a Page Template

There may be times when you want to view the content information of a primary or secondary page template to see what metadata is assigned to it, who authored it, and so on.

To open the content information page for a page template, perform these steps:

Launch the Site Manager Application (see "Launching Site Manager").

For primary pages, open the Page Template tab.

For secondary pages, open the Secondary Page Template tab.

Click the info icon (Figure 2-4) next to the page template.

Figure 2-4 Info Icon

You are taken to the standard content information page in the content server, where you can view or update the metadata assigned to the page template.

2.6 Starting and Stopping the Web Site

Site managers may occasionally be required to take a site down, or restore a site to make it available once more. The sites that are currently up and available are listed on the Manage Web Sites page (see "Manage Web Sites Page"), in the Web Sites area under the heading "Running Web Sites." The Web sites that have been stopped are listed under "Stopped Web Sites."

To start or stop a Web site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Sites.

The Manage Web Sites page is displayed (see "Manage Web Sites Page").

Select the site and click either Start Web Site or Stop Web Site.

2.7 Reloading Web Sites

When sites are started and stopped, occasionally the list of the running and the stopped Web sites must be refreshed to reflect the current status.

To reload all Web sites, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Sites.

The Manage Web Sites page is displayed (see "Manage Web Sites Page").

Click Reload Web Sites.

2.8 On-Demand Web Sites

Site Studio administrators can now mark Web sites as served "on demand." The Web sites marked as on-demand Web sites are not loaded into the content server's memory until a request is received to load the site. This reduces load times when starting the content server.

The Manage Web Sites page on the content server includes an On-Demand Web Sites button, which opens a page where you can mark sites as "on-demand" sites. There will be a slight delay to serve those sites listed as on-demand when accessed by a user for the first time.

Those sites marked on the Manage On-Demand Web Site page (see "Manage On-Demand Web Sites Page") as on-demand will only have enough information loaded to resolve the URLs associated with those Web sites. For those who run large numbers of Web sites, thus fewer sites are loaded into memory when the server is started, cutting down the start-up time.

Those sites that are on-demand will take slightly longer to load the first time they are requested on the server, as the project file must be fully loaded. Any request for the site from the content server will fully load any on-demand site.

Once a site is loaded in the content server, it will remain loaded.

This section covers the following topics:

"Working with On-Demand Web Sites in the Oracle Content Server Interface."

"Working with On-Demand Web Sites in Designer"

2.8.1 Working with On-Demand Web Sites in the Oracle Content Server Interface.

From the Site Studio Administration page, select Manage Web Sites.

From the Site Studio Administration page, select Manage Web Sites.

The Manage Web Sites page displays (see "Manage Web Sites Page" for more information).

Click Manage On-Demand Web Sites.

The Manage On-Demand Web Sites page displays (see "Manage On-Demand Web Sites Page" for more information).

Select the checkboxes for the Web sites you want to load on-demand, and click Update.

2.8.2 Working with On-Demand Web Sites in Designer

When a Web site is marked as on-demand, the addresses for the sites will still show in the Site Studio Designer Connection Manager without loading any of the Web sites. The population of the address in the Connection Manager does not load any of the Web sites on the server.

However, when a designer opens a site in Site Studio Designer to make any changes, this does load the Web site. This might be something you should consider when selecting which sites to mark as on-demand.

3 Managing Web Site Addresses

Concepts

"About Web Site Addresses"

Tasks

"Adding a Web Site Address"

"Selecting and Deselecting Default Web Addresses"

"Removing a Web Site Address"

3.1 About Web Site Addresses

Site Studio can identify a Web site using a folder address, a domain address, or a combination of both. The Administrator can specify a domain, a folder, or a combination to map to a particular Web site.

A folder-based site, using a folder address, uses only the folder to identify a site. An example of this would be www.example.com/SiteStudio, where the folder SiteStudio identifies the specific site on the domain.

A domain-based site uses simply a domain to identify a site. Examples would be www.example.com, or sales.example.com. The domain identifies the site.

The combination of both uses a domain and a folder (or any number of folders). Common examples of this are to use language folders, such as www.example.com/en/ or www.example.com/fr/.

You can set a Web site address for a Site Studio Web site on the Site Studio Administration page on the content server.

A domain address requires additional DNS configuration that the site manager or site administrator must perform.

3.2 Adding a Web Site Address

Domain addresses are usually easier to remember for people to remember when accessing a site than folder addresses are. Adding domain addresses can then make your site easier to access.

To add a Web site address, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Site Addresses.

The Web Site Addresses page is displayed (see "Web Site Addresses Page").

Note:

You can also use the Site Address dialog in Site Studio Designer to configure domain addresses.

Select a Web site and enter an address. When entering domain addresses, do not enter the connection (for example, http:// or https://)

Click Add.

The Web site address is displayed at the top of the page.

3.3 Selecting and Deselecting Default Web Addresses

When web addresses for the Web sites have been entered, a default web address for a given Web site can be selected, and an existing default web address can be removed as the default. The default web address is the first address listed when Web sites are listed in Site Studio.

Selecting a Default Web Address

To make a Web site address as the default, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration").

Click Manage Web Site Addresses.

The Web Site Addresses page is displayed (see "Web Site Addresses Page"). If you run Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

In the list of Web site addresses, click the actions icon next to the address.

From the menu, select Select as Default Web Address.

The default web address is displayed in bold.

Deselecting a Default Web Address

To deselect a Web site address as the default, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Site Addresses.

The Web Site Addresses page is displayed (see "Web Site Addresses Page").

In the list of Web site addresses, click the actions icon next to the address.

From the menu, select Deselect as Default Web Address.

The default web address is no longer displayed in bold.

3.4 Removing a Web Site Address

When a Web site address is no longer useful, it can be removed.

To remove a Web site address, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Web Site Addresses.

The Web Site Addresses page is displayed (see "Web Site Addresses Page").

In the list of Web site addresses, click the actions icon next to the address to be removed.

From the menu, select Remove Site Address.

The Web site address is no longer included in the list.

4 Managing Fragment Libraries

Concepts

"About Fragment Libraries"

Tasks

"Deploying a Fragment Library on the Server"

"Configuring JSP Fragments on the Server"

4.1 About Fragment Libraries

A fragment can be a single line of text (perhaps one that states your company's copyright), or it can be a complex collection of scripts performing client-side and server-side actions (such as a JavaScript-based menu).

Fragments are compiled in libraries which can be made available to multiple Web sites. A fragment library must be located in the [CS-Dir]\weblayout\fragments directory to be available to your Web site. They are deployed to this location by default when you install Site Studio. However, if you manually check a fragment library into the content server, you must deploy it to this location.

4.2 Deploying a Fragment Library on the Server

If you have a fragment library that is checked into the content server but not deployed to the appropriate directory where it can be used by your site, then you can deploy your fragments in the Site Studio Administration section on the content server.

To deploy a fragment library on the server, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Fragment Libraries.

The Manage Fragment Libraries page is displayed (see "Manage Fragment Libraries Page").

Select the fragment library to deploy.

Click Deploy Fragment Library.

The fragments are deployed to the [CS-Dir]\weblayout\fragments directory on the content server. After this is done, the page refreshes and the Deploy Fragment Library button is disabled again (until you select another library).

As an alternate to performing these steps, you can use the Upload Fragment Library/Download Fragment Library feature in the Designer application. See the Oracle WebCenter Content User's Guide for Site Studio Designer for more information.

4.3 Configuring JSP Fragments on the Server

If, after installing the Site Studio component, you add a group to the list of JSP-enabled groups in the content server, you must redeploy (extract) the JSP support files that enable Site Studio JSP fragments to work properly.

To configure JSP fragments on the server, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Fragment Libraries.

The Manage Fragment Libraries page is displayed (see "Manage Fragment Libraries Page").

Click Configure JSP Support.

The required support files are extracted to the appropriate location on the content server.

4.4 Compressing Contributor JavaScript

There is a lot of JavaScript used to help Contributor load and apply changes that contributors make to a Web site. The JavaScript can be compressed which can improve the performance of serving the Web site. This compression involves stripping out spaces and line breaks, as well as replacing long variable names with single letters. All JavaScript is then concatenated.

To compress the Contributor JavaScript, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Fragment Libraries.

The Manage Fragment Libraries page is displayed (see "Manage Fragment Libraries Page").

Click Compress Contributor JavaScript.

The JavaScript files are compressed and concatenated, then placed on the content server.

5 Setting Default Project Document Information

Concepts

"About Default Project Document Information"

Tasks

"Setting Default Project Document Information"

5.1 About Default Project Document Information

When you create a Web site in Designer, Site Studio generates an XML-based project file and checks it into the content server with certain metadata values. The default document information specifies which fields are automatically filled.

The default project document information is useful to make entering Web site sections easier and grouping them more usefully on the content server.

5.2 Setting Default Project Document Information

To enter the default project document information, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Set Default Project Document Information.

The Set Default Project Document Information page is displayed (see "Set Default Project Document Information Page").

Enter the information for the default values in the applicable fields. All required metadata fields have red-colored field labels. If a field does not need or should not have default information, you can leave it blank.

Click Update (at the bottom of the page).

6 Managing Site Replication

Concepts

"About Site Replication"

"Replication Process"

"What Gets Replicated"

"Revisions Included"

"Additional Export Settings"

Tasks

"Configuring the Target Server for Replication"

"Setting Up an Outgoing Provider on the Source Server"

"Setting Up the Import Archive on the Target Server"

"Setting Up the Export Archive on the Source Server"

"Starting the Site Replication"

"Setting Up "Ready to Replicate""

6.1 About Site Replication

To better understand replication, you should be aware of the terminology and processes that are involved. Because Site Studio relies on the content server's Archiver/Replicator tool to replicate the site, you can refer to the content server documentation for more information.

To replicate your site, you must perform several steps to ensure that the site works properly on the server that you are copying it to (the target server). You must prepare that server environment, configure the two servers so that they communicate with one another, set up archives on both servers, and finally, perform the actual replication.

Most of the replication features are on the Manage Site Replication page on the content server, but you can also use the Site Studio Replicator tool to customize the replication even more. Site Studio Replicator is installed with Site Studio Designer, and is a four-part wizard. For more information on the Replicator installed alongside Designer, see the Oracle WebCenter Content User's Guide for Site Studio Designer.

When you replicate a site, you copy the site hierarchy, page templates, fragments, contributor data files, native documents, site assets, and more. The replication feature in Site Studio uses the existing replication framework in the content server (Archiver/Replicator).

6.2 Replication Process

The replication process in Site Studio includes a source server, a target server, an export archive, an import archive, and the transfer.

Figure 6-1 Replication Process

Export: Native files, web-viewable files, content types, and user attributes are copied out of the source content server into an export archive.

Import: Files and content server information are copied from an import archive to the target content server.

Transfer: Content is transferred from one content server to another. This function can be used to copy content across a firewall or between two servers that do not have access to the same file system. You can also transfer archives between two content servers that have access to the same file system.

Replicate: Automates the export, import, and transfer steps. You can use replication to automatically export from one content server, transfer the archive to another computer, and then import to another content server.

When you replicate your site from one content server to another, the Site Studio replication feature exports the contents of your site into an export archive. The contents of this export archive is subsequently copied into an import archive which resides on the target server. The import archive is then extracted to that server so that your site can be viewed and used again on the server.

You create the export archive on the source server and an import archive on the target server. You must create the import archive on the target server first, however, so that you can point the export archive to that location when you set one up.

The replication process consists of several steps:

"Configuring the Target Server for Replication"

"Setting Up an Outgoing Provider on the Source Server"

"Setting Up the Import Archive on the Target Server"

"Setting Up the Export Archive on the Source Server"

"Starting the Site Replication"

6.3 What Gets Replicated

When you use the Site Studio replication feature to replicate your site from one content server to another, the following items are included:

Project file (the dDocName of the project file)

Web site ID (where the xWebsites field contains the site ID of the site)

Web site sections (where the xWebsiteSection field contains the site ID of the site)

Fragment libraries (where the xWebsiteObjectType field contains the value "fragment")

It is important that the metadata values for xWebsites, xWebsiteSection, and xWebsiteObjectType be used correctly on your site in order for the contents of the site to be replicated.

6.4 Revisions Included

Revisions with a release date later than the most recent export date are exported. This prevents archives from exporting material that has been exported, which ensures the migration of content only once and prevents the unfettered growth in the size of the archives. Furthermore, all selected revisions of content that match the export query are exported to the archive. This works in tandem with the release date filter to ensure that the required Web site content is replicated.

6.5 Additional Export Settings

The Site Studio replication feature includes several other useful settings to ensure that your site is successfully replicated:

Configuration information for the content is included for administrators who plan to synchronize metadata models between two content servers. (Site Studio does not use this information.)

The source archive is identified as the transfer owner (the content server that initiates the transfer from the source archive to the target archive).

The import archive on the target server is identified as the target archive, which takes responsibility for receiving material exported and transferred from a source server and then imports the material into the target server.

6.6 Configuring the Target Server for Replication

The Site Studio replication feature copies your site from one content server to another. If it does not, however, copy the content server environment from the source server to the target server.

Before you replicate the site, you must make sure the content server environment on the target server is set up the same way as the source server (at least the parts used by your site). If you skip this step, your Web site will experience problems during the replication process.

The steps to reproduce the content server environment vary from one organization to another and from one Web site to another. As such, we offer these general guidelines.

To manually configure the target server environment, perform these steps:

Recreate the metadata model used on the source server. This includes all custom metadata fields and file formats. This metadata is required for your site to operate properly. For example, checking in files generally relies on your metadata settings, and certain features on your site rely on custom metadata fields.

Reinstall all components used by your site on the source server. This includes Dynamic Converter (for native documents) and Check Out and Open (to check native documents out using the contribution icon).

Recreate unmanaged resources. This includes custom ActiveX controls or JSP objects that are used by your site.

Recreate any additional configuration settings that you have introduced to the server. This includes anything that has changed the behavior of the server.

If you use Oracle Content Server version 7.5.2 or later (including 10gR3), you may be able to use Oracle Content Server's Configuration Migration Utility to replicate the content server environment. The next step is to set up an outgoing provider (see "Setting Up an Outgoing Provider on the Source Server").

6.7 Setting Up an Outgoing Provider on the Source Server

In Oracle Content Server, a provider is an API (Application Programming Interface) that establishes a connection between two or more content servers. To replicate a Web site, you must create an outgoing provider on the source server that establishes a connection between it and the target server.

After you configure the target server (see "Configuring the Target Server for Replication"), you are ready to set up an outgoing provider on the source server.

To set up an outgoing provider on the source server, perform these steps:

Log in to the content server as an administrator.

Click Providers.

The Providers page is displayed.

Under Create a New Provider, click Add beside the "outgoing" provider type.

The Add Outgoing Provider page is displayed

Enter the following information:

Provider Name: A name to identify the provider. The name appears in the providers list on this page (after you add one), and it becomes a subdirectory in the [CS-Dir]/data/providers on the source server.

Provider Description: A friendly description for the provider.

Provider Class: Enter intradoc.provider.SocketOutgoingProvider (the name of the Java class for outgoing providers).

Connection Class: Enter intradoc.provider.SocketOutgoingConnection (the name of the Java class that implements provider connections).

Configuration Class: May be left empty (this identifies a Java class for additional configuration settings, useful for database providers).

Server Host Name: The name (typically, the system name or IP address) of the target server. A socket connection is made to this host.

HTTP Server Address: May be left empty (this is the http address of the target server, which is not necessary for this type of connection).

Server Port: The port (typically, 4444) used to communicate with the target server. You can determine the port by viewing the server output when starting the content server.

Instance Name: The name (IDC_Name) of the target content server.

Relative Web Root: The relative web root for the target content server (for example, /root/) You can skip the remaining options as they are not required for this type of connection.

Click Add to save the provider information and return to the Providers page. (You see your outgoing provider in the providers list.)

Restart the content server.

To test the provider and make sure it was properly set up, return to the Providers page and click Test beside the outgoing provider.

In addition to setting up the outgoing provider, you may still must configure the server IP address filter on the target system so that the source server is allowed to communicate with the target server (for more information, see the Content Server documentation).

If there is a firewall in place, you must allow connections from the source server to the target server on the port defined in step 4.

The next step is to create an import archive (see "Setting Up the Import Archive on the Target Server").

6.8 Setting Up the Import Archive on the Target Server

An import archive resides on the target content server. During replication, content from an export archive (residing on a source server) is copied into the import archive. The import archive then copies the content to the target content server, thus completing the replication process.

After you set up a provider connection (see "Setting Up an Outgoing Provider on the Source Server"), you are ready to create an import archive. You create (or edit) an import archive on the Manage Site Replication page on the target server.

To set up an import archive, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Site Replication.

The Manage Site Replication page is displayed (see "Manage Site Replication Page").

Click Add Import Archive....

The Add Import Archive page is displayed (see "Add Import Archive Page").

Or, if you are updating an existing import archive, select it in the list of archives and click Change Settings....

Enter a name for the archive in the Archive Name field. This name appears in the list of available archives on the Manage Site Replication page. The archive name should not contain any spaces or special characters.

Enter a description of the archive in the Archive Description field.

To retain content that contributors assign to each region on the target site, select the Retain switched region content on target server during import check box.

These are the areas where a contributor has switched the contributor data file or native document originally assigned to a region.

You would typically choose to retain switched region content if you are replicating from a development server (source) to a contribution server (target), because in that scenario you want to preserve the changes made by a contributor.

You would likely disable this option if you are replicating from a contribution server (source) to a consumption server (target), because in that scenario you want to overwrite anything that has changed on the consumption server.

To retain content that contributors edit in each region on the target site, select the Retain region content on target server during import check box.

This prevents any contributor data files and native documents from being copied from the source server to the target server, which would potentially overwrite files edited by contributors.

You would typically choose to retain region content if you are replicating from a development server (source) to a contribution server (target), because in that scenario you want to preserve the changes made by a contributor.

You would likely disable this option if you are replicating from a contribution server (source) to a consumption server (target), because in that scenario you want to overwrite anything that has changed on the consumption server.

Click Add Archive.

Or, if you are updating an existing import archive, click Update.

The next step is to create an export archive (see "Setting Up the Export Archive on the Source Server").

6.9 Setting Up the Export Archive on the Source Server

An export archive resides on the source content server, where it collects information from the Web site. During replication, the export archive is copied to an import archive residing on the target server. (That import archive must be created first so that you can point to it when you create the export archive.)

After you create an import archive (see "Setting Up the Import Archive on the Target Server"), you are ready to create an export archive. You create (or edit) an export archive using the Manage Site Replication page on the source server.

To set up an export archive, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Manage Site Replication.

The Manage Site Replication page is displayed (see "Manage Site Replication Page").

Click Add Export Archive.

The Add Export Archive page is displayed (see "Add Export Archive Page").

Or, if you are updating an existing export archive, select it in the list of archives and click Change Settings.

Enter a name for the archive in the Archive Name field. This name appears in the list of available archives on the Manage Site Replication page. The archive name should not contain any spaces or special characters.

Enter a description of the archive in the Archive Description field.

Choose the Web site to replicate in the Web Site menu.

Select the Include project file in export archive check box to replicate your entire site hierarchy.

If you do not want to replicate the entire site hierarchy and instead want to replicate individual sections, then clear this check box, continue with the steps below, and then use the Site Studio Replicator tool (see the Oracle WebCenter Content User's Guide for Site Studio Designer).

For Transfer to Collection, select the collection on the target content server where this archive is copied to.

Click Open Collection... to browse to the collection on the target server and select it.

For Transfer to Archive, select the archive on the target server where this export archive is copied to (see "Setting Up the Import Archive on the Target Server").

Select the Automatically export new and changed content check box if you want the replication process to be automatic whenever content on the source server changes. (If you do not enable this option, you must manually trigger the replication.)

Click Add Archive.

Or, if you are updating an existing export archive, click Update.

When you select a Web site for the export archive, Site Studio archives and replicates everything related to your site (see "What Gets Replicated"). To customize what gets archived or to add more items to the archive, you can refine the archive query directly using the Archiver applet on the content server.

The next step is to start the replication (see "Starting the Site Replication").

If you plan to use Site Studio Replicator to replicate individual sections of your site, then the next step is launch the Site Studio Replicator tool (see the Oracle WebCenter Content User's Guide for Site Studio Designer).

6.10 Starting the Site Replication

Once you have set up an export archive (see "Setting Up the Export Archive on the Source Server"), you are ready to initiate the replication process on the source server using the Manage Site Replication page.

To replicate your Web site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration").

Click Manage Site Replication.

The Manage Site Replication page is displayed (see "Manage Site Replication Page").

Select the desired export archive.

Click Export.

If you chose to automatically export new and changed content (see "Setting Up the Export Archive on the Source Server"), then the replication process is automatic after you export the archive.

Depending on the size and complexity of your site, you should allow plenty of time for the target content server to re-index your site after the replication is complete.

6.11 Setting Up "Ready to Replicate"

Site Studio allows the contributor to change the contributor data file, or even replace it with a new file. However, the manager can step in to make sure the new contributor file is ready for replication before the page is replicated.

When Ready to Replicate is a field in the section properties for each section and home page of a Web site. The designer enables the section property in Designer. For more information on enabling Ready to Replicate in Designer, see the Oracle WebCenter Content User's Guide for Site Studio Designer.

Once Ready to Replicate is enabled, it allows the manager to determine which sections, or even the primary or secondary pages in a section, can be replicated, and which will not. More importantly, whenever the content file for a placeholder is switched, the status of the section will change from Replicate (Figure 6-2) to Don't Replicate (Figure 6-3).

Figure 6-2 Page Marked For Replication

Figure 6-3 Pages Marked For No Replication

Since contributors can switch the contributor data files, or even create a new, blank file in each case, the manager has control over the replication to ensure that some pages don't end up with blank information from the creation of a new file. Whenever someone changes the contributor data file, the page is marked as Don't Replicate, regardless of the security level of the person who made the change.

The designer can also mark a section for replication, or to prevent replication, by setting the appropriate Ready to Replicate section properties field value in Designer. However, it is expected that the manager will handle all tasks related to replication, and thus would handle the review of pages marked as Don't Replicate.

7 Backing Up and Restoring Web Sites

Concepts

"About Backup and Restore"

Tasks

"Backing Up Your Site"

"Restoring Your Site"

"Viewing the Server Configuration Details"

7.1 About Backup and Restore

Site Studio offers a backup and restore feature on the Site Studio Administration page on the content server that you can use to create a backup of your site (as a single zip file) and restore the backup at any time. Creating a backup of your site is also a great way to transport the site from one location to another (especially where there is no network access).

The Site Studio backup feature creates a copy of your Web site and stores it in a compressed file that you can then copy from one location to another. In order to recognize the files that belong to your site, it performs a query for the following items and adds them to the import archive:

Project file (the dDocName of the project file)

Web site ID (where the xWebsites field contains the site ID of the site)

Web site sections (where the xWebsiteSection field contains the site ID of the site)

Fragment libraries (where the xWebsiteObjectType field contains the value "fragment")

It is important that the metadata values for xWebsites, xWebsiteSection, and xWebsiteObjectType be used correctly on your site in order for the contents of the site to be backed up and restored.

The backup feature uses the same archiving process that is used in site replication (see Chapter 6, "Managing Site Replication" for more details).

7.2 Backing Up Your Site

You back up your site using the Backup and Restore page, which is accessible from the Site Studio Administration page on the Oracle Content Server.

To back up your site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Backup and Restore.

The Backup and Restore page is displayed (see "Backup and Restore Page").

Select the Web site to back up, and click Create Web Site Backup.

The progress of the backup is shown (Figure 7-1).

Figure 7-1 Backup Progress

Click Back when the backup is done (that is, the completion percentage is 100%).

You can go back to the previous page at any time without affecting the current backup.

On the Backup and Restore page, click Manage Web Site Backups.

The Web Site Backup Archives page is displayed (see "Manage Archives Page").

This page shows a list of all Web site backups that are currently on the content server. To download the backup that you created, click the actions menu icon (Figure 7-2) next to it, and choose Download backup archive as ZIP.

Figure 7-2 Actions Menu Icon

Depending on the size of your site, you may have to wait several minutes for the zip file to be created.

Click Save in the file download dialog, choose a location for the zip file, and click Save to begin the download.

Note:

If your Web site exceeds the maximum file limit of 65,535 in a zip file, then the backup archive file is not created. Instead, you must open the backup archive directly from the file system and download it from there. Backup archives are stored in the [CS-Dir]\data\sitestudio\backuparchives directory on the content server.

You can delete a backed-up site at any time by clicking the actions menu or icon and then choosing Delete backup archive. You can do this on the Web Site Backup Archives page (see "Manage Archives Page") and the Backup Archive Information page (see "Backup Archive Information Page").

7.3 Restoring Your Site

You restore your site using the Backup and Restore page, which is accessible from the Site Studio Administration page on the content server.

Important:

To prevent clashes with existing content in the content server, it is recommended that you restore to a clean content server.

To restore your site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Backup and Restore.

The Backup and Restore page (see "Backup and Restore Page") is displayed.

Click Browse (in the Upload Backup Archive area) to locate the backed-up site (zip file).

A file selection dialog is displayed.

Select the archive zip file and close the file selection dialog.

Click Upload Backup Archive.

The Backup Archive Information page is displayed (see "Backup Archive Information Page"), where you see the details of the backup, including the archive name, description, Web site, and date of import.

If you have not configured the content server so that it matches the content server environment where the site originated, click Actions and choose Show server configuration details. Then re-create the settings that you see on that page (see "Viewing the Server Configuration Details").

In the Actions menu, choose Restore backup archive contents.

Click OK to the confirmation message.

The progress of the restore operation is shown (Figure 7-3).

Figure 7-3 Restore Progress

Depending on the size of your site, you may have to wait several minutes for the Web site to be restored and then indexed by the content server.

Click Back when the restore operation is done (that is, the completion percentage is 100%).

You can go back to the previous page at any time without affecting the current restore operation.

You can now use your site on the content server.

You can delete a backed-up site at any time by clicking the actions menu or icon and then choosing Delete backup archive. You can do this on the Web Site Backup Archives page (see "Manage Archives Page") and the Backup Archive Information page (see "Backup Archive Information Page").

7.4 Viewing the Server Configuration Details

You can view detailed configuration information for the content server that a backed-up Web site was located on at the time of the backup. This information includes the custom metadata fields, content types, security groups, configuration and environment settings, installed components, defined providers, and so on. This information is especially useful when you must restore a site and want to configure the content server so that it matches the server where the site originated.

To view the server configuration details of a backed-up site, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click Backup and Restore.

The Backup and Restore page (see "Backup and Restore Page") is displayed.

Click Manage Web Site Backups.

Click the actions menu icon (Figure 7-4) next to the desired site, and choose Show server configuration details.

Figure 7-4 Actions Menu Icon

The Server Configuration Details page is displayed (see "Server Configuration Details Page"), where you can note the details of the server where the site originated.

Note:

You may want to use Oracle Content Server's Configuration Migration Utility to replicate the content server environment from one server to another.

8 General Component Information

Concepts

"About General Component Information"

Tasks

"Viewing General Component Information"

"Resetting the Install Number"

8.1 About General Component Information

You can find information about the installed Site Studio component, Site Studio-specific metadata, directory paths, versions, and other information on the General Component Information page. This information may be useful for noting the version numbers and relative paths for Web sites and fragments.

8.2 Viewing General Component Information

To view the general component information for Site Studio, perform these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click General Component Information.

The General Component Information page is displayed (see "General Component Information Page").

8.3 Resetting the Install Number

The Install Number is the number of the current Site Studio component. It is used to track what software updates will install when you update your Site Studio component. New components will only install the necessary changes compared to the current install number.

In most cases, the install number will not be important. But in those few cases where you may wish to eliminate all changes, and create a fresh installation, resetting the install number might be necessary.

To reset the install number, follow these steps:

Log in to the content server as an administrator.

In the Administration section, select Site Studio Administration.

The Site Studio Administration page is displayed (see "Site Studio Administration"). If you run Oracle Content Server in the Top Menus layout, you do not see this page. Instead, all administration options are then items in the Site Studio Administration menu.

Click General Component Information.

The General Component Information page is displayed (see "General Component Information Page").

Click (Reset).

The install number is set to 0.

A User Interface

The Content Server interface includes various pages that you can use to administer and manage your Site Studio Web sites:

"Manage Web Sites Page"

"Manage Site Page (Site Studio Manager)"

"Manage On-Demand Web Sites Page"

"Web Site Objects Report Page"

"Web Site Addresses Page"

"Manage Fragment Libraries Page"

"Set Default Project Document Information Page"

"Manage Site Replication Page"

"Add Export Archive Page"

"Edit Export Archive Page"

"Add Import Archive Page"

"Edit Import Archive Page"

"General Component Information Page"

"Backup and Restore Page"

"Manage Archives Page"

"Server Configuration Details Page"

"Backup Archive Information Page"

"Server Configuration Details Page"

"External Applications Administration page"

A.1 Manage Web Sites Page

The Manage Web Sites page is used to manage all available Web sites on the content server. From here you can view the Web site, view the objects report, start or stop the Web site (make it available or unavailable to view), and control the management of each selected Web site as described in this document.

Figure A-1 Manage Web Sites Page

Element
Description

Web Sites
This area lists all Web sites that are managed by the content server. All sites that are currently up and available are listed under "Running Web Sites," and all sites that are not running are under "Stopped Web Sites."

View Web Site
Click this button to view the selected Web site in your web browser.

Update Navigation
Click this button to update the navigation of the selected Web site. As a site manager, you can modify the structure of a Web site, including adding and removing directories and subdirectories, or moving directories into other areas of the Web site. If you alter the site structure, then all site navigation should be updated (rebuilt).

View Web Site Objects Report
Click this button to view the Web Site Objects Reports page for the selected site (see "Web Site Objects Report Page"). This page details the activity of use of each part of a Web site.

Manage Site
Click this button to see the Manage Site page for the selected site (see "Manage Site Page (Site Studio Manager)"). This page enables you to perform several site management tasks, such as modifying the site hierarchy, assigning page templates, and changing custom properties.

Stop Site
Click this button to stop the selected site. The site then moves from the "Running Web Sites" list to the "Stopped Web Sites" list in the Web Sites area.

Start Site
Click this button to start the selected site. The site then moves from the "Stopped Web Sites" list to the "Running Web Sites" list in the Web Sites area.

Reload Web Sites
Click this button to reload the page. When sites are started and stopped, occasionally the list of the running and the stopped Web sites must be refreshed to reflect the current status.

Manage On-Demand Web Sites
Click this button to open the On-Demand Web Sites page (see "Manage On-Demand Web Sites Page").

A.2 Manage Site Page (Site Studio Manager)

The Manage Site page is used to perform several management tasks for a Web site. This page may be accessible through the content server or Site Studio Contributor (if the designer set it up that way). If the Manager fragment appears on a page in Contributor and the page is in contribution mode, the tools available to the site manager appear within the application. They then appear either minimized (that is, just the top bar) or with the interface fully displayed within the page. To show the full Manager interface, click manage site in the bar. When accessed through the content server, the full interface is always shown.

Figure A-2 Manager Interface

The site hierarchy of the current Web site is shown on the left. You can right-click any item and perform several management tasks.

This page may have four tabs, each of which provides specific site management options:

Section Tab

Page Template Tab

Secondary Page Template Tab

Custom Properties Tab

A.2.1 Section Tab

The Section tab on the Manage Site page is used to manage the sections within the hierarchy of the Web site, which includes adding and removing sub-sections, moving sections, and mark the error handler section of the Web site.

Figure A-3 Section Tab of Manage Site Page

Element
Description

Add
Click to add a sub-section to the current section. See "Adding a Section" for more information.

Remove
Click to remove the current section from the Web site. See "Removing a Section" for more information.

Move
Click to move the current section to a different area of the site hierarchy. See "Moving a Section" for more information.

error handler
Click to mark the current section as the error handler section. See "Designating a Section as an Error Handler" for more information.

Section ID
This is the section ID that uniquely identifies the current section in the site hierarchy (and the content server). This field is typically disabled because changing it can break links that target this section.

Section Label
This is the name of the current section. The name is displayed in the site hierarchy and in the navigation menus on the Web site (but not necessarily in the URL). You can change the section label if you want. See "Renaming a Section" for more information.

Include in Navigation
Select this check box if you want the current section to be displayed as a link in the navigation menus on the Web site. See "Showing or Hiding a Section on the Web Site" for more information.

Contributor Only
Select this check box if you want the current section to appear only when the site is viewed in contribution mode. This may be useful, for example, to communicate directly with contributors or to preview content before making it publicly available. See "Designating a Section as Contributor-Only" for more information.

Url Directory Name
This is the directory name of the current section as it appears in the site URLs. For example, in the address http://www.example.com/product1/index.htm, the URL directory name is "product1." This value is also used in all path-based links to this section. By default, the URL directory name is identical to the section label, but you can use a different value if you want. The name should not contain any spaces or special characters.

Url Page Name
This is the URL that represents the primary page (associated with the current section) in the Web site address. If you do not specify a URL page name, then "index.htm" is used to represent the primary page.

Maximum Age
This is the maximum amount of time (in seconds) that a Web site page in the current section remains in cache. This improves the performance and security of a Site Studio Web site. See "Changing the Maximum Age of a Section" for more information.

A.2.2 Page Template Tab

The Page Template tab on the Manage Site page is used to view the web page using the current page template. Additional page templates can be applied and previewed against the current section as well.

Figure A-4 Page Template Tab of Manage Site Page

Element
Description

Info icon

Click the icon to open the content information page for the current page template. This does not appear if the page template has not been set.

clear
Click to remove the page template from the current section. This does not appear if the page template has not been set. See "Removing a Page Template From a Section" for more information.

Preview page template (menu)
Select a page template from the list to view within the current section. See "Previewing Page Templates" for more information.

Apply
Click to apply the selected page template to the current section. See "Assigning a Primary Page to a Section" for more information.

A.2.3 Secondary Page Template Tab

The Secondary Page Template tab on the Manage Site page is used to view the web page using the current secondary page template. Additional page templates can be applied and previewed against the current section as well.

Figure A-5 Secondary Page Template Tab of Manage Site Page (With No Page Selected)

Element
Description

Info icon

Click the icon to open the content information page for the current page template. This does not appear if the secondary page template has not been set.

clear
Click to remove the page template from the current section. This does not appear if the secondary page template has not been set. See "Removing a Page Template From a Section" for more information.

Preview page template (menu)
Select a page template from the list to view within the current section. See "Previewing Page Templates" for more information.

Apply
Click to apply the selected page template to the current section. See "Assigning a Secondary Page to a Section" for more information.

A.2.4 Custom Properties Tab

The Custom Properties tab on the Manage Site page is used to edit the custom property information for the selected section in the site hierarchy. All custom properties are determined by the site designer. Section properties cannot be added or removed by a manager; only their values can be edited.

Figure A-6 Custom Properties Tab of Manage Site Page

Note:

Contact your site designer regarding the proper use of the custom properties.

A.3 Manage On-Demand Web Sites Page

The Manage On-Demand Web Sites page is used to mark sites as "on-demand" sites. The Web sites designated as "on-demand" are not loaded into the content server's memory until a request is received to load the site. This reduces load times when starting the content server. There will be a slight delay to serve the sites listed as "on-demand" when you access them in Designer for the first time.

Figure A-7 Manage On-Demand Web Sites page

Element | Description
Check box | Select the check box to mark the site as an on-demand Web site.
Web Site ID | The site ID of the Web site on the content server.
Web Site | The name of the Web site on the content server.
Content ID | The content ID of the Web site on the content server.
Status | Displays which sites are loaded or not loaded into server memory.

A.4 Web Site Objects Report Page

The Web Site Objects Report page shows site usage reports for all Web site objects marked for reporting. You can see information about several object categories, including page templates, contributor data files, page template fragments, fragment libraries, Web site assets, and the Web site project.

Figure A-8 Web Site Objects Report Page

Element
Description

Object categories
Click any of the object categories to see the report specific to that category.

Content ID
The content ID of the object in the content server.

Usage Detail
The specific information on the Web site object and where it was referenced.

Click this icon to see the content information page for the object.

A.5 Web Site Addresses Page

The Web Site Addresses page is used to manage the site addresses for all available Web sites on the content server. You can view the defined site addresses, and add addresses or remove existing ones.

There are two ways to access your site: using a folder address or a domain address. When you first set up your site, you can use the folder address, like http://MyComputer/MySite (where MyComputer is the name of the system and MySite is the site ID). Sooner or later, however, you will likely want to use a domain address, like http://www.example.com (where example.com is your domain name) as a more convenient and public way to access your site.

A domain address requires additional DNS configuration that you or a site administrator must perform.

You can also use the Site Address dialog box in Designer to configure domain addresses.

Figure A-9 Manage Web Site Addresses Page

Element
Description

Web Site Addresses
Displays existing site addresses that are configured for the specified site.

Click the menu icon in the Action column for more options:

Select As Default Address: Makes this address the default site address.

Remove Site Address: Removes this address from the Web site.

Add Web Site Address
Web Site: Use this menu to select a Web site on the content server.

Address: Enter the domain name to use. (You can add multiple domain names for your site.)

Add
Adds the domain name to your site.

A.6 Manage Fragment Libraries Page

The Manage Fragment Libraries page is used to deploy fragment libraries to their required location on the content server. The libraries must be in the [CS-Dir]\weblayout\fragments directory to be available to your Web site. They are deployed to this location by default when you install Site Studio. However, if you manually check a fragment library into the Oracle Content Server, you must deploy it to this location.

The Manage Fragment Libraries page is also used to configure JSP support for JSP-enabled Web sites. If, after installing the Site Studio component, you add a group to the list of JSP-enabled groups in the Oracle Content Server, you must redeploy (extract) the JSP support files that enable Site Studio JSP fragments to work properly.

Figure A-10 Manage Fragment Libraries Page

Element
Description

Fragment Libraries
Displays all fragment libraries currently checked into the content server.

Deploy Fragment Library
Click to copy the selected fragment library to its required location on the content server ([CS-Dir]\weblayout\fragments), where it is available to Site Studio. You must select a fragment library in the list before this button becomes available.

As an alternative to this deployment method, you can use the Upload Fragment Library/Download Fragment Library element in Designer.

Configure JSP Support
Click to redeploy (extract) JSP support files to the necessary location on the content server so that JSP fragments work properly.

Compress Contributor JavaScript
Click to compress the Contributor JavaScript in the published Web site. This often improves performance of the pages in a Web site.

A.7 Set Default Project Document Information Page

The Set Default Project Document Information page is used to define the default metadata (that is, content information) for Site Studio project files.

When you create a Web site in Designer, Site Studio generates an XML-based project file and checks it into the content server with certain metadata values. The default document information specifies which fields are automatically filled.

Figure A-11 Set Default Project Document Information Page

Element
Description

Metadata fields
Display all of the available metadata values in the content server that can be assigned to a Site Studio project file.

Enter the information for the default values in the applicable fields. All required metadata fields have red-colored field labels. If a field does not need or should not have default information, you can leave it blank.

Update
Click to update the metadata that is assigned to a Site Studio project file automatically.

Reset
Resets the page to its initial state when it was launched.

A.8 Set Default Web Asset Document Information Page

The Set Default Web Asset Document Information page is used to define the default metadata (that is, content information) for Site Studio Web site assets, such as templates, images, or definitions.

This allows Site Studio to use default metadata when checking in web assets.

Figure A-12 Set Default Web Asset Document Information Page

Element
Description

Metadata fields
Display all of the available metadata values in the content server that can be assigned to a Site Studio Web site asset.

Enter the information for the default values in the applicable fields. All required metadata fields have red-colored field labels. If a field does not need or should not have default information, you can leave it blank.

Update
Click to update the metadata that is assigned to a Site Studio Web site asset automatically.

Reset
Resets the page to its initial state when it was launched.

A.9 Manage Site Replication Page

The Manage Site Replication page is used to manage the replication of Web sites from one content server to another. During this process, you must create an export archive on the source server and an import archive on a target server.

Before you perform these steps, you must configure the content servers so that they communicate with one another.

Figure A-13 Manage Site Replication Page

Element
Description

Site Studio Archives
Displays all export and import archives currently checked into the content server.

Add Export Archive
Click to open the Add Export Archive page (see "Add Export Archive Page"), where you can create an export archive (on the source server).

Add Import Archive
Click to open the Add Import Archive page (see "Add Import Archive Page"), where you can create an import archive (on the target server).

Change Settings
Click to open the Edit Export Archive page (see "Edit Export Archive Page") or Edit Import Archive page (see "Edit Import Archive Page"), where you can edit the properties of an existing archive.

Delete
Click to delete the selected archive.

Export
Click to export the selected archive to the target server and initiate the replication process.

Once you export the archive, the replication process is automated. You do not have to import the archive on the target content server, manually transfer the archive, and so on.

Show Archiver Status
Click to display the progress of an existing archive (that replicates to a target server).

Archiver
Click the icon to launch the Archiver utility on the content server.

See the Content Server documentation for more information on Archiver and the archiving process.

Archiver Logs
Click the icon or the link to display the list of archive logs available to review.

See the Content Server documentation for more information on the Archiver logs and log files in general.

A.10 Add Export Archive Page

The Add Export Archive page is used to create an export archive file, which is used in the process of replicating a Web site from one content server to another. An export archive resides on the source server, where it collects information from the Web site. During replication, the export archive is copied to an import archive, which resides on the target server.

You must create an import archive on the target server before you create an export archive on the source server.

Figure A-14 Add Export Archive Page

Element
Description

Archive Type
Specifies whether this is an export or import archive (this option is marked for you).

Archive Name
Name of the archive. The name appears in the list of available archives on the Manage Site Replication page (see "Manage Site Replication Page").

The archive name should not contain any spaces or special characters.

Archive Description
Description of the archive.

Web Site
Identifies the Web site to create an export archive from and then replicate. Select the Web site from the menu.

Include project file in export archive: Select this check box if you want the project file to be included in the archive, which means you replicate the entire site. If you only want to replicate certain sections, clear this check box.

Transfer to Collection
Identifies the collection for the import archive on the target server where this export archive is copied to.

Open Collection: Click to open a browse dialog where you can select the collection on the target server.

Transfer to Archive
Identifies the import archive on the target server where this export archive is copied to.

Automatically export new and changed content: Select this check box if you want content that has changed on the source server to be replicated to the target server automatically. If you do not enable this option, you must manually trigger the replication.

Add Archive
Adds the export archive and returns you to the Manage Site Replication page (see "Manage Site Replication Page").

Cancel
Cancels your settings and returns you to the Manage Site Replication page (see "Manage Site Replication Page").

A.11 Edit Export Archive Page

The Edit Export Archive page is used to edit the properties of an existing export archive file, which is used in the process of replicating a Web site from one content server to another. An export archive resides on the source server, where it collects information from the Web site. During replication, the export archive is copied to an import archive, which resides on the target server.

Figure A-15 Edit Export Archive Page

Element
Description

Archive Type
Specifies whether this is an export or import archive (this option is marked for you).

Archive Name
Name of the archive. The name appears in the list of available archives on the Manage Site Replication page (see "Manage Site Replication Page").

The archive name should not contain any spaces or special characters.

Archive Description
Description of the archive.

Web Site
Identifies the Web site to create an export archive from and then replicate.

Transfer to Collection
Identifies the collection for the import archive on the target server where this export archive is copied to.

Open Collection: Click to open a browse dialog where you can select the collection on the target server.

Transfer to Archive
Identifies the import archive on the target server where this export archive is copied to.

Automatically export new and changed content: Select this check box if you want content that has changed on the source server to be replicated to the target server automatically. If you do not enable this option, you must manually trigger the replication.

Update
Click to update the export archive and return to the Manage Site Replication page (see "Manage Site Replication Page").

Cancel
Click to cancel your settings and return to the Manage Site Replication page (see "Manage Site Replication Page").

A.12 Add Import Archive Page

The Add Import Archive page is used to create an export archive file, which is used in the process of replicating a Web site from one content server to another. An import archive resides on the target server. During replication, content from the export archive is copied into the import archive. The import archive then copies the content to the target content server.

Figure A-16 Add Import Archive Page

Element
Description

Archive Type
Specifies whether this is an import or export archive (this option is marked for you).

Archive Name
Name of the archive. The name appears in the list of available archives on the Manage Site Replication page (see "Manage Site Replication Page").

The archive name should not contain any spaces or special characters.

Archive Description
Description of the archive.

Retain switched region content on target server during import
Select this check box you want to retain content that contributors assign to each region on the target Web site. These are the areas where a contributor has switched the contributor data file or native document originally assigned to a region.

You would typically choose to retain switched region content if you are replicating from a development server (source) to a contribution server (target), because in that scenario you want to preserve the changes made by a contributor.

You would likely disable this option if you are replicating from a contribution server (source) to a consumption server (target), because in that scenario you want to overwrite anything that has changed on the consumption server.

Retain region content on target server during import
Select this check box if you want to retain the content that contributors edit in each region on the target Web site.

This prevents any contributor data files and native documents from being copied from the source server to the target server, which would potentially overwrite files edited by contributors.

You would typically choose to retain region content if you are replicating from a development server (source) to a contribution server (target), because in that scenario you want to preserve the changes made by a contributor.

You would likely disable this option if you are replicating from a contribution server (source) to a consumption server (target), because in that scenario you want to overwrite anything that has changed on the consumption server.

Add Archive
Click to add the import archive and return to the Manage Site Replication page (see "Manage Site Replication Page").

Cancel
Click to cancel your settings and return to the Manage Site Replication page (see "Manage Site Replication Page").

A.13 Edit Import Archive Page

The Edit Import Archive page is used to edit the properties of an existing import archive file, which is used in the process of replicating a Web site from one content server to another. An import archive resides on the target server. During replication, content from the export archive is copied into the import archive. The import archive then copies the content to the target content server.

Figure A-17 Edit Import Archive Page

Element
Description

Archive Type
Specifies whether this is an import or export archive (this option is marked for you).

Archive Name
Name of the archive. The name appears in the list of available archives on the Manage Site Replication page (see "Manage Site Replication Page").

The archive name should not contain any spaces or special characters.

Archive Description
Description of the archive.

Retain switched region content on target server during import
Select this check box you want to retain content that contributors assign to each region on the target Web site. These are the areas where a contributor has switched the contributor data file or native document originally assigned to a region.

You would typically choose to retain switched region content if you are replicating from a development server (source) to a contribution server (target), because in that scenario you want to preserve the changes made by a contributor.

You would likely disable this option if you are replicating from a contribution server (source) to a consumption server (target), because in that scenario you want to overwrite anything that has changed on the consumption server.

Retain region content on target server during import
Select this check box if you want to retain the content that contributors edit in each region on the target Web site.

This prevents any contributor data files and native documents from being copied from the source server to the target server, which would potentially overwrite files edited by contributors.

You would typically choose to retain region content if you are replicating from a development server (source) to a contribution server (target), because in that scenario you want to preserve the changes made by a contributor.

You would likely disable this option if you are replicating from a contribution server (source) to a consumption server (target), because in that scenario you want to overwrite anything that has changed on the consumption server.

Update
Click to update the import archive and return to the Manage Site Replication page (see "Manage Site Replication Page").

Cancel
Click to cancel your settings and return to the Manage Site Replication page (see "Manage Site Replication Page").

A.14 General Component Information Page

The General Component Information page is used to provide information about the installed Site Studio component, Site Studio-specific metadata, directory paths, versions, and so on.

Figure A-18 General Component Information Page

Element
Description

Product Version
Displays the version of the Site Studio component.

Component Build Version
Displays the specific build of the Site Studio component version.

Disable Contribution
Indicates whether contribution is disabled (TRUE or FALSE).

Web Site Object Type Field
Displays the metadata field used for the Web site object types.

Web Site ID Field
Displays the metadata field used for the Web site IDs.

Web Sites Field
Displays the metadata field used for the Web site names.

Web Site Section Field
Displays the metadata field used for the Web site section names.

Do not Show In Lists For Web Sites Field
Displays the metadata field used for withholding from the Web site lists.

Region Definition Field
Displays the metadata field used for the region definition names.

Relative Web Sites Root
Displays the path to the Web sites.

Relative Fragments Root
Displays the path to the fragments.

Unique Section Counter Value
Displays the ID that is used for newly created sections in the site hierarchy (unless the designer manually enters a section ID).

Install Number
Displays the current install number of the Site Studio component.

(Reset)
Click to reset the current install number to 0.

Contributor Directory
The location of the Contributor source, including where all minified data is located.

Contributor Console Enabled
Displays if the Contributor Console is enabled and available, or disabled and unavailable.

For more information about the Contributor Console, see the Oracle WebCenter Content Technical Reference Guide for Site Studio.

(Enable) | (Disable)
Click to make the Contributor Console enabled or disabled. Only one option will appear depending on the current status of the console.

A.15 Backup and Restore Page

The Backup and Restore page is used to create backups of your site, download the backup file to a secure location or portable device, and restore from that backup. The backup feature uses the existing archiving and replicating framework built into Site Studio and Content Server.

Figure A-19 Backup and Restore Page

Element | Description
Web Sites | Displays all existing Web sites currently available on the content server.
Create Web Site Backup | Click to create a backup of the selected Web site. You see a page that shows the progress of the backup and any status information and error messages.
Manage Archives | Click to open the Manage Archives page (see "Manage Archives Page"), where you can view existing backups and definition bundles and choose to perform various actions on them.
Browse | Click to select an existing site backup file or download bundle for uploading to the content server.
Upload Archive | Uploads the Web site backup or definition bundle from your file system to the content server. You see a page that shows the progress of the backup and any status information and error messages.

A.16 Manage Archives Page

The Manage Archives page is used to manage the existing Web site backups and the definition bundles uploaded through Administrator. You can view existing backups, and bundles, download a backup, restore from a backup, delete a backup, and unpack definition bundles.

Figure A-20 Web Site Backup Archives Page

Element
Description

Archive Type
Displays if the archive is a Web site backup or a definition bundle.

Archive Name
Displays the name of the archive used by the backup.

Web Site ID
Displays the name of the Web site that was backed up.

Backup Export Date
Displays the date and time that the backup was created or the bundle was uploaded.

Actions icon

Click this icon to open the actions menu, which will be different based on if the menu is for a Web site backup or if it for a definition bundle.

For a Web site backup:

Download backup archive as ZIP: Creates a zip file of the backup and downloads it to your computer.

Delete backup archive: Deletes the backup from the content server.

Restore backup archive contents: Restores the Web site from the backup to the content server.

Show server configuration details: Opens the Server Configuration Details page (see "Server Configuration Details Page"), where you can view the content server environment for this particular site.

For a definition bundle:

Download definition bundle archive as ZIP: Creates a zip file of the backup and downloads it to your computer.

Delete definition bundle archive: Deletes the backup from the content server.

Restore definition bundle archive contents: Restores the Web site from the backup to the content server.

Info icon

Click this icon to open the Backup Archive Information page (see "Backup Archive Information Page"), which shows the details of the Web site backup or download bundle, including the archive name, description, Web site, and creation date

To resize the columns on this page so that you can read each category, place your mouse over a border until it turns into a double-arrow and then drag your mouse to resize the column.

A.17 Backup Archive Information Page

The Archive Information page shows the details of a backup or definition bundle, including the archive name, description, Web site, creation date, and so on.

Figure A-21 Backup Archive Information Page

Element
Description

Actions (menu)
For a Web site backup:

Show server configuration details: Opens the Server Configuration Details page (see "Server Configuration Details Page"), where you can view the content server environment for this particular site.

Download backup archive as ZIP: Creates a zip file of the backup and downloads it to your file system.

Restore backup archive contents: Restores the Web site from the backup to the content server.

Delete backup archive: Deletes the backup from the content server.

For a definition bundle:

Download definition bundle archive as ZIP: Creates a zip file of the definition bundle and downloads it to your computer.

Restore definition bundle archive contents: Restores the site assets from the definition bundle to the content server.

Delete definition bundle archive: Deletes the definition bundle from the content server.

Backup information fields
These fields show the details of the site backup or definition bundle, such as the archive name, archive description, Web site, creation date, and so on.

Batch File
Shows the details of the batch files used in the backup.

Instance Name
Name of the server the batch file was created on.

Number
Number of files contained in the backup/definition bundle when it was first uploaded.

State
The current state of the batch file.

To resize the columns on this page so that you can read each category, place your mouse over a border until it turns into a double-arrow and then drag your mouse to resize the column.

A.18 Server Configuration Details Page

The Server Configuration Details page provides detailed configuration information for the content server that a backed-up Web site was located on at the time of the backup. This information includes the custom metadata fields, content types, security groups, configuration and environment settings, installed components, defined providers, and so on. This can be useful when you must know the content server environment for a particular site before you restore it.

Figure A-22 Server Configuration Details Page

Element | Description
DocMetaDefinition | Displays the document types that were used on the content server.
OptionsList | Displays the option lists that were used on the content server.
QdocTypes | Displays the default content types that were used on the content server.
Qroles | Displays the users that were used on the content server.
QsecurityGroups | Displays the security groups that were used on the content server.
DocFormats | Displays the content formats that were used on the content server.
ConfigCfg | Displays the configuration settings that used on the content server.
GeneralConfig | Displays the general configuration settings that were used on the content server.
ServerEnvironment | Displays the server environment on the content server.
ComponentConfiguration | Displays the installed components that were used on the content server, along with their settings.
Providers | Displays the providers that were used on the content server.

To expand a particular category and view it on a separate page, click the heading of that category.

To resize the columns on this page so that you can read each category, place your mouse over a border until it turns into a double-arrow and then drag your mouse to resize the column.

A.19 External Applications Administration page

The External Applications Administration page provides detailed cache information for external Site Studio applications. This cache information is sent back to external Site Studio applications so that they can clear their caches and request new content when needed.

Figure A-23 External Applications Administration Page

Element
Description

Directory Cache list (untitled)
Displays the directory caches from the Oracle Content Server's weblayout area.

Clear Directory Cache
Click to clear the selected cache and refresh.

Conversion Cache List (untitled)
Displays the conversions in the cache.

Clear Conversion Cache
Click to clear the selected conversion cache and refresh.

Clear Entire Cache
Click to have all external Site Studio applications clear their caches.

Token
Displays a number that the external Site Studio application requests for cache information.

Cache Type
Displays the content type of the cache:

G - general content. This refers to items located in the weblayout/groups folder.

R - resources content. This refers to items located in the weblayout/resources folder.

D - dynamic conversion. This refers to dynamic conversions that have run.

Cache Id
Displays the ID for the cache.

Message
Displays a debugging message from the Oracle Content Server indexing cycle.

Client Id
Displays the ID for the application server.

Access Count
Displays the number of times the Client Id polled the cache.

Last Access Time
Displays the last time an access was made to the directory cache list by the Client Id.

Request Token
Displays the token sent as a request from the application server.

Sent Token
Displays the token sent to the Client Id in response.

Message
Displays an Oracle Content Server debugging message.

B Miscellaneous Administration Tasks and Considerations

This section covers the following miscellaneous administration tasks and considerations:

"Changing the Default Contributor Keystroke Combination"

"Blocking Access to the Consumption Server"

"Changing the Default Contributor Editor"

"Updating Custom Elements"

"Using the Certificate Validation Applet"

"Configuring a Single Sign-On (SSO) Environment"

"Using Pre-10gR4 Site Studio Projects"

B.1 Changing the Default Contributor Keystroke Combination

The default keystroke combination for entering contribution mode on a web page is Ctrl+Shift+F5, but you can change this. To do so, you need access to the "custom" directory on the content server where Site Studio is installed. You should inform the designers and contributors of the site if you change this value.

To change the default keystroke combination, perform these tasks:

Browse to the following directory (where [CS-Dir] is the installation location of your content server):

[CS-Dir]\custom\SiteStudio\publish\resources\wcm\sitestudio\

Open wcm.toggle.js in a text editor.

Locate the function OnKeyDown.

Change the implementation of this function to use a different keystroke combination that will call WCM.CONTRIBUTOR.Toggle.

This function uses virtual key codes to determine the key combination entered by the user. The default value is Ctrl+Shift+F5. The F5 key has a virtual key code of 116 (or 0x74 in hexadecimal). The codes for the other typical function keys, F1 through F12 are 112 (0x70) through 123 (0x7B), respectively.

Save and close wcm.toggle.js.

Note:

The next time you upgrade Site Studio or install a patch, you may need to perform these steps again to retain your keystroke combination.

Note:

The key codes used to determine the keystrokes should be given special consideration in instances where contributors may use different operating systems, since the virtual key codes may vary among operating systems.

B.2 Blocking Access to the Consumption Server

A contributor gains access to the content of a Web site by using a keystroke combination to enter contribution mode and then clicking a contribution icon to launch the Contributor application.

While such access is necessary on the server used for building the Web site, it is not desirable for the consumption server; that is, the server used to run the live Web site. To block contributor access to the consumption server, create the following server configuration variable in config.cfg:

DisableSiteStudioContribution=true

If the variable is not present or is set to false, contributor access is allowed.

Make sure that you restart the content server.

B.3 Changing the Default Contributor Editor

The default editor used for the Contributor application is FCKeditor, but this can be changed to Ephox. Both editors have been optimized for the Site Studio contribution editing environment.

If you want to use Ephox as the contribution editor, include the following server configuration variable in config.cfg:

SSDefaultEditor=ephox

If you want to change the default editor back to FCKeditor, remove this variable or change it to:

SSDefaultEditor=fck

Make sure that you restart the content server.

B.4 Updating Custom Elements

Any custom element forms created using a Site Studio release before 10gR3 (10.1.3.3.3) are not compatible with Site Studio 11gR1. They must be manually upgraded and re-authored. The primary reason for not maintaining backward compatibility is Site Studio's prior dependency on Internet Explorer's proprietary 'window.external' functionality (due to the ActiveX control used for the Contributor application). This functionality was removed from Site Studio as a result of the browser-independent, JavaScript-based Contributor application that is used in Site Studio 10gR3 (10.1.3.3.3) and higher. See the Oracle WebCenter Content Technical Reference Guide for Site Studio for more information.

B.5 Using the Certificate Validation Applet

If you set up Site Studio to use Ephox as the contributor editor, the Contributor application uses a signed Java applet that has one or more signed plug-ins packaged with it. The first time that these applets are loaded on any given system, the user is prompted to accept the security certificates. Some Java Virtual Machines (JVMs) have a problem when multiple signed applets attempt to load at the same time, which may cause the browser to hang. If you encounter this problem on any client computers, there are two solutions. One is to have the security certificates pushed out to the client computers by your IT department. The other solution is to manually accept the certificates one at a time. Site Studio provides a Site Studio Certificate Validation page on the content server, where users can accept the certificates. This page is accessed from the user profile page (under "My Profile").

Since it is possible to build custom plug-ins for Site Studio Contributor, this page has been made extensible to allow the certificates to be accepted in the same way for any custom signed plug-ins. The following server configuration variables are used in this context:

SSExtraCertificateClasses

SSExtraCertificateLabels

SSExtraCertificateJars

SSHttpLayerManager

SSExtraCertificateClasses

This entry appends customer-specific entries to the list of classes loaded by the certificate validation applet. The value is a space-separated list of classes to load during the certificate validation process, for example:

SSExtraCertificateClasses=com.xalco.XalcoEphoxPlugin com.zeng.TextGenerator

Notes:

Each class in the list should have a corresponding label set using the SSExtraCertificateLabels entry.

This should be used with the SSExtraCertificateLabels and SSExtraCertificateJars entries.

SSExtraCertificateLabels

This entry appends customer-specific labels to the list of certificates checked by the certificate validation applet. The value is a caret-separated list of certificate descriptions to display during the certificate validation process, for example:

SSExtraCertificateLabels=Xalco Certificate^Ravenna Certificate

Notes:

Each label in the list should have a corresponding class set using the SSExtraCertificateClasses entry.

This should be used with the SSExtraCertificateClasses and SSExtraCertificateJars entries.

SSExtraCertificateJars

This entry appends customer-specific entries to the classpath used by the certificate validation applet. This allows the JVM to find the classes listed in the SSExtraCertificateClasses entry. The value is a comma-delimited list of certificate descriptions to display during the certificate validation process, for example:

SSExtraCertificateJars=<$HttpWebRoot$>resources/xalco/XalcoEphoxPlugin.jar,
<$HttpWebRoot$>groups/public/documents/adacct/HelloWorldPlugin.jar

Notes:

Idoc Script tags embedded in the entries are evaluated.

This should be used with the SSExtraCertificateClasses and SSExtraCertificateLabels entries.

SSHttpLayerManager

This entry allows the use of the "Sun" or default HttpLayer manager inside the Ephox Editor. Changing to the Sun layer may provide better results when running in an SSL environment. The possible values are:

SSHttpLayerManager=default: Uses the default, internal Ephox HttpLayer manager.

SSHttpLayerManager=sun: Uses the "Sun" HttpLayer manager.

This corresponds to Ephox's setHttpLayerManager configuration entry. See http://www.ephox.com/developers/editliveforjava/v50/html/prop_httpmanagerlayer.html for more information.

B.6 Configuring a Single Sign-On (SSO) Environment

Site Studio 11gR1 can be used in forms-based authentication and single sign-on (SSO) environments. The following HTML comment must be added to the login page that prompts the user for credentials:

<!--IdcClientLoginForm=1-->

This token must be used verbatim, without any spaces or case changes. Please note that if the login form does not contain this HTML comment, Site Studio Designer cannot connect successfully when attempting to connect to a Web site protected by a forms-based login. Site Studio Designer then displays a "200 OK" message, but fails to connect.

The form's HEAD section may contain a lot of code; for example, many META tags or JavaScript code. The delivered page must have the HTML comment (or token) in the first 5,000 characters of the response, otherwise the server connection may fail. The software on the client computer sniffs the response for the <!--IdcClientLoginForm=1--> token (using a strict string search) and route through the prompting code if it is found. It is encoded as an HTML comment so that regular browsers do not show the token when they attempt to log in. If it is Idoc Script, then the parser removes that bit of code from the delivered page, and the client-side browser will not see anything in the page.

In addition, if the forms-based login solution delivers the login form to the client without using a redirect, as is the case with Oracle Content Server's ExtranetLook component, the following server configuration variables must be added to the config.cfg file:

SSEnableExtranetLookCompatibility=1

Do not forget to restart the content server after modifying the config.cfg file. If you do not add this configuration variable, the browser shows a CGI-based URL after entering contribution mode in a Web site instead of a path-based URL.

B.7 Using Pre-10gR4 Site Studio Projects

Site Studio 11gR1 is backward compatible with earlier releases. This means that you can use Site Studio Designer 11gR1 to work with projects created in earlier Site Studio releases. You do not need to upgrade them per se. It is important to note, though, that these projects will continue to work in "legacy" mode; that is, they will use the pre-10gR4 architecture and they will not take advantage of the new architecture and features introduced in Site Studio 11gR1.

If you want to use Site Studio projects created in Designer releases before 7.5, you must upgrade them first. Please note that, after upgrading, these projects will work as "legacy" projects.

For more information on upgrading pre-10gR4 projects, see the Oracle WebCenter Content Technical Reference Guide for Site Studio.

Index

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  R  S  T  U  V  W 

A

access to consumption server, B.2

Add Export Archive page, A.10

Add Import Archive page, A.12

Add New Section dialog, 2.5.2

adding a Web site address, 3.2

adding sections, 2.5.2

address of Web site, 3.1, A.5

adding --, 3.2

deselecting --, 3.3

removing --, 3.4

selecting --, 3.3

administration of Site Studio, 1.4

administrator, 1.4

administrators, 1.2

applets in Contributor, B.5

Archive Information page, A.17

Archiver status, A.9

archives

export, 6.9, A.10, A.11

import, 6.8, A.12, A.13

assigning external URLs to sections, 2.5.15

assigning primary pages to sections, 2.5.14

assigning secondary pages to sections, 2.5.16

automatically exporting new and changed content, 6.9

B

backing up sites, 7.2

Backup and Restore page, A.15

backup progress, 7.2

backups, 7.1

server configuration, 7.4

blocking access to consumption server, B.2

C

caching, 2.5.11, A.2.1

certificate validation applet, B.5

changed content in replication, 6.9

changing maximum age of sections, 2.5.11

changing URL or site sections, 2.5.10

component information, 8, A.14

component install number, 8.3

component on Content Server, 1.1

Compressing Contributor JavaScript, 4.4

compressing JavaScript, 4.4

configuration variables

DisableSiteStudioContribution, B.2

SSDefaultEditor, B.3

SSEnableExtranetLookCompatibility, B.6

SSExtraCertificateClasses, B.5

SSExtraCertificateJars, B.5

SSExtraCertificateLabels, B.5

SSHttpLayerManager, B.5

configuring JSP fragments, 4.3

configuring SSO, B.6

configuring target server for replication, 6.6

consumption server, blocking access to --, B.2

content file, 6.11

content information page of page templates, 2.5.18

Content Server

component, 1.1

configuring JSP, 4.3

location of fragment libraries, 4.1, A.6

Site Studio Certificate Validation page, B.5

contribution mode

key combination, B.1

Contributor

access to consumption server, B.2

certificate validation, B.5

default editor, B.3

key combination, B.1

Contributor (application), 1.1, 1.3.3

contributor (user), 1.2, 1.3.3

contributor data files, 1.3.3

contributor-only site sections, 2.5.8

custom elements, B.4

custom properties, 2.5.12

custom properties (of section), A.2.4

Custom Properties tab of Manage Site page, A.2.4

D

data files, see 'contributor data files'

default Contributor editor, B.3

default project document information, 5.1, 5.2, A.7

setting --, 5.2

default web asset document information, A.8

deploying fragment libraries, 4.2

deselecting a Web site address, 3.3

designating sections as contributor-only, 2.5.8

designating sections as error handler, 2.5.9

Designer (application), 1.1, 1.3.1

designer (user), 1.2, 1.3.1

DisableSiteStudioContribution variable, B.2

distributing a site, 1.3.4

domain site addresses, 3.1, A.5

dragging and dropping sections, 2.5.4

E

Edit Export Archive page, A.11

Edit Import Archive page, A.13

editing sections, 2.5.5

editor, default for Contributor, B.3

elements, updating custom --, B.4

Ephox, B.3

certificate validation, B.5

error handler site sections, 2.5.9

export archive, 6.9, A.10, A.11

export settings for replication, 6.5

exporting new and changed content, 6.9

exporting sites, 6.2

External Applications Administration page, A.19

external SSEA applications, A.19

external URLs, 2.5.15

F

FCKeditor, B.3

files included in replication, 6.3

folder site addresses, 3.1, A.5

fragment libraries, 4.1, A.6

deploying --, 4.2

fragment library

deploying, 4.2

fragments, 4.1, A.6

JSP, 4.3

G

general component information, 8, A.14

General Component Information page, A.14

H

hiding sections, 2.5.7

hierarchy, see 'site hierarchy'

I

IdcClientLoginForm tag, B.6

import archive, 6.8, A.12

import archives, A.13

importing sites, 6.2

including project file in export archive, 6.9

information about versions, 8, A.14

install number, 8.3, 8.3

interface

Add Export Archive page, A.10

Add Import Archive page, A.12

Add New Section dialog, 2.5.2

Archive Information page, A.17

Backup and Restore page, A.15

Edit Export Archive, A.11

Edit Import Archive page, A.13

External Applications Administration page, A.19

General Component Information page, A.14

Manage Archives page, A.16

Manage Fragment Libraries, A.6

Manage Site page, A.2

Manage Site Replication page, A.9

Manage Web Sites page, A.1

Server Configuration Details page, A.18

Set Default Project Document Information page, A.7

Set Default Web Asset Document Information page, A.8

Site Studio Administration page, 1.4

Web Site Addresses page, A.5

Web Site Objects Report page, A.4

J

Java Virtual Machine (JVM), B.5

JavaScript

compressing, 4.4, 4.4

performance, 4.4

JSP fragments, 4.3, 4.3

JSP support files, 4.3

JVM, B.5

K

key combination for contribution mode, B.1

L

launching Site Studio Manager, 2.5.1

layout pages, see 'page templates'

legacy projects, B.7

libraries of fragments, 4.1, A.6

deploying --, 4.2

location

fragment libraries (on content server), 4.1, A.6

M

Manage Archives page, A.16

Manage Fragment Libraries page, A.6

Manage Site page, A.2

Custom Properties tab, A.2.4

Page Template tab, A.2.2

Secondary Page Template tab, A.2.3

Section tab, A.2.1

Manage Site Replication page, A.9

Manage Web Sites page, A.1

Manager (application), 1.1, 1.3.2, A.2

adding sections, 2.5.2

assigning external URLs to sections, 2.5.15

assigning primary pages to sections, 2.5.14

assigning secondary pages to sections, 2.5.16

changing custom properties, 2.5.12

changing URL of section or page, 2.5.10

Custom Properties tab, A.2.4

designating sections as contributor-only, 2.5.8

designating sections as error handler, 2.5.9

editing sections, 2.5.5

hiding sections, 2.5.7

launching --, 2.5.1

maximum age of sections, 2.5.11

moving sections, 2.5.4

Page Template tab, A.2.2

previewing page templates, 2.5.13

removing page templates from sections, 2.5.17

removing sections, 2.5.3

renaming sections, 2.5.6

Secondary Page Template tab, A.2.3

Section tab, A.2.1

showing sections, 2.5.7

using --, 2.5

manager (user), 1.2, 1.3.2

managing fragment libraries, 4

managing site replication, 6

managing Web site addresses, 3

managing Web sites

Web sites

managing --, 2.1

maximum age, 2.5.11, A.2.1

metadata for project files, 5.1, A.7

metadata for web assets, A.8

moving sections, 2.5.4

N

native documents, 1.3.3

navigation of sites, 2.3

new content in replication, 6.9

O

objects report for sites, 2.4, A.4

On-Demand Web Site, A.3

On-Demand Web sites, 2.8

on-demand web sites, 2.8.1

outgoing provider for replication, 6.7

P

page template (of section), A.2.2

Page Template tab of Manage Site page, A.2.2

page templates, 2.5.13

content information page, 2.5.18

removing -- from site sections, 2.5.17

performance improvement, 4.4

previewing a site, 1.3.4

previewing page templates, 2.5.13

process of replication, 6.2

progress of backup, 7.2

progress of restore, 7.3

project document information, 5.1, A.7

project file, 5.1

project files, 5.1, A.7

and replication, 6.9

projects

using pre-10gR4 projects, B.7

providers

outgoing, 6.7

publishing a site, 1.3.4

publishing model, 1.3

adding and editing content in Contributor, 1.3.3

creating site in Designer, 1.3.1

managing site in Manager, 1.3.2

previewing and distributing completed site, 1.3.4

R

Ready to Replicate, 6.11

reloading Web sites, 2.7

removing a Web site address, 3.4

removing page templates from sections, 2.5.17

removing sections, 2.5.3

renaming sections, 2.5.6

replication, 6.1, 6.11, A.9

and content files, 6.11

automatically export new and changed content, 6.9

configuring target server, 6.6

contents of site, 6.3

export, 6.2

export settings, 6.5

import, 6.2

including project file in export archive, 6.9

process, 6.2

retaining region content, 6.8

retaining switched region content, 6.8

revisions of files, 6.4

scope, 6.3

setting up export archive on source server, 6.9

setting up import archive on target server, 6.8

setting up outgoing provider on source server, 6.7

starting --, 6.10

transfer, 6.2

reports about Web site objects, 2.4, A.4

resetting the install number, 8.3, 8.3, 8.3

restore progress, 7.3

restoring sites, 7.3

retaining region content in replication, 6.8

retaining switched region content in replication, 6.8

revisions of files included in replication, 6.4

S

secondary page template (of section), A.2.3

Secondary Page Template tab of Manage Site page, A.2.3

Section tab of Manage Site page, A.2.1

sections

adding --, 2.5.2

assigning external URLs to --, 2.5.15

assigning primary pages to --, 2.5.14

assigning secondary pages to --, 2.5.16

contributor-only, 2.5.8

custom properties, A.2.4

editing --, 2.5.5

error handler, 2.5.9

hiding --, 2.5.7

maximum age, 2.5.11, A.2.1

moving --, 2.5.4

page template, A.2.2

removing --, 2.5.3

removing page templates from --, 2.5.17

renaming --, 2.5.6

secondary page template, A.2.3

showing --, 2.5.7

URL, 2.5.10

URL directory name, A.2.1

URL page name, A.2.1

selecting a Web site address, 3.3

Server Configuration Details page, A.18

server configuration of backups, 7.4

Set Default Project Document Information page, A.7

Set Default Web Asset Document Information page, A.8

setting default project document information, 5.2

setting up export archive on target server, 6.9

setting up import archive on target server, 6.8

setting up outgoing provider on source server, 6.7

shortcut for contribution mode, B.1

showing sections, 2.5.7

signed applets, B.5

single sign-on (SSO), B.6

site addresses, 3.1, A.5

adding --, 3.2

deselecting --, 3.3

removing --, 3.4

selecting --, 3.3

site contributor, see 'contributor (user)'

site designer, see 'designer (user)'

site hierarchy, A.2

adding sections, 2.5.2

contributor-only sections, 2.5.8

editing sections, 2.5.5

error handler sections, 2.5.9

external URLs, 2.5.15

hiding sections, 2.5.7

maximum age of sections, 2.5.11

moving sections, 2.5.4

primary pages of sections, 2.5.14

removing page templates, 2.5.17

removing sections, 2.5.3

renaming sections, 2.5.6

secondary pages of sections, 2.5.16

showing sections, 2.5.7

URL of sections, 2.5.10

site manager, see 'manager (user)'

site objects reports, 2.4, A.4

site replication, see 'replication'

Site Studio, 1.1

administration, 1.4

Contributor, 1.1, 1.3.3

Designer, 1.1, 1.3.1

install number, 8.3

Manager, 1.1, 1.3.2

pre-10gR4 projects, B.7

publishing model, 1.3

users, 1.2

version information, 8, A.14

Site Studio Administration page, 1.4

Site Studio Certificate Validation page, B.5

Site Studio Designer, see 'Contributor (application)'

Site Studio Designer, see 'Designer (application)'

Site Studio Designer, see 'Manager (application)'

sites, see 'Web sites'

source server for replication, 6.7, 6.9

source server of backup, 7.4

SSDefaultEditor variable, B.3

SSEnableExtranetLookCompatibility variable, B.6

SSExtraCertificateClasses variable, B.5

SSExtraCertificateJars variable, B.5

SSExtraCertificateLabels variable, B.5

SSHttpLayerManager variable, B.5

SSO, B.6

starting replication, 6.10

starting Site Studio Manager, 2.5.1

starting Web sites, 2.6

status of Archiver, A.9

stopping Web sites, 2.6

switch content file, 6.11

T

target server for replication, 6.8

target server in replication, 6.6

transferring sites, 6.2

types of users, 1.2

U

updating custom elements, B.4

updating site navigation, 2.3

URL directory name, 2.5.10, A.2.1

URL of site sections or pages, 2.5.10

URL page name, 2.5.10, A.2.1

usage details, 2.4, A.4

user interface, see 'interface'

users

administrators, 1.2

contributors, 1.2, 1.3.3

designers, 1.2, 1.3.1

managers, 1.2, 1.3.2

users, types of --, 1.2

V

validation of Ephox certificates, B.5

variables, see 'configuration variables'

version information, 8, A.14

viewing general component information, 8.2

viewing Web site objects reports, 2.4

viewing Web sites, 2.2

virtual key codes, B.1

W

wcm.toggle.js, B.1

web asset document information, A.8

web assets, A.8

Web site addresses, 3.1, A.5

adding --, 3.2

deselecting --, 3.3

removing --, 3.4

selecting --, 3.3

Web Site Addresses page, A.5

Web Site Objects Report page, A.4

Web sites

adding sections, 2.5.2, 2.5.2

address, 3.1, A.5

backing up --, 7.2

contributor-only sections, 2.5.8

custom properties, 2.5.12

error handler sections, 2.5.9

external URLs of sections, 2.5.15

hiding sections, 2.5.7

maximum age of sections, 2.5.11

moving sections, 2.5.3, 2.5.3, 2.5.4, 2.5.4

navigation, 2.3

primary pages of sections, 2.5.14

reloading --, 2.7

removing page templates, 2.5.17

renaming sections, 2.5.6, 2.5.6

replicating --, 6.1, A.9

restoring --, 7.3

secondary pages of sections, 2.5.16

showing sections, 2.5.7

starting --, 2.6

stopping --, 2.6

URL of sections or pages, 2.5.10

viewing --, 2.2

window.external functionality, B.4

Screenshot of the Site Studio Manager application. It shows the main interface, with the site hierarchy on the left and four tabs for each of the main functional areas: Section, Page Template, Secondary Page Template, and Custom Properties.

Screenshot of the Server Configuration Details page, which provides detailed configuration information for the content server that a backed-up Web site was located on at the time of the backup.

Screenshot of the Set Default Web Asset Document Information page, where you specify the default metadata for Site Studio web assets that are checked in to the content server.

Screenshot of the Manage Archive page, where you manage the existing Web site backups and definition bundles on the content server. It shows a list of all backups for all sites, along with their archive names and creation dates.

Screenshot of the Manage Web Sites page, where you perform several site management tasks. These tasks are described in the table that follows this image.

Screenshot of the Page Template tab of the Manage Site page, where you can assign a page template to the selected section in the site hierarchy.

Screenshot of the Add Export Archive page, where you define an export archive file, which is used in the process of replicating a Web site from one content server to another.

Screenshot of the Custom Properties tab of the Manage Site page, where you can modify the values of custom properties assigned to the current section by the site designer.

Screenshot of the Backup Archive Information page, which shows the details of a backup, including the archive name, description, Web site, creation date, and so on.

Screenshot of the Set Default Project Document Information page, where you specify the default metadata for Site Studio project files that are checked into the content server.

Screenshot of the Manage On-Demand Web Sites page, where you can designate Web sites on the content server as being on demand.

Screenshot of the Secondary Page Template tab of the Manage Site page, where you can assign a secondary page template to the selected section in the site hierarchy.

Screenshot of the Add Import Archive page, where you define an import archive file, which is used in the process of replicating a Web site from one content server to another.

Screenshot of the Web Site Addresses page, where you view or add site addresses for all available Web sites on the content server.

Screenshot of the Edit Import Archive page, where you edit the properties of an existing import archive file, which is used in the process of replicating a Web site from one content server to another.

Screenshot of the Edit Export Archive page, where you edit the properties of an existing export archive file, which is used in the process of replicating a Web site from one content server to another.

Screenshot of the Web Site Objects Report page, which shows usage information for all Web site objects marked for reporting. You can see information about page templates, contributor data files, page template fragments, fragment libraries, Web site assets, and the Web site project.

Diagram that shows the stages involved in replication. The process is described in the surrounding text.

Screenshot of the External Applications Administration page, which provides detailed debugging information for external Site Studio applications.

Screenshot of the Section tab of the Manage Site page, where you can manage the sections within the hierarchy of a Web site, add or remove the current section, and modify some properties of the current section.

Screenshot of the Backup and Restore page, where you can create, manage, and upload backup archives.

Screenshot of the General Component Information page, which provides information about the installed Site Studio component, Site Studio-specific metadata, directory paths, versions, and so on.

Screenshot of the Manage Site Replication page, where you manage the replication of your sites to other content servers.

Screenshot of the Manage Fragment Libraries page, where you deploy fragment libraries (that is, copy them to the correct location on the content server), configure JSP support for JSP-enabled Web sites, and compress Contributor JavaScript.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2010, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

Hazardous Applications Notice

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Trademark Notice

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Third-Party Content, Products, and Services Disclaimer

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.