> Installation and Upgrade Guide > Installing Pages

Installation and Upgrade Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Installing Pages

This chapter describes how to install AquaLogic Pages. There are several steps involved with installing Pages:

  1. Ensure that you have met the prerequisites for installation. For details, see Installation Prerequisites.
  2. Create the Pages database. For details, see Creating the Pages Database.
  3. Install the Pages components. For details, see Installing Pages Components.
  4. Configure Pages. For details, see Verifying the Configuration Settings.
  5. Start Pages. For details, see Starting the BEA AquaLogic Pages Service.
  6. If you are going to access Pages through AquaLogic Interaction, complete the steps in Registering Pages with the Portal. Then modify experience definitions and custom navigation in the portal. For details, see the Administrator Guide for AquaLogic Pages.
  7. If you are going to access Pages through AquaLogic Ensemble, complete the steps in Registering Pages with AquaLogic Ensemble.

 

Creating the Pages Database

This section describes how to set up the Pages database. It contains the following sections:

Creating the Pages Database in Microsoft SQL Server 2000

To create the Pages database in Microsoft SQL Server 2000:

  1. Open SQL Server Enterprise Manager.
  2. Create the Pages database user:
    1. In the navigation pane, expand the objects to display subfolders of the Security folder.
    2. Right-click the Logins icon; then click New Login.
    3. In the SQL Server Login Properties dialog box, enter the user name you specified in the Installation and Configuration Worksheets for AquaLogic Pages.
    4. In the Authentication area, choose SQL Server Authentication and enter the corresponding password.
    5. Confirm the password to complete the process.
  3. Create the Pages database with the name you provisioned when you completed the Installation and Configuration Worksheets for AquaLogic Pages.
  4. Set the security for the database:
    1. In the navigation pane, expand the objects to select the Security folder.
    2. In the objects pane, right-click the Pages user and select Properties.
    3. On the General tab, in the Defaults section, select the Pages database.
    4. Click the Database Access tab.
    5. Under Specify which databases can be accessed by this login, select the Pages database.
    6. In the Database roles for database_name box, select public and db_owner.
    7. Click OK.
    8. In the navigation pane, expand the objects to display the Pages database; right-click the Pages database and select Properties.
    9. Click the Permissions tab and grant all permissions to the Pages database user.
  5. Click OK.
  6. Close SQL Server Enterprise Manager.

Creating the Pages Database in Microsoft SQL Server 2005

To create and set up the Pages database in Microsoft SQL Server 2005:

  1. Open SQL Server Management Studio.
  2. Create the Pages database user:
    1. In the navigation pane, expand the objects to display subfolders of the Security folder.
    2. Right-click the Logins icon; then click New Login.
    3. In the SQL Server Login Properties dialog box, enter the user name you provisioned when you completed the Installation and Configuration Worksheets for AquaLogic Pages.
    4. In the Authentication area, choose SQL Server Authentication and enter the corresponding password.
    5. Confirm the password to complete the process.
  3. Create the Pages database with the name you provisioned when you completed the Installation and Configuration Worksheets for AquaLogic Pages.
  4. Grant the Pages database user the dbo server role.
  5. Click OK.
  6. Set the security for the database:
    1. In the Object Explorer, expand the Pages database and right-click the Security folder.
    2. Select New Schema.
    3. In the Schema Name field, type the name of the Pages database user.
      4. Note: The schema name must exactly match the name of the Pages database user.
    4. Click the Search button and browse for the name of the Pages database user.
    5. Click OK.
    6. In the Object Explorer, expand the Users folder, which is under the Security folder.
    7. Right-click the Pages database user and select Properties.
    8. In the Database User dialog box, on the User Mapping page, click the ... button to the right of the Default Schema name to launch the Select Schema dialog box.
    9. Browse for the schema that you created; this name should match the Pages database user name.
    10. Click OK to close the Select Schema dialog box.
    11. Click OK to close the Database User dialog box.
  7. Close SQL Server Management Studio.

Creating the Pages Database in Oracle

To create and set up the Pages tablespace in Oracle:

  1. Create the Pages tablespace:
    1. Create a new tablespace for Pages in the portal database instance.
    2. Create the Pages tablespace with the name you provisioned when you completed the Installation and Configuration Worksheets for AquaLogic Pages.
    3. Configure the newly created Pages tablespace to Automatically extend data file.
  2. Create the Pages schema user:
    1. Create the Pages schema user with the name you provisioned when you completed the Installation and Configuration Worksheets for AquaLogic Pages.
    2. Grant the Pages schema user default ownership of the newly created Pages tablespace.
    3. Grant the Pages schema user the Resource role.

 

Installing Pages Components

There are several components involved in a Pages deployment:

The components can be installed on different hosts, in any order; however, you should not start any of the components until all components are installed. For details on provisioning hosts for the various Pages components, see the Deployment Guide for BEA AquaLogic User Interaction.

Note: In a typical deployment the Pages Application is installed on a different computer than the Pages Portal Extensions and the Image Service Files.

Launching the Pages Installer

To launch the Pages installer:

  1. Log into the Windows host as the local administrator.
  2. Copy the ALPages_v1-0_mp2.exe installer to a temporary location.
  3. Close all unnecessary windows and applications.
  4. Double-click ALPages_v1-0_mp2.exe to launch the installer.

Complete the installation wizard panels as described in Completing the Installer Wizard Pages, and according to the settings you planned when you completed the configuration worksheets.

Completing the Installer Wizard Pages

The following table describes the Pages installer wizard pages. The installer wizard pages that appear vary according to the selections you choose.

Note: If the installer setting does not apply to the Pages components you are installing, the installer does not display the wizard page.

Table 4-1 Pages Installer Wizard Pages
Wizard Page
Description
Introduction
This page provides a brief description of the installer and describes how to run the installer in silent mode. Click Next.
Choose Install Set
In the Install Set drop-down list, select either Complete or Custom. If you select Complete, the full set of Pages components is installed. If you select Custom, you can choose from the following individual components to install according to your deployment plan:
  • Pages Application: The core set of Web UI components that comprise the Pages application.
  • Pages Portal Extensions: The files necessary to enable communication between the portal and Pages.

    • If your AquaLogic Interaction deployment is hosted on a non-Windows platform, do not install the Pages Portal Extensions using the Pages installer. Instead follow the instructions in Installing Pages Portal Extensions on UNIX or Linux.

  • Image Service Files: The necessary images, styles, user interface controls, and online help for Pages. Install these files on the same computer on which the portal’s Image Service is installed.

    • If your Image Service is hosted on a non-Windows platform, do not install the Pages Image Service Files using the Pages installer. Instead follow the instructions in Installing Image Service Files on UNIX or Linux.

After you have chosen the components you want to install, click Next.

Note: In a typical deployment the Pages Application will be installed on a different computer than the Pages Portal Extensions and the Image Service Files.
Configuration Manager - Port and Password
Specify the port and password you want to use for the Configuration Manager (a web tool that allows you to configure properties for Pages and other ALUI products). The default port is 12345.
If you have previously installed the Configuration Manager on this computer, you can update the password and port if necessary by selecting Update password and port.
Installation Location
Specify where you want to install the software. The default installation folder is C:\bea\alui.
After you have specified the location, click Next.
Portal Path
Specify where the portal files are installed. The default portal installation folder is C:\bea\alui\ptportal\6.1\.
After you have specified the location, click Next.
Installation Location for Image Service Files
Specify where the Image Service files are installed. The default Image Service installation folder is C:\bea\alui\ptimages.

Note: The security for the Image Service directory must be appropriately configured to allow for installation of the Image Service files.

After you have specified the location, click Next.
Pre-Installation Summary
Confirm the installer settings (install folder, components to install, and space needed for install), and click Install to start the installation.
Launch Configuration Manager
Click the link to launch the Configuration Manager and to configure settings for Pages. Log in as Administrator with the password you entered in the installer. For information on the Configuration Manager settings, refer to Verifying the Configuration Settings.
After completing the Configuration Manager, save your settings, close Configuration Manager, and click Next.
Application Settings Confirmation
Specify whether your application settings are correct, and click Next:
  • If you verified that all the settings in the Configuration Manager were correct, select Yes.
  • If you were not able to verify all the settings, but do not want to launch Configuration Manager again now to correct them, select No, configure later.
Install Complete
When the installer has finished, this page alerts you as to whether the installer succeeded. Click Done.

Redeploying the Portal Application

If you are using WebLogic, after installing the Pages Portal Extensions, you must redeploy the portal in the WebLogic console.

To redeploy the portal:

  1. Open the WebLogic console.
  2. Update, or delete and re-add, the portal deployment for install_dir\webapp\portal.ear file.

 

Verifying the Configuration Settings

Use the Configuration Manager to configure Pages database and connectivity settings.

  1. If you were not able to navigate to the Configuration Manager by clicking the link in the installer, navigate to https://localhost:12345/cm/ui/cm.jsf (replacing localhost with the name of the computer that hosts the Pages application, and replacing 12345 with the port number you specified during installation).
  2. Log in as Administrator with the password you specified during installation.
  3. Click Pages.
  4. Verify the following values:
    1. Vendor: The database vendor used for the AquaLogic Pages database.
    2. Host: The name of the computer that hosts the Pages database.
    3. Port: The port number on which the Pages database services requests (the default for SQL Server is 1433, the default for Oracle is 1521).
    4. Repository Name: The name of the Pages database (for Oracle databases, this is the SID).
    5. User Name: The name of the Pages database user. (If you have to correct the user name, you should also correct the associated password.)
    6. HTTP Enabled: Select if non-secured HTTP should be used for the application's communication.
    7. HTTP Port: The port number the application should listen to for non-secured requests.
    8. HTTPS Enabled: Select if secured HTTP over SSL should be used for the application's communication.
    9. HTTPS Port: The port number the application should listen to for secured requests.
    10. AJP/1.3 Enabled: Select if AJP/1.3 should be used for the application's web protocol.
    11. AJP/1.3 Port: The port number the application should listen to for AJP/1.3 requests.
  5. If any of the values are incorrect, click the name of the associated page (Repository or Pages Application Settings) to display the editable fields. Correct the values and click Save.
Note: Embedded online help is available in the Configuration Manager’s user interface.

 

Starting the BEA AquaLogic Pages Service

Note: The AquaLogic Interaction Search and API services or daemons must be started before you start the BEA AquaLogic Pages service.

To start the BEA AquaLogic Pages service:

  1. Open the Windows Services console. Click Start Arrow symbol Settings Arrow symbolControl Panel Arrow symbol Administrative Tools Arrow symbolServices.
  2. In the list of services, double-click BEA AquaLogic Pages.
  3. In the Startup type drop-down list, select Automatic.
  4. Click Start.
  5. Click OK to exit the properties dialog box.
  6. Close the Services console.

 

Installing Pages Portal Extensions on UNIX or Linux

The Pages Portal Extensions component must be manually installed when AquaLogic Interaction is hosted on a non-Windows platform. When AquaLogic Interaction is hosted on a Windows platform, use the Pages installer to install the Pages Portal Extensions component, as described in Installing Pages Components.

To install the Pages Portal Extension component to a UNIX or Linux platform:

  1. Stop your application server.
  2. Copy taglibPages.jar to the following portal directory: install_dir/ptportal/version/lib/java. For example, execute the following command:
    3. cp taglibPages.jar opt/bea/alui/ptportal/6.1/lib/java
  3. Navigate to the directory that contains the portal.war and portal.ear files: install_dir/ptportal/version/webapp. For example, execute the following command:
    4. cd /opt/bea/alui/ptportal/6.1/webapp
  4. Update the portal.war with the taglibPages.jar file by executing the following commands:
    1. Create a tmp directory by executing the following command:
      2. mkdir tmp
    2. Copy the portal.war to the tmp directory by executing the following command:
      3. cp portal.war tmp
    3. Extract the portal.war file by executing the following command:
      4. jar -xvf portal.war
    4. Copy the taglibPages.jar from install_dir/ptportal/version/lib/java to the extracted portal.war in install_dir/ptportal/version/webapp. For example, execute the following command:
      5. cp /opt/bea/alui/ptportal/6.1/lib/java/taglibPages.jar /opt/bea/alui/ptportal/6.1/webapp/tmp/WEB-INF/lib
    5. Repackage portal.war with new .jar by executing the following command:
      6. jar -cvf portal.war *
    6. Copy new portal.war file to new location by executing the following command:
      7. cp portal.war ../tmp
  5. Verify the taglibPages.jar was added to the portal.war by executing the following command:
    6. jar tf portal.war
  6. Update the portal.ear file with the new portal.war by executing the following command:
    7. jar uf portal.ear portal.war
  7. Navigate to the directory that contains the CustomTags.xml file: install_dir/settings/portal. For example, execute the following command:
    8. cd /opt/bea/alui/settings/portal
  8. Open the CustomTags.xml file in a text editor and add the following line to the <AppLibFiles> node section:
    9. <libfile name="taglibPages"/>

    For example: 

    <?xml version="1.0" encoding="UTF-8"?>
    <AppLibFiles>
         <libfile name="testlibApp" />
         <libfile name="taglibPages"/>
    </AppLibFiles>
  9. Save the changes you made to CustomTags.xml.
  10. Copy the pagesconfig.xml file to the settings directory: install_dir/settings. For example, execute the following command:
    11. cp pagesconfig.xml /opt/bea/alui/settings
  11. Restart your application server.

 

Installing Image Service Files on UNIX or Linux

The Image Service Files component must be manually installed when the Image Service is hosted on a non-Windows platform. When the Image Service is hosted on a Windows platform, use the Pages installer to install the Pages Image Service Files component, as described in Installing Pages Components.

To install the Pages Image Service Files component to a UNIX or Linux platform:

  1. Copy the imagesvr.tar file into your imageserver directory: install_dir/ptimages. For example, execute the following command:
    2. cp imagesvr.tar /opt/bea/alui/ptimages
  2. Navigate to this directory. For example, execute the following command:
    3. cd /opt/bea/alui/ptimages
  3. Extract the files by executing the following command:
    4. tar xvf imagesvr.tar
  4. Verify the following directories were created:
    • ptimages/imageserver/plumtree/pages/private/components
    • ptimages/imageserver/plumtree/pages/private/css
    • ptimages/imageserver/plumtree/pages/private/help
    • ptimages/imageserver/plumtree/pages/private/img
    • ptimages/imageserver/plumtree/pages/private/js
    • ptimages/imageserver/plumtree/pages/private/layouts
    • ptimages/imageserver/plumtree/pages/private/organizer
    • ptimages/imageserver/plumtree/pages/private/pagecomponentsselector
    • ptimages/imageserver/plumtree/pages/private/richtext
    • ptimages/imageserver/plumtree/pages/private/shells
    • ptimages/imageserver/plumtree/pages/private/webapp
  5. Restart the web server hosting your Image Service.

 

Registering Pages with the Portal

If you are going to access Pages through AquaLogic Interaction, you must register Pages with the portal. To register the Pages objects with the portal perform the following steps:

  1. Move the migration package (pagesobjects.pte) from the computer that hosts Pages to the computer that hosts the portal. The migration package is located in install_dir\pages\1.0\serverpackages (for example, C:\bea\alui\pages\1.0\serverpackages\pagesobjects.pte).
  2. Log in to the portal as a portal administrator.
  3. Click Administration.
  4. From the Select Utility drop-down list select Migration - Import.
  5. Browse to select the location of the migration package.
  6. Click Load Package.
  7. Click Finish.

The following portal objects are created when you import the migration package:

Table 4-2 Portal Objects Included in Pages Migration Package
Object
Description
Pages Objects
This folder stores all the objects included in the migration package.
DataSpace Creators
This group provides members with the ability to create DataSpaces.
LiveSpace Creators
This group provides members with the ability to create LiveSpaces.
Pages Administrators
This group provides members with the ability to create and manage any Pages object.
Pages Users
Users in this group are granted the Guest role (read access) to newly created LiveSpaces and DataSpaces by default.
Pages Base URL Portlet
This portlet is only for internal code purposes. It is used to gateway the Pages application.
Pages Launcher Portlet
This portlet provides access to the Pages user interface. It includes a link to the Dashboard.
Pages Components Selector
This portlet template enables you to create a portlet from an existing page component, to display content form a page component in a portal page.
Pages Server
This remote server points to the Pages installation.
Pages Base URL Web Service
This web service is used to gateway content in Pages.
Pages Dashboard Web Service
This web service is used to display the Dashboard.
Pages DataSpaces Web Service
This web service provides the list of DataSpaces to the DataSpaces menu.
Pages Launcher Web Service
This is the web service for the Pages Launcher Portlet.
Pages LiveSpaces Web Service
This web service provides the list of LiveSpaces to the LiveSpaces menu.
Pages Components Service
This web service is used to gateway components displayed in portlets.

Next you should integrate Pages into the portal navigation and set up security for Pages. For details, see the Administrator Guide for AquaLogic Pages.

 

Registering Pages with AquaLogic Ensemble

You can configure Pages to be accessed through the AquaLogic Ensemble proxy. This provides you more control over the appearance of Pages URLs and allows you to take advantage of Ensemble’s integration with AquaLogic Interaction Analytics.

To register Pages with Ensemble, register Pages as a resource. For instructions on registering resources in Ensemble, see the Administrator Guide for AquaLogic Ensemble.


  Back to Top       Previous  Next