3 Deploying Oracle WebCenter Wiki and Blog Server

Before you deploy Oracle WebCenter Wiki and Blog Server on Oracle WebLogic Server, you must perform certain tasks. These tasks include:

To deploy Oracle WebCenter Wiki and Blog Server, you require its WAR file, owc_wiki.war.

1. Download Oracle WebCenter Wiki and Blog Server from Oracle's Electronic Delivery (e-delivery) at http://edelivery.oracle.com/ or from the Oracle WebCenter Additional Services 10 g Release 3 (10.1.3.4.0) page on the Oracle Technology Network at:

   http://www.oracle.com/technology/products/webcenter/owcs_10134_addtlservices.html

2. Create a temporary directory, for example wikiblogs, on your file system.

3. Follow the instructions on OTN and download the V15935-01.zip file to the temporary directory.

4. Unzip the V15935-01.zip file (for example, with unzip V15935-01.zip).

   The V15935-01.zip file contains the following files:

   • Oracle-Wikis-Blogs.zip (Oracle WebCenter Wiki and Blog Server)

   • Oracle-Discussions.zip (Oracle WebCenter Discussions)

5. Unzip Oracle-Wikis-Blogs.zip. This zip file contains the owc_wiki.war file. This document refers to the folder in which you unzip the file as $unzipped_dir .

6. Create a directory named owc_wiki anywhere under $WLS_HOME. The owc_wiki directory is the deployment directory for your wiki and blog server.

   
   

   Note: In this document, the wiki and blog server deployment directory is created at the following path: $WLS_HOME /user_projects/domains/ owc_wiki Where, $WLS_HOME refers to the Oracle WebLogic Server 10.3 installation directory and owc_wiki refers to the wiki and blog server domain.

   
   

   For example, use the following commands:

   cd $WLS_HOME /user_projects/domains/ owc_wiki

   mkdir owc_wiki

   The new directory structure is $WLS_HOME /user_projects/domains/ owc_wiki (this is the domain for the wiki and blog server) /owc_wiki (this is where you will deploy the wiki and blog server).

   
   

   Note: The wiki and blog server deployment directory must be named owc_wiki.

   
   

7. Copy owc_wiki.war from the zip extracted directory ( $unzipped_dir ) to the owc_wiki deployment directory.

   For example, you can use the following commands to navigate to the newly created directory and copy the extracted owc_wiki.war file there:

   cd $WLS_HOME / user_projects/domains/ owc_wiki /owc_wiki

   cp $unzipped_dir /owc_wiki.war

8. Extract owc_wiki.war (for example, with unzip owc_wiki.war) within the owc_wiki directory.

9. Delete owc_wiki.war (for example, with rm owc_wiki.war) from this directory.

You must set up a database for your Oracle WebCenter Wiki and Blog Server. This involves creating the wiki schema and then running the oracle.sql script to create the tables required for Oracle WebCenter Wiki and Blog Server.

After you have set up the database for Oracle WebCenter Wiki and Blog Server, you must create a JDBC data source to configure database connectivity.

1. Start the Admin server for the Oracle WebLogic Server domain in which you want to deploy Oracle WebCenter Wiki and Blog Server.

   On Windows:

   • From Start, select All Programs. Navigate to your Oracle WebLogic home where you installed Oracle WebLogic Server and then select User Projects. Next, select your domain and then select Start Admin Server for WebLogic Server Domain. ( Figure 3-1)

     
     

     Tip: On Windows, you can also start the Admin server by navigating to $WLS_HOME /user_projects/domains/ owc_wiki /bin on the file system and double-clicking startWebLogic.cmd.

     
     

     Figure 3-1 Starting the Admin Server

     
     Description of "Figure 3-1 Starting the Admin Server"
     
     

   On Linux:

   • Navigate to $WLS_HOME /user_projects/domains/ owc_wiki /bin.

   • Run ./startWebLogic.sh.

2. After the server has started, start the Oracle WebLogic Server Administration Console by using the following URL format in your browser:

   http:// host:port / console

   Where host:port refers to the host name and port on which Oracle WebLogic Server is installed. If you did not enter a console port when you created the domain, then by default the port is 7001. For example, the URL may be http://localhost:7001/console.

   
   

   Tip: On Windows, you can start the Oracle WebLogic Administration Server Console by using the Start menu. From Start, select All Programs. Then, navigate to your Oracle WebLogic home and select User Projects. Next, select your domain and then click Admin Server Console.

   
   

3. Specify the user name and password to log on as the domain administrator. The WebLogic Server Administration Console displays.

4. Under Domain Structure, expand Services, JDBC, and then select Data Sources, as shown in Figure 3-2.

   Figure 3-2 Accessing the Data Source Settings

   
   Description of "Figure 3-2 Accessing the Data Source Settings"
   
   

5. Click New.

   
   

   Note: If you are using Production Mode, then click the Lock and Edit button on the left side to activate the New button.

   
   

6. On the JDBC Data Source Properties page, in the Name field, enter jdbc/OWCWikiDS as the name for the JDBC data source, as shown in Figure 3-3.

7. In the JNDI Name field, enter jdbc/OWCWikiDS as the JNDI name for your new JDBC data source.

   
   

   Note: The value that you enter in the Name and JNDI Name fields must be the same.

   
   

8. From the Database Type dropdown list, select Oracle.

9. From the Database Driver dropdown list, select the database driver as Oracle's Driver (Thin) Versions:9.0.1,9.2.0,10,11.

10. Click Next.

    Figure 3-3 Specifying JDBC Data Source Details

    
    Description of "Figure 3-3 Specifying JDBC Data Source Details"
    
    

11. On the Transaction Options page, click Next.

12. On the Connection Properties page, specify the properties for connecting to the database in which you created the wiki schema by running the oracle.sql script. The properties include the database name, host name, port number, database user name, and password. Figure 3-4 shows sample connection details for the JDBC data source.

    Figure 3-4 Specifying Connection Properties

    
    Description of "Figure 3-4 Specifying Connection Properties"
    
    

13. Click Next.

14. On the Test Database Connection page, click Test Configuration. If the connection is successful, a success message displays.

15. Click Next.

16. On the Select Targets page, select the server on which you wish to deploy your JDBC data source, as shown in Figure 3-5. This should be the same server on which you plan to deploy your wiki and blog server.

    Figure 3-5 Selecting the Target Server

    
    Description of "Figure 3-5 Selecting the Target Server"
    
    

17. Click Finish.

    A summary of the newly created JDBC data source displays, as shown in Figure 3-6.

    
    

    Note: If you are using Production Mode, then you must select the newly created data source and click Activate changes.

    
    

    Figure 3-6 Summary of JDBC Data Source

    
    Description of "Figure 3-6 Summary of JDBC Data Source"
    
    

You must update the Admin Server and the managed server where you deployed wiki and blog server to use the correct TopLink jars. To do this, you need to update the Admin Server script, startWebLogic, and the config.xml file of the wiki and blog domain.

To deploy Oracle WebCenter Wiki and Blog on Oracle WebLogic Server:

1. Ensure that the Admin server is running for the domain in which you want to deploy Oracle WebCenter Wiki and Blog Server. (For information, see step 1 in Section 3.4, "Creating a JDBC Data Source")

2. Start the Oracle WebLogic Server Administration Console by using the following URL format and then log on as the domain administrator:

   http:// host:port / console

   
   

   Tip: On Windows, from Start, you can also select All Programs, select the Oracle WebLogic home directory, and then User Projects. Next, select your domain and then click Admin Server Console.

   
   

3. In the left navigation panel, under Domain Structure, click the Deployments link, as shown in Figure 3-8.

   If there are any applications already deployed in the domain, a list of those applications displays on the right.

   Figure 3-8 Oracle WebLogic Server Administration Console

   
   Description of "Figure 3-8 Oracle WebLogic Server Administration Console"
   
   

4. Click Install.

   
   

   Note: If you are using Production Mode, the Install button appears disabled. Click the Lock and Edit button on the left to enable it.

   
   

5. Navigate to the owc_wiki deployment directory where you extracted the owc_wiki.war file. Alternatively, you can specify the directory path in the Path field.

   Figure 3-9 shows owc_wiki (open directory) as selected.

6. Figure 3-9 Specifying the Location of the WAR File

   
   Description of "Figure 3-9 Specifying the Location of the WAR File"
   
   

7. Click Next.

   Note that if the WAR file is local, then it may take several minutes to upload it to the server.

8. Select the targeting style for deploying the wiki and blog server. You can deploy it either as an application or as a library. ( Figure 3-10)

9. Click Next.

   Figure 3-10 Choosing the Targeting Style

   
   Description of "Figure 3-10 Choosing the Targeting Style"
   
   

10. Select the server on which you wish to deploy the wiki and blog server. ( Figure 3-11)

    If you are not running a managed server as the deployment target, then your wiki and blog server is deployed to the Admin server.

    
    

    Note: If you are using Production Mode, then it is recommended that you deploy Oracle WebCenter Wiki and Blog Server on a managed server.

    
    

    Figure 3-11 Deployment Target for the Wiki and Blog Server

    
    Description of "Figure 3-11 Deployment Target for the Wiki and Blog Server"
    
    

11. Click Next.

12. Specify the optional deployment settings. Enter the application name in the Name field. By default, the application name is same as the directory name where you extracted the owc_wiki.war.file, which is owc_wiki.

13. Select the security model for the application. The default is to use roles and policies defined in the deployment descriptor. ( Figure 3-12)

14. Specify how you want the deployment source files to be accessible to the target server. The default setting is to use the defaults defined by deployment's targets. ( Figure 3-12)

    Figure 3-12 Optional Deployment Settings

    
    Description of "Figure 3-12 Optional Deployment Settings "
    
    

15. Click Next.

16. Verify the deployment settings and specify whether you plan to review the application configuration immediately after deployment. ( Figure 3-13)

    Figure 3-13 Reviewing Deployment Information

    
    Description of "Figure 3-13 Reviewing Deployment Information "
    
    

17. Click Finish.

18. Review the settings and click Save.

19. After Oracle WebCenter Wiki and Blog Server is deployed successfully, a confirmation message is displayed. If the deployment is not successful, review the log and ensure that the deployment settings are correct.

    
    

    Note: Oracle WebCenter Wiki and Blog Server includes an HSQL database that runs on a specific default port (1475). If that port is not available, then after deployment you can modify the port in both the beans.xml file and the application_config.script file. These files are located in $WLS_HOME /user_projects/domains/ owc_wiki /owc_wiki/WEB-INF/classes, where owc_wiki is the domain directory and owc_wiki is the deployment directory where you extracted the owc_wiki.war file.

    
    

20. Click Deployments.

21. For your newly deployed Oracle WebCenter Wiki and Blog Server, verify that the State is shown as New. ( Figure 3-14)

    Figure 3-14 Deployed Wiki and Blog Server

    
    Description of "Figure 3-14 Deployed Wiki and Blog Server"
    
    
    
    

    Note: If you are using Production Mode, then after deployment, you must select the deployed application and then click Activate changes. After changes are activated, start the server where you deployed the wiki and blog server, select the deployed application, and then click Start - Servicing all request.

    
    

22. Start the server to which you deployed the wiki and blog server.

    If you deployed your wiki and blog server on the Admin server, restart the Admin server.

    If you deployed your wiki and blog server on a managed server, start the managed server.

    • To start the managed server on Linux:

      1. Navigate to $WLS_HOME /user_projects/domains/ owc_wiki /bin.

      2. Run ./startManagedWeblogic.sh wiki_server http:// host:port .

         Where wiki_server refers to the managed server and host:port refers to the host name and port number of the Admin server.

         For example, if your managed server named wikiserver is deployed on the default port on your local machine, then you can use the following command to start the managed server:

         ./startManagedWeblogic.sh wikiserver http://localhost:7001

      3. Enter the user name and password of the domain administrator to start the managed server.

    • To start the managed server on Windows:

      1. Navigate to $WLS_HOME /user_projects/domains/ owc_wiki /bin.

      2. Run startManagedWeblogic.cmd wiki_server http:// host:port .

      3. Enter the user name and password of the domain administrator to start the managed server.

    After restarting the server on which your wiki and blog server is deployed, if you verify the deployment status of the wiki and blog server, the State is shown as Active and Health is shown as OK. ( Figure 3-15)

    Figure 3-15 Deployment Status of the Wiki and Blog Server

    
    Description of "Figure 3-15 Deployment Status of the Wiki and Blog Server"
    
    

23. To access the newly deployed wiki and blog server, use the following URL format:

    http:// host:port /owc_wiki

    Where host and port are the host and the port number of the server where you deployed Oracle WebCenter Wiki and Blog Server, and owc_wiki refers to your deployed application. For example, if your managed server is running on port 8001, you may specify the path as http://localhost:8001/owc_wiki.

    When you access Oracle WebCenter Wiki and Blog Server for the first time, it may take some time for the server to start.

    
    

    Note: The supported browsers for Oracle WebCenter Wiki and Blog Server are Internet Explorer 7.0 or later and Mozilla Firefox 2.0 or later.

    
    

24. Enter the domain administrator user name and password to log on to Oracle WebCenter Wiki and Blog Server as an administrator.

Oracle WebCenter Wiki and Blog Server provides Oracle WebCenter Wiki Web Services that enable interaction between your application and the server. All Web Services methods are protected to prevent unauthorized access. If you plan to use Web Services, then for security purposes you may want to change the default passphrase, which is owCwIKi, used for calling Web Services methods. The passphrase must be shared with trusted application developers wishing to use Web Services. For information about Oracle WebCenter Wiki Web Services, see Section 6.3, "Oracle Wiki Server Web Services Interface."

To generate the passphrase:

1. Open the web.xml file from the wiki and blog server deployment directory. For example: $WLS_HOME /user_projects/domains/ owc_wiki /owc_wiki.

2. Update the value for the /oracle/webCenter/owcWiki/webServiceSecurityPassphrase environment entry. Specify the new passphrase in the <env-entry-value> entry. Example 3-3 shows the environment entry for the passphrase.

   Example 3-3 Environment Entry for the Passphrase in web.xml

       <env-entry>
         <description>Wiki WebService Security Passphrase</description>
         <env-entry-name>/oracle/webCenter/owcWiki/webServiceSecurityPassphrase
         </env-entry-name>
         <env-entry-value>owCwIKi</env-entry-value>
         <env-entry-type>java.lang.String</env-entry-type>
       </env-entry>
   

3. Save web.xml.

4. Restart the server to which you deployed your wiki and blog server.

Oracle WebCenter Wiki and Blog Server 10.1.3.4 enables you to use either a file system-based repository or a database repository. However, Oracle WebCenter Wiki 10.1.3.2 supports storage of data only in a file system-based repository. In a file system-based repository, a domain is represented by a directory and wiki pages within the domain are represented by files within that directory.

1. On the wiki and blog server 10.1.3.2 navigate to the $SOURCE_WIKI_HOME /pages directory, where $SOURCE_WIKI_HOME refers to the directory where you deployed the wiki and blog server 10.1.3.2.

2. Copy these files to the $WIKI_HOME/ pages directory on the wiki and blog server 10.1.3.4, where $WIKI_HOME refers to the directory where you deployed the wiki and blog server 10.1.3.4.

   For example, the following is a sample path for copying domain files on the wiki and blog server 10.1.3.4:

   D:/Oracle/Middleware/user_projects/domains/owc_wiki/servers/wikiserver/stage/owc_wiki/owc_wiki/pages

   Where, owc_wiki is the wiki domain and wikiserver is the managed server on which the wiki and blog server is deployed.

   If you are using the file system-based storage on the wiki and blog server 10.1.3.4, then it recognizes the newly copied directories and files within as new domains.

   
   

   Note: Attachments associated with wiki pages are stored in a separate directory named attachments. You can import attachments only when upgrading to a database-based repository. You must copy the source attachments directory to the $WIKI_HOME/ attachments directory on your wiki and blog server 10.1.3.4.

   
   

3. If you are using a database repository in wiki and blog server 10.1.3.4, then you must import the domains. Log on to the wiki and blog server 10.1.3.4 by using the administrator credentials you specified while installing Oracle WebLogic Server.

   
   

   Note: To perform initial configuration of your wiki and blog server, you must log on using the default administrator credentials.

   
   

4. Click the Administration link on the top-right corner to access the Administration mode. ( Figure 3-16)

   For information about the Administration mode, see Section 5.1.2, "About the Administration Mode."

   Figure 3-16 Administration Link on Oracle WebCenter Wiki and Blog Server 10.1.3.4

   
   Description of "Figure 3-16 Administration Link on Oracle WebCenter Wiki and Blog Server 10.1.3.4"
   
   

5. Under Domain Related, click Import Domain to import the domain directory into the database.

   
   

   Note: You can import only one domain at a time.

   
   

6. On the Import Domain page, specify the following details: domain name, description, start page name, and the location where your domain files of the wiki and blog server 10.1.3.2 are stored. ( Figure 3-17)

   Figure 3-17 Importing a Domain

   
   Description of "Figure 3-17 Importing a Domain"
   
   

7. Click Import Domain.

   Repeat step 5 and 6 to import other domains.

8. Restart the server on which you deployed your wiki and blog server 10.1.3.4.