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

E16706-11
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

10 Installing BRM Client and Server Applications on Windows

This chapter describes how to install Oracle Communications Billing and Revenue Management (BRM) applications on Windows.

Note:

The BRM server components (Connection Manager (CM), Data Manager (DM), and so on) do not run on Windows systems.

About BRM Client and Server Applications for Windows

The BRM system includes several client applications that provide graphical user interfaces to the data in the BRM database. You use BRM client applications to manage customers and payments and to configure your BRM system. See "About the BRM Client Applications" in BRM Concepts.

The BRM system also includes one server application, Self-Care Manager, that provides customer self-care services using Web browsers and wireless devices. Customers use Self-Care Manager to display and modify their account data. See "About Self-Care Manager" in BRM Managing Customers.

You can install BRM applications in any combination and in any order; however, you must first install BRM. See "BRM Installation Overview".

Required Disk Space for BRM Windows Applications

The following table lists the approximate disk space required to download, extract, and install each client application.

Note:

BRM client applications require the Java Runtime Environment (JRE). The JRE is included in each application package and is approximately 50 MB. Once the JRE is installed with a BRM application, it will not be reinstalled.

Table 10-1 Required Disk Space for Windows Applications

Application Type Required Disk Space

Brand Manager

Client application

100 MB

Business Configuration Center

Client application

100 MB

Collections Configuration

Client application

100 MB

Customer Center

Client application

125 MB

Customer Center SDK

Developer tool

54 MB

Developer Center

Developer tool

110 MB

Payment Tool*

Client application

140 MB

Permissioning Center

Client application

112 MB

Pricing Center

Client application

165 MB

Self-Care Manager

Server application

100 MB


* Payment Center is installed with Payment Tool. It is accessible only if you purchase the Payment Suspense Manager feature.

Installing BRM Client Applications on Windows

This section describes how to install and start all BRM client applications except Customer Center and Pricing Center.

To install Customer Center, see "Installing Customer Center on Windows".

To install Pricing Center, see "Installing Pricing Center on Windows".

Before Installing BRM Client Applications

To install the BRM client applications, you need the following:

  • An application such as WinZip for extracting compressed files.

  • The following information about the machine running the CM to which Customer Center, Payment Tool, Payment Center, and Pricing Center will connect:

    • Computer or server name

    • Port number

    • Database number

  • Windows users must have administrator privileges to install Customer Center, Payment Tool, or Pricing Center.

For information on localized versions of the client applications, see "Creating a Localized Version of BRM" in BRM Developer's Guide.

Downloading the Compressed Files

  1. Download the software to a temporary directory (temp_dir).

    Important:

    To install Payment Center, download and install the PaymentTool.zip file.
  2. Extract the files in the .zip file to a temporary directory.

Installing the Software

For information on installing Customer Center, see "Installing Customer Center on Windows".

For information on installing Pricing Center, see "Installing Pricing Center on Windows".

To install all other client applications:

  1. Follow the steps in "Downloading the Compressed Files".

  2. Go to the temporary directory where you extracted the client application download file.

  3. Double-click Setup.exe.

  4. On the Choose Destination Location screen, select the destination folder for the program and click Next.

  5. On the Connection Manager screen, enter the server, port, and database information and click Next.

    For a demonstration system, enter the server name (computer where you installed the CM) and accept the default values of 11960 and 0.0.0.1.

  6. On the Select Program Folder screen, accept the default program folder Portal or select a new one; click Next.

  7. On the Start Copying Files screen, click Next to start installing the application.

  8. On the Setup Complete screen, you can choose to restart the computer or wait until you have installed all the applications.

  9. Click Finish to complete the process.

Starting and Using a BRM Client Application

This procedure applies to any BRM client application, but there are additional ways to start Customer Center and Pricing Center. See "Starting Customer Center" and "Starting Pricing Center".

To start a client application:

  1. Choose the application from the Start - Programs - Portal menu or open the shortcut on your desktop if available.

    The Login dialog box appears.

  2. Enter your login name and password.

    For information on login names and passwords for client applications, see "Implementing System Security" in BRM System Administrator's Guide.

  3. To connect to a database other than the one specified during installation, click Connection Info and enter the host name and port number.

  4. Click OK.

For information on how to use a client application, see the Help for that application.

Installing Customer Center on Windows

To install Customer Center, see the following:

About Installing and Running Customer Center

You must install Customer Center on a system with a Web server. You then use the Web server and Java Web Start technology to distribute Customer Center to your CSRs.

To use Customer Center, CSRs download it from the Web server to their Windows client systems. When CSRs run Customer Center, they run their local versions that communicate directly with the BRM database.

Each time a CSR runs Customer Center, the application uses Java Web Start to check the Web server for updates and automatically download new versions.

Note:

You can install Customer Center on either a UNIX or Windows system, but Customer Center can be run only on a Windows system.

Before Installing Customer Center

  • Obtain the following information about the machine running the CM to which Customer Center will connect:

    • Computer or server name

    • Port number

    • Database number

  • Make sure you have Windows administrator privileges.

  • Install a third-party Web server.

  • Make sure each Customer Center client system has a Web browser.

    For a list of supported browsers, see "BRM Software Compatibility".

  • Optionally, you can install the Java Runtime Environment (JRE) 1.6.0_26 on each client system. If you do not do it in advance, JRE 1.6.0_26 will be installed as part of downloading Customer Center.

    See "Installing Java Web Start and Downloading Customer Center".

  • To display decimals to the desired precision, ensure that your regional settings are properly defined.

  • If you have not already downloaded and extracted the client application, follow the steps for "Downloading the Compressed Files".

Installing the Customer Center Files

Install Customer Center on the same system as your Web server.

  1. Go to the temporary directory where you unzipped the client application download file.

  2. Double-click Setup.exe.

  3. Enter a destination folder. You can enter your Web server's document root directory, such as C:\Program Files\Apache Group\Apache\htdocs on an Apache Web server.

    You can also enter a subdirectory of your Web server's document root directory or another directory that you map to your Web server.

  4. Enter the name and port number of the BRM server where the CM is running.

  5. Enter the database number for the DM (for example, 0.0.0.1).

  6. Enter the full URL to the location of Customer Center on your Web server. The default URL is http://machine_name where machine_name is the name of the system where you are installing Customer Center.

    Important:

    Your Web server must be mapped to the URL you specify.

    Specify the URL as follows:

    • If you are installing Customer Center in your Web server's document root directory, or a directory mapped to your Web server's document root directory, use the default URL.

    • If you are installing Customer Center in a subdirectory of your Web server's document root, add the subdirectory names to the default URL. But do not change the top-level URL.

      For example, if your default URL is http://server1, and you install Customer Center in the applications subdirectory of your document root, your URL should be http://server1/applications.

    • If you are installing Customer Center in a directory outside your Web server directory, map that installation directory to a subdirectory of your document root. Then add the name of the subdirectory of the document root to the default URL.

      For example, you can install Customer Center in C:\Program Files\Portal Software\CustomerCenter, and then map that directory to the applications subdirectory of the Web server document root. If your default URL is http://server1, your URL should be http://server1/applications.

    • If your Web server uses a port number other than 80, add the port number to the URL as follows: URL:port_number.

      For example, if your Customer Center URL is http://server1 and your port number is 81, your URL should be http://server1:81.

    See your Web server documentation for information on the document root directory and mapping other directories to your URL.

    Note:

    To access Customer Center, add the file name CustomerCenter_en.html to the URL you specify here. Do not add the file name on this screen.
  7. For Apache and iPlanet Web servers, open your Web server's MIME types file to add an entry for JNLP, a special file type associated with Java Web Start. For IIS Web servers, you do not need to do this.

    Add a MIME type as follows:

    • For an Apache Web server, add the following entry to the mime.types file:

      application/x-java-jnlp-file  JNLP
        
      
    • For an iPlanet Web server, add the following entry to the mime.types file:

      type=application/x-java-jnlp-file  exts=JNLP 
        
      

      You can also use the iPlanet Server Manager to add a MIME type.

    For more information, see your Web server documentation.

  8. For iPlanet Web servers only, edit the mime.types file for your Web server to enable downloading of .exe files. This is necessary so that client systems can download the Java Web Start installation file from the Web server.

    Change the .exe file extension's MIME type association as follows:

    • Remove exe, and the comma before it, from this line:

      type=magnus-internal/cgi  exts=cgi,bat,exe 
        
      
    • Add exe, preceded by a comma, to the end of this line:

      type=application/octet-stream  exts=bin,exe 
        
      

    You can also make this change with the iPlanet Server Manager. See the iPlanet documentation.

  9. Stop and restart your Web server.

Setting the Heap Size for Java Web Start

To set the heap size for Java Web Start implementations:

  1. Open your CustomerCenter_locale.jnlp file.

  2. Change the j2se element to set the initial and maximum heap size.

    The default entry looks like this:

    <j2se version="1.4*"/> 
      
    

    For example, this entry changes the initial heap size to 128 megabytes and the maximum heap size to 256 megabytes:

    <j2se version="1.4*" initial-heap-size="128m" max-heap-size="256m"/>
    

    Note:

    The heap sizes specified in the JNLP file is used for all associated Customer Center clients.
  3. Stop and restart Customer Center to make the change take effect.

Installing Java Web Start and Downloading Customer Center

The first time you start Customer Center on a client system, you download and install Java Web Start.

Note:

With Internet Explorer, you have the option of installing directly from the server without downloading the file.
  1. Go to this URL in your Web browser:

    http://machine_name/CustomerCenter_en.html

    Replace machine_name with the name of the system running the Web browser and Customer Center. If Customer Center is located in a subdirectory of your Web browser's document root directory, include the full path to CustomerCenter_en.html.

    If your Web server uses a port number other than the default of 80, include the port number in the URL:

    http://machine_name:port_number/CustomerCenter_en.html

    For example, if Customer Center is on a system called server1 using port 81, go to this URL: http://server1:81/CustomerCenter_en.html.

    The browser begins downloading the Java Web Start installation file, javawebstart-install.exe.

    Note:

    • If your Web server uses default port 80, specifying the port number is optional. Otherwise, you must include the port number.

    • If your Web server does not display the page correctly or does not start downloading the Java Web Start installation file, make sure you set the JNLP MIME type in your Web server. See Installing the Customer Center Files.

    • If the MIME type is set in your Web server, try clearing the cache in your Web browser. For Internet Explorer, delete temporary Internet files. For Netscape, clear the memory cache and the disk cache.

  2. Choose the directory to save the installation file, then save the file.

  3. Go to the temporary directory where you saved the Java Web Start installation file.

  4. Double-click javawebstart-install.exe and follow the prompts in the installer.

    Note:

    • If you do not have JRE 1.6.0.26 installed, Java Web Start installs it.

    • If you are using a Netscape browser, Java Web Start prompts you to restart your browser at the end of the installation.

    • Java Web Start might prompt you to restart your system.

  5. (For Netscape 6 only) In Netscape, choose Edit - Preferences - Navigator - Helper Applications and create a new MIME type using the values in Table 10-2:

    Table 10-2 Netscape MIME Values

    Parameter Value

    File Extension

    jnlp

    MIME Type

    application/x-java-jnlp-file

    Application to Use

    javaws.exe, located in your Java Web Start installation directory, such as C:\Program Files\Java Web Start


  6. Stop and restart Netscape.

  7. In your Web browser, return to the Customer Center URL (http://machine_name:port_number/CustomerCenter_en.html) and click the link for running Customer Center.

    Java Web Start launches and copies the Customer Center files from the Web server.

  8. In the Security dialog box that asks whether you want to install and run Customer Center, click Start.

For more information on using Java Web Start, see the Java Web Start documentation at java.sun.com.

Starting Customer Center

After installing Java Web Start and running Customer Center for the first time, you can start Customer Center in any of these ways:

Using any of these methods, if there's a newer version of the Customer Center files on the Web server, Java Web Start installs them on your system.

Starting Customer Center from Java Web Start

To start Customer Center from the Java Web Start Application Manager:

  1. Start Java Web Start from the desktop icon or the Start menu.

  2. If you do not see Customer Center listed in the Application Manager, choose View - Downloaded Applications.

  3. Select Customer Center and click Start.

Starting Customer Center from a Shortcut

To create a shortcut and use it to start Customer Center:

  1. Open the Desktop Integration window in one of these ways:

    • The second time you start Customer Center, Java Web Start asks whether you want to create shortcuts to Customer Center on your desktop and your Start menu.

    • Start Java Web Start; in the Application Manager, select Customer Center and choose Application - Create Shortcuts.

  2. Select one or both of these options:

    • Shortcut on Desktop

    • Shortcut in Start Menu

  3. Click Yes.

  4. Start Customer Center from the desktop icon or the Start menu.

Starting Customer Center from Your Browser

To start Customer Center from your browser, go to the URL http://machine_name:port_number/CustomerCenter_en.html.

This URL automatically starts Java Web Start, which in turn starts Customer Center.

Uninstalling Customer Center from a Client System

To remove a version of Customer Center that has been downloaded to a client system:

  1. Start Java Web Start from the desktop icon or the Start menu.

  2. If you do not see Customer Center listed in the Application Manager, choose View - Downloaded Applications.

  3. Select Customer Center.

  4. Choose Application - Remove Application.

Installing GSM Manager Customer Center Extension on Windows

For more information about the GSM Manager components, see "About the GSM Manager Components" in BRM Telco Integration.

GSM Manager Customer Center Extension enables support for assigning SIM cards and telephone numbers in Customer Center. See the discussion about setting up GSM services in Customer Center Help.

Important:

You must install the GSM Manager Customer Center Extension on a system that already has Customer Center installed. See "Installing Customer Center on Windows".

To install GSM Manager Customer Center Extension:

  1. Download the software to a temporary directory (temp_dir).

  2. Extract the downloaded .zip file to a temporary directory (temp_dir).

  3. Go to temp_dir and run the setup.exe program. The installation wizard for GSM Manager Customer Center Extension starts.

  4. Answer the prompts in the installation wizard screens.

Your GSM Manager Customer Center Extension installation is now complete.

Installing Pricing Center on Windows

To install Pricing Center, see the following sections:

About Installing and Running Pricing Center

Pricing Center can be installed as a standalone application or on a system with a Web server.

  • If you will use Pricing Center as a standalone application on a single system, install the standalone version.

  • If you are installing with a Web server, you use the Web server and Java Web Start technology to distribute Pricing Center to your CSRs.

To use Pricing Center, CSRs download it from the Web server to their Windows client systems. When CSRs run Pricing Center, they run their local versions that communicate directly with the BRM database.

Each time CSRs run Pricing Center, the application uses Java Web Start to check the Web server for updates and to automatically download any new versions it finds.

Note:

When you install Pricing Center, you also automatically install the Resource Editor and the Zone Mapper.

Before Installing Pricing Center

  • Obtain the following information about the machine running the CM to which Pricing Center will connect:

    • Computer or server name

    • Port number

    • Database number

  • Make sure you have Windows administrator privileges.

  • Install a third-party Web server.

  • Make sure each Pricing Center client system has a Web browser.

    For a list of supported browsers, see "BRM Software Compatibility".

  • Optionally, you can install JRE 1.6.0_26 on each client system. If you do not do it in advance, JRE 1.6.0_26 will be installed as part of downloading Pricing Center.

    See "Installing Java Web Start and Downloading Pricing Center".

Installing the Pricing Center Files

Important:

Install Pricing Center on the same system as your Web server.
  1. Follow the steps for "Downloading the Compressed Files".

  2. Go to the temporary directory where you unzipped the client application download file.

  3. Double-click Setup.exe.

  4. When the Welcome screen appears, click Next.

    The Choose Destination Location window opens.

  5. Enter the directory path where you want the Pricing Center files to be installed.

    By default, Pricing Center is installed into the directory C:\Program Files\Portal Software\PricingCenter. Click Next to choose the default directory, or use the Browse button to choose a different directory and then click Next.

    The Install Type window opens.

  6. On the Install Type window, choose one of the following:

    • Standalone install

      If you will use Pricing Center as a standalone application on a single system, select Standalone install and click Next.

      The Install Sample Price Plans window opens.

      Sample price plans are selected by default. To install them, click Next. To skip installing sample price plans, clear the check box, then click Next.

      The Enable Pipeline Rating Feature window opens. Skip to the next step.

    • Web server install

      If you are installing Pricing Center on a central server, select Web server install and click Next.

      The Enter the Web Server Name window opens.

      Specify the URL as follows:

      If you are installing in your Web server's document root directory or in a directory mapped to your Web server's document root directory: Use the default URL.

      If you are installing in a subdirectory of your Web server's document root: Add the subdirectory names to the default URL. But do not change the top-level URL.

      If you are installing in a directory outside your Web server directory: Map that installation directory to a subdirectory of your document root. Then add the name of the subdirectory of the document root to the default URL.

      Enter the URL where you want Pricing Center installed and click Next.

      The Enable Pipeline Rating Feature window opens.

  7. The Enable pipeline rating feature check box is selected by default.

    • If you rate events using Pipeline Manager, accept the default selection and click Next.

    • If you do not rate events using Pipeline Manager, clear this option and click Next.

    The Enable Data Migration Functionality window opens.

  8. You use the Pipeline Manager data migration feature to move pipeline pricing data from a development system to a production system. For more information on data migration, see Pricing Center Help.

    Choose how you want data migration to be handled using the values in Table 10-3:

    Table 10-3 Data Migration Configuration Values

    Value Description

    Turn OFF Data Migration

    Turns off the data migration feature. This is the default.

    Import Only

    Gives you the ability to import change set files without enabling the full set of data migration features. This option is useful for production systems where you want to reduce the risk of accidental data changes.

    Turn ON Data Migration

    Turns on the full set of data migration features so you can manage, import, and export pipeline pricing data.


    Click Next.

    The Select Program Folder window opens.

  9. Specify the folder where you want Pricing Center to add program icons and click Next.

    The Start Copying Files window opens.

    By default, Pricing Center is installed in C:\Program Files\Portal Software\PricingCenter.

  10. Click Next.

    The Pricing Center files are copied to the directory you specified.

    When the files have been copied, the Setup Complete window appears.

  11. Click Finish to complete the setup process.

Installing Java Web Start and Downloading Pricing Center

Important:

If you installed Pricing Center as a standalone product, skip this section and go to "Granting Administrative Privileges to Pricing Center Users".

If you installed the Web Server version of Pricing Center, follow the instructions in this section.

The first time you start Pricing Center on a client system, you download and install Java Web Start.

  1. Go to this URL in your Web browser:

    http://machine_name/PricingCenter_en.html

    Replace machine_name with the name of the system running the Web browser and Pricing Center. If Pricing Center is located in a subdirectory of your Web browser's document root directory, include the full path to PricingCenter_en.html.

    If your Web server uses a port number other than the default of 80, include the port number in the URL:

    http://machine_name:port_number/PricingCenter_en.html

    For example, if Pricing Center is on a system called server1 using port 81, go to this URL: http://server1:81/PricingCenter_en.html.

    The browser begins downloading the Java Web Start installation file, javawebstart-install.exe. On Internet Explorer, you have the option of installing directly from the server without downloading the file.

    Note:

    • If your Web server uses default port 80, specifying the port number is optional. Otherwise, you must include the port number.

    • If your Web server does not display the page correctly or does not start downloading the Java Web Start installation file, make sure you set the JNLP MIME type in your Web server.

    • If the MIME type is set in your Web server, try clearing the cache in your Web browser. For Internet Explorer, delete temporary Internet files. For Netscape, clear the memory cache and the disk cache.

  2. Specify the directory where you want the installation file saved, then save the file.

  3. Go to the temporary directory where you saved the Java Web Start installation file.

  4. Double-click javawebstart-install.exe and follow the prompts in the installer.

    Note:

    • If you do not have JRE 1.6.0_26 installed, Java Web Start installs it.

    • If you are using a Netscape browser, Java Web Start prompts you to restart your browser at the end of the installation.

    • Java Web Start might prompt you to restart your system.

  5. (For Netscape 6 only) In Netscape, choose Edit - Preferences - Navigator - Helper Applications and create a new MIME type as described in Table 10-4.

    Table 10-4 Netscape MIME Values

    Parameter Value

    File Extension

    jnlp

    MIME Type

    application/x-java-jnlp-file

    Application to Use

    javaws.exe, located in your Java Web Start installation directory, such as C:\Program Files\Java Web Start


  6. Stop and restart Netscape.

  7. In your Web browser, return to the Pricing Center URL (http://machine_name:port_number/PricingCenter_en.html) and click the link for running Pricing Center.

    Java Web Start launches and copies the Pricing Center files from the Web server.

  8. In the Security dialog box that asks whether you want to install and run Pricing Center, click Start.

For more information on using Java Web Start, see the Java Web Start documentation at java.sun.com.

Granting Administrative Privileges to Pricing Center Users

You use the pricing_admin.pl script to grant administrative privileges to Pricing Center users. Users with administrative privileges are called pricing admins.

To grant administrative privileges to Pricing Center users, perform the procedures in the following sections:

  1. Modifying the Database Configuration File

  2. Modifying the pricing_admin.pl Script Configuration File

  3. Setting Up the Database Server for the Pipeline Manager Administrator

  4. Configuring Pricing Center for Branding

  5. Initializing the Pricing Admin Configuration Object

  6. Specifying Administrative Privileges for Pipeline Manager Users

  7. Removing Pricing Admins

Modifying the Database Configuration File

  1. Go to the DM directory:

    cd BRM_Home/sys/dm_oracle
      
    
  2. Back up the database configuration file (pin.conf).

    Important:

    You will be restoring the pin.conf file later in the procedure.
  3. Open the pin.conf file with a text editor.

  4. If the dd_write_enable_objects entry is set to 0, set the entry to 1.

  5. If the crypt entry is commented out, uncomment it and configure it according to the notes that precede this entry:

    - crypt md5| BRM_Home/lib/libpin_crypt4dm.so "secret_key"
      
    

    For more information, see "About Encrypting Information" in BRM Developer's Guide.

  6. Save and close the file.

  7. Stop and restart the DM and CM. See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.

Modifying the pricing_admin.pl Script Configuration File

  1. Go to the BRM_Home\setup\scripts directory.

  2. Open the setup configuration file (pin.conf) file with a text editor.

  3. Check that the following entries are specified in the pin.conf file:

    - nap login_type 1
    - - userid 0.0.0.1 /service/admin_client 1
     
    Specify appropriate values for the login_name and login_pw parameters:
     
    - nap login_name login_name
    - nap login_pw password
     
    

    For example:

    - nap login_name integrate
    - nap login_pw integrate
      
    
  4. Enter the host name and port number of your server in the cm_ptr entry:

    - nap cm_ptr ip host_name port_number
      
    
  5. Specify values for the entries described in the following table. These entries specify Pipeline Manager configuration data used by the pricing_admin.pl script to set up and maintain pricing admins and the Pipeline Manager database for Pricing Center.

    Table 10-5 Pipeline Manager Configuration Data

    Entry Description

    default_table_space_name

    The tablespace that newly created Oracle users are assigned to. The default is INTEGRATE_TS_1_DAT.

    If the default tablespace is not available in the Pipeline Manager database, use an available existing tablespace or create a new one.

    Important: You must specify a value for default_table_space_name before you run the pricing_admin.pl script with the -set parameter.

    database_role_name

    The role that provides select, insert, delete, and update privileges on IFW_* and JSA_* tables. The default is INTEGRATE_ROLE_ALL.

    If the default role is not available in the Pipeline Manager database, use an existing role that provides these privileges or create a new role.

    If you use the -init parameter, the entry is optional.

    host

    The host name for the server where the Pipeline Manager database is located and running.

    port

    The port number used by the Pipeline Manager database listener.

    db

    The name of the Pipeline Manager database instance.

    Note: You must set the db value to the ORACLE_SID value. If you set the db value to the SERVICE_NAME value, BRM does not generate an error when creating the /config/pricing_admin object; however, you cannot connect to the Pipeline Manager database from Pricing Center.

    db_type

    The name of the database vendor. The value should be one of the system database driver groups of entries in the jsaconf.properties file, for example, oracle.

    login_name

    The default Pipeline Manager database user name.

    Important: You must specify a value for login_name before you run the pricing_admin.pl script with the -init parameter.

    login_pw

    The password of the default Pipeline Manager database user.

    Important: You must specify a value for login_pw before you run the pricing_admin.pl script with the -init parameter.

    admin

    The DBA on the Pipeline Manager database that has user creation privileges.

    admin_pw

    The password of the DBA account.

    db_alias

    The alias used to log in to the Pipeline Manager database.

    Important: Ensure that the tnsnames.ora file also contains an entry with this alias.


    Example 10-1 Sample pin.conf Entry Value

    - pipeline default_table_space_name    INTEGRATE_TS_1_DAT
    - pipeline database_role_name          INTEGRATE_ROLE_ALL
    - pipeline host                        ttal-013
    - pipeline port                        1521
    - pipeline db                          pindb
    - pipeline db_type                     oracle
    - pipeline login_name                  integrate
    - pipeline login_pw                    integrate
    - pipeline admin                       system
    - pipeline admin_pw                    manager
    - pipeline db_alias                    ttal
    

    Note:

    To ensure that Pricing Center can connect to the server, add the name and IP address of the Pipeline Manager host system to the host file of each machine running Pricing Center.
  6. Save and close the file.

Setting Up the Database Server for the Pipeline Manager Administrator

To set up an Oracle database server for the Pipeline Manager administrator:

  1. Edit the tnsnames.ora file to specify HOST, PORT, and SERVICE_NAME values. Use the same values that you used for the host, port, and db entries in the setup configuration file (BRM_Home\setup\scripts\pin.conf).

    The following is the required name entry in the tnsnames.ora file that corresponds to the sample pin.conf file shown in Step 5 of "Modifying the pricing_admin.pl Script Configuration File".

    Note:

    The DB alias in the following example is ttal-013, the port name is 1521, and the Pipeline Manager database name (SERVICE_NAME) is pindb. Be sure to change these values to match your environment.
    TTAL-013 =
     (DESCRIPTION =
      (ADDRESS_LIST =
       (ADDRESS = (PROTOCOL = TCP) (HOST = ttal_013) (PORT = 1521) )
      )
     (CONNECT_DATA =
      (SERVICE_NAME = pindb)
     )
    )
      
    
  2. To ensure that the pin.conf entries for admin, admin_pw, db_alias, and host are correct, try connecting to the Pipeline Manager database using the following command:

    sqlplus admin/admin_pw@db_alias
    

Configuring Pricing Center for Branding

If your system uses branding and you use pipeline pricing components:

  1. Open the pricing_admin.sce scenario file located in BRM_Home\setup\scripts.

  2. Change the PIN_FLD_READ_ACCESS value from Self to Global:

    PIN_FLD_READ_ACCESS              STR [0] "Global"
      
    
  3. Save and close the file.

Initializing the Pricing Admin Configuration Object

Initialize the pricing admin configuration object by running the pricing_admin.pl script:

  1. Go to the BRM_Home\setup\scripts directory.

  2. Run the pricing_admin.pl script with the -init parameter:

    perl pricing_admin.pl -init
      
    

    If initialization is successful, the system returns this line:

    Initialized config object for pricing admin.
      
    
  3. Restore the original database configuration file (pin.conf) that you backed up in "Modifying the Database Configuration File".

  4. Stop and restart the DM to apply the new settings. See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.

Specifying Administrative Privileges for Pipeline Manager Users

To specify administrative privileges for Pipeline Manager users:

  1. Ensure that every Pipeline Manager user who will be a pricing admin has a CSR account in BRM (an account using the admin_client service). You create CSR accounts in Customer Center by using the CSR Plan. See information about the Account Creation wizard's Contact page in Customer Center Help.

  2. Create a text file that has the user name and password (in that order) of each pricing admin on a separate line. User names and passwords must be separated by a space. For example:

    john_jones valhalla
    mary_allen dorado
    

    Important:

    BRM user names (login names) are case sensitive, but Pipeline Manager user names are not. Therefore, be sure to type the names exactly as specified in Customer Center, but avoid using names that are too similar. For example, do not create two accounts with the user names ”Smith” and ”smith” because they will both be logged in to the Pipeline Manager as ”SMITH.”
  3. Go to the BRM_Home\setup\scripts directory.

  4. Run the pricing_admin.pl script with the -set parameter:

    perl pricing_admin.pl -set < text_file
      
    

    where text_file is the name of the file you created in Step 2.

  5. Delete the text file if security is a concern.

Removing Pricing Admins

This section describes how to remove single and multiple users from the Pipeline Manager database.

Removing One Pricing Admin

To remove one pricing admin from the database:

  1. Go to the BRM_Home\setup\scripts directory.

  2. Run the pricing_admin.pl script with the -remove parameter:

    perl pricing_admin.pl -remove
      
    
  3. When prompted, enter the user name to be deleted.

    For each pricing admin removed, the system responds with this line:

    Removed pricing admin user_name
      
    
  4. Repeat Step 3 until all appropriate user names are removed.

Removing Multiple Pricing Admins

To remove multiple pricing admins from the database:

  1. Go to the BRM_Home\setup\scripts directory.

  2. Create a text file (text_file) containing only the user names that you want to remove. Put each user name on a separate line, as in this example:

    john_jones
      
    mary_allen
      
    
  3. Run the pricing_admin.pl script with the -remove and text_file parameters:

    perl pricing_admin.pl -remove < text_file
    

Starting Pricing Center

After installing the standalone version of Pricing Center, you can start it from the Windows Start menu.

See "Starting Standalone Pricing Center from the Start Menu".

After installing Java Web Start and running Pricing Center for the first time, you can start Pricing Center in the following ways:

Using any of these methods of starting the Web version, if there's a newer version of the Pricing Center files on the Web server, Java Web Start installs them on your system.

To start standalone Pricing Center, see "Starting Standalone Pricing Center from the Start Menu".

Starting Standalone Pricing Center from the Start Menu

To start the standalone version of Pricing Center:

  1. From the Start menu, choose Start - Programs - Portal - Pricing Center.

  2. Enter the root account password in the Login Application Center window.

Starting Pricing Center from Java Web Start

To start Pricing Center from the Java Web Start Application Manager:

Important:

To start Pricing Center from Java Web Start, ensure that your Web browser is using the latest version of JRE 1.6. You cannot start Pricing Center from Java Web Start in a Web browser using JRE 1.7.
  1. Start Java Web Start from the desktop icon or the Start menu.

  2. If you do not see Pricing Center listed in the Application Manager, choose View - Downloaded Applications.

  3. Select Pricing Center and click Start.

Starting Pricing Center from a Shortcut

To create a shortcut and use it to start Pricing Center:

  1. Open the Desktop Integration window in one of these ways:

    • The second time you start Pricing Center, Java Web Start asks whether you want to create shortcuts to Pricing Center on your desktop and your Start menu.

    • Start Java Web Start; in the Application Manager, select Pricing Center and choose Application - Create Shortcuts.

  2. Select one or both of these options:

    • Shortcut on Desktop

    • Shortcut in Start Menu

  3. Click Yes.

  4. Start Pricing Center from the desktop icon or the Start menu.

Starting Pricing Center from Your Browser

To start Pricing Center from your browser, go to the URL http://machine_name:port_number/PricingCenter_en.html.

This URL automatically starts Java Web Start, which in turn starts Pricing Center.

Uninstalling Pricing Center from a Client System

To remove a version of Pricing Center that has been downloaded to a client system:

  1. Start Java Web Start from the desktop icon or the Start menu.

  2. If you do not see Pricing Center listed in the Application Manager, choose View - Downloaded Applications.

  3. Select Pricing Center.

  4. Choose Application - Remove Application.

Uninstalling Pricing Center from Windows

To remove a standalone version of Pricing Center from Windows:

  1. From the Windows Start menu, choose Settings - Control Panel - Add or Remove Programs.

  2. Select Pricing Center 7.5.

  3. Click Change/Remove.

  4. Click OK.

Installing Customer Center SDK on Windows

This section describes the requirements and the procedure for installing Customer Center SDK on Windows.

Customer Center SDK package includes components that are used to customize both Customer Center and Self-Care Manager. Follow these instructions for installing the common SDK package.

To customize Customer Center, see "Customizing the Customer Center Interface" in BRM Developer's Guide.

To customize Self-Care Manager, see "Customizing the Self-Care Manager Interface" in BRM Developer's Guide.

Important:

Before installing Customer Center SDK, verify that JDK 1.6.0_26 is installed in your development environment. You must also have access to a BRM server.

For information about Customer Center SDK, see "Using Customer Center SDK" in BRM Developer's Guide.

Software Requirements

Customer Center SDK is available for the Windows operating system.

You must have the following software installed on or available to your system before you install Customer Center SDK:

  • BRM.

    See "BRM Installation Overview".

  • A Web server such as Apache HTTP Server, IPlanet Web Server, or Microsoft Internet Information Server (IIS) with the Customer Center client software installed.

    To install Customer Center, see "Installing Customer Center on Windows".

  • An application such as WinZip for extracting compressed files.

  • The JDK supported for this release.

    See "BRM Software Compatibility".

  • (Customer Center only) A Java Code Signing Certificate. Customer Center SDK includes a makecertificate utility for creating a self-signed certificate that you use to create jar files to deploy your customizations.

  • (Optional) Borland JBuilder 5 or later, Professional or Enterprise Edition. You can use JBuilder for various tasks such as creating WAR files for Self-Care Manager and custom pages for Customer Center.

Information Requirements

Before installing Customer Center SDK, have the following information available:

  • The destination folder for your Customer Center SDK installation. The default folder is C:\Program Files\Portal Software\CustomerCareSDK

  • The name of the server where the CM is running.

  • The port number where the CM is running.

  • The database number for the Oracle DM.

  • The URL for the Web server from which Customer Center is deployed. This is the directory where Customer Center is installed. For example, http://server1.

Installing Customer Center SDK

To install Customer Center SDK, verify that you have Administrator privileges, and then follow these steps:

  1. Download the Customer Center SDK software.

  2. Unzip the compressed Customer Center SDK files you downloaded.

  3. Click Setup.exe to start the installation.

    The installation program extracts files to a temporary directory on your computer.

  4. Follow the instructions on the screen, providing the following information when prompted, or click Next to accept the default entries:

    • Destination folder for the installed software.

    • CM's server name, port, and database number.

    • Customer Center Web Start deployment URL, if available. Use the URL where you will deploy your customizations.

    • Program folder for the Start menu.

  5. When the Setup Complete dialog box appears, click Finish to complete the installation.

    Note:

    You can delete the temporary extraction directory created by the installation program if it is not automatically deleted when you exit your unzip application.
  6. If you installed GSM Customer Center Extension on a Customer Center installation, copy the following files from the Customer Center library directory (CC_path\lib) to the library directory of the version of Customer Center included in Customer Center SDK (CCSDK_Path\lib):

    • GSMManager.jar

    • GSMManager_en.jar

    • Modular.properties

    where:

    CC_path is the path to your Customer Center installation (by default C:\Program Files\Portal Software\CustomerCenter) and CCSDK_Path is the CC SDK installation path (by default C:\Program Files\Portal Software\CustomerCareSDK).

    GSM Customer Center Extension enables additional features, such as support for associating SIM and number devices with GSM services. See the information about working with GSM accounts in Customer Center Help.

Installing the Localization SDK on Windows

To extract the SDK files, you need a zip file utility, such as WinZip.

  1. If you have installed an earlier version of the SDK, uninstall it.

  2. Extract the files in the zip file to a temporary directory.

  3. Install the files.

  4. In a command window, use the subst command to substitute the drive letter for the build tree directory of the SDK. If you installed the SDK in the default location, enter the command as follows:

    subst W: "C:\Program Files\Portal Software\Localization SDK" 
      
    
  5. To prepare the MFC files, verify that the Visual C++ files are in the path:

    C:\Program Files\Microsoft Visual Studio .NET 2003\Vc7\bin\vcvars32.bat 
      
    

    The MFC files are ready to be translated. After translation, see "Building Payment Tool" in BRM Developer's Guide.

Installing Self-Care Manager on Windows

To use Self-Care Manager, you must install a third-party Web server, an application server, and Self-Care Manager itself. Perform the following procedures:

Installing an Application Server

Supported application servers include WebLogic and WebSphere. For more information, see the vendor installation instructions for the application server you are using.

Installing the Self-Care Manager Files

Before installing Self-Care Manager, make sure your application server servlet engine is installed. See "Installing an Application Server".

To install the Self-Care Manager files:

  1. Follow the steps for "Downloading the Compressed Files".

  2. See "Installing the Software" for information about the dialog boxes that appear when you install Self-Care Manager.

    Note:

    You can install Self-Care Manager in any location, including the default, C:\Program Files\Portal Software\WebKit. When you configure your application server, it extracts the Self-Care Manager files to a location within your application server installation. The default location is C:\Program Files\application_server\servers\default\WebKit.
  3. Configure your application server to work with Self-Care Manager. For details, see "Configuring the Application Server" in BRM Managing Customers.

Problems Installing BRM Client Applications

This section describes problems you might encounter when installing BRM client applications and their solutions.

Problem: Cannot Start a Client Application after Installation

You cannot start one of the client applications, even though the installation appeared to be successful.

Possible Cause

BRM could not add the client application to your Windows path because the path is too long. Therefore, Windows cannot find it.

Solution

Review your path statement and delete references to obsolete programs. For more information, see your Windows documentation. Reboot the system before you try restarting the client application.