8.1 Supported Configurations: HP OpenVMS 7.3 on Alpha

HP OpenVMS 7.3-2 on Alpha with 8.1 SP3

Provides full support for WebLogic Server and run-time only support for WebLogic Workshop and WebLogic Integration. WebLogic Portal is not supported. See below for Design and Development Tools support.

This section provides the following information:

Related Information

For information about supported database configurations, Web servers, and browsers, plus support for interoperability tools and WebLogic Platform product support information, see WebLogic Platform 8.1 Supported Configurations.
For details about HP OpenVMS 7.3-* on Alpha, visit the following HP Web site: http://h71000.www7.hp.com

Configuration Requirements

Table 1-1 Requirements for WebLogic Platform 8.1 SP3 on HP OpenVMS 7.3-2 on Alpha

Operating System Version and Patches	HP OpenVMS 7.3-2
Chip Architecture and Minimum Processor Speed	HP Alpha processor (433 MHz) with a non-system disk that can be converted or initialized to ODS-5. Note: The disk must not have page or swap files on it.
SDK	HP Fast VM 1.4.2-4 JDK 1.4.2 Java^TM 2 Runtime Environment, Standard Edition, Fast VM (build 1.4.2-4, build J2SDK.v.1.4.2:12/06/2004-01:55, native threads, jit_142) HP Fast VM 1.4.2-4 JDK 1.4.2 Java^TM 2 Runtime Environment, Standard Edition, Fast VM (build 1.4.2-4.p2, build J2SDK.v.1.4.2:05/09/2005-13:09, native threads, jit_142)
Design and Development Tools	Supports WebLogic Server development tools.
RAM	For WebLogic Server	512 MB required; 1 GB recommended
	For WebLogic Integration	2 GB required; 4 GB recommended
Performance Pack	None
Node Manager	Included	Java
BEA jDrivers for Oracle	Oracle 9.2.0 Thin Driver for Oracle 9.2.0 Oracle 10g Thin Driver

Known Issues

This section provides recommendations and workarounds for the following problems that occur in WebLogic Server 8.1 SP3:

For more information about known issues with this release, see the WebLogic Server 8.1 Release Notes document:

http://download.oracle.com/docs/cd/E13222_01/wls/docs81/notes/index.html

Apache 1.3 Plugin Support

Apache Plugin binaries and installation instructions for this release can be obtained by calling BEA customer support and referring to CR239534.

Examples Problem for WebLogic Server and WebLogic Integration

When you run the examples for WebLogic Server and/or WebLogic Integration, you may see the following warning:

<Warning> <Socket> <BEA-000402> <There are: 5 active sockets, but 
the maximum number of socket reader threads allowed by the 
configuration is: 4. You may want to alter your configuration.

Ignore this warning. It does not adversely affect the running of the examples.

Native Libraries Not Supported by WebLogic Server

WebLogic Server 8.1 does not support any WebLogic Server native libraries. For example, there is no support for jDriver or pollmuxer.

Upgrade Problems with WebLogic Server

During the procedure for upgrading from WebLogic Server 7.0 to 8.1, several problems may occur. To perform an upgrade, complete the following procedure:

Follow the instructions provided in WebLogic Server 8.1 Upgrade Guide:

http://download.oracle.com/docs/cd/E13222_01/wls/docs81/upgrade/index.html

Open each WebLogic Server 7.0 .XML file that is accessed by WebLogic Server 8.1, and make the following modifications:

Change any references to (a) your WebLogic Server device (wldisk) and/or (b) the BEA account home directory in the .XML files that are not case sensitive and that do not match your WebLogic Server settings. For example, if you have defined the WebLogic Server device logical as wldisk and the BEA account home directory as [bea], then you must make the following change:

From: Path="/WLDISK/BEA/user_projects/mydomain/applications"To: Path="/wldisk/bea/user_projects/mydomain/applications"
Change, to wldisk, any references to your WebLogic Server device (wldisk) that have been resolved to a device specification and written in the .XML files by WebLogic Server 7.0. For example:
From: Path="/DQA0/bea/user_projects/mydomain/applications"To: Path="/wldisk/bea/user_projects/mydomain/applications"

Download and Installation Instructions for WebLogic Server

This section provides instructions for the following tasks:

Note: Review all instructions before proceeding. If you are upgrading from WebLogic Server 7.0 to 8.1, please review Known Issues. WebLogic Server must be installed on an ODS-5 disk.

Preparing Your System

This section provides instructions for the following tasks:

Verifying the Prerequisites on Your System

Before you download WebLogic Server for your system, you must make sure that in addition to the OpenVMS 7.3-2 operating system, the following required software is installed:

Java 2 SDK 1.4.2-4, including Java Fast Virtual Machine (Fast VM), available from the Java on Alpha System Version 1.4.2 Download Page:

http://h18012.www1.hp.com/java/download/ovms/1.4.2/index.html

Additional Java Software Patches (ECOs), if any, necessary for Java 2 SDK 1.4.2-4, available from the v1.4.2 Java Patch Installation Page:

http://h18012.www1.hp.com/java/download/ovms/1.4.2/sdk1.4.2_patches.html

Required Supplemental Software

In addition to the WebLogic Server software, you also need the OpenVMS 7.3.2 Supplementary JAR file, wls813_OpenVMS_supp.jar, which contains installation and configuration files for OpenVMS. Instructions for downloading this file are provided in Downloading the WebLogic Server Software and Supplementary JAR File.

Note: The supplemental file contains customized command files for OpenVMS, which are automatically copied to the proper directories during installation. The following files are delivered: commEnv.com, config.com, configDB.com, configEnvVMS.com, configEnvVMS_template.dat, configFilesVMS.com, env.com, extEnv.com, login.com, parseNodeManager.exe, setEnv.com, setExamplesEnv.com, setJavaClasspath.com, setMedRecEnv.com, setWLSEnv.com, startExamplesServer.com, startManagedWebLogic.com, startMedRecServer.com, startNodeManager.com, startNodeManagerProcess.com, startWebLogic.com, startWebLogicDetached.com, startWLS.com, startWLSNm.com, stopWebLogic.com, stopWLS.com, vms_javac.com, and _java.policy.

Setting Up a Disk, Directory, and Account to Run WebLogic Server

Before you can run WebLogic Server on OpenVMS, you must set up an ODS-5 disk, and a dedicated directory and account. To do so, complete the following procedure:

Set the minimum quotas for the SYSTEM account to values greater than or equal to those of the bea account, as specified in Step 3 below. For installation purposes, the SYSTEM account must have a minimum BYTLM of 6000000 (6M).
$ SET PROCESS /PARSE_STYLE=EXTENDED

Create or convert an ODS-5 disk, define a system logical called wldisk to reference this disk, and then mount the disk. For example:

Note: This INITIALIZE command will destroy all data on the selected drive.

$ INITIALIZE/STRUCTURE_LEVEL=5 DKA100: "wldisk"

Note: If the logical defined in the next step contains any lowercase characters, it must be enclosed in quotes. Take note of the exact syntax. You must specify the same spelling (including distinctions between uppercase and lowercase) and syntax when you create the default bea directory on the ODS-5 device. This also applies when you specify the default device and directory specification for the bea account in the user authorization file. (UAF).
$ DEFINE/SYSTEM/EXECUTIVE_MODE/TRANSLATION_ATTRIBUTES=CONCEALED - _$ "wldisk" DKA100:
To verify the logical definition:
$ SHOW LOGICAL wldisk /FULL "wldisk" [exec] = "DKA100:" [concealed] (LNM$SYSTEM_TABLE) $ MOUNT/SYSTEM DKA100: "wldisk"
Add the DEFINE and MOUNT commands, above, to SYS$STARTUP:SYSTARTUP_VMS.COM.

Using AUTHORIZE, create a BEA Home account called bea.

$ SET DEFAULT SYS$SYSTEM $ RUN SYS$SYSTEM:AUTHORIZE.EXE
Set the default device to the logical name defined in the previous step. Set the directory of this account to bea: /DEVICE="wldisk" /DIRECTORY=bea
The account must have the following minimum quotas: /PGFLQUO=2097152 /WSDEF=8192 /WSEXTENT=32768 /WSQUO=16384 /BYTLM=400000 /FILLM=4096
The system parameter CHANNELCNT must be greater than or equal to FILLM.
Use the SYSMAN utility to examine the value of CHANNELCNT: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> PARAMETERS SHOW CHANNELCNT Parameter name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- CHANNELCNT 127 127 21 2047 Channels SYSMAN> EXIT $
To change the value of CHANNELCNT, edit the SYS$SYSTEM:MODPARAMS.DAT file and then use AUTOGEN.

Create a directory on the ODS-5 disk called wldisk:[bea] and set the owner to the bea account. The directory name is case sensitive; it must match the directory specified earlier for the bea home account. For example:

$ CREATE/DIRECTORY/OWNER=BEA/VERSION=0 wldisk:[bea]

Create an additional directory on the ODS-5 disk to hold the downloaded kits, and set the owner to the bea account. For example, to name the directory wldisk:[kits], enter the following command:

$ CREATE/DIRECTORY/OWNER=BEA/VERSION=0 wldisk:[kits]

Steps 7 and 8 are based on the assumption that Java 2 SDK 1.4.2-4, including Java Fast Virtual Machine and all its prerequisite software patches, are installed on your system. If these items are installed, skip to step 7.

If these items are not installed yet, install them now and reboot the system. The SDK and all required patches are available from:
http://h18012.www1.hp.com/java/download/

From the SYSTEM account, execute the following commands:

$ SET DEFAULT wldisk:[bea] 
$ SET PROCESS/PARSE_STYLE=EXTENDED 
$ DEFINE DECC$ARGV_PARSE_STYLE ENABLE 
$ DEFINE DECC$EFS_CASE_PRESERVE ENABLE 
$ @SYS$COMMON:[JAVA$142.COM]JAVA$142_SETUP.COM FAST 
$ DEFINE DECC$READDIR_DROPDOTNOTYPE ENABLE 
$ DEFINE DECC$EFS_CHARSET ENABLE
$ DEFINE JAVA$CLASSPATH [] 
$ DEFINE JAVA$CREATE_DIR_WITH_OWNER_DELETE TRUE 
$ DEFINE JAVA$DELETE_ALL_VERSIONS TRUE
$ DEFINE JAVA$DISABLE_JAVA_FCNTL_LOCKS TRUE
$ DEFINE JAVA$FILENAME_CONTROLS 8 
$ DEFINE JAVA$FILE_OPEN_MODE 3
$ DEFINE JAVA$FORK_SUPPORT_CHDIR TRUE
$ DEFINE JAVA$FSYNC_INTERVAL 5
$ DEFINE JAVA$RENAME_ALL_VERSIONS TRUE 
$ DEFINE JAVA$TIMED_READ_USE_QIO TRUE
$ DEFINE SYS$SCRATCH 'F$ENVIRONMENT("DEFAULT")

Before you start running WebLogic Server on OpenVMS, verify that the OpenVMS time zone is set correctly by running the following command:

$ @SYS$MANAGER:UTC$TIME_SETUP SHOW

For more information, see Section 6.1, "Setting Correct Time Zone Information on Your System" in the OpenVMS System Manager's Manual.

Downloading the WebLogic Server Software and Supplementary JAR File

To download WebLogic Server to your system, complete the following procedure:

Go to the WebLogic Server download site:

http://commerce.bea.com/downloads/weblogic_server.jsp

Find the listings for WebLogic Server 8.1 SP3 and select HP OpenVMS from the drop-down menu.

Download the following:

WebLogic Server installer: pj_server813_generic.jar
OpenVMS 7.3.2 Supplementary JAR file, wls813_OpenVMS_supp.jar, containing supplementary installation and configuration files for OpenVMS

COPY (or FTP in binary mode) the files to a convenient location, such as wldisk:[kits].

Installing WebLogic Server 8.1 Service Pack 3

From the SYSTEM account, install the WebLogic Server kit as follows:

Set attributes for the downloaded installer and supplemental .jar files to stream LF. For example:

$ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]pj_server813_generic.jar 
$ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]wls813_OpenVMS_supp.jar

Install the WebLogic Server kit in console mode by setting the default to wldisk:[bea] and using the java command to unpack the archive:

$ SET DEFAULT wldisk:[bea] 
$ java -DJAVA_HOME=/sys$common/java$142 -Djdk.check.override=true -
_$ -jar /wldisk/kits/pj_server813_generic.jar -mode=console

These command lines are based on the assumption that the .jar file resides in the wldisk:[kits] directory. If the .jar file on your system resides elsewhere, modify the java command as appropriate.

Note: This java command creates the WebLogic Server directory structure, starting with the WebLogic directory under [bea]: that is, [bea.weblogic81]. Depending on the speed of the machine, this command may run for over 20 minutes.
While the BEA installer is running, note the pathnames of the "BEA Home Directory" and "Product Installation Directory." These directory specifications are required as input for the configuration of the WebLogic Server environment on OpenVMS (during the execution of configEnvVMS.com).
The following code shows an example of an installation. User responses are highlighted in bold. To select [Next] at any time, press Enter.

0%..................................................100% <------------- WebLogic Server 8.1 SP3 -------------> Welcome: --------
This installer will guide you through the installation of WebLogic Server 8.1 SP3. Type "Next" or enter to proceed to the next prompt. If you want to change data entered previously, type "Previous". You may quit the installer at any time by typing "Exit".
Enter [Exit][Next]> Next
<------------- WebLogic Server 8.1 SP3 -------------> BEA Systems License Agreement: -------------------------------
BEA SYSTEMS, INC. SOFTWARE LICENSE AGREEMENT NOTE: Please read the license agreement.
Select Option: 1 - Yes, I agree with the terms of the license 2 - No, I do not agree with the terms of the license
Enter option number to select OR [Down] [Exit] [Previous]> 1
<------------- WebLogic Server 8.1 SP3 -------------> Choose BEA Home Directory: --------------------------
"BEA Home"=[/SYS$SYSROOT/SYSMGR/bea] Input new BEA Home OR [Exit][Previous][Next]> /wldisk/bea
<------------- WebLogic Server 8.1 SP3 -------------> Choose BEA Home Directory: --------------------------
*BEA home choice
  ->1 Yes, Use this BEA home directory [/wldisk/bea]     2 No, return to BEA home directory selection
      Enter index number to select OR [Exit][Previous][Next]> 1
<------------- WebLogic Server 8.1 SP3 -------------> Choose Install Type: --------------------
->1 Complete       Install the complete BEA WebLogic Platform.
  2 Custom Installation      Choose software components to install and perform optional configuration.
     Enter index number to select OR [Exit][Previous][Next]> 1
<------------- WebLogic Server 8.1 SP3 -------------> Choose Product Directory: -------------------------
"Product Installation Directory" = [/wldisk/bea/weblogic81]
Input new Product Installation Directory OR [Exit][Previous][Next]> /wldisk/bea/weblogic81
<------------- WebLogic Server 8.1 SP3 -------------> Choose Product Directory: --------------------------
  ->1 Yes, use this product directory [/wldisk/bea/weblogic81]     2 No, select another product directory
      Enter index number to select OR [Exit][Previous][Next]> next
<------------- WebLogic Server 8.1 SP3 -------------> Installing files...
0%           25%          50%         75%        100% [------------|------------|------------|------------] [**************                                     ] (NOTE: You may notice a delay at this point. Do not abort.)
<------------- WebLogic Server 8.1 SP3 -------------> Installation Complete
Congratulations! WebLogic Server 8.1 SP3 has been successfully installed to /wldisk/bea/weblogic81.
Press any key to continue OR [Exit]> Exit
<------------- WebLogic Server 8.1 SP3 -------------> Clean up process in progress ... $

Use the jar command to unpack the contents of the OpenVMS command procedures file
wls813_OpenVMS_supp.jar. This file is the one you copied, earlier, into a convenient location, such as wldisk:[kits].

$ CREATE/DIRECTORY wldisk:[bea.wls813_OpenVMS_supp]
$ SET DEFAULT wldisk:[bea.wls813_OpenVMS_supp]
$ jar xf /wldisk/kits/wls813_OpenVMS_supp.jar

Log out of the SYSTEM account.

Run the following command procedure to configure the WebLogic Server environment on OpenVMS:

$ SET DEFAULT wldisk:[bea.wls813_OpenVMS_supp]
$ @configEnvVMS  
          Configure BEA WebLogic Server Environment
Enter the BEA Home Directory (e.g., wldisk:[bea]])? wldisk:[bea]
Enter the BEA WebLogic Product Directory (e.g., wldisk:[bea.weblogic81
)? wldisk:[bea.weblogic81] 
Creating WLDISK:[bea.wls813_OpenVMS_supp]setEnvVMS.com . . .
Create complete
Install OpenVMS Command Procedures.
If modifications were made to installed command procedure files on this
system please save them in an alternate directory previous to running 
this install.
Install OpenVMS Command Procedure Files (Y/N)? Y
Installing OpenVMS Command Procedure Files...
OpenVMS Command Procedure Files installed.
$

Run the BEA Configuration Wizard to configure a domain, as shown in the following example:

$ SET DEFAULT SYS$LOGIN
$ @LOGIN
$ SET DEFAULT WL_HOME:[common.bin]
$ @config "-mode=console"

<------------- BEA WebLogic Configuration Wizard ------------->
Create or Extend a Configuration:
---------------------------------

Choose between creating and extending a configuration. Based on your
selection, the Configuration Wizard guides you through the steps to
generate a new or extend an existing configuration.

 ->1|Create a new WebLogic configuration
    |Start here to create a WebLogic configuration in your projects
    |directory.

   2|Extend an existing WebLogic configuration
    |Start here to extend an existing WebLogic configuration. Use this
    |option to add applications and services, including Database access
    |(JDBC) and Messaging (JMS). This option also enables you to extend
    |functionality by enabling WebLogic Workshop.

Enter index number to select OR [Exit][Next]> 1

<------------- BEA WebLogic Configuration Wizard ------------->
Select a Domain Template:
-------------------------

Please select a template from the list or select another directory of
templates.

    * [/wldisk/bea/weblogic81/common/templates/domains]
   1|WebLogic Server Examples Domain 8.1.3.0
    |BEA Systems, Inc.
    |Create the WebLogic Server Examples domain in a directory outside
    |of the installed kit. The Examples domain contains a collection of
    |examples to show best practices for coding individual J2EE APIs.
   2|Avitek Medical Records Sample Domain 8.1.3.0
    |BEA Systems, Inc.
    |Create the Avitek Medical Records domain in a directory outside of
    |the installed kit. The Avitek Medical Records is a WebLogic 
    |Server sample application suite that concisely demonstrates all
    |aspects of the J2EE platform.
 ->3|Basic WebLogic Server Domain 8.1.3.0
    |BEA Systems, Inc.
    |Create a basic WebLogic Server domain without installing sample
    |applications.
   4|Basic WebLogic Workshop Domain 8.1.3.0
    |BEA Systems, Inc.
    |Create a basic WebLogic Workshop domain, without installing
    |sample applications. Domains created from this template will 
    |support the

Enter index number to select OR [Down][Exit][Previous][Next]> 3

(NOTE: WebLogic Server Examples domain and Avitek Medical Records domain
are created during installation inside of the installed kit. Select 1
or 2 only if you wish to create domains outside of the installed kit.)

<------------- BEA WebLogic Configuration Wizard ------------->
Choose Configuration Option:
----------------------------

    *Do you want to run the wizard in express mode?

  ->1|Yes
    2|No

Enter index number to select OR [Exit][Previous][Next]> 1

<------------- BEA WebLogic Configuration Wizard ------------->
Configure Administrative Username and Password:
-----------------------------------------------

Create a user automatically assigned to the Administrative Role. This
user is the default administrator used to start development mode servers.

               Name                            Value
  1        User Name *                       weblogic
  2       User Password *
  3   Confirm User Password *
  4        Description         This user is the default administrator.

  Select Option

      1 - Modify "User Name *"
      2 - Modify "User Password *"
      3 - Modify "Confirm User Password *"
      4 - Modify "Description *"

  Enter option number to select OR [Exit][Previous][Next]> 2

<------------- BEA WebLogic Configuration Wizard ------------->
Configure Administrative Username and Password:
-------------------------------------------------

Create a user automatically assigned to the Administrative Role. This
user is the default administrator used to start development mode servers.

    "User Password *" = []
Input new User Password * OR [Exit][Reset][Accept]> <enter_password>

<------------- BEA WebLogic Configuration Wizard ------------->
Configure Administrative Username and Password:
-------------------------------------------------

Create a user automatically assigned to the Administrative Role. This
user is the default administrator used to start development mode servers.

               Name                            Value
  1        User Name *                       weblogic
  2       User Password *                    ********
  3   Confirm User Password *
  4        Description         This user is the default administrator.

  Select Option

      1 - Modify "User Name *"
      2 - Modify "User Password *"
      3 - Modify "Confirm User Password *"
      4 - Modify "Description *"
      5 - Discard Changes

  Enter option number to select OR [Exit][Previous][Next]> 3

<------------- BEA WebLogic Configuration Wizard ------------->
Configure Administrative Username and Password:
-------------------------------------------------

Create a user automatically assigned to the Administrative Role. This
user is the default administrator used to start development mode servers.

    "Confirm User Password *" = []
Input new Confirm User Password * OR [Exit][Reset][Accept]> <enter_password>

<------------- BEA WebLogic Configuration Wizard ------------->
Configure Administrative Username and Password:
-------------------------------------------------

Create a user automatically assigned to the Administrative Role. This
user is the default administrator used to start development mode servers.

               Name                            Value
  1        User Name *                       weblogic
  2       User Password *                    ********
  3   Confirm User Password *                ********
  4        Description         This user is the default administrator.

  Select Option

      1 - Modify "User Name *"
      2 - Modify "User Password *"
      3 - Modify "Confirm User Password *"
      4 - Modify "Description *"
      5 - Discard Changes

  Enter option number to select OR [Exit][Previous][Next]> Next

<------------- BEA WebLogic Configuration Wizard ------------->
Domain Mode Configuration:
---------------------------

Enable Development or Production Mode for this domain.

->1 Development Mode 2 Production Mode
      Enter index number to select OR [Exit][Previous][Next]> 1

<------------- BEA WebLogic Configuration Wizard -------------> Java SDK Selection: --------------------
->1|Other Java SDK Enter index number to select OR [Exit][Previous][Next]> 1
<------------- BEA WebLogic Configuration Wizard -------------> Java SDK Selection: --------------------
    "JVM Directory" = [] Input new JVM Directory OR [Exit][Previous][Next]> /sys$common/java$142
<------------- BEA WebLogic Configuration Wizard -------------> Java SDK Selection: -------------------
    "JVM Directory" = [/sys$common/java$141] Input new JVM Directory OR [Exit][Previous][Next]> Next
<------------- BEA WebLogic Configuration Wizard -------------> Select the target domain directory for this configuration: ----------------------------------------------------------
    "Target Location" = [/wldisk/bea/user_projects/domains] Input new Target Location OR [Exit][Previous][Next]> Next
NOTE: Record this Target Location for later reference.
<------------- BEA WebLogic Configuration Wizard -------------> Edit Domain Information:
           Name                            Value   1       Name *                          mydomain Enter value for "Name *" OR [Exit][Previous][Next]> Next
<------------- BEA WebLogic Configuration Wizard -------------> Creating Domain...
0%          25%          50%          75%         100% [------------|------------|------------|------------] [***************************************************] **** Domain Created Successfully! **** $

Install the domain-related command procedures. You should run this procedure for each domain you create.

$ SET DEFAULT wldisk:[bea.wls813_OpenVMS_supp]
$ @configFilesVMS domain
Install OpenVMS Command Procedures for Domains.
The BEA Configuration Wizard configures a WebLogic Server Domain. There
are additional OpenVMS Command Procedures related to this domain that
will now be installed.
Has a WebLogic Server Domain been configured (Y/N)? Y
Enter the target domain directory (e.g., wldisk:
[bea.user_projects.domains.mydomain] ?
wldisk:[bea.user_projects.domains.mydomain]
Copy command procedures to wldisk:
[bea.user_projects.domains.mydomain] (Y/N)? Y
Domain related command procedures installed.
$

Note: If you do not plan to run WebLogic Server clusters, skip step 9 and proceed to step 10.

If you plan to run WebLogic Server clusters, you must set TCP/IP quotas, which are required by the Administration Server and Managed Servers. To set such quotas, complete the following procedure:

Set the quotas as follows, for use in the current TCP/IP session:

$ TCPIP SET PROTOCOL UDP/QUOTA=SEND:65536
$ TCPIP SET PROTOCOL UDP/QUOTA=RECEIVE:65536

To modify these quotas in the permanent database so they can be used at boot time or when TCP/IP Services are restarted interactively, enter the following: $ TCPIP SET CONFIGURATION PROTOCOL UDP/QUOTA=SEND:65536 $ TCPIP SET CONFIGURATION PROTOCOL UDP/QUOTA=RECEIVE:65536

Log out of the SYSTEM account.

An evaluation license is provided with your download. Before you can use WebLogic Server for production, however, you must obtain a license from BEA. For information about obtaining a license, see "Licensing" at:

http://download.oracle.com/docs/cd/E13196_01/platform/docs81/interm/license.html
Once you have obtained your license, complete the following procedure:

Copy the new WebLogic Server license that you obtained from BEA to your WebLogic Home directory.

To install the new license, launch LicenseMerger by running the java command. For example:

$ COPY *new_license_filename* wldisk:[bea.weblogic81]
$ SET DEFAULT wldisk:[bea]
$ SET FILE/ATTRIBUTE=(RFM:STMLF) *new_license_filename*
$ java -cp ./utils/utils.jar -
_$ com.bea.plateng.common.registry.LicenseMerger -
_$ license.bea ./weblogic81/*new_license_filename*

The installation and configuration of WebLogic Server 8.1 SP3 on your HP OpenVMS 7.3-2 system are now complete.

Post-Installation Setup Instructions for WebLogic Server

This section provides instructions for the following tasks:

Starting WebLogic Server or the WebLogic Server Examples

The following procedures are working examples of how to start WebLogic Server on OpenVMS. Start the server as follows:

Choose one of the following operations and complete the instructions provided under the appropriate heading:

Start WebLogic Server interactively

Run the following commands:

$ SET DEFAULT BEA_HOME:[user_projects.domains.mydomain] $ @startWebLogic

When prompted, enter the required information:

Enter the WebLogic Server username: Enter the Weblogic Server password:

Note: Enter the same username and password you supplied during installation.

When WebLogic Server is ready to run your application, the following message is displayed:
<Notice> <WebLogicServer> <BEA-000360> <BEA-Server started in running mode>.
To access the console, open a browser and enter the following URL:
http://*node-name-here*:7001/console

During the startup process, a startwls_environment.log is created in the directory.

Start WebLogic Server in detached mode

Running WebLogic Server in DETACHED mode requires a boot identity file named boot.properties. If the file does not already exist, you must create it as per the instructions in the WebLogic Server Administration Console Online Help (http://download.oracle.com/docs/cd/E13222_01/wls/docs81/ConsoleHelp/index.html). Subsequent server sessions use the encrypted version of the file when starting in DETACHED mode.

WebLogic Server encrypts the boot.properties file you manually created and writes an encrypted version of that file to the disk when the server is started and is in running mode. Manually purge the original file (containing clear text) from the server's root directory for security purposes:
$ PURGE BEA_HOME:[user_projects.domains.mydomain]boot.properties
To run detached from the bea account:
$ SUBMIT - _$ BEA_HOME:[user_projects.domains.mydomain]- _$ startWebLogicDetached.com$
To run detached from an alternate account (such as SYSTEM):
$ SUBMIT -_$ /USER=bea wldisk:[bea.user_projects.domains.mydomain] -_$startWebLogicDetached.com$
Use of the /USER qualifier requires CMKRNL (change mode to kernel) privilege and read (R) and write (W) access to the user authorization file (UAF).

WebLogic Server is ready to run your application when the following message can be read in startWebLogicDetached.log:

<Notice> <WebLogicServer> <BEA-000360> <BEA-Server started in running mode>.
To access the console, invoke http://*node-name-here*:7001/console from your browser.

During startup, a file called startwls_environment.log is produced in the BEA_HOME:[user_projects.domains.mydomain] directory.

Start the MedRec Server application

Avitek Medical Records (MedRec) is a sample WebLogic Server application suite that concisely demonstrates all aspects of the J2EE platform.

Note: The default username (weblogic) and password (weblogic) are specified in the startMedRecServer.com command procedure. If necessary you may edit this file to change the username or password. Running the MedRec sample is a good way to verify that your installation is complete.

Note: The MedRec Server application accesses the internet. If your server requires a proxy to access the internet, edit the startMedRecServer.com command procedure to set -Dhttp.proxyHost and -Dhttp.proxyPort.
$SET DEFAULT WL_HOME:[samples.domains.medrec]$ @startMedRecServer
Using Internet Explorer, access the MedRec application via: http://*node-name-here*:7001/index.jsp
During startup a file called startwls_environment.log is produced in the directory.

Start the Examples Server

WebLogic Server Examples demonstrate a variety of tasks using WebLogic Server.
$SET DEFAULT WL_HOME:[samples.domains.examples]$ @startExamplesServer
Then, using Internet Explorer, access the example applications via:

http://*node-name-here*:7001/examplesWebApp/index.jsp
Note: The default username (weblogic) and password (weblogic) can be modified by editing the startExamplesServer.com command procedure. Running additional examples is a good way to learn more about using WebLogic Server.
During startup, a file called startwls_environment.log is produced in the directory.

Shutting Down WebLogic Server

To shut down WebLogic Server, run the stopWebLogic.com command (which is supplied with WebLogic Server):

$ @wldisk:[bea.weblogic81]stopWebLogic.com

With this command, you may supply the following arguments, either interactively or as parameters on the command line:

Port number
WebLogic Server username
WebLogic Server password
Confirmation to proceed (Yes/No or Y/N)

Because the username and password are case sensitive, be sure to use quotes around these arguments when supplying them interactively. For example:

7001 "username" "password" Y

Configuring the WebLogic Server Node Manager

Note: For an overview of the WebLogic Server Node Manager, see
http://download.oracle.com/docs/cd/E13222_01/wls/docs81/adminguide/nodemgr.html

If your deployment of WebLogic Server requires that you start and stop Managed Servers from the WebLogic Server Administration Console, complete the following procedure:

In a text editor:

Open WL_HOME:[server.bin]startNodeManager.com and modify the weblogic.ListenAddress with the IP address of the system on which the Node Manager will run. For example:

Before: $ WRITE COMMAND "-Dweblogic.ListenAddress=a.b.c.d"
After: $ WRITE COMMAND "-Dweblogic.ListenAddress=11.22.33.44"

Open WL_HOME:[common.nodemanager.config]nodemanager.hosts, and add the IP address of the Administration Server to the end of the file. For example:

# localhost, loopback
localhost
127.0.0.1 
22.33.44.55

Open WL_HOME:[common.nodemanager]startWLSNm.com and find the following text:

$ mypid = F$GETJPI("","PID")
$ myname = "WLS_" + "''mypid'"
$ SET PROCESS/NAME='myname'
$ java -"V" WL_HOME:[common.nodemanager]nmparams.dat
$ EXIT

Add the text shown in bold: $ servername = F$GETJPI("","PRCNAM") $ mypid = F$GETJPI("","PID") $ myname = "WLS_" + "''mypid'" $ SET PROCESS/NAME='myname' $ java -"V" WL_HOME:[common.nodemanager]nmparams_'servername'.dat $ EXIT

Start the Node Manager:

$ SET DEFAULT WL_HOME:[server.bin]
$ @startNodeManagerProcess

A process called WLS_NODEMANAGER is created on port 5555.

When the Node Manager process is running, invoke the WebLogic Server Administration Console and follow the instructions for two tasks:

Configure a Machine to Use Node Manager
Configure Startup Arguments for Managed Servers

The instructions for both tasks are available at http://download.oracle.com/docs/cd/E13222_01/wls/docs81/adminguide/nodemgr.html

Now you can use the Node Manager to start and stop Managed Servers from the WebLogic Server Administration Console.

Building Examples with Ant

Set up the Examples environment:

$ @WL_HOME:[samples.domains.examples]setExamplesEnv.com $ SET DEFAULT WL_HOME:[samples.server.examples.src.examples.jndi]

To build the example, enter the following command:

$ java org.apache.tools.ant.Main

Instructions for Upgrading WebLogic Server 8.1 SP1 to 8.1 SP3

To upgrade your WebLogic Server installation from 8.1 SP1 to 8.1 SP3, complete the following procedure:

Back up your existing WebLogic Server 8.1 SP1 installation.

Note: Once you start the upgrade, you cannot revert to SP1. The only way you can revert to SP1 is by restoring from your backup.

Download the upgrade installer (pj_server813_upgrade_generic.jar) from the BEA Customer Support Web site at http://support.bea.com.

Upgrade your operating system and SDK:

Back up your existing operating system environment (OpenVMS 7.3-1).

Upgrade the operating system from OpenVMS 7.3-1 to OpenVMS 7.3-2. (OpenVMS 7.3-2 is required for the 1.4.2_04 SDK.)

Upgrade your SDK to Java 1.4.2_04 from the following download site: http://h18012.www1.hp.com/java/download/index.html

Apply the required Java Software Patches (ECOs) listed on the Java Patch Installation Page:

http://h18012.www1.hp.com/java/download/ovms/1.4.2/sdk1.4.2_patches.html

Upgrade WebLogic Server 8.1 SP1 to WebLogic Server 8.1 SP3:

Complete the tasks described in Preparing Your System.

From the SYSTEM account, set up your environment for the upgrade process:

$ SET PROCESS/PARSE_STYLE=EXTENDED 
$ DEFINE DECC$ARGV_PARSE_STYLE ENABLE 
$ DEFINE DECC$EFS_CASE_PRESERVE ENABLE 
$ @SYS$COMMON:[JAVA$142.COM]JAVA$142_SETUP.COM FAST 
$ DEFINE DECC$READDIR_DROPDOTNOTYPE ENABLE 
$ DEFINE DECC$EFS_CHARSET ENABLE 
$ DEFINE JAVA$CLASSPATH [] 
$ DEFINE JAVA$CREATE_DIR_WITH_OWNER_DELETE TRUE
$ DEFINE JAVA$DELETE_ALL_VERSIONS TRUE
$ DEFINE JAVA$DISABLE_JAVA_FCNTL_LOCKS TRUE
$ DEFINE JAVA$FILENAME_CONTROLS 8
$ DEFINE JAVA$FILE_OPEN_MODE 3
$ DEFINE JAVA$FORK_SUPPORT_CHDIR TRUE
$ DEFINE JAVA$FSYNC_INTERVAL 5
$ DEFINE JAVA$RENAME_ALL_VERSIONS TRUE
$ DEFINE JAVA$TIMED_READ_USE_QIO TRUE
$ DEFINE SYS$SCRATCH 'F$ENVIRONMENT("DEFAULT")

To perform the upgrade, enter the following command:

$ java -jar <directory>pj_server813_upgrade_generic.jar -mode=console

Install the WebLogic Server 8.1 SP3 supplemental JAR file:

Follow the WebLogic Server 8.1 SP3 installation instructions for downloading and expanding the OpenVMS 7.3-2 Supplementary JAR file, wls813_OpenVMS_supp.jar, which contains installation and configuration files for OpenVMS.

For each WebLogic Server domain, install domain-related command procedures via the following commands:

$ SET DEFAULT wldisk:[bea.wls813_OpenVMS_supp]
$ @configFilesVMS domain

If any of your WebLogic Server 8.1 SP1 supplemental JAR files (such as startWeblogic.com, stopWeblogic.com, and so on) are customized for your server, manually merge the custom changes into the corresponding WebLogic Server 8.1 SP3 files.

Download and Installation Instructions for WebLogic Integration

This section provides instructions for the following tasks:

Note: Review all instructions before proceeding. WebLogic Integration must be installed on an ODS-5 disk, and it must be installed together with WebLogic Server.

Preparing Your System

This section provides instructions for the following tasks:

Verifying the Prerequisites on Your System

Before you download WebLogic Integration for your system, you must make sure that in addition to the OpenVMS 7.3-2 operating system, the following required software is installed:

Java 2 SDK 1.4.2-4, including Java Fast Virtual Machine (Fast VM), available from the Java on Alpha System Version 1.4.2 Download Page:

http://h18012.www1.hp.com/java/download/ovms/1.4.2/index.html

Additional Java Software Patches (ECOs), if any, necessary for Java 2 SDK 1.4.2-4 are available from the V1.4.2 Java Patch Installation Page:

http://h18012.www1.hp.com/java/download/ovms/1.4.2/sdk1.4.2_patches.html

Required Supplemental Software

In addition to the WebLogic Integration software, you also need the OpenVMS 7.3-2 Supplementary JAR file, wli813_OpenVMS_supp.jar, which contains supplementary installation and configuration files for OpenVMS. Instructions for downloading this file are provided in Downloading the WebLogic Integration Software and Supplementary JAR File.

Note: The supplemental file contains customized command files for OpenVMS, which are automatically copied to the proper directories during installation. The following files are delivered: commEnv.com, config.com, configDB.com, configEnvVMS.com, configEnvVMS_template.dat, configFilesVMS.com, env.com, extEnv.com, login.com, parseNodeManager.exe, setEnv.com, setExamplesEnv.com, setJavaClasspath.com, setMedRecEnv.com, setWLSEnv.com, startExamplesServer.com, startManagedWebLogic.com, startMedRecServer.com, startNodeManager.com, startNodeManagerProcess.com, startWebLogic.com, startWebLogicDetached.com, startWebLogicIntegration.com, startWLI.com, startWLS.com, startWLSNm.com, stopWebLogic.com, stopWLS.com, vms_javac.com, WEBLOGIC_CUSTOMER_TABLE_Events.class, and _java.policy.

Setting Up a Disk, Directory, and Account to Run WebLogic Integration

Before you can run WebLogic Integration on OpenVMS you must set up an ODS-5 disk, and a dedicated directory and account. To do so, complete the following procedure:

Set the SYSTEM account minimum quotas to values greater than or equal to those of the bea account, as specified in Step 3 below. For installation purposes the SYSTEM account must have a minimum BYTLM of 6000000 (6M).
$ SET PROCESS /PARSE_STYLE=EXTENDED

Create or convert an ODS-5 disk, define a system logical called wldisk to reference this disk, and then mount the disk. For example:

Note: This INITIALIZE command will destroy all data on the selected drive.

$ INITIALIZE/STRUCTURE_LEVEL=5 DKA100: "wldisk"

Note: If the logical defined in the next step contains any lowercase characters, it must be enclosed in quotes. Take note of the exact syntax. You must specify the same spelling (including uppercase and lowercase distinctions) and syntax when you create the default bea directory on the ODS-5 device. This requirement also applies when you specify the default device and directory specification for the bea account in the user authorization file (UAF).
$ DEFINE/SYSTEM/EXECUTIVE_MODE/TRANSLATION_ATTRIBUTES=CONCEALED - _$ "wldisk" DKA100:
To verify the logical definition:
$ SHOW LOGICAL wldisk /FULL "wldisk" [exec] = "DKA100:" [concealed] (LNM$SYSTEM_TABLE) $ MOUNT/SYSTEM DKA100: "wldisk"
Add the DEFINE and MOUNT commands above to SYS$STARTUP:SYSTARTUP_VMS.COM.

Using AUTHORIZE, create a BEA Home account called bea.

$ SET DEFAULT SYS$SYSTEM $ RUN SYS$SYSTEM:AUTHORIZE.EXE
Set the default device to the logical name defined in the previous step. Set the directory of this account to bea:
/DEVICE="wldisk" /DIRECTORY=bea
The account must have the following minimum quotas:
/PGFLQUO=2097152 /WSDEF=8192 /WSEXTENT=32768 /WSQUO=16384 /BYTLM=400000 /FILLM=4096
The system parameter CHANNELCNT must be greater than or equal to FILLM.
Use the SYSMAN utility to examine the value of CHANNELCNT: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> PARAMETERS SHOW CHANNELCNT Parameter name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- CHANNELCNT 127 127 21 2047 Channels SYSMAN> EXIT $
To change the value of CHANNELCNT, edit the SYS$SYSTEM:MODPARAMS.DAT file and then use AUTOGEN.

$ CREATE/DIRECTORY/OWNER=BEA/VERSION=0 wldisk:[bea]

Create an additional directory on the ODS-5 disk to hold the downloaded kits, and set the owner to the bea account. For example, to name the directory wldisk:[kits], enter the following command:

$ CREATE/DIRECTORY/OWNER=BEA/VERSION=0 wldisk:[kits]

If these items are not installed yet, install them now and reboot the system. The SDK and all required patches are available from:
http://h18012.www1.hp.com/java/download/ovms/1.4.2/index.html

From the SYSTEM account, execute the following commands:

$ SET DEFAULT wldisk:[bea] $ SET PROCESS/PARSE_STYLE=EXTENDED $ DEFINE DECC$ARGV_PARSE_STYLE ENABLE $ DEFINE DECC$EFS_CASE_PRESERVE ENABLE $ @SYS$COMMON:[JAVA$142.COM]JAVA$142_SETUP.COM FAST $ DEFINE DECC$READDIR_DROPDOTNOTYPE ENABLE $ DEFINE DECC$EFS_CHARSET ENABLE $ DEFINE JAVA$CLASSPATH [] $ DEFINE JAVA$CREATE_DIR_WITH_OWNER_DELETE TRUE $ DEFINE JAVA$DELETE_ALL_VERSIONS TRUE $ DEFINE JAVA$DISABLE_JAVA_FCNTL_LOCKS TRUE $ DEFINE JAVA$FILENAME_CONTROLS 8 $ DEFINE JAVA$FILE_OPEN_MODE 3 $ DEFINE JAVA$FORK_SUPPORT_CHDIR TRUE $ DEFINE JAVA$FSYNC_INTERVAL 5 $ DEFINE JAVA$RENAME_ALL_VERSIONS TRUE $ DEFINE JAVA$TIMED_READ_USE_QIO TRUE $ DEFINE SYS$SCRATCH 'F$ENVIRONMENT("DEFAULT")
Before you start running WebLogic Integration on OpenVMS, verify that the OpenVMS time zone is set correctly by running the following command:
$ @SYS$MANAGER:UTC$TIME_SETUP SHOW
For more information, see Section 6.1, "Setting Correct Time Zone Information on Your System" in the OpenVMS System Manager's Manual.

Downloading the WebLogic Integration Software and Supplementary JAR File

To download WebLogic Integration to your system, complete the following procedure:

Go to the WebLogic Integration download site:

http://commerce.bea.com/showallversions.jsp?family=WLI

Find the listings for WebLogic Integration 8.1 SP3 and select HP OpenVMS from the drop-down menu.

Download the following:

WebLogic Platform installer: pj_platform813_generic.jar
OpenVMS 7.3-2 Supplementary JAR file, wli813_OpenVMS_supp.jar, containing supplementary installation and configuration files for OpenVMS

COPY (or FTP in binary mode) the files to a convenient location, such as wldisk:[kits].

Installing WebLogic Integration 8.1 Service Pack 3

From the SYSTEM account, install the WebLogic Integration kit as follows:

Set attributes for the downloaded installer and supplemental .jar files to stream LF. For example:

$ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]pj_platform813_generic.jar $ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]wli813_OpenVMS_supp.jar

Install the WebLogic Integration kit in console mode by setting the default to wldisk:[bea] and using the java command to unpack the archive:

$ SET DEFAULT wldisk:[bea] $ java -DJAVA_HOME=/sys$common/java$142 -Djdk.check.override=true - _$ -jar /wldisk/kits/pj_platform813_generic.jar -mode=console
These command lines are based on the assumption that the .jar file resides in the wldisk:[kits] directory. If the .jar file on your system resides elsewhere, modify the java command as appropriate.

Note: This java command creates the WebLogic Integration directory structure, starting with the WebLogic directory under [bea]: that is, [bea.weblogic81]. Depending on the speed of the machine, this command may run for over 20 minutes.
While the BEA installer is running, note the pathnames of the "BEA Home Directory" and "Product Installation Directory." These directory specifications are required as input for the configuration of the WebLogic Integration environment on OpenVMS (during the execution of configEnvVMS.com).
The following code shows an example of an installation. User responses are highlighted in bold. To select [Next] at any time, press Enter.
0%..................................................100% <------------------- WebLogic Platform 8.1 SP3 -------------------> Welcome: --------
This installer will guide you through the installation of WebLogic Platform 8.1 SP3. Type "Next" or enter to proceed to the next prompt.
If you want to change data entered previously, type "Previous". You may quit the installer at any time by typing "Exit".
Enter [Exit][Next]> next


<------------------- WebLogic Platform 8.1 SP3 -------------------> BEA Systems License Agreement: -------------------------------
BEA SYSTEMS, INC. SOFTWARE LICENSE AGREEMENT
USE OF SOFTWARE ORDERED FROM BEA SYSTEMS, INC. ("BEA") IS PROVIDED ONLY UNDER LICENSE FROM BEA. PLEASE READ THE FOLLOWING LICENSE CAREFULLY AND INDICATE YOUR ACCEPTANCE BY CLICKING THE ACCEPTANCE BOX. CERTAIN CAPITALIZED TERMS ARE DEFINED IN SECTION 11.
1. LICENSE TERMS
a. Workshop Free Use. The terms of this Section 1(a) are applicable to you if you have registered as a Workshop Free customer. Subject to the terms of this Agreement, BEA grants to you a non-exclusive, non-transferable, royalty-free license to use Workshop Free solely for Development Use and Scale-Limited Personal Use for the number of users and/or developers and the number of CPU's, Servers and/or at the Sites, as specified at the time of registration. Third party software products or modules supplied by BEA, if any, may be used solely with the Software. All rights not specifically granted to you herein are retained by BEA.
b. Workshop Pro Use. The terms of this Section 1(b) are applicable to you if you have registered as a Workshop Pro customer. Subject to the terms of this Agreement, BEA grants to you a non-exclusive, non-transferable, fee-bearing
Select Option:
1 - Yes, I agree with the terms of the license 2 - No, I do not agree with the terms of the license
Enter option number to select OR [Down][Exit][Previous]> 1


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose BEA Home Directory: --------------------------
"BEA Home" = [/SYS$SYSROOT/SYSMGR/bea] Input new BEA Home OR [Exit][Previous][Next]>/wldisk/bea


<------------------- WebLogic Platform 8.1 SP3 ------------------->
Choose BEA Home Directory: --------------------------
*BEA home choice ->1 Yes, Use this BEA home directory [/wldisk/bea] 2 No, return to BEA home directory selection Enter index number to select OR [Exit][Previous][Next]> 1


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Install Type: --------------------- ->1 Complete Install the complete BEA WebLogic Platform. 2 Custom Installation Choose software components to install and perform optional configuration. Enter index number to select OR [Exit][Previous][Next]> 2


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Components to install: ------------------------------
Release 8.1.3.0 |_____WebLogic Server [1] x | |_____Server [1.1] x | |_____Server Examples [1.2] x |_____WebLogic Workshop [2] x | |_____Workshop Runtime Framework [2.1] x | |_____WebLogic Workshop Application Developer Edition [2.2] x | |_____Workshop Samples [2.3] x |_____WebLogic Integration [3] x | |_____Integration Server [3.1] x | |_____WebLogic Workshop Integration Extension [3.2] x | |_____Integration Examples [3.3] x |_____WebLogic Portal [4] x | |_____Portal Server [4.1] x | |_____WebLogic Workshop Portal Extension [4.2] x | |_____Portal Examples [4.3] x |_____Platform Samples and Utilities [5] x |_____Platform Tour [5.1] x
Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]> 1
[Note: X - means product is selected, above step de-selects all products and below steps will select required products features for Weblogic Integration installation. Please make sure that you are not selecting any other additional features as they are not supported on OpenVMS.]


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Components to install: ------------------------------
Release 8.1.3.0 |_____WebLogic Server [1] | |_____Server [1.1] | |_____Server Examples [1.2] |_____WebLogic Workshop [2] | |_____Workshop Runtime Framework [2.1] | |_____WebLogic Workshop Application Developer Edition [2.2] | |_____Workshop Samples [2.3] |_____WebLogic Integration [3] | |_____Integration Server [3.1] | |_____WebLogic Workshop Integration Extension [3.2] | |_____Integration Examples [3.3] |_____WebLogic Portal [4] | |_____Portal Server [4.1] | |_____WebLogic Workshop Portal Extension [4.2] | |_____Portal Examples [4.3] |_____Platform Samples and Utilities [5] |_____Platform Tour [5.1]
Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]> 1


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Components to install: ------------------------------
Release 8.1.3.0 |_____WebLogic Server [1] x | |_____Server [1.1] x | |_____Server Examples [1.2] x |_____WebLogic Workshop [2] | |_____Workshop Runtime Framework [2.1] | |_____WebLogic Workshop Application Developer Edition [2.2] | |_____Workshop Samples [2.3] |_____WebLogic Integration [3] | |_____Integration Server [3.1] | |_____WebLogic Workshop Integration Extension [3.2] | |_____Integration Examples [3.3] |_____WebLogic Portal [4] | |_____Portal Server [4.1] | |_____WebLogic Workshop Portal Extension [4.2] | |_____Portal Examples [4.3] |_____Platform Samples and Utilities [5] |_____Platform Tour [5.1]
Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]> 3


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Components to install: --------------------------=---
Release 8.1.3.0 |_____WebLogic Server [1] x | |_____Server [1.1] x | |_____Server Examples [1.2] x |_____WebLogic Workshop [2] x | |_____Workshop Runtime Framework [2.1] x | |_____WebLogic Workshop Application Developer Edition [2.2] x | |_____Workshop Samples [2.3] |_____WebLogic Integration [3] x | |_____Integration Server [3.1] x | |_____WebLogic Workshop Integration Extension [3.2] x | |_____Integration Examples [3.3] x |_____WebLogic Portal [4] | |_____Portal Server [4.1] | |_____WebLogic Workshop Portal Extension [4.2] | |_____Portal Examples [4.3] |_____Platform Samples and Utilities [5] |_____Platform Tour [5.1]
Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]>next


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Components to install: ------------------------------
->1 Yes, use these component selections. 2 No, return to component selection
Enter index number to select OR [Exit][Next]> 1


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Product Directory: -----------------------=--
"Product Installation Directory" = [/wldisk/bea/weblogic81] Input new Product Installation Directory OR [Exit][Previous][Next]>next


<------------------- WebLogic Platform 8.1 SP3 -------------------> Choose Product Directory: --------------------------
->1 Yes, use this product directory [/wldisk/bea/weblogic81] 2 No, select another product directory
Enter index number to select OR [Exit][Next]> 1


<------------------- WebLogic Platform 8.1 SP3 ------------------->
Installing files. . .

0% 25% 50% 75% 100% [------------|------------|------------|------------] [***************************************************]
<------------------- WebLogic Platform 8.1 SP3 -------------------> Installation Complete
Congratulations! WebLogic Platform 8.1 SP3 has been successfully installed to /wldisk/bea/weblogic81.
Press any key to continue OR [Exit]> Exit


<------------------- WebLogic Platform 8.1 SP3 -------------------> Clean up process in progress ... $

(optional) In the login directory for the account running WebLogic Platform, delete temporary directories with similar names that contain special characters, such as bea16107^.tmp.DIR;1. These directories were created during the installation process; they are no longer needed by WebLogic Platform.

Use the jar command to unpack the contents of the OpenVMS command procedures file wli813_OpenVMS_supp.jar. This file is the one you copied, earlier, into a convenient location, such as wldisk:[kits].

$ CREATE/DIRECTORY wldisk:[bea.wli813_OpenVMS_supp] $ SET DEFAULT wldisk:[bea.wli813_OpenVMS_supp] $ jar xf /wldisk/kits/wli813_OpenVMS_supp.jar

Log out of the SYSTEM account.

Run the following command procedure to configure the WebLogic Platform environment on OpenVMS:

$ SET DEFAULT wldisk:[bea.wli813_OpenVMS_supp]
$ @configEnvVMS
Configure BEA WebLogic Platform Environment
Enter the BEA Home Directory (e.g., wldisk:[bea])? wldisk:[bea]
Enter the BEA WebLogic Product Directory (e.g., wldisk:[bea.weblogic81])? wldisk:[bea.weblogic81]
Creating WLDISK:[bea.wls813_OpenVMS_supp] setEnvVMS.com . . .
Create complete
Install OpenVMS Command Procedures.
If modifications were made to installed command procedure files on this system please save them in an alternate directory previous to running this install.
Install OpenVMS Command Procedure Files (Y/N)? Y
Installing OpenVMS Command Procedure Files...
OpenVMS Command Procedure Files installed. $

Run the BEA Configuration Wizard to configure a domain, as shown in the following example:

$ SET DEFAULT SYS$LOGIN $ @LOGIN $ SET DEFAULT WL_HOME:[common.bin] $ @config "-mode=console"


<--------------- BEA WebLogic Configuration Wizard ---------------> Create or Extend a Configuration: ----------------------------------
Choose between creating and extending a configuration. Based on your selection, the Configuration Wizard guides you through the steps to generate a new or extend an existing configuration.
->1 Create a new WebLogic configuration Start here to create a WebLogic configuration in your projects directory. 2 Extend an existing WebLogic configuration Start here to extend an existing WebLogic configuration. Use this option to add applications and services, including Database access (JDBC) and Messaging (JMS). This option also enables you to extend functionality by enabling WebLogic Workshop.
Enter index number to select OR [Exit][Next]> 1


<--------------- BEA WebLogic Configuration Wizard ---------------> Select a Domain Template: --------------------------
Please select a template from the list or select another directory of templates. * [/wldisk/bea/weblogic81/common/templates/domains]
1|WebLogic Server Examples Domain 8.1.3.0 |BEA Systems, Inc. |Create the WebLogic Server Examples domain in a directory outside |of the installed kit. The Examples domain contains a collection |of examples to show best practices for coding individual J2EE |APIs. | 2|Avitek Medical Records Sample Domain 8.1.3.0 |BEA Systems, Inc. |Create the Avitek Medical Records domain in a directory outside |of the installed kit. The Avitek Medical Records is a WebLogic |Server sample application suite that concisely demonstrates all |aspects of the J2EE platform. | ->3|Basic WebLogic Integration Domain 8.1.3.0 |BEA Systems, Inc. |Create a basic WebLogic Integration domain without installing |sample applications.Domains created from this template will |support the WebLogic Server, WebLogic Workshop, and WebLogic |Integration runtime functionality, including support for J2EE |applications, Web applications, Web Services, custom controls, |and business processes. Use domains created from this template |for the development of WebLogic Integration applications.
Enter index number to select OR [Down][Exit][Previous][Next]> 3


<--------------- BEA WebLogic Configuration Wizard ---------------> Choose Configuration Option: -----------------------------
*Do you want to run the wizard in express mode?
->1 Yes 2 No
Enter index number to select OR [Exit][Previous][Next]> 1


<--------------- BEA WebLogic Configuration Wizard ---------------> Configure Administrative Username and Password: -------------------------------------------------
Create a user automatically assigned to the Administrative Role. This user is the default administrator used to start development mode servers.
Name Value 1 *User Name: weblogic 2 *User Password: 3 *Confirm User Password: 4 Description: This user is the default administrator.
Select Option
1 - Modify "User Name" 2 - Modify "User Password" 3 - Modify "Confirm User Password" 4 - Modify "Description"
Enter option number to select OR [Exit][Previous][Next]> 2

<--------------- BEA WebLogic Configuration Wizard ---------------> Configure Administrative Username and Password: -------------------------------------------------
Create a user automatically assigned to the Administrative Role. This user is the default administrator used to start development mode servers.
"*User password:" = []
Input new *User password: OR [Exit][Reset][Accept]> weblogic


<--------------- BEA WebLogic Configuration Wizard ---------------> Configure Administrative Username and Password: -------------------------------------------------
Create a user automatically assigned to the Administrative Role. This user is the default administrator used to start development mode servers.
Name Value 1 *User Name weblogic 2 *User Password ******** 3 *Confirm User Password 4 Description This user is the default administrator.
Select Option
1 - Modify "User Name" 2 - Modify "User Password" 3 - Modify "Confirm User Password" 4 - Modify "Description" 5 - Discard Changes
Enter option number to select OR [Exit][Previous][Next]> 3


<--------------- BEA WebLogic Configuration Wizard ---------------> Configure Administrative Username and Password: -------------------------------------------------
Create a user automatically assigned to the Administrative Role. This user is the default administrator used to start development mode servers.
"*Confirm user password:" = [] Input new *Confirm user password: OR [Exit][Reset][Accept]>weblogic


<--------------- BEA WebLogic Configuration Wizard ---------------> Configure Administrative Username and Password: -------------------------------------------------
Create a user automatically assigned to the Administrative Role. This user is the default administrator used to start development mode servers.
Name Value 1 *User Name weblogic 2 *User Password ******** 3 *Confirm User Password ******** 4 Description This user is the default administrator.
Select Option
1 - Modify "User Name" 2 - Modify "User Password" 3 - Modify "Confirm User Password" 4 - Modify "Description" 5 - Discard Changes
Enter option number to select OR [Exit][Previous][Next]> next


<--------------- BEA WebLogic Configuration Wizard ---------------> Domain Mode Configuration: ---------------------------
Enable Development or Production Mode for this domain.
->1 Development Mode 2 Production Mode
Enter index number to select OR [Exit][Previous][Next]> 1


<--------------- BEA WebLogic Configuration Wizard ---------------> Java SDK Selection: --------------------
->1 Other Java SDK
Enter index number to select OR [Exit][Previous][Next]> 1


<--------------- BEA WebLogic Configuration Wizard ---------------> Java SDK Selection: -------------------
"JVM Directory" = [] Input new JVM Directory OR [Exit][Previous][Next]>/sys$common/java$142


<--------------- BEA WebLogic Configuration Wizard ---------------> Java SDK Selection: -------------------
"JVM Directory" = [/sys$common/java$142] Input new JVM Directory OR [Exit][Previous][Next]>next


<--------------- BEA WebLogic Configuration Wizard ---------------> Select the target domain directory for this configuration: ------------------------------------------------------------
"Target Location" = [/wldisk/bea/user_projects/domains] Input new Target Location OR [Exit][Previous][Next]>next


<--------------- BEA WebLogic Configuration Wizard ---------------> Select the applications directory for this configuration: -----------------------------------------------------------
"Target Location" = [/wldisk/bea/user_projects/applications] Input new Target Location OR [Exit][Previous][Next]>next


<--------------- BEA WebLogic Configuration Wizard ---------------> Edit Domain Information: -------------------------
Name Value
1 *Name: integration
Enter value for "Name" OR [Exit][Previous][Next]> next


<--------------- BEA WebLogic Configuration Wizard ---------------> Creating Domain ...
0% 25% 50% 75% 100% [------------|------------|------------|------------] [***************************************************]
**** Domain Created Successfully! **** $

Note: The preceding procedure creates a WebLogic Integration sample domain. If you wish to create a WebLogic Server domain, complete the following steps: (1) Repeat step 8, selecting 1 for "Create WebLogic Configuration." (2) Select "down" at "Select a Domain Template." (3) Select option 4 to create a "Basic WebLogic Server Domain."

Install the domain-related command procedures. You should run this procedure for each domain you create.

$ SET DEFAULT wldisk:[bea.wli813_OpenVMS_supp] $ @configFilesVMS wlidomain
Install OpenVMS Command Procedures for Domains
The BEA Configuration Wizard configures a WebLogic Integration Domain.There are additional OpenVMS Command Procedures related to this domain that will now be installed.
Has a WebLogic Integration Domain been configured (Y/N)? y
Enter the target domain directory (e.g., wldisk:[bea.user_projects.domains.integration]) ?wldisk:[bea.user_projects.domains.integration] Copy command procedures to wldisk:[bea.user_projects.domains.integration] (Y/N)? y%COPY-S-COPIED, WLDISK:[BEA.WLI813_OPENVMS_SUPP]startWebLogicIntegration.com;1 copied to WLDISK:[bea.user_projects.domains.integration]startWebLogicIntegration.com;1 (6 blocks)
Domain related command procedures installed. $

Note: If you configured a Weblogic Server Domain during step 8, you also need to configure the command files for the domain. Follow step 9, substituting "wlsdomain" for "wlidomain." For example: $ @configFilesVMS wlsdomain

If you plan to run WebLogic Server clusters you must set TCP/IP quotas, which are required by the Administration Server and Managed Servers. If you do not plan to run WebLogic Server clusters, skip this step and proceed to the next.

To set TCP/IP quotas, complete the following procedure:

Set the quotas as follows for use in the current TCP/IP session:

$ TCPIP SET PROTOCOL UDP/QUOTA=SEND:65536 $ TCPIP SET PROTOCOL UDP/QUOTA=RECEIVE:65536

To modify these quotas in the permanent database so they can be used at boot time or when TCP/IP Services are restarted interactively, enter the following:

$ TCPIP SET CONFIGURATION PROTOCOL UDP/QUOTA=SEND:65536 $ TCPIP SET CONFIGURATION PROTOCOL UDP/QUOTA=RECEIVE:65536

Log out of the SYSTEM account.

An evaluation license is provided with your download. Before you can use WebLogic Integration for production, however, you must obtain a license from BEA. For information about obtaining a license, see "Licensing" at:

http://download.oracle.com/docs/cd/E13196_01/platform/docs81/interm/license.html
Once you have obtained your license, complete the following procedure:

Copy the new WebLogic Server license that you obtained from BEA to your WebLogic Home directory.

To install the new license, launch LicenseMerger by running the java command. For example:

$ COPY *new_license_filename* wldisk:[bea.weblogic81] $ SET DEFAULT wldisk:[bea] $ SET FILE/ATTRIBUTE=(RFM:STMLF) *new_license_filename* $ java -cp ./utils/utils.jar - _$ com.bea.plateng.common.registry.LicenseMerger - _$ license.bea ./weblogic81/*new_license_filename*

The installation and configuration of WebLogic Integration 8.1 SP3 on your HP OpenVMS 7.3-2 system are now complete.

Post-Installation Setup Instructions for WebLogic Integration

This section provides instructions for the following tasks:

Starting a WebLogic Integration Domain or the WebLogic Integration Examples

The procedures provided in this section are working examples of how to start WebLogic Integration on OpenVMS:

Choose one of the following operations and complete the procedure under the appropriate heading:

Start a WebLogic Integration Domain Interactively

Enter the following commands and, when prompted, enter your username and password:

$ SET DEFAULT wldisk:[bea.user_projects.domains.integration] $ @startWebLogicIntegration Enter the WebLogic Server username: Enter the Weblogic Server password:

Note: Enter the username and password you supplied during installation.

WebLogic Integration is ready to run your application when the following message is displayed:

<Notice> <WebLogicServer> <BEA-000360> <BEA-Server started in running mode>.
To access the console, invoke http://*node-name-here*:7001/wlai from your browser.

During startup a startwli_environment.log is produced in the directory.

Start the WebLogic Integration Examples Server

Enter the following commands and, when prompted, enter your username and password:

$ SET DEFAULT wldisk:[bea.weblogic81.samples.domains.integration] $ @startWebLogicIntegration Enter the WebLogic Server username: Enter the Weblogic Server password:

To access the console, invoke http://*node-name-here*:7001/wlai from your browser.

Starting a WebLogic Server Domain or the WebLogic Server Examples

If you have already configured a WebLogic Server domain, using the previous steps, and you now want to know how to work with your WebLogic Server domain or the WebLogic Server examples, go to Starting WebLogic Server or the WebLogic Server Examples.