6 Post Installation Tasks

This chapter describes the tasks you may have to complete after installing Oracle Communications Marketing and Advertising and configuring the Oracle WebLogic Server domain.

You may not need to perform all of the following tasks depending on the type of Marketing and Advertising installation.

Creating JMS Servers for Any Additional Core Servers

If you have added any core servers to the initial two provided by the domain template, you must edit the configuration to add support for the EDR Service. Each server in the core requires its own JMS server for the EDR Service to work correctly.

Before you do this, start the administrative server in your Marketing and Advertising installation so that you can use the administration console to make the necessary adjustments.

For more information on using the console, please see the System Administrator's Guide, a separate document in this set.

Logging into the Servers

To start and log in to the servers:

1. Start Marketing and Advertising on the Administrative Server.

2. In a command prompt window, change to the domain\bin directory.

3. Run the startWebLogic script.

   The administrative server loads.

4. Watch the command prompt window as the server loads. Wait until the prompt indicates that the server is in the RUNNING state.

5. Start a Core server.

6. Do one of the following:

   1. Change to the domain/bin directory on the administrative server.

   2. Enter the following:

      startManagedWebLogic CoreServer1 Admin_Server_URL

   or

   1. Log in to the core server. that you started.

   2. Change to the domain\bin directory.

   3. Enter the following:

      startManagedWebLogic

7. Watch the command prompt window as the core server loads. Wait until the prompt indicates that the server is in the RUNNING state.

8. When both servers are in the RUNNING state, start the administration console.

9. In your browser, enter the following address:

   http://hostname:port/console

   where hostname is the hostname of the administrative server and port is the listen address assigned to it during domain configuration. The default port is 8001.

10. Log in using your login credentials.

    If this is the first time you have logged in, you should use the values you set up in the domain configuration stage. There are instructions in the System Administrator's Guide on changing these values once your system is fully configured.

Creating a JMS Server

To create a JMS server from the administration console:

1. Open the Domain Structure panel.

2. Select Services > Messaging > JMS Servers > New.

3. In the Name text box, enter the name of the new JMS server.

4. Click Next

5. In the Target menu, select the appropriate server.

6. Click Finish.

7. Click Activate Changes.

Installing Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files

Marketing and Advertising does not require the JCE files, but you can install them if you wish to use JCE providers. For more information, see the section about the nCipher JCE Provider in Oracle WebLogic Server Securing WebLogic Server at:

http://download.oracle.com/docs/cd/E12840_01/wls/docs103/secmanage

Deploying Administrative Web Services

Marketing and Advertising has a set of administrative Web services that can be used to automate some of the tasks normally performed through the Web application's graphical interface. The ear file in which these Web services are found, ocma-ws-ear.ear, is not deployed by default in any installation except for those using the basic colocated domain template.

If you wish to use the administration Web Services in other environments, you need to manually deploy this ear on the Web tier. The ear file can be found in <MIDDLEWARE_HOME>\ocma_5.1\applications.

There are many ways to deploy applications in Oracle WebLogic Server. For more information, see Deploying Applications to WebLogic Server at:

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

Setting Up Embedded LDAP Replication

If you have configured a clustered or basic HA domain, you must set up the embedded LDAP server to propagate organization and user information to all servers properly. If you do not set up replication, setting and resetting passwords will not work properly.

To set up LDAP replication from the administration console:

1. At the top of the Domain Structure panel, click the domain name for the domain that you are configuring.

   The Settings for domain_name page opens on the right.

2. Click the Security tab.

3. Click the Embedded LDAP sub-tab.

4. Check these checkboxes if they are not checked:

   • Refresh Replica At Startup

   • Master First

5. Click Save.

6. After the Messages at the top of the screen indicate success, restart the cluster.

Configuring Load Balancers to Support Persistence of Session State

In a clustered or basic HA domain, it is assumed that load balancers will be used to distribute requests across the cluster. To avoid session time-out issues, these load balancers should be configured to support persistence of session state. Consult your load balancer documentation for instructions on how to do this.

Checking the System Locale Parameter

Marketing and Advertising uses the system locale parameter to set the language for some features. Make sure this parameter is set on your system. If "LANG =" is set to null or to "C", the system will not start up. There are a number of different ways to do this, depending on your operating system. For example, using Solaris, you can add the following line to the setDomainEnv.sh script found in the Domain_Home/bin directory:

LANG="en_US.UTF-8"export LANG

Setting the WebLogic Locale Parameter for Currency

Marketing and Advertising uses the WebLogic locale parameter to set the display format for some system wide entities such as system currency. To set the locale value in the WebLogic Administration Console:

1. In the left pane of the Console, click OCMA.

2. Select the General tab.

3. In the Locale menu select the correct country.

4. Click Save.

Configuring WebLogic Cluster Front End Host Settings

Each Marketing and Advertising server in a clustered configuration must be configured to support high availability of Web services individually. Configure the WebLogic Frontend Host and Frontend HTTP/HTTPS Port for each node to ensure that Marketing and Advertising HTTP requests are properly directed to the correct node and Web service.

Configure the Frontend values in the WebLogic Administration Console using the following procedure:

1. If the Change Center is enabled in WebLogic Administration console click the Lock and Edit button.

2. In the left pane of the Console, expand Environment.

3. Select Servers.

4. On the Summary of Servers page, select the server instance you want to configure.

5. Select the Protocols tab.

6. Select the HTTP tab.

7. In the Frontend Host field provide the IP address of the server.

8. In the Frontend HTTP/HTTPS field provide the port number for Web requests.

9. Click Save.

10. Click Activate Changes in the Change Center if needed.

Configuring Oracle Communications Marketing and Advertising

After you have installed the Marketing and Advertising, configured the domain, and completed any necessary post-installation steps, you can proceed to configuring Marketing and Advertising itself. The details for performing these tasks are presented in the System Administrator's Guide. The following list gives you a general outline of the initial tasks you must perform:

• Configure certain aspects of WebLogic Server using the Administration Console

• Configure Marketing and Advertising using the Administration Console

• Configure the delivery mechanism to communicate with the network using the Administration Console.

• Use the system owner organization or related Web services to provision organizations and users for all other organization types