This script opens a new, small, floating window and puts TOC<name>.html and IX<name>.html files in it and sets a generic popup window code to enable the display of some viewlets in the WebLogic Platform Tour.
Skip navigation.
Product Documentation

Supported Configurations for WebLogic Server 5.1

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF  
Get
Adobe Reader

Installation Help for Your Platform

This document contains installation instructions for the following platforms:

 


Compaq Open VMS

For general information about Java technology for Compaq Alpha Systems, see the Compaq Java Technology Center website.

Information on Compaq VMS with WebLogic Server 5.1

OpenVMS v7.2 has been tested on WebLogic Server 5.1.with jdbcKona/MSSQLServer4. Note the following, however:

WebLogic Server must be started statically for the OpenVMS platform.

Make sure compileCommand=javac is valued under your weblogic.httpd.register.*.jsp entry in the weblogic properties file. This will enable compilation of JSP's on the OpenVMS platform.

Known Issues with OpenVMS v7.2 on WebLogic 5.1

ActivatableRuntimeDescriptor.getStub() is not supported on this platform.

 


IBM OS/400 V5R1

Known Issues

There are a number of known issues associated with this release on this platform:

Installation

Download the WebLogic distribution

For information on how to download this platform, see Download WebLogic Server for Your Platform.

  1. Find your WebLogic Server release and Service Pack on the download page.
  2. From your client workstation, download WebLogic for AS/400 from the WebLogic web site. (webl610sp2.zip)
  3. Use a 32-bit program such as WinZip to unpack the zip file.

Transfer WebLogic to the AS/400 and install

  1. Log into the AS/400 with an administrative account.
  2. Create a save file in the AS/400 library QGPL:
  3. ===> CRTSAVF FILE (QGPL/WEBL610sp2)

    This command creates a save file on the AS/400 where you will transfer the webl610sp2 file.

  4. At a command prompt on the Windows NT client computer, type:
  5. $ ftp AS/400-hostname $ bin $ put webl610sp2 QGPL/WEBL610sp2

  6. Log into the AS/400 with an administrative account. Restore the save file:
  7. ===> RSTLIB SAVLIB(WEBLOGIC61) DEV(*SAVF)SAVF(QGPL/WEBL610SP2)

  8. Run the WebLogic installation script:
  9. ===> WEBLOGIC61/INSWEBL

    The INSWEBL script does the following:

    1. Creates WEBLOGIC and WLADMIN user profiles.
    2. Gives WEBLOGIC and WLADMIN user profiles all authority for all commands in the WEBLOGIC61 library.
    3. Installs WebLogic and the Java programs associated with its classes, .jar files, and .zip files. During this process, you will see the message:
    4. Restoring WebLogic Server files. Please wait.

      If the restore succeeds, you will see the message:

      WebLogic Server product successfully installed.

      If the restore does not succeed, you will see the message

      WebLogic Server product did not install successfully.

  10. If you want, you can delete the save file with the command:
  11. ===> DLTF FILE(QGPL/WEBL610sp2)

    On your Windows NT workstation, you can also delete the .zip file you downloaded and the webl610sp2 file.

  12. The WEBLOGIC61/INSWEBL programs (*PGM) and command (*CMD) are shipped with public authority set to *USE. Once the install has been run successfully, the administrator may set the authority on these objects to PUBLIC *EXCLUDE.
  13. Your AS/400 now has a WebLogic IFS directory containing the WebLogic Java classes as well as configuration files and example programs.

    The Java classes are transformed with the AS/400 Java transformer with level 40 optimization, so AS/400 direct executables for WebLogic are used.

  14. The weblogic server is installed at /weblogic/610sp2. The BEA home directory is /weblogic/61sp2. The WebLogic product installation directory is /weblogic/61sp2/wlserver6.1.
  15. For more information about the BEA home directory, please refer to the discussion here:

    http://download.oracle.com/docs/cd/E13222_01/wls/docs61/install/instpre.html#1066128

Add WebLogic administrative users

WebLogic administrative users have *ALL authority for the commands in the WEBLOGIC61 library and *RWX authority on certain files in the /weblogic directory. To allow a user to start and stop the server or to modify any of these files, you can add GRPPRF(WLADMIN) to their profiles.

To create a new user with authority to administer WebLogic, use this command:

===> CRTUSRPRF USRPRF(USERNAME) GRPPRF(WLADMIN)

To add authority to administer WebLogic to an existing user, use this command:

===> CHGUSRPRF USRPRF(USERNAME) GRPPRF(WLADMIN)

About the WEBLOGIC user

The WEBLOGIC61/INSWEBL command creates the WEBLOGIC user profile with authorizations of *NONE. You cannot log in as WEBLOGIC. However, you can add users to the WLADMIN group, allowing them to start WebLogic Server.

About the evaluation license

This installer can not generate evaluation license dynamically. Please contact BEA customer support to download an evaluation license at the BEA product download site.

Setting the CLASSPATH and other environment variables

Before you start WebLogic Server, you must add the WebLogic classes to the CLASSPATH environment variable.

The CLASSPATH environment variable for the session in which you run WebLogic Server must contain these classes:

/weblogic/610sp2/wlserver6.1/lib/os400/wlos400.jar:/weblogic/610sp2/wlserver6.1/lib/weblogic.jar

You must also set the QIBM_MULTI_THREADED environment variable to Y before you run STRWEBL, JAVA, or RUNJAVA commands or the JAVA command in an interactive QSHELL shell.

You can enter the CLASSPATH as a parameter when you run the STRWEBL CL command. Or you can use ADDENVVAR to add variables to your environment, CHGENVVAR to change an environment variable, or WRKENVVAR to add or modify variables in the environment.

The next sections describe how to set the CLASSPATH and other variables on the AS/400 using ADDENVVAR or QSHELL and on a Windows NT workstation. (The commands are displayed on several lines here for clarity, but they should be typed without line breaks when you enter them.)

Setting environment variables with the CL ADDENVVAR command

The following commands set the CLASSPATH and QIBM_MULTI_THREADED environment variables in an AS/400 session:

===> ADDENVVAR ENVVAR(CLASSPATH) VALUE( '/weblogic/610sp2/wlserver6.1/lib/os400/wlos400.jar:/weblogic/610sp2/wlserver6.1/lib/weblogic.jar')

===> ADDENVVAR ENVVAR(QIBM_MULTI_THREADED) VALUE('Y')

Setting environment variables in QSHELL

If you set environment variables in your session before you start QSHELL, the variables remain set in QSHELL, unless a ".profile" file in your home directory or the /etc/profile file resets environment variables.

You can set environment variables for every interactive QSHELL shell you start with STRQSH or QSH by setting the CLASSPATH in the .profile file in your home directory. An administrator can set environment variables globally by adding them to the /etc/profile file, which is executed whenever any user starts a QSHELL shell with the STRQSH or QSH commands.

To set environment variables in QSHELL, use these commands at the prompt, or add them to one of the profile files:

$ export -s \ CLASSPATH='/weblogic/610sp2/wlserver6.1/lib/os400/wlos400.jar:/weblogic/610sp2/wlserver6.1/lib/weblogic.jar')

$ export -s QIBM_MULTI_THREADED=Y

Setting CLASSPATH on a workstation with Client Access

You must set the CLASSPATH environment variable on a workstation running WebLogic classes from the AS/400. The QIBM_MULTI_THREADED environment variable is needed only when you are running Java classes in the AS/400 VM.

In this example, AS400SRVR is the name of the AS/400 server where WebLogic Server is installed.

C:\>SET \ CLASSPATH==%CLASSPATH%://AS400SRVR/weblogic/610sp2/wlserver6.1/lib/os400/wlos400.jar://AS400SRVR/weblogic/610sp2/wlserver6.1/lib/weblogic.jar

Starting WebLogic Server

The WEBLOGIC61/STRWEBL command starts WebLogic Server. This command changes to the WEBLOGIC account before it starts the server. This is important because objects the server creates belong to the WEBLOGIC account. If you start the server using a method other than the WEBLOGIC/STRWEBL command, you may experience problems with permissions. With QSHELL you can start WebLogic sever using the shell script shipped with WebLogic server, but WebLogic Server will be using your user profile. This could be a security problem in a production environment.

To start WebLogic Server with the WEBLOGIC61/STRWEBL command:

  1. Log into the AS/400 with an account that is a member of the WLADMIN group.
  2. Change to the WebLogic root directory. For example, there is a default root directory shipped with WebLogic server: "/weblogic/610sp2/wlserver6.1".
  3. ===> CD '/weblogic/610sp2/wlserver6.1'

  4. Make sure that the CLASSPATH variable is set as described in the previous section.
  5. Make sure there is no active QSHELL session within the current job. You should press F3 to quit a QSHELL session, otherwise WebLogic Server won't start.
  6. Start WebLogic Server with the following CL command:
  7. ===> WEBLOGIC61/STRWEBL

  8. Enter domain name in the WebLogic Domain Name field. For example, enter mydomain (the default shipped with Weblogic)
  9. Enter server name in the WebLogic Server Name field. For example, enter myserver (the default shipped with WebLogic).
  10. In the bea.home Directory field, enter the bea home directory, or use *ROOT_INSTALL_DIR as default, which will point to /weblogic/610sp2
  11. In the "WebLogic root directory" field, enter the default value *CURDIR (which will point to /weblogic/610sp2/ wlserver6.1).
    Optionally, enter the directory that contains the security resources for your domains and your configuration files.
  12. Enter CLASSPATH in the Classpath field or use *ENVVAR as default.
  13. Enter JVAV and WebLogic properties and values in the "Property name" and "Property value" list.
  14. For more information about WebLogic Server startup properties, see Starting and Stopping WebLogic Servers.

  15. If you want to run WebLogic Server in the background, change the Submit field to *YES.
  16. Modify any of the other parameters as needed.
  17. For parameters such as CLASSPATH, there may not initially be enough room to enter the entire value. You can expand a line by entering an ampersand (&) before you enter the value. Keep entering ampersands until there is enough room to enter your value. Press Enter to execute the command.

    For example, the following command starts the default server shipped with WebLogic Server:

    ===> WEBLOGIC61/STRWEBL DOMAINNAME(mydomain) SERVERNAME(myserver) PROPERTIES((java.security.policy '=/weblogic/610sp2/wlserver6.1/lib/weblogic.policy'))

    If you start the WebLogic Server interactively (Submit set to *NO), do not press F3 or F12 to exit the Java Command Entry Screen until you see a message similar to this:

    Java program completed

    See the WebLogic Server Administration Guide for detailed instructions on administering WebLogic, including setting up WebLogic Server as an HTTP server.

    WebLogic Server has extensive properties to give you a fine degree of control its operation.

    Also read about the property-related changes in the release notes for WebLogic Server.

Stopping WebLogic Server

You can shut down WebLogic Server through the Administration Console, or enter the ENDWEBL command:

===> WEBLOGIC61/ENDWEBL

Enter the WebLogic administrative user name (usually system) and password, and then press Enter to continue. Wait until you see a message similar to the following:

Shutdown initiated
The shutdown sequence has been initiated.
Java program completed

After this message appears, you can press F3 to exit the Java Command Entry Screen and return to the AS/400 Command Entry screen.

First time Set-up for the default servers shipped with WebLogic.

BEA ships three default servers with WebLogic product. The configuration repository can be found at /weblogic/610sp2/wlserver6.1/config.

Server myserver in Domain mydomain is the default product server.

The initial system password of WebLogic Servers is abcd1234. You should change it the first time when server is started.

To change the password:

  1. Start your default WebLogic Server. When the system asks for your password, type:
  2. abcd1234

  3. After the server started, open an Administration Console from a web browser using the URL:
  4. http://AS400NAME:PORT/console

    Enter system as your administrative user name and abcd1234 as your password.

  5. In the left panel of the console, click on the Users icon under the Security category.
  6. Change the system password on the right panel.

Additional demo domains

Two additional demo domains are also shipped: PetStore and Examples.

These servers were supposed to use the evaluation copy of CloudScape database shipped with WebLogic. We found Cloudscape doesn't work with JDK1.3.1 on AS/400, so a DDL for demo database is shipped with WebLogic.

To set up the demo database, execute the following CL command:

RUNSQLSTM SRCFILE(WEBLOGIC61/SQLSRC) SRCMBR(WLSDEMO) COMMIT(*NONE)

A demo database named WLSDEMO will be created on your machine. If you want to use a different name for the database, please edit member WLSDEMO in the file WEBLOGIC61/SQLSRC, replacing the string wlsdemo with the name you chose.

To set up proper JDBC connection pool properties like user name and password, you also need to modify file config.xml in these directories:

For more information about setting up JDBC connections please refer to the WebLogic for IBM AS/400e Technical FAQ.

Starting the PetStore server

  1. Modify /weblogic/610sp2/wlserver6.1/config/petstore/config.xml, seting user id and password for the JDBC connection pool to demo database WLSDEMO.
  2. Execute:
  3. ===> CD '/weblogic/610sp2/wlserver6.1'

  4. Set CLASSPATH to:
  5. /weblogic/610sp2/wlserver6.1/lib/os400/wlos400.jar:/weblogic/610sp2/wlserver6.1/lib/weblogic.jar:/weblogic/610sp2/wlserver6.1/config//petstore/serverclasses

  6. The initial password for this server is abcd1234
  7. Execute:
  8. ===> WEBLOGIC61/STRWEBL DOMAINNAME(petstore) SERVERNAME(petstoreServer) PROPERTIES( (java.security.policy'=/weblogic/610sp2/wlserver6.1/lib/weblogic.policy'))

Starting the Examples Server

  1. Modify /weblogic/610sp2/wlserver6.1/config/examples/config.xml, set up user name and password for the JDBC connection pool to demo database WLSDEMO.
  2. Execute:
  3. ===> CD '/weblogic/610sp2/wlserver6.1'

  4. set CLASSPATH to
  5. /weblogic/610sp2/wlserver6.1/lib/os400/wlos400.jar:/weblogic/610sp2/wlserver6.1/lib/weblogic.jar

  6. The initial password for this server is abcd1234
  7. Execute:
  8. ===> WEBLOGIC61/STRWEBL DOMAINNAME(examples) SERVERNAME(examplesServer) PROPERTIES((java.security.policy '=/weblogic/610sp2/wlserver6.1/lib/weblogic.policy'))

WebLogic Developer Center for IBM AS/400e

The AS/400 Developer Center is your starting point for using WebLogic Server on the IBM AS/400. From the Developer Center you can access documentation written specifically about using WebLogic software in an AS/400 environment, as well as documents relevant to all WebLogic users.

 


IBM OS/390 Platform Support

For more supported platform information, see IBM S/390 with OS/390.

General Information

For general information about S/390, OS/390, and USS/390, see IBM's S/390 website.

Installation

Install WebLogic Server on OS/390 using the WebLogic .zip archive distribution. Follow the instructions for installing from a .zip archive for your version of WebLogic Server.

Important for WebLogic 5.1 users 

You can download the latest JDK that runs on WebLogic Server 5.1 from the S/390 Java page at:

http://www.s390.ibm.com/java/about118.html

After you install WebLogic Server on OS/390, you must run the USS390PostInst utility, which is in the util390.jar file, to convert text files from ASCII to EBCDIC encoding. It is only necessary to do this one time after you install. Follow these steps:

  1. Copy the util390.jar file into your WebLogic home directory.
  2. Add util390.jar to your CLASSPATH environment variable:
  3. $ CLASSPATH=<WebLogic home directory path>/util390.jar:$CLASSPATH; export $CLASSPATH

  4. Run the USS390PostInst utility:
  5. $ java USS390PostInst

    USS390PostInst prints a message as it converts each text file in the WebLogic distribution.

Notes on using WebLogic Server with OS/390

 

Skip navigation bar  Back to Top Previous Next