English

How To: Install WebLogic 9.1 with J2SE JDK 5.0 Update 6 for ArcIMS 9.2 on Windows 2003/2000/XP

Summary

Instructions provided are for the installation and configuration of WebLogic 9.1 Server Platform using J2SDK 1.5.2_06 for ArcIMS on Windows.

Specific information for the installation of ArcIMS is included with the product's Install Guide.
 

Note:
WebLogic possesses its own native servlet engine and does not require other third-party servlet engines.

These instructions are for the WebLogic Platform Net Installer. Configuration steps outlined for ArcIMS, directory structures and dialog boxes vary from those for the WebLogic Server Package Installer.
This installation requires the following software:
· A Windows based server
· J2SE Development Kit (JDK) 5.0 Update 6
· WebLogic 9.1 Server
· ArcIMS 9.2 Installation Disk

A user account that has administrative privileges on the ArcIMS machine is required.
· Familiarity with certain Windows tasks is required to install and configure ArcIMS. For details, see Common Windows tasks when installing ArcIMS.

· For more information on the acronyms and terms used in this document, see the Glossary of terms used in ArcIMS Installation articles.

· Review and follow steps 1 and 2 from the ArcIMS Installation Guide on the DVD. These two steps ensure that the system meets the minimum requirements and assist in planning the ArcIMS site configuration. To open the ArcIMS Installation Guide, launch the DVD menu and click 'ArcIMS Installation Guide'.

Procedure

Previous versions of ArcIMS must be uninstalled to install ArcIMS 9.2. The setup program for ArcIMS 9.2 on Windows prompts for the removal of previously installed versions.

If ArcIMS components were distributed among several computers, it is recommended to first remove the components on each computer before continuing by going to Add/Remove Programs and select Remove for ArcIMS.
 

Warning:
A supported Web server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS 9.2.
 
  1. Uninstall any unsupported versions of J2SDK/JRE, Web Server and Servlet Engine.
    How To: Uninstall ArcIMS-related third-party software on Windows
  2. Install Java 2 Standard Edition Development Kit version 5.0 Update 6
     
    A. Click J2SE Development Kit (JDK) 5.0 Update 6 to download Sun Java 2 SDK, Standard Edition, version 5.0 Update 6.

    B. Click 'Download JDK'.

    C. Accept the license agreement.

    D. Click on the download link for the Windows Offline Installation Multi-Language. The file jdk-1_5_0_06-windows-i586-p.exe is downloaded.

    E. Run the installer after it has finished downloading.

    F. Accept all of the default installation options, unless changes are required. This installs both the Java Runtime and Development Kit.

    G. After the install, Navigate to Start > Settings > Control Panel > Java.

    H. Click the 'Update' tab and remove the checkmark for 'Check for Updates Automatically'.

    I. Click Apply and close the Java Control Panel.
  3. Install WebLogic 9.1 Server
     
    A. Run the BEA setup program to install WebLogic 9.1(server910_win32.exe)

    B. Click Next at the 'Welcome' dialog

    C. Accept the License Agreement and click Next.

    D. At the “Choose BEA Home Directory” screen, browse to your desired install location or keep the default at c:\bea and click Next.

    E. At the “Choose Install Type” screen, choose “complete” and click Next.

    F. Uncheck Mercury profiling tools and click Next.

    G. At the “Choose Product Directory” screen, choose the same install location as in step 4 (i.e. c:\bea\weblogic91) and click Next.

    H. Select “All Users” Start Menu Folder and click Next

    I. At the “Installation Complete” screen, uncheck the “Quick Start” box and click Done.
  4. Create and Configure your WebLogic 9.1 Domain
     
    A. Run the Configuration Wizard by going to Start>Programs>BEA Products>Tools>Configuration Wizard

    B. At the “Welcome” screen, choose “Create a new Weblogic domain” and click Next.

    C. At the “Select Domain Source” screen, choose “Generate a domain configured automatically to support the following BEA products:” and ensure only "Weblogic Server" is checked and click Next.

    D. At the “Configure Administrator Username and Password” screen, enter a username and password (for example weblogic/weblogic) and click Next.

    E. At the “Configure Server Start Mode and JDK” screen, choose “Production Mode” and choose the "Sun SDK 1.5.0_04" listed in the box as “BEA Supplied JDK” and click Next.

    F. At the “Customize Environment and Services Settings” screen, choose Yes and click Next.

    G. Under Listen Port, type in 80.

    H. Click next though the next few screens until you come to the "Create Weblogic Domain" screen.

    G. At the “Create Weblogic Domain” screen, enter esridomain. Leave the domain location the same and click Create.

    I. When the domain creation is finished, click Done.

    J. Now re-run the Configuration Wizard.

    K. At the “Welcome” screen, choose “Extend an existing Weblogic domain” and click Next.

    L. At the “Select a Weblogic Domain Directory” screen, expand the domains tree view and select the esridomain folder. Highlight it and click Next.

    M. At the “Select Extension Source” screen, choose “Extend my domain using an existing extension template” and browse to “wls_default.jar” and highlight it. (<BEA_HOME>/weblogic90/common/templates/applications), click OK, and click Next.

    N. At the “Customize JDBC and JMS File Store Settings” screen, choose No and click Next.

    O. At the “Extend Weblogic Domain” screen, click Extend.

    P. At the “Creating Domain” screen click Done.
  5. Install ArcIMS 9.2 from the installation CD. Refer to the ArcIMS Installation Guide (install.htm), Step 3a.
  6. To configure ArcIMS 9.2 run the ArcIMS Post Installation, see the ArcIMS Installation Guide, Step 3b.
     
    A. Select Typical as the Post Installation option.

    B. Please choose the method you wish to register ArcIMS with. When done, click Next.

    C. On the dialog to select the Web site and Output directories, navigate to the following path: <Bea WebLogic Installation Directory>\user_projects\applications\esridomain\server\examples\build\mainWebApp

    D. Click Next through the next few dialogs until you are on the ArcIMS Configuration dialog asking about the System Domain\User name. Enter the username for the account that will be using ArcIMS. (This account should have administrative rights) Click Next.

    E. On the Web Server-Servlet Engine Configuration panel, select 'I will manually configure my Web server / servlet engine'. Click Next then OK.

    F. Click Finish.
  7. Configure WebLogic 9.1 for ArcIMS
     
    A. Go to Control Panel > Systems and on the Systems Properties settings click on the Advanced tab. Click on Environment Variables.
    Create a new system environment variable "JAVA_HOME" with the value of the following path: <Bea Installation Directory>\jdk150_04

    B. Find the Path variable and click Edit. Including the semicolon add ";%JAVA_HOME%/bin" to the end of the existing Path variable.

    C. Open a command window from Start > Run and type "cmd" and hit enter.

    D. To navigate to the Servlet directory, type cd and the path:
     
    cd /Connectors/Servlet

    Hit Enter.

    E. Type
     
    copy arcimsservletconnector.war servlet.war

    Hit Enter.

    F. Type
     
    mkdir build

    Hit Enter

    G. Type
     
    cd build

    Hit Enter

    H. Type
     
    C:\bea\jdk150_04\bin\jar -xvf ../servlet.war

    Hit Enter

    I. In Notepad, open the Esrimap_prop file from the newly created location at C:\Program Files\ArcGIS\ArcIMS\Connectors\Servlet\build\WEB-INF\classes
    Verify the appServerMachine variable is set to the name of the Application Server computer. If not, edit the variable and save and close the file. It should look like this:
     
    appServerMachine=mymachine


    J. Go back to the Command Console and type
     
    C:\bea\jdk150_04\bin\jar -cvf servlet.war *

    Hit Enter

    K. Type
    move servlet.war ../.


    Type "yes" when it asks and hit Enter.

    L. Start the Admin Server by running Start > Programs > BEA Products > User Projects > esridomain > Start Admin Server for Weblogic Server Domain

    M. Type the username and password if the command prompt asks for it.

    N. When the Welcome to BEA WebLogic Server website loads, click on "Start the Administration Console" located on the top right after "Controls:"

    O. Enter the username and password and press Log In.

    P. In the upper left corner, click the "Lock & Edit" button.

    Q. In the left panel under Domain Structure, click on "Deployments".

    R. In the right panel, click “Install”.

    S. Browse to the servlet.war file located at <ArcIMS Install Directory>/Connectors/Servlet, choose it and click Next.

    T. Select “Install this deployment as an application” and click Next.

    U. Under the Security section, choose “CustomRolesandPolicies: Ignore all roles and policies in deployment descriptors.”

    V. Under the Source Accessibility section, choose “Copy this application onto every target for me” and click Next.

    W. Click Finish.

    X. Click “Activate changes” on the left panel.

    Y. Click on the “Security” tab.
    YA. Make sure that you are on the page Application Scope > Roles.
    YB. Click on “Roles” then click New, and click OK.
    YC. In the left panel, click on “deployments”.
    YD. In the right panel, click on servlet.
    YE. Click on “Security” tab.
    YF. Click on “URL Patterns”
    YG. Click on “Roles” then New.
    YH. Type in “/servlet/*” for the URL pattern.
    YI. Type in “servlet” for the Role Name.
    YJ. Click Finish.

    Z. Go back to the Admin Server Console and in the left panel, click “Deployments”.

    AA. Check "servlet" and click “start” | ”Servicing all requests” and press Yes

    BB. With Windows Explorer, browse to <BEA_HOME>/user_projects/applications/esridomain/server/examples/build/mainWebApp/WEB-INF

    CC. Open the file web.xml in a text editor such as Wordpad.
    Under <welcome-file>index.jsp</welcome-file> add the following lines so that it looks like this:
     
    <welcome-file>index.jsp</welcome-file>
    
    <welcome-file>default.htm</welcome-file>
    
    <welcome-file>default.html</welcome-file>
    

    Save and close the file.

    DD. Back in the Weblogic Administration Console, select Lock and Edit.

    EE. In the left panel, click “Deployments”.

    FF. In the right panel, click on mainWebApp

    GG. Click on the “Configuration” tab, then check the box for “Index Directory Enabled” and click Save.

    HH. Check mailWebApp and click Finish.

    II. Click on Activate Changes in the upper left hand corner.

    JJ. In the left panel, click “deployments”.

    KK. Stop and Start the mainWebApp like this:
    a) In the right panel, check the box next to "mainWebApp"
    b) Click "stop | When work completes" and then click Yes.
    c) In the right panel, check the box next to "mainWebApp"
    d) Click "Start | Servicing all requests" and then click Yes.

    LL. Verify the ArcIMS services Application Server, Monitor and Tasker are started in list under the Control Panel > Administrative Tools > Services.
  8. Verify that the ArcIMS installation was successful.
     
    A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.

    B. Verify that the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.
     
    Note:
    On Windows XP/2003 machines, Internet Explorer sometimes does not show the host name and port number. If this is the case, right-click near the top of the window, under the address bar, and select 'Allow Blocked Content'.

    C. Test both components.

    The result for Test 1 should be:

    IMS v9.2.0
    Build_Number=514.1916
    Version=9.2.0
    Test successful

    The result for Test 2 should be:

    Version=9.2.0
    Build_Number=514.2159
    Test successful
     
    Note:
    If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly. If an error message is received, select the error number from the drop-down list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and run the Diagnostics tool again.
  9. See the ArcIMS 9.2 Installation Guide, Step 5: 'Configure ArcIMS' to finish setting up ArcIMS.

    For getting the ArcIMS Web ADF for the Java Platform or for the .NET Framework setup, please refer to the according Installation Guide.

Related Information