E Administering Oracle WebCenter Wiki

E.1 Accessing the Administration Mode

To access the Oracle WebCenter Wiki Administration mode, first log in using the administrator user name and password you created during the installation of Oracle WebCenter Wiki. In the upper right menu of each wiki page, you can click the Administration link to access the Administration mode. Figure E-1 shows this link.

Figure E-1 Administration Link

Description of "Figure E-1 Administration Link"

Once you click this link, you see the Administration mode, as shown in Figure E-2.

Figure E-2 Administration Mode

Description of "Figure E-2 Administration Mode"

To exit the Administration mode, click Exit Admin Mode under General.

E.2 Domains and Menus

The wiki administrator organizes the wiki pages into domains, then can create menus to enable easy access to pages within each domain. This section discusses basic domain and menu administration tasks.

E.2.1 Domains

As a wiki administrator, you create, edit, or delete the domains that will contain the pages the wiki users then create, edit, or delete. In Oracle WebCenter Wiki, a domain is the highest level of categorization and all wiki pages must belong to a domain.To create a new domain, in the Administration mode, under General, click Domains.

Figure E-3 Administration Page of the Wiki

Description of "Figure E-3 Administration Page of the Wiki"

To create a new domain as shown in Figure E-3, click Add a new domain. Enter a domain name, a description, and a name for your new start page, then click Save, as shown in Figure E-4.

Tip: When naming your page, ensure you adhere to the wiki markup standards, as explained in Table 6-2 in Chapter 6, "Integrating Oracle WebCenter Wiki".

Figure E-4 Creating a New Domain

Description of "Figure E-4 Creating a New Domain"

The new domain displays on the Administer domains page as shown in Figure E-5.

Figure E-5 Administer Domains Page

Description of "Figure E-5 Administer Domains Page"

Return to the wiki home page by clicking Exit Admin Mode in the navigation bar. If your new start page does not automatically display, click the All Domains link in the upper left corner to view the existing domains. You can then click the new page in your new domain, for example My Wiki. Once you have created a new page, you can edit it using the Edit tab.

E.2.2 Menus

As an administrator, you can create a single menu for each domain, then modify them. The following is an example of how you can modify the existing menu in the domain.

First, in the menu, click the Edit this menu link, as shown in Figure E-6.

Figure E-6 Edit Link on the Menu

Description of "Figure E-6 Edit Link on the Menu"

When you click the edit link, you can edit the menu the same way you edit a page, using the Edit page text box as shown in Figure E-7.

Figure E-7 Editing the Menu

Description of "Figure E-7 Editing the Menu"

The menu consists of menu topics. The menu topics display as headers of every block of menu items. For example, in the owc_wiki domain in Oracle WebCenter Wiki, General is menu topic and All Pages is a menu item. The topics display in the order you create them. Within each topic, you can define menu items, which can be links to wiki pages or links to targets external to the wiki. When you create a menu item, you must specify a name and either a wiki page name or a URL. The name displays in the menu.

Note: After you create a menu, it is good practice to change the mode to only administrators are allowed to edit (from the Mode drop-down list, select this option). Although wiki automatically removes the Edit this menu link from the menu if the registered user is not administrator, users may accidentally edit the menu page.

E.3 Locking and Unlocking Pages

As the administrator, you can configure the locking and unlocking of wiki pages. Every time a user edits a wiki page, the page is locked for a specified time period for that particular user before other users can modify that page. As the administrator, you can configure the time period during which only the current user can modify the page. To specify the time period (in minutes), click the Configuration link under General in the administration menu, then enter a time in the Time in minutes to lock a page field. Figure E-8 shows this page.

Figure E-8 Configuration Page

Description of "Figure E-8 Configuration Page "

You can also unlock these pages by clicking the Locked Pages link under the General category. Here, you can view a list of all the locked pages and unlock a page by clicking the remove lock link next to the desired page. Figure E-9 shows this page.

Figure E-9 Unlocking a Page

Description of "Figure E-9 Unlocking a Page"

E.4 User Interface Templates

Templates enable you to set up a framework for users when they create pages. You can create new user interface templates as well as edit or delete existing ones. To access the templates, in the Administration mode, under General, click Templates. Use the links next to an existing template name to modify it. Or, click Add new template to create a new template (Figure E-10).When you name, edit, and create a template, use the wiki markup language described in Section 6.3.3, "Wiki Markup". Template names should follow the same convention as page names.

Figure E-10 Managing Templates

Description of "Figure E-10 Managing Templates"

After you create a new template, users can choose to use this new template when creating a page (Figure E-11).

Figure E-11 Creating a New Page with a Template

Description of "Figure E-11 Creating a New Page with a Template"

E.5 Changing Themes of the Wiki Page

You can apply themes to change the look and feel of your wiki. To change the theme, in the Administration mode, under General, click Configuration. Choose a different theme from the Theme drop-down list.

Figure E-12 Choosing a Theme

Description of "Figure E-12 Choosing a Theme"

Exit the Administration mode to see your changes take effect.

E.6 Monitoring Oracle WebCenter Wiki

The monitoring log file is located in OC4J_HOME/bin/owc_wiki.log. To change the log level, modify the jlo_logging.xml file located here:

ORACLE_HOME/j2ee/home/owc_wiki/

You can change the targets of the loggers in this file. The following targets are currently supported: trace, info, debug, warn, error, and fatal. You can also use two special targets: off (to switch of all the targets) or all (to switch on all the targets). For more information on the jLo logger, see http://jlo.jzonic.org/GettingStarted.html.

For additional troubleshooting information, refer to Appendix G, "Troubleshooting WebCenter Applications".

E.7 Backing Up and Restoring Wiki Content

You can back up wiki content by using the file system. To do so, make a copy of the following folder:

OC4J_HOME/applications/application_name/owc_wiki/pages

You can restore the content by overwriting this folder with the back-up copy of the folder.

E.8 Exporting a Domain

Oracle WebCenter Wiki enables you to export a wiki domain as static HTML files. You can use the wiki as a simple content management system (CMS) on a local computer, then export the content and upload the HTML files to a Web server.

When you export the contents of your domain, Oracle WebCenter Wiki replaces the wiki links with the corresponding HTML filename. The wiki renames all start pages in your domain index.html.

While your domain displays, access the Administration mode. In the navigation bar, under Domain related, click Export Domain. If you do not see this option and you are logged in as an administrator, you may need to add this specific permission. To do so, under User Management, click Roles. Then, edit the ADMIN role and add the ExportDomain permission. For more information, refer to Section E.10, "Permissions".

On the Export domain page, you can update the options described in Table E-1. After you have chosen the desired options, click export domain.

E.9 Blocking an IP Address

You can block Edit access to the wiki from a certain IP address. To do so, under General, click Manage Blacklist (Figure E-13). Enter the IP address you wish to block, then click Save. The IP address you have blocked displays in the Blacklist.

Figure E-13 Manage Blacklist

Description of "Figure E-13 Manage Blacklist"

E.10 Permissions

You can set permissions for the two roles user and admin for the wiki operations from the Administration mode. In the navigation bar, under User Management, click Roles. Under the role you want to modify, click edit. For example, under the USER role, click edit to view the page in Figure E-14.

Figure E-14 User Role Permissions

Description of "Figure E-14 User Role Permissions"

E.11 Enabling Anonymous Access to Oracle WebCenter Wiki

By default, only registered users can access pages in the Oracle WebCenter Wiki. However, you can also enable anonymous access so that users can view pages without logging in. To do so, in the Administration mode, under General, click Settings. Next to Is this owc_wiki installation only available for registered users, choose NO from the drop-down list (Figure E-15), then click the save button.

Figure E-15 Anonymous Access Setting

Description of "Figure E-15 Anonymous Access Setting"

E.12 Other Configuration Parameters

In the Administration mode, you can configure the following options:

• The name of the file where the last recent updates are stored

• The default attachment size in kilobytes (KB)

• The default domain

• The supported attachment types

• The default wiki page

• The maximum number of LRU pages stored

You can find these options and others by choosing Configuration under General, as shown in Figure E-16.

Figure E-16 Configuration Page

Description of "Figure E-16 Configuration Page"