Resources

Feedback

BEA WebLogic Server 8.1

Installing the BEA WebLogic Server and Deploying Web Applications Using SAS 9.1.3

This document explains how to install and configure the version of the BEA WebLogic Server that is available for download from the BEA web site. You can use this J2EE application server to run such SAS web applications as SAS Web Report Studio and SAS Information Delivery Portal.

Note: These installation instructions do not apply to the OEM version of WebLogic that SAS ships with the SAS Solutions.

If you are an experienced WebLogic administrator, there is not much special information that you will need. You simply install the correct version of the BEA WebLogic Platform--you can determine the correct version by visiting the SAS Third Party Software Downloads page--and configure a managed server in which the SAS web applications can run. To avoid having to edit advanced properties in the SAS Configuration Wizard, you should use the following names and port numbers when you configure the WebLogic server:

You should also read over the information in this document concerning the configuration of your managed server and the the steps you must perform after installing your SAS web applications.

If you are new to the BEA WebLogic Server, you can use the instructions in this document to install and configure WebLogic for use with the SAS web applications and to deploy the SAS web applications to the server. The document discusses the following tasks:

Note: This documentation is not meant to replace the BEA documentation. It is intended for users who want to quickly configure the BEA WebLogic Server in a way that will facilitate the deployment of the SAS Intelligence Platform.

Acquiring the Server and Security Patches

To acquire the server:

  1. Determine the version of BEA WebLogic Server required and patches needed. To do this, go to the SAS Third Party Software Downloads page. Click the Web Application Servers link for the version of the SAS Intelligence Platform that you are installing. This will take you to the Application Servers table. This table lists supported Operating Systems and WebLogic Server versions. The Notes column contains information about required patches, if any.
  2. Contact BEA to acquire the relevant version of BEA WebLogic Server and patches.

    3. Note: If downloading the installer, the WebLogic Server Package Installer is recommended over the WebLogic Server Net Installer.

Installing the Server (Windows)

To install the server:

  1. Run the executable that you downloaded: server812_win32.exe. The BEA installation program will load, and you will see a Welcome screen.
  2. In the Welcome screen, click Next.
  3. In the BEA License Agreement screen, select the Yes radio button and click Next.
  4. In the Choose BEA Home Directory screen, select the Create a new BEA Home radio button, leave the default value in the BEA Home Directory text box, and click Next.
  5. In the Choose Install Type screen, select the Custom radio button and click Next.
  6. In the Choose Components screen, uncheck the WebLogic Workshop check box (leaving the WebLogic Server box checked), and click Next.
  7. In the Choose Product Directory screen, leave the default value in the Product Installation Directory text box, and click Next.
  8. Windows only: In the Install Windows Services screen, select the Yes radio button, and click Next. At this point, the WebLogic files will be copied to your disk. When the copy is complete, the Installation Complete screen will appear.
  9. In the Installation Complete screen, uncheck the Install XML Spy check box, uncheck the Run Quickstart check box, and click Done.

Applying Required Patches

When you downloaded the BEA WebLogic Platform, you should also have downloaded any required patches. Some of these patches come with installation instructions. For those patches, follow the installation instructions. For the other patches, which are delivered as JAR files, you "apply" the patches by adding the JAR files to your managed server's CLASSPATH. You will add these files to the CLASSPATH later, when you configure the managed server.

Configuring the Server

To configure your server:

  1. Start the BEA WebLogic Configuration Wizard by executing the script config.extension. This script is located in BEA-install-dir\weblogic81\common\bin.
  2. In the wizard's Create or Extend a Configuration screen, select the Create a new WebLogic configuration radio button, and click Next.
  3. In the Select a Configuration Template screen, leave the default value (Basic WebLogic Server Domain) selected, and click Next.
  4. In the Choose Express or Custom Configuration screen, select the Custom radio button, and click Next.
  5. In the Configure the Administration Server screen, set the Name to myadminserver, set the Listen port to 7501, and click Next.
  6. In the Managed Servers, Clusters, and Machine Options screen, select the Yes radio button, and click Next.
  7. In the Configure Managed Servers screen, click the Add button. Then, set Name to myserver, set Listen port to 7001, and click Next.
  8. In the Configure Clusters screen, click Next.
  9. In the Configure Machines screen, click the Add button. Then set the Name to new_machine_1, and click Next.
  10. In the Assign Servers to Machines screen, move the myadminserver and myserver icons from the Server list to the Machine list. Then click Next.
  11. In the Database (JDBC) Options screen, click Next.
  12. In the Messaging (JMS) Options screen, click Next.
  13. In the Configure Administrative Username and Password screen, enter a user ID in the User name text field and a password in the User password and Confirm user password text fields. Leave the No radio button selected, and click Next.
  14. Windows only: In the Configure Windows Options screen, select both Yes radio buttons, and click Next.
  15. Windows only: In the Build Start Menu Entries screen, set the text fields as shown in the table below:
    • Shortcut link name - Start SAS Managed Server
    • Program - startManagedWebLogic.cmd
    • Argument - myserver http://localhost:7501/
    • Working directory -
    • Description - Link to start myserver outside of Node Manager
    Then, click Next.
  16. On the Configure Server Start Mode and Java SDK screen:
    1. Select the Production Mode radio button.
    2. Select the Other Java SDK radio button, and then use the Browse button to navigate to the J2SDK that you installed for use with the SAS Intelligence Platform.
    3. Click Next.
  17. In the Create WebLogic Configuration screen, enter the name mydomain in the Configuration Name text box, and click Next.
  18. In the Creating Configuration screen, uncheck the Start Admin Server check box; then, click Done. You will exit the BEA WebLogic Configuration Wizard.
  19. Set the common environment variables for WebLogic by editing the file commEnv.extension in BEA-install-dir\weblogic81\common\bin. Set JAVA_HOME to point to the installation directory for the Java 2 SDK that you installed for use with the SAS Intelligence Platform. Then save the file.
  20. Start the administration server and the Node Manager services. You can start these services from the Services window in the Control Panel (Start > Settings > Control Panel > Administrative Tools > Services). Right-click the icon for each service, and select Start from the pop-up menu.
  21. With the administration server and the Node Manager running, you can start the WebLogic Server Console in order to configure your managed server. Start the console by opening a web browser and browsing to http://localhost:7501/console.
  22. Log on to the console using the administrator user ID and password that you specified while running the BEA WebLogic Configuration Wizard.
  23. To configure the managed server, go to the server's Configuration: Remote Start properties page, and set the properties listed below. To get to this page, expand the Server folder in the tree structure on the left, and select myserver. On the right side of the interface, select the Configuration tab (if it is not already selected); then, select the Remote Start subtab. Set the following properties:
    • Java Home: Directory where you installed the version of the Java 2 SDK required by the SAS Intelligence Platform, for example, C:\j2sdk1.4.2_04.
    • BEA Home: Directory where you installed WebLogic, for instance, C:\bea.
    • Class Path: Prepend the following JAR files to your current CLASSPATH:
      • The JAR files for any patches that you have not already installed.
      • C:\j2sdk1.4.2_04\lib\tools.jar
      • C:\bea\weblogic81\server\lib\weblogic_sp.jar
        Note: Depending on which WebLogic Server release, service pack, or patch has been installed, the weblogic_sp.jar file might not exist on the system. Regardless of whether the file currently exists, BEA recommends that it be included in the CLASSPATH to ensure compatibility with any updates.
      • C:\bea\weblogic81\server\lib\weblogic.jar
      • C:\bea\weblogic81\server\lib\ojdbc14.jar
      • C:\j2sdk1.4.2_04\jre\lib\rt.jar
      • C:\bea\weblogic81\server\lib\webservices.jar
      Note: You may need to change the paths slightly, depending on where you installed the Java 2 SDK and WebLogic.
    • Arguments: Start with the following arguments (separated by spaces):
      • -server
      • -Xms512m
      • -Xmx512m
      • -XX:NewSize=64m
      • -XX:MaxNewSize=64m
      • -XX:MaxPermSize=128m
      • -Xss128k
      • -XX:-UseTLAB
      • -XX:+UseConcMarkSweepGC
      • -XX:+DisableExplicitGC
      • -Dsun.rmi.dgc.client.gcInterval=3600000
      • -Dsun.rmi.dgc.server.gcInterval=3600000
      • -Djava.awt.headless=true
      (You can use these arguments as a starting point. For further information about Java Virtual Machine options, see the SAS Intelligence Platform: Planning and Administration Guide.)
    • Security Policy File: Full path to the file weblogic.policy. The file is located in BEA-install-dir\weblogic81\server\lib.

    After setting these properties, click the Apply button.

  24. You can now start the managed server. You can do this by performing these steps in the WebLogic Server Console:
    • In the left-hand pane, expand the Servers folder, right-click on the icon for myserver, and select Start/stop this server from the pop-up menu.
    • In the right-hand pane, click the Start this server link.

After Installing Your SAS Web Applications

After you have installed your SAS software and run the SAS Configuration Wizard, there a few steps you must take before you can run your web applciations:

For instructions on how to edit your weblogic.policy file, see the configuration instructions generated by the SAS Configuration Wizard (instructions.html). See the section named "Modifying Policy Files." After editing the policy file, you must restart the managed server.

When the SAS Configuration Wizard runs, it places exploded versions of your web applications in subdirectories subordinate to the directory configuration-directory\Lev1\web\webapps\exploded. You can deploy the applications from this location by using the deployment instructions for that application.

For SAS Information Delivery Portal, you must set the load order for the application SASTheme_default. See Step F in the table referred to in the list above.