Getting Started Tutorials

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

Tutorial 1: Installing Oracle Entitlements Server

This section contains the following topics:

 

Overview

This tutorial walks you through installation of the OES Administration Server. At the completion of this task, you’ll be able to start the server and launch the Entitlements Administration Application.

Note: In order to follow the steps in this tutorial, you must have already installed the application server and the database.

After installing the database used as the policy store, you must add a user account that is needed to run the Administration Server installation program. This is performed with tool that is downloadable from the OTN site.

 

Run the Database Configuration Tool

After obtaining the tool, perform the following steps:

  1. Unzip the file.

    2. The script file name is OES10gR3_DBConfigTool_win32.zip (Windows) or OES10gR3_DBConfigTool_unix.zip (UNIX and Linux).

  2. Open DBConfig.bat|sh in an editor and set the following properties:
    • JAVA-HOME — specify the fully-qualified path to a JDK.
    • INSTALL_HOME — specify the fully-qualified path to the directory where you unzipped ales320_DBConfigTool_win32.zip or ales320_DBConfigTool_unix.tar.gz
    • DB_JDBC_DRIVER_LOC — For Pointbase and MSSQL, specify the fully-qualified path to the JDBC driver. (This is not required for Oracle or Sybase databases.) Examples:

      • (Pointbase) C:\bea\weblogic92\common\eval\pointbase\lib\pbclient.jar

      (MS-SQL) C:\Program Files\Microsoft SQL Server 2005 JDBC Driver\sqljdbc_1.2\enu\sqljdbc.jar

  3. Enter dbconfig.bat or dbconfig.sh on a command line. The program issues a number of prompts to answer.
  4. Respond to the prompts as described in the table below:

    5. Prompt
    Description
    Please input DB type<oracle|sybase|mssql|pointbase>
    Enter one of the database names listed.
    Please input JDBC URL
    Enter the JDBC URL for the database server.
    Oracle—jdbc:oracle:thin:@<server>:<port>:<sid>
    Sybase— jdbc:sybase:Tds:<server>:<port>
    Sql Server— jdbc:sqlserver://<server>:<port>
    Pointbase—jdbc:pointbase:server://<server>/ales
    <server>—name or IP address of database machine
    <port>—port where the database listener is running
    <sid>—database SID of Oracle database
    Please input JDBC Driver
    Enter the JDBC driver used to connect to the database.
    Oracle—oracle.jdbc.driver.OracleDriver
    Sybase—com.sybase.jdbc3.jdbc.SybDriver
    Sql—com.microsoft.jdbc.sqlserver.SQLServerDriver
    Pointbase—com.pointbase.jdbc.jdbcUniversalDriver
    Enter new database user name
    Enter a username for the account being created.
    Enter new database user password
    Confirm new database user password
    Enter and confirm a password for the new user.
    Please input database admin username (not required for Pointbase)
    Enter the database administrator user name.
    Please input database admin password (not required for Pointbase)
    Enter the database administrator password.

  5. The script runs and displays messages like the following:

    6. -- Configuring table space [ales_oracle]
    ** Tablespace [ales_oracle] exists in DB server. Continuing with the same.
    -- Creating new user [ales_db_admin] .......Done
    -- Configuring     ALES role [asi_role]
    -- Assigning privs to     ALES role .......Done
    -- Assigning privs to new user [ales_db_admin].......Done
    -- Closing down connection
    -- Successfully created ALES Database Account --

At the completion of these steps, you may install the Administration Server. See the next section for instructions.

 

Install the Administration Server

  1. Start the installation program using one of the options described below:

    2. Platform
    Command
    Windows
    OES10gR3_admin_win32.exe
    Sun Solaris
    1. Change the protection on the install file by entering:

      2. chmod u+x oes10gR3_admin_solaris32.bin

    2. Enter: ./oes10gR3_admin_solaris32.bin
    Red Hat
    1. Change the protection on the install file by entering:

      2. chmod u+x oes10gR3_admin_linux32.bin

    2. Enter: ./oes10gR3_admin_linux32.bin

  2. On the Welcome window, click Next.
  3. On the Choose BEA Home Directory, select the directory containing the application server and click Next.
  4. On the Choose Product Installation Directories, accept the default and click Next.
  5. On the Choose Service Control Manager Directory, accept the default and click Next.
  6. On the Choose Application Server, select the application server you are using (WebLogic or Tomcat) and then specify the web server directory and click Next.
    7. WARNING: When using Tomcat, the directory name cannot contain spaces.
  7. On the Choose Network Interfaces window, accept the default and click Next.
  8. On the Configure Administration Application window, accept the default and click Next.
  9. On the Configure Database Connection, select your database type from the Database client dropdown list. Then complete the following fields and click Next.

    10. JDBC URL—Replace the bracketed values. These vary by database type:

    <SERVER>—name/IP address of the database machine
    <PORT>—port number where the database listener is running
    <INSTANCE>—instance name to connect to on <server>
    <SID>—database SID of Oracle database

    JDBC driver—Accept the default

    Driver location—If required, browse to and select the driver location.

    Login ID—user created using the database setup script described in Run the Database Configuration Tool on page 2-1.

    Install Schema—make sure the checkbox is selected.

  10. On the Key Protection Password Selection window, select Generate Random Password and click Next.

    11. The program takes several minutes to install the files and displays a status bar showing progress.

  11. On the Choose JDK window, select the default and click Next.
  12. On the Installation Complete window, click Done. This page indicates the Administration Server completed successfully.

    13. A command window will open and notices about server starts and the schema addition will appear. This may take 5 minutes or more.

  13. When prompted, press Enter to close the window.

    14. The Administration Server should now be running.

 

Starting the Server

If you just finished installing the server as described above, the server should already be running and you can launch the Entitlements Administration Application as described in the next section. Otherwise, to start the server on Windows:

  1. From the Windows Start Menu, select Programs > Oracle Entitlements Server > Administration Server > Start Server.

    2. This opens a DOS box that gives information about the start process, which can take several minutes. When the server starts, a message like the following appears:

    The OES WLS.<server_name> service was started successfully.

 

Launch the Entitlements Administration Application

To launch the Entitlements Administration Application:

  1. Open Internet Explorer and go to https://<servername>:7010/entitlementsadministration where <servername> is the server name.

    2. When you see a message about the security certificate being used, click Yes to display the the log on window.



  2. Complete the Username and Password field and click Login to access the Entitlements Administration Application’s main window.
    3. Note: The default admin username and password is admin and password respectively.

 

Summary

This tutorial walked you through a basic installation of the Administration Server and showed how to start the server and launch the Entitlements Administration Application.


  Back to Top       Previous  Next