Skip Headers
Oracle® Communications Billing and Revenue Management Installation Guide
Release 7.5

E16706-13
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

13 Installing Pipeline Configuration Center

This chapter explains how to install Oracle Communications Billing and Revenue Management (BRM) Pipeline Configuration Center (PCC).

PCC Installation Overview

This section provides an overview of the PCC installation process.

Overview of PCC Installation

PCC installation should be performed only by experienced system administrators. You must be familiar with the following before you begin the installation:

  • UNIX operating system

  • Oracle WebLogic Server administration

  • Oracle Database 11gR2 administration

Additionally, you should have experience installing Java-related packages.

About the PCC Architecture

PCC is a Web-based BRM application that serves as the user interface for Pipeline Manager.

PCC runs on a managed server in an Oracle WebLogic Server domain. To interact with PCC, users enter the PCC login page URL in a browser and then enter their PCC user name and password in the login page. After a user is authenticated, the PCC home page appears in the browser.

Figure 13-1 shows how PCC and Pipeline Manager are integrated.

Figure 13-1 PCC and Pipeline Manager Integrated Architecture

Description of Figure 13-1 follows
Description of "Figure 13-1 PCC and Pipeline Manager Integrated Architecture"

Operating System Security

PCC is supported on Linux 5 UL3+ (both Oracle Linux and Red Hat Enterprise Linux), Oracle Solaris for SPARC (10 Update 4+), Windows XP (SP3) (browser only), Windows 7 (browser only), and Windows 8.1 (browser only). See the following documents for more information:

Overview of the PCC Installation Procedure

The following is an overview of the PCC installation procedure:

  1. Plan your installation. Planning an installation involves the following:

    • Determining the scale of your implementation (for example, is it a small test system or a large production system?).

    • Assessing how many physical computers you need and which software components to install on which computers.

  2. Review system requirements.

  3. Perform the following pre-installation tasks:

    • Install and configure Oracle WebLogic Server.

    • Install and configure BRM.

  4. Install PCC.

  5. Perform the post-installation configuration tasks.

  6. Verify the installation.

Performing a Secure PCC Installation

This section describes recommended deployment configurations for your PCC installation that enhance security.

Recommended Installation Mode

You can install PCC in the following modes:

  • GUI mode

  • Silent mode

Oracle recommends that you install PCC using Secure Sockets Layer (SSL) in a production environment. See "Installing PCC" for more information.

The silent mode installation is not meant for production environments. It should be used only in test environments and only for setting up quickly or backing up the properties for later use in another test environment.

See "Secure Deployment Checklist" for information about the checklist to deploy PCC securely.

Ensuring a Successful PCC Installation

To ensure that the PCC installation is successful, follow these guidelines:

  • As you install each component (for example, the WebLogic Server), verify that the component is installed successfully before continuing the installation process.

  • Pay close attention to the system requirements.

    Before you begin installing the application, ensure that your system has the required software. In addition, ensure that you know all the required configuration values, such as host names and port numbers.

  • Make a note of any new configuration values as you create them.

    You will be required to enter configuration values later.

PCC System Requirements

This section describes the software, hardware, server, and database requirements for installing PCC.

Software Requirements

PCC is deployed on an Oracle WebLogic Server domain. You must install and connect all required software for optimal performance. PCC is supported only on software and hardware listed in the following sections.

Supported Operating Systems

Table 13-1 lists operating systems that PCC supports.

Table 13-1 PCC Operating Systems Requirements

Product Version

Oracle Linux, x86-64 (64bit)

5 UL3+

Red Hat Enterprise Linux, x86-64 (64bit)

5 UL3+

Oracle Solaris for SPARC (64bit)

10 Update 4+

Windows XP, x86 (32 bit) (browser only)

Professional with Service Pack 3

Windows 7, x86 (64 bit) (browser only)

Professional with Service Pack 1

Windows 8.1 (browser only)

Enterprise

Support added in BRM 7.5 Patch Set 10.


Additional Software Requirements

Table 13-2 lists software required for running PCC.

Table 13-2 PCC Software Requirements

Product Version Disk Space

Oracle WebLogic Server 11g Enterprise Edition

10.3.4

1 GB.

Oracle Fusion Middleware 11g Application Development Framework

11.1.1.4 with patch 9941133

1 GB.

Oracle Database Server

The same version used by the BRM 7.5 installation to which PCC connects

1.2 GB.

BRM on Linux x86-64 (64 bit) or Solaris SPARC (64 bit)

7.5 with patch set 2 (14334024)

BRM server: 300 MB.

BRM database: 2 to 5 GB per 10,000 customers per year. This requirement varies greatly with the number of accounts and the amount of activity.

Internet Browser

(Windows only) Microsoft Internet Explorer 8 on Windows XP and Windows 7

(Windows only) Microsoft Internet Explorer 11 on Windows 7 and Windows 8.1 (Compatibility View mode)

Mozilla Firefox 32

NA.

Java

JDK 1.6.0_33 or above with minimum heap size of 500 MB

NA.


The PCC installer checks for all required software and displays errors if it detects any missing or unavailable components or if there are any connectivity-related issues.

Note:

For information on how to download a required software component, see the relevant sections in the installation guide for that component.

Hardware Requirements

The number and configuration of the computers that you employ for your PCC installation depend on the scale and the kind of deployment you have planned.

Table 13-3 provides the minimum hardware requirements for PCC installed on a single managed server in a domain.

Table 13-3 PCC Minimum Hardware Requirements

Component Requirement

Hard disk

1.5 GB of free disk space.

Note: A minimum of 1.5 GB should be free in the domain home.

Processor

Oracle recommends using twin cores, each running at 1.5 GHz CPU.

Memory

A minimum of 4 GB physical memory and 4 GB swap.

If you plan to install the database on the same server as PCC, the minimum memory requirements increase to 6 GB physical memory and 6 GB swap.


Information Requirements

This section describes the information that you must provide during the PCC installation process. You define some of these configuration values when you install and configure Oracle WebLogic Server for PCC during the pre-installation tasks.

Note:

Oracle recommends that you print the tables and record the values for future reference.

Oracle WebLogic Server Domain Information

Table 13-4 lists the domain information required during PCC installation. This information pertains to the domain on which you want to deploy PCC.

Table 13-4 Oracle WebLogic Server Domain Information

Field Description

Host Name

The IP address or the host name of the computer on which the PCC domain is configured.

Port Number

The port number assigned to the PCC domain administration server.

User Name

The PCC domain administrator user name.

Password

The password for the PCC domain administrator user.

WebLogic Home

The path of the directory where the Oracle WebLogic Server software is installed.

Use SSL?

(Optional) A check box to indicate whether the server on which you want to deploy PCC supports secure socket layer (SSL).

Note: You must configure SSL when creating the domain on which you want to deploy PCC. See "Configuring SSL for the Oracle WebLogic Server Domain" for more information.

Keystore Location

(Optional) The path of the client-side keystore file generated from the exported public certificate using the keytool utility.

Note: If you select the Use SSL? check box, you must select or enter the path of the keystore file.


BRM Pipeline Manager Database Connection Information

Table 13-5 lists the Pipeline Manager database connection information required during PCC installation.

Table 13-5 Pipeline Manager Database Connection Information

Field Description

Host Name

The IP address or the host name of the computer on which the Pipeline Manager database is configured.

Port Number

The port number assigned to the Pipeline Manager database service.

User Name

The user name of the Pipeline Manager database user.

Password

The password of the Pipeline Manager database user.

Service Name

The name of the Pipeline Manager database service.


PCC Pre-Installation Tasks

This section describes the tasks that you perform before installing PCC.

Overview of Pre-Installation Tasks

Pre-installation tasks for PCC are divided into the following groups:

  • Installing and configuring Oracle WebLogic Server.

    • Enable SSL for the target Oracle WebLogic Server server domain, configure the server keystore certificate, and get the client keystore trusted certificate (.jks file).

    • If SSL is enabled, ensure that the keystore file is created in a secure drive and access is strictly limited to the user account.

  • Installing and configuring BRM.

  • Configure Oracle Database advanced security encryption and integrity algorithms for a secure connection from the installer. See the Oracle Database documentation for advanced security configuration parameters. This is required for the PCC installer to make a secured (encrypted) database connection over the network. For more information, see Oracle Database Advanced Security Administrator's Guide 11g Release 1 (11.1), available at the following Web site:

    http://download.oracle.com/docs/cd/B28359_01/network.111/b28530/asojbdc.htm#i1006157

  • Verify that you have JDK 1.6.0_33 or later installed.

Installing and Configuring Oracle WebLogic Server

This section describes procedures related to installing Oracle WebLogic Server and configuring the Oracle WebLogic Server domain on which you will deploy PCC.

Downloading and Installing WebLogic Server

Oracle WebLogic Server is available as a component of the Oracle Fusion Middleware 11g media pack. Fusion Middleware 11g PS3 includes WebLogic Server 10.3.4.

Download Oracle WebLogic Server 10.3.4 from the Oracle software delivery Web site:

http://edelivery.oracle.com

For information on installing Oracle WebLogic Server 10.3.4, see the Oracle WebLogic Server documentation on the Oracle Technology Network.

Installing and Configuring Oracle Application Development Runtime

Oracle Application Development Runtime 11g must be installed on the computer on which you install PCC. You can download Oracle Application Development Runtime 11g from the Oracle software delivery Web site:

http://edelivery.oracle.com

See Oracle Fusion Middleware Installation Guide for Application Developer 11g Release for information on installing Oracle Application Development Runtime 11g.

Note:

The Oracle Fusion Middleware 11g Application Developer installer installs both Oracle Application Development Runtime and Oracle Enterprise Manager.

See Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework for more information on Application Development Framework.

Creating an Oracle WebLogic Server Domain

To create a domain on which to deploy PCC, see the Oracle WebLogic Server documentation.

You must create the domain with at least one managed server and one administration server. Oracle recommends that you deploy PCC on a managed server in a production environment.

Table 13-6 shows the values to choose when creating the domain for PCC.

Table 13-6 Oracle WebLogic Server Domain Configuration Values

Configuration Value Description

Domain Source

Select Generate a domain configured automatically to support the following BEA products.

From the list, select Oracle JRF - 11.1.1.0 [oracle_common].

Domain Mode Configuration

Select Production Mode.

Optional Configuration

Select Administration Server, Managed Servers, Clusters and Machines and Deployments and Services.

Administration Server Listen Address

Use a listen address that is equal to a resolvable DNS host or IP address.

Do not use localhost or 127.0.0.1. Those addresses interfere with clustered servers.

Managed Server Listen Address

Enter a listen address that is equal to a resolvable DNS host or IP address.

Target Deployments to Clusters or Servers

Add all libraries to both the managed server target and the Administration Server.

Target Services to Clusters or Servers

Add all services to the managed server target.


See Oracle Fusion Middleware Installation Guide for Oracle Enterprise Content Management Suite 11g Release 1 for more information on Oracle WebLogic Server domains.

You can now start the domain administration server manually and log in to the WebLogic Administration Console.

Configuring SSL for the Oracle WebLogic Server Domain

To enable secure communication for PCC, you must configure secure socket layer (SSL) for the domain on which you want to deploy PCC.

To configure SSL for the domain:

  1. Generate the server-side keystore file using the keytool utility.

    See the Key and Certificate Management Tool online documentation for more information.

  2. Export the public certificate from the server-side keystore file using the keytool utility.

    See the Key and Certificate Management Tool online documentation for more information.

  3. Generate the client-side keystore file from the exported public certificate using the keytool utility.

    See the Key and Certificate Management Tool online documentation for more information.

    Note:

    Note the path of the client-side keystore file. You must provide this path during the PCC installation if you choose to use SSL.
  4. In the WebLogic Administration Console, configure SSL for the domain managed server on which you want to deploy PCC.

    See the Oracle WebLogic Server Administration Console Help for more information.

Installing and Configuring BRM

You must install BRM 7.5 with Patch Set 2 (14334024).

To install BRM:

  1. Download BRM 7.5 from the Oracle software delivery Web site:

    http://edelivery.oracle.com

  2. Install BRM and Pipeline Manager.

    See the BRM installation documentation.

  3. Download BRM 7.5 Patch Set 2 (14334024) from the My Oracle Support Web site.

    http://support.oracle.com

  4. Install BRM 7.5 Patch Set 2 (14334024).

    See BRM 7.5 Patch Set Installation Guide.

Setting Up the Business Parameter

If you use PCC with PDC, after installing BRM and the required patches, you must set up the PriceDesignCenterInst business parameter.

To set up PriceDesignCenterInst:

  1. Go to BRM_Home/sys/data/config and run the following command, which creates an editable XML file from the pricing instance of the /config/business_params object.

    pin_bus_params -r BusParamsPricing bus_params_pricing.xml
     
    

    This directory includes the support files used by the pin_bus_params utility. To run it from a different directory, see pin_bus_params in the BRM documentation.

    This command creates the XML file named bus_params_pricing.xml.out in your working directory. If you do not want this file in your working directory, specify the path as part of the file name.

  2. Search for the following line in the XML file:

    <PriceDesignCenterInst>disabled</PriceDesignCenterInst>
     
    

    By default, PriceDesignCenterInst is set to disabled.

  3. Change disabled to enabled.

  4. Save the file as bus_params_pricing.xml.

  5. Use the following command to load this updated file into the /config/business_params object:

    pin_bus_params bus_params_pricing.xml
     
    
  6. Read the object with the testnap utility or Object Browser to verify that all fields are correct.

Installing PCC

This section describes how to install PCC. Before installing PCC, read the following:

You can install PCC in the following modes:

  • GUI mode: Use the GUI mode when you want to interact with the PCC installer GUI during installation. See "Installing PCC in GUI Mode".

  • Silent mode: Use the silent mode when you install PCC using the same configuration repeatedly. Silent install mode does not use the GUI, and it runs in the background. See "Installing PCC in Silent Mode".

The PCC installer must be launched from the computer hosting the Oracle WebLogic Server domain. PCC installation must be performed by the user who has permissions to write to the Oracle Inventory (oraInventory) directory and the WebLogic_Home/user_projects/domains directory, where WebLogic_Home is the directory in which you installed the WebLogic Server.

For more information about the oraInventory directory, see the Oracle documentation available at the Oracle Technology Network Web site:

http://docs.oracle.com

Installing PCC in GUI Mode

Note:

To perform a GUI installation, install a GUI application, such as X Windows, and set the DISPLAY environment variable before you install PCC.

To install PCC in GUI mode:

  1. Ensure that the Pipeline Manager database server is running.

  2. Start the Oracle WebLogic Server domain administration server and managed server on which you want to deploy PCC.

  3. Create a temporary directory (temp_dir).

  4. Go to the Oracle software delivery Web site:

    http://edelivery.oracle.com

  5. Download the appropriate PipelineConfigurationCenter-7.4-platform.zip software pack to temp_dir, where platform is linux, solaris, or win32.

  6. Unzip the PipelineConfigurationCenter-7.4-platform.zip file.

    The following folder structure is created:

    temp_dir/pcc/Disk1/install/ and temp_dir/pcc/Disk1/stage/

    temp_dir is the directory in which you unzipped the PCC software.

  7. Go to the temp_dir/pcc/Disk1/install/ directory, and enter the following UNIX command:

    ./runInstaller 
     
    

    The Welcome screen appears.

  8. Click Next.

    Note:

    The PCC installer creates the oraInventory directory if it does not detect any installed Oracle products on the system. The oraInventory directory manages all Oracle products installed on your system.

    The Specify Home Details screen appears.

  9. Enter the following PCC installation details:

    1. In the Name field, enter the PCC installation name.

      Note:

      You can select the name for the installation from the list of names the installer provides.
    2. In the Path field, enter the path to the directory where you want to install PCC.

      Note:

      Optionally, click Browse to navigate to the directory.
    3. Click Next.

      The WebLogic Administration Server Connection screen appears.

  10. Enter the following details for the domain on which you want to deploy PCC (see Table 13-4, "Oracle WebLogic Server Domain Information" for more information):

    1. In the Host Name field, enter the IP address or the host name of the computer on which the domain is configured.

    2. In the Port Number field, enter the port number assigned to the domain administration server.

    3. In the Username field, enter the domain administrator user name.

    4. In the Password field, enter the password for the domain administrator user.

    5. In the WebLogic Home field, enter the path of the directory where the Oracle WebLogic Server software is installed.

      WARNING:

      The PCC installer will not proceed until it verifies with the running instance of Oracle WebLogic Server that the domain administration server information you entered is valid.

    6. Do one of the following.

      If the server does not support SSL, deselect the Use SSL? check box.

      If the server supports SSL, leave the Use SSL? check box selected, and in the Keystore Location field, enter the path of the client side keystore file generated from the exported public certificate using the keytool utility. See "Configuring SSL for the Oracle WebLogic Server Domain" for more information.

    7. Click Next.

      The WebLogic Server/Cluster Selection screen appears.

  11. Select the domain administration server or managed server on which you want to deploy PCC, and click Next.

    Note:

    Oracle recommends deploying PCC on a managed server. If you select a managed server, ensure that the managed server and the node manager are running.

    The BRM Pipeline Database Connection screen appears.

  12. Enter the following information required to connect to the Pipeline Manager database (see Table 13-5 for more information):

    1. In the Host Name field, enter the IP address or the host name of the computer on which the Pipeline Manager database is configured.

    2. In the Port Number field, enter the port number assigned to the Pipeline Manager database service.

    3. In the Username field, enter the user name of the Pipeline Manager database user.

    4. In the Password field, enter the password of the Pipeline Manager database user.

    5. In the Service Name field, enter the name of the Pipeline Manager database service.

      WARNING:

      The PCC installer will not proceed until it verifies with the running instance of the Pipeline Manager database server that the database information you entered is valid.

    6. Click Next.

      The Pipeline Configuration Center User screen appears.

      Note:

      Entering information in this screen is optional. If you do not want to create a PCC user now, click Next.
  13. (Optional) Enter the following information required to create a PCC user:

    1. In the Username field, enter the name for the PCC user.

    2. In the Password field, enter a password for the PCC user.

      Note:

      The PCC user password can contain up to 12 characters and should contain at least one nonalphabetic character. For example, Weblogic123.

      The user name must not be a part of the password.

    3. In the Confirm Password field, enter the password again.

    4. Click Next.

      The Summary screen appears.

  14. Review the selections you made in the preceding screens, and click Install.

    The Install screen appears.

    Note:

    After the installation begins, if you click Stop installation, the installation process stops, but the files that are already copied are not removed.
  15. When the End of Installation screen appears, note the provided URL.

    You use this URL to access PCC.

    Note:

    If the server supports SSL, the secure connection is established for PCC even if you deselect the Use SSL? check box in the WebLogic Administration Server Connection screen. In this case, two connection URLs are displayed:
    • A secured connection URL with SSL listen port and the HTTPS schema

    • An unsecured connection URL with the HTTP schema

  16. Click Exit.

    The Exit confirmation message appears.

  17. Click Yes.

If you did not create a PCC user during installation, you must create one after the installation is complete. See "PCC Post-Installation Tasks".

See "Verifying the PCC Installation" for information on verifying the successful installation of PCC.

See "About Installation Logs" for information on PCC installer logs.

Installing PCC in Silent Mode

Silent-mode installation enables you to set installation configurations only once and then use those configurations to duplicate the installation on many machines. In this mode, you use a response file template that contains a predefined set of values to install PCC.

Note:

The silent installation is not meant for production environments, and it should be used in test environments only for setting up quickly or backing up the properties for later use in another test environment.

About the Response File Template

The PCC installer includes a response file template, temp_dir/pcc/Disk1/stage/Response/oracle.communications.pcc.Complete.rsp, where temp_dir is the directory in which you unzipped the PCC software.

This response file template contains all the parameters that the PCC installer requires during the silent, unattended installation, but it does not contain the parameter values. You must update the response file template per your installation requirements before starting the silent installation.

Installing PCC in Silent Mode

To install PCC in silent mode:

  1. Go to the temp_dir/pcc/Disk1/stage/Response/ directory, where temp_dir is the directory in which you unzipped the PCC software.

  2. Make a copy of the oracle.communications.pcc.Complete.rsp file, and open it in a text editor.

  3. Enter the values in the parameters per your installation requirements.

    Notes:

    • The response file template contains guidelines and examples on how to enter the values in the parameters.

    • The PCC installer treats incorrect context, format, and type values in a response file as if no value were specified.

  4. Save and close the file.

  5. Go to the temp_dir/pcc/Disk1/install/ directory, where temp_dir is the directory in which you unzipped the PCC software, and enter the following UNIX command:

    ./runInstaller -responseFile path -silent
     
    

    where path is the response file name and location.

    For example:

    ./runInstaller -responseFile /response_files/myresponsefile.rsp -silent
     
    

    The installation runs silently in the background.

  6. Open the PCC_Home/install/readme.txt file, where PCC_Home is the directory in which you installed PCC.

  7. Copy the URL and paste it in your browser's address field.

    You can now access the PCC application.

See "Verifying the PCC Installation" for information on how to verify that the PCC installation was successful.

See "About Installation Logs" for information on the PCC installer logs.

About Installation Logs

The PCC Installer logs can be found in the oraInventory/logs directory.

Use the following log files to monitor installations and post-installations:

  • installActionTimeStamp.log

  • oraInstallTimeStamp.err

  • oraInstallTimeStamp.out

  • silentInstallTimeStamp.log (for silent mode installation)

where TimeStamp is the date and time the log file was created.

PCC Post-Installation Tasks

This section provides instructions for the following PCC post-installation tasks:

Creating a PCC User after Installing PCC

During the PCC installation, the installer creates the Config Admin Oracle WebLogic Server group. Users belonging to this group have read and write access to perform all the tasks in PCC.

You can create a PCC user during or after the installation. When you create a user during the installation, the installer automatically adds it to the Config Admin group.

To create a PCC user after installing PCC, use the WebLogic Administration Console to create a user and to add the user to the Config Admin group.

Note:

Do not use your browser's remember password feature for the WebLogic Administration Console URL. As a precaution, always enter the WebLogic server user name and password manually.

To create a PCC user after installing PCC:

  1. Log in to the WebLogic Administration Console.

  2. In the Domain Structure panel, click the Security Realms link.

    The Summary of Security Realms page appears.

  3. Click the myrealm link.

    The Settings for myrealm page appears.

  4. Click the Users and Groups tab.

  5. Click the Users subtab.

  6. Click New.

    The Create a New User page appears.

  7. Do the following:

    1. In the Name field, enter a name for the PCC user.

    2. (Optional) In the Description field, enter a brief description for the PCC user.

    3. In the Password field, enter a password for the PCC user.

      Note:

      The PCC user password can contain up to 12 characters and should contain at least one nonalphabetic character. For example, Weblogic123.

      The user name must not be a part of the password.

    4. In the Confirm Password field, enter the password again to confirm it.

  8. Click OK.

    The user name appears in the User table.

  9. Click the user link, where user is the PCC user that you created.

    The Settings for user page appears.

  10. Click the Groups tab.

  11. In the Parent Groups section's Available list, select Config Admin.

  12. Move Config Admin to the Chosen list.

  13. Click Save.

Configuring a Connection from PCC to BRM

After the PCC installation is complete, configure a connection from PCC to BRM.

To configure a connection from PCC to BRM:

  1. Open the PCC_Home/plan/AppFileOverrides/PCCView.war/Infranet.properties file, where PCC_Home is the directory in which you installed PCC.

    Note:

    As a backup, a copy of the Infranet.properties file might also be in the location specified in the HOME environment variable of the operating system user who starts WebLogic Server. In this situation, you must configure the connection in both instances of the file.
  2. Search for the infranet.connection entry.

  3. Edit the infranet.connection entry as follows:

    infranet.connection=pcp://username:password@hostname:port/service 1
     
    

    where:

    • username is the login name to use for connecting to BRM. You can use any valid CSR login name.

    • password is the password for username.

    • hostname is the name or IP address of the computer running the primary Connection Manager (CM) or CM Master Process (CMMP).

    • port is the TCP port number of the CM or CMMP on the host computer. The port number must match the corresponding cm_ports entry in the primary CM or CMMP configuration file.

    • service is the service type. The trailing 1 is the POID of the service.

  4. Save your changes, and close the file.

  5. Log in to the WebLogic Administration Console for the PCC domain, and do the following:

    1. In the Domain Structure panel, click Deployments.

      The Summary of Deployments page appears.

    2. In the Deployments table, select the PipelineConfigurationCenter check box.

    3. Click Update.

      The Update Application Assistant starts.

    4. Select the Update this application in place with new deployment plan changes option.

    5. Set Deployment plan path to the location of the Infranet.properties file. Use the Change Path button to browse to the file.

    6. Click Next, and review your choices.

    7. Click Finish.

    8. Restart WebLogic Server.

    See the Oracle WebLogic Server Administration Console Help for more information about the console.

  6. Secure the BRM connection information as follows:

    • Encrypt the password by using the pin_crypt_app utility. See the BRM documentation for more information about the utility.

    • Set the Infranet.properties file permissions to permit only specified system administrators to access the file.

Using Secure Cookies

Oracle recommends deploying PCC only on SSL, which encrypts sensitive data, thus eliminating problems like session stealing.

WebLogic Server enables a user to securely access HTTPS resources in a session that was initiated using HTTP, without loss of session data.

To use secure cookies:

  1. Open the WebLogic_Home/user_projects/domains/Domain_Name/config/config.xml file.

    where:

    • WebLogic_Home is the directory in which you installed WebLogic Server.

    • Domain_Name is the name of the domain you are configuring.

  2. Add AuthCookieEnabled="true" to the <WebServer> element:

    <WebServer Name="myserver" AuthCookieEnabled="true"/>. 
    

Note:

By default, AuthCookieEnabled is set to true. The secured cookies are enabled by default even if the config.xml file does not contain this entry. You can set AuthCookieEnabled to false to disable secured cookies. However, Oracle recommends not disabling it.

You can also set this entry by using the WebLogic Administration Console:

  1. Log in to the WebLogic Administration Console.

    The home page appears.

  2. In the Domain Configurations section, under Domain, click Domain.

    The Settings for Domain_Name page appears.

  3. Click the Web Applications tab.

  4. Verify that the Auth Cookie Enabled check box is selected.

  5. Click Save.

By default, the Auth Cookie Enabled check box is selected, but it is not present in the config.xml file. If you deselect it, the <AuthCookieEnabled> element is added to the config.xml file.

Setting AuthCookieEnabled to true, the default setting, causes the WebLogic Server instance to send a new secure cookie, _WL_AUTHCOOKIE_JSESSIONID, to the browser when authenticating through an HTTPS connection. After the secure cookie is set, the session is allowed to access other security-constrained HTTPS resources only if the cookie is sent from the browser.

For more information, see the "Using Secure Cookies to Prevent Session Stealing" article on the Oracle Technology Network Web site:

http://download.oracle.com/docs/cd/E12840_01/wls/docs103/security/thin_client.html#wp1053780

Oracle recommends keeping cookie settings enabled in the browser. Disabling cookies in the browser disables several features, such as Help.

Configuring the Session Timeout

The default session timeout in PCC is 600 seconds. The WebLogic Server administrator can change this value as follows:

  1. Log in to the WebLogic Administration Console.

  2. In the Domain Structure panel, click Deployments.

    The Summary of Deployments page appears.

  3. In the Deployments table, click PipelineConfigurationCenter.

    The Settings for PipelineConfigurationCenter page appears.

  4. Click the Configuration tab.

  5. In the Session Timeout (in seconds) field, enter a new timeout value in seconds.

  6. Click the Overview tab.

  7. In the Modules and Components table, click PCC-PCCViewController-context-root.

  8. Click the Configuration tab.

  9. In the Session Timeout (in seconds) field, enter the same timeout value, in seconds, that you entered in step 5.

  10. Click Save.

    If no deployment plan is created, WebLogic Server creates one with the preceding changes and prompts you to save the deployment plan. Provide the name and path for the deployment plan, and click OK.

  11. In the Domain Structure panel, click Deployments.

  12. Select the PipelineConfigurationCenter check box.

  13. Click Update.

    The Update Application Assistant starts.

  14. Select the Update this application in place with new deployment plan changes option.

  15. Set Deployment plan path to the deployment plan created in step 10. Use the Change Path button to browse to the file.

  16. Click Next.

  17. Click Finish.

  18. Restart WebLogic Server.

  19. Verify your changes by doing the following:

    1. Log in to the WebLogic Administration Console.

    2. In the Domain Structure panel, click Deployments.

    3. Click PipelineConfigurationCenter.

      The Settings for PipelineConfigurationCenter page appears.

    4. Click the Configuration tab.

    5. Verify that Session Timeout (in seconds) is set to the value you specified.

For more information, see the "Configuring Applications for Production Deployment" article on the Oracle Technology Network Web site:

http://download.oracle.com/docs/cd/E12840_01/wls/docs103/deployment/config.html

Verifying the PCC Installation

This section describes how to verify that PCC is installed correctly.

Checking the State of All Installed Components

You can verify that PCC is installed correctly by checking the state of all installed components.

To check the state of all installed components:

  1. Log in to the PCC domain WebLogic Administration Console.

  2. In the Domain Structure panel, click Deployments.

    The Summary of Deployments page appears.

  3. In the Control tab, if PCC is installed correctly, the deployed PipelineConfigurationCenter application appears in the Active state.

Logging In to PCC

You can log in to PCC to verify that PCC is installed.

To log in to PCC:

  1. Open a browser window.

  2. Enter the URL provided by the PCC installer at the end of the installation into the browser's address field.

    Note:

    The URL to access PCC is also available in the PCC_Home/install/readme.txt file, where PCC_Home is the directory in which you installed PCC.
  3. Press Enter.

    The PCC login page appears.

  4. Do the following:

    1. In the Username field, enter the user name.

    2. In the Password field, enter the password.

  5. Click Login.

    The PCC home page appears, verifying that PCC is successfully installed.

About File Permissions

  • The following default permissions are set for the installed files:

    • rw------- 600 (for all nonexecutable files)

    • rwx------ 700 (for all executable files)

    Permissions are set to the lowest possible level, and the WebLogic Server administrator can add or revoke permissions. Oracle recommends keeping the permissions as restrictive as possible.

  • Protect the WebLogic configuration (JMS, JDBC, and so on) file, config.xml, in the domain's config directory with proper permissions.

Securing the Infranet.properties File

During the PCC installation, the installer creates the PCC_Home/plan/AppFileOverrides/PCCView.war/Infranet.properties file.

Note:

As a backup, a copy of the Infranet.properties file might also be in the location specified in the HOME environment variable of the operating system user who starts WebLogic Server. In this situation, you must secure both instances of the file.

An Infranet.properties file is a configuration file that contains entries to control connections from Java applications to BRM. For more information about such files, see the BRM documentation set.

After the installation is complete, you add the BRM user name and password for connecting PCC to BRM to the PCC Infranet.properties file. See BRM PCC Installation and System Administration Guide for more information.

To secure this connection information, do the following:

  • Encrypt the password by using the pin_crypt_app utility. See the BRM Developer's Guide for more information about the utility.

  • Set the Infranet.properties file permissions to permit only specified system administrators to access the file.

Uninstalling PCC

You use the PCC installer to uninstall PCC.

Note:

To enable a graphical user interface (GUI) uninstallation, install a GUI application such as X Windows and set the DISPLAY environment variable to point to the GUI application server before you uninstall PCC.

To uninstall PCC:

  1. Go to the temp_dir/pcc/Disk1/install directory, where temp_dir is the directory in which you unzipped the PCC software.

  2. Enter the following UNIX command:

    ./runInstaller
     
    

    The Welcome screen appears.

  3. Click Deinstall Products.

    The Inventory screen appears.

  4. Select the PCC installation name that you entered during PCC installation.

  5. Click Remove.

    The Confirmation screen appears.

  6. Click Yes.

    The User Input screen appears.

  7. In the WebLogic Administrator password field, enter the PCC domain administrator password.

    See Table 13-4 for more information.

    Important:

    Even if you enter an incorrect WebLogic Administrator password, the uninstallation is completed; however, it is not a clean uninstallation. In this case, you must perform manual cleanup tasks after uninstalling PCC. See Pipeline Configuration Center Release Notes.
  8. Click OK.

    Important:

    After the uninstallation begins, even if you click Cancel, PCC is uninstalled. Oracle recommends not clicking Cancel in the middle of the uninstallation to prevent the PCC installer screen from hanging.

    The PCC components are uninstalled.

    The Inventory screen appears.

  9. Click Close.

    The Welcome screen appears.

  10. Click Cancel.

    The Exit dialog box appears.

  11. Click Yes.

The PCC installer removes all files except log files. You must delete the log files manually. The log files are in the oraInventory/logs directory.

Uninstalling PCC in Silent Mode

To uninstall PCC in silent mode:

  1. Go to the temp_dir/pcc/Disk1/install directory, where temp_dir is the directory in which you unzipped the PCC software.

  2. Run the following command:

    ./runInstaller -responseFile path -silent -deinstall
     
    

    where path is the response file name and location.

    A message indicating that PCC has been uninstalled successfully appears.

Deleting Files after Uninstalling PCC

The following files remain in the system after PCC is uninstalled:

  • Install logs

    The log files are in the oraInventory/logs directory.

  • PCC_Home/oui/data.properties

    This file is used to auto-populate the data during reinstalls.

Delete these files manually if you do not need them, or protect them appropriately if they are required for further installations.

By default, these files are created with the file-level permission 640 (owner can read/write; group members can read; others cannot do anything).

Administering PCC

This section provides an overview of basic administration tasks for PCC.

PCC Administrator Tasks

A PCC administrator is responsible for the day-to-day tasks of maintaining and managing PCC and its users. You perform the following tasks as a PCC administrator:

Managing PCC Security

Oracle WebLogic Server includes a security architecture that provides a secure foundation for applications. PCC depends on the WebLogic Server security framework to secure its resources and servers. Managing PCC security involves the following:

  • Managing security realms: Configuring new security realms, changing the default security realm, and deleting security realms

  • Managing users and groups: Defining users and assigning them to a group that can be authenticated in a security realm

  • Managing security providers: Managing security providers that provide security services to applications to protect WebLogic Server resources

See the Oracle WebLogic Server Administration Console Help for more information on managing security realms, managing users and groups, and managing security providers.

Monitoring PCC

Regularly monitoring your system ensures fast recognition and resolution of problems or issues. You can use the WebLogic Administration Console to monitor the following:

  • PCC domain

  • PCC administration server and managed servers

  • PCC cluster

See the Oracle WebLogic Server Administration Console Help for more information.

Managing PCC

You manage PCC by managing the WebLogic server on which PCC is installed. This includes starting and stopping the PCC administration server and managed servers.

See the Oracle WebLogic Server Administration Console Help for more information.

Troubleshooting PCC

This section provides guidelines for troubleshooting problems with PCC. It includes information about log files, diagnosing common problems, and contacting Oracle Global Support.

Troubleshooting Checklist

When problems occur, it is best to do some troubleshooting before you contact Oracle Global Support:

  • You know your installation better than Oracle Global Support does. You know whether anything in the system has been changed, so you are more likely to know where to look first.

  • Troubleshooting skills are important. Relying on Oracle Global Support to research and solve all your problems prevents you from being in full control of your system.

If you have a problem with your PCC system, ask yourself the following questions because Oracle Global Support will ask them:

  • What exactly is the problem? Can you isolate it?

    Oracle Global Support needs a clear and concise description of the problem, including when it began to occur.

  • What do the log files say?

    This is the first thing that Oracle Global Support asks for. Check the error log for the PCC component you are having problems with.

  • Has anything changed in the system? Did you install any new hardware or new software? Did the network change in any way? Does the problem resemble another one you had previously? Has your system usage recently jumped significantly?

  • Is the system otherwise operating normally? Has response time or the level of system resources changed? Are users complaining about additional or different problems?

Using Error Logs to Troubleshoot PCC

PCC error log files provide detailed information about system problems. If you are having a problem with PCC, look in the log files.

PCC records information about actions performed in the PCC GUI in Oracle WebLogic Server log files. See the Oracle WebLogic Server Administration Console Help for more information.

Diagnosing PCC Problems

PCC problems can be diagnosed using the Oracle WebLogic Server Diagnostic Framework, which enables you to collect, archive, and access diagnostic information about applications hosted on the WebLogic server. See the Oracle WebLogic Server Administration Console Help for more information.

This section lists some common PCC problems and describes how to diagnose the error messages and resolve the problems.

Refreshing the Browser

Do not refresh your browser.

Refreshing the browser causes unpredictable problems in PCC.

Unable to Perform Any Task after Logging In

After you log in to PCC, the links in the navigation pane are not displayed, and you cannot perform any task.

This means that you are not in the Config Admin WebLogic Server group. Contact your system administrator, and request to be added to that group.

Getting Help for PCC Problems

If you cannot resolve a PCC problem, contact Oracle Global Support.

Before you contact Oracle Global Support, try to resolve the problem with the information in the log files. See "Using Error Logs to Troubleshoot PCC" for more information. If this does not help resolve the problem, gather the following information:

  • A clear and concise description of the problem, including when it began to occur.

  • Relevant portions of the relevant log files.

  • Relevant configuration files.

  • Recent changes in your system after which the problem occurred, even if you do not think they are relevant.

  • A list of all PCC components and patches installed on your system.

When you are ready, report the problem to Oracle Global Support.

Secure Deployment Checklist

To deploy PCC securely, follow this checklist:

  1. Pre-installation steps:

    1. Enable SSL for the target Oracle WebLogic Server domain.

    2. Configure the server keystore certificate, and get the client keystore trusted certificate.

    3. Configure Oracle Database advanced security encryption and integrity algorithms for a secure connection from the installer.

    4. Verify that you have JDK 1.6.0_33 or later installed and configured with your PCC/WebLogic Server installation.

  2. Installation steps:

    1. Select SSL mode, and provide the client keystore certificate (.jks file) for connecting to a WebLogic server over SSL.

  3. Post-installation steps:

    1. If you do not need the installation log files, delete them.

    2. The WebLogic Server administrator must create PCC users based on the roles and privileges.

    3. Do not use your browser's remember password feature for the WebLogic Administration Console URL.

    4. Enable secure cookies.

    5. Verify that file permissions for the installed files are 600 for all nonexecutable files and 700 for all executable files.

  4. Un-installation steps:

    1. Delete the log files in the oraInventory/logs directory manually if you do not need them, or protect them appropriately if they are required for further installations.