8.1 Supported Configurations: HP OpenVMS 7.3 on Alpha

HP OpenVMS 7.3-1 on Alpha with WebLogic Server 8.1 SP1

 

This section provides the following information:

• Configuration Requirements
• Known Issues
• Download and Installation Instructions
• Post-Installation Setup Instructions

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 or 7.3-1 on Alpha, visit the following HP Web site: http://h71000.www7.hp.com/

 

---

Configuration Requirements

Table 2-1 Requirements for WebLogic Server 8.1 SP1 on HP OpenVMS 7.3-1 on Alpha 

Operating System Version and Patches	HP OpenVMS 7.3-1
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.1-2 JDK 1.4.1 JavaTM 2 Runtime Environment, Standard Edition Fast VM (build 1.4.1-2, build J2SDK.v.1.4.1:09/09/2003-18:43, native threads, jit_141)
Design and Development Tools	Supports WebLogic Server development tools.
RAM	512 MB required; 1 GB recommended
Performance Pack	None
Node Manager	Included	Java
BEA jDrivers for Oracle	Oracle 9.2.0 Thin Driver for Oracle 9.2.0

 

 

---

Known Issues

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

• Examples Problem
• Native Libraries Not Supported
• Upgrade Problems

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

Examples Problem

When you run WebLogic Server examples, 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

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

Upgrade Problems

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 any references to your WebLogic Server device (wldisk) that were resolved to a device specification and written in the .XML files by WebLogic 7.0 to wldisk For example:
  
From: Path="/DQA0/bea/user_projects/mydomain/applications" modified to To: Path="/wldisk/bea/user_projects/mydomain/applications"

 

---

Download and Installation Instructions

This section provides instructions for the following tasks:

• Preparing Your System
• Downloading the WebLogic Server Software and Supplementary JAR File
• Installing WebLogic Server 8.1 Service Pack 1

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
• Required Supplemental Software
• Setting Up a Disk, Directory, and Account to Run WebLogic Server

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-1 operating system, the following required software is installed:

• Java 2 SDK 1.4.1-2, including Java Fast Virtual Machine (Fast VM), available from the Java on Alpha System Version 1.4.1 Download Page, including any additional Java Software Patches (ECOs):

http://h18012.www1.hp.com/java/archive_download/index.html

Required Supplemental Software

In addition to the WebLogic Server software, you also need the OpenVMS 7.3.1 Supplementary JAR file, wls811_OpenVMS_supp.jar, which contains supplementary 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, _java.policy

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

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

Log in to the SYSTEM account.

Set the SYSTEM account minimum quotas 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 4000000 (4M).

$ 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: The following 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. Remember whether the spelling you specify includes uppercase and/or lowercase letters. You must reproduce the same spelling, including uppercase and lowercase, when you create the default bea directory on the ODS-5 device and 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 ($ RUN SYS$SYSTEM:AUTHORIZE.EXE ), create a BEA Home account called bea.

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.1-2, 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$141.COM]JAVA$141_SETUP.COM FAST 
$ DEFINE DECC$READDIR_DROPDOTNOTYPE ENABLE 
$ DEFINE DECC$EFS_CHARSET ENABLE 
$ DEFINE JAVA$CREATE_DIR_WITH_OWNER_DELETE TRUE 
$ DEFINE JAVA$DELETE_ALL_VERSIONS TRUE 
$ DEFINE JAVA$FILENAME_CONTROLS "8" 
$ DEFINE JAVA$RENAME_ALL_VERSIONS TRUE 
$ DEFINE JAVA$CLASSPATH [] 
$ 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 5.9, "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 SP1 and select HP OpenVMS from the drop-down menu.
Download the following:
• WebLogic Server installer: pj_server811_generic.jar
• OpenVMS 7.3.1 Supplementary JAR file, wls811_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 1

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_server811_generic.jar 
$ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]wls811_OpenVMS_supp.jar 

Install the WebLogic Server kit 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$141 -Djdk.check.override=true 
-jar /wldisk/kits/pj_server811_generic.jar 

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.

Unable to instantiate GUI, defaulting to console mode.
0%..................................................100%
<------------- WebLogic Server 8.1 SP1 ------------->
Welcome:

This installer will guide you through the installation of WebLogic 
Server 8.1 SP1. 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 SP1 ------------->
BEA Systems License Agreement:
BEA SYSTEMS, INC. SOFTWARE LICENSE AGREEMENT
NOTE: Please read the license agreement.
Enter [Yes][No][Exit][Previous][More]> Yes
<------------- WebLogic Server 8.1 SP1 ------------->
Choose BEA Home Directory:
--------------------------
    *BEA home choice   
   1|Create a new BEA Home [/SYS$SYSROOT/sysmgr/bea]
 ->2|Use an existing BEA Home [/wldisk/weblogic700/bea]
Enter index number to select OR [Exit][Previous][Next]> 1
<------------- WebLogic Server 8.1 SP1 ------------->
Choose BEA Home Directory:
--------------------------
    "BEA Home" = [/SYS$SYSROOT/sysmgr/bea]
Input new BEA Home OR [Exit][Previous][Next]> /wldisk/bea
<------------- WebLogic Server 8.1 SP1 ------------->
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
NOTE: Record the BEA Home directory for later reference.
<------------- WebLogic Server 8.1 SP1 ------------->
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 SP1 ------------->
Choose Product Directory:
-------------------------
    "Product Installation Directory" = [/wldisk/bea/weblogic81]
Input new Product Installation Directory OR [Exit][Previous][Next]> Next
<------------- WebLogic Server 8.1 SP1 ------------->
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]> 1
NOTE: Record the Product Installation Directory for later reference.
<------------- WebLogic Server 8.1 SP1 ------------->
Installing files..
0%           25%          50%         75%        100%
[------------|------------|------------|------------]
[***************************************************]
(NOTE: You may notice a delay at this point.  Do not abort.)
<------------- WebLogic Server 8.1 SP1 ------------->
Installation Complete
Congratulations! WebLogic Server 8.1 SP1 has been successfully installed to /wldisk/bea/weblogic81.
Press any key to continue OR [Exit]> Exit
<------------- WebLogic Server 8.1 SP1 ------------->
Clean up process in progress ...
$

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

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

Log out of the SYSTEM account.
Log in to the bea account
Run the following command procedure to configure the WebLogic Server environment on OpenVMS.

$ SET DEFAULT wldisk:[bea.wls811_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.wls811_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.0.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.0.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.0.0
    |BEA Systems, Inc.
    |Create a basic WebLogic Server domain without installing sample
    |applications.
   4|Basic WebLogic Workshop Domain 8.1.1.0
    |BEA Systems, Inc.
    |Create a basic WebLogic Workshop domain, without installing sample
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 a 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$141
<------------- 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.wls811_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:
Log in to the SYSTEM account.
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.
A one-year evaluation license is provided with your download and normal installation. To continue use of WebLogic Server beyond the initial evaluation period, you must obtain a new license from BEA. To do so, 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 SP1 on your HP OpenVMS 7.3 system are now complete.

Installing the Apache Plug-in File

Go to the BEA Downloads site:

http://commerce.bea.com/index.jsp

Download the Apache plug-in file: OpenVMS_apache_plugins.jar. For details, see Downloading the WebLogic Server Software and Supplementary JAR File.
Copy the OpenVMS_apache_plugins.jar file to $WL_HOME/server/lib/openvms.
Go to the $WL_HOME/server/lib/openvms directory:

$ cd $WL_HOME/server/lib/openvms

Extract the OpenVMS_apache_plugins.jar file to $WL_HOME/server/lib/openvms:

$ jar -xvf OpenVMS_apache_plugins.jar 

 

---

Post-Installation Setup Instructions

This section provides instructions for the following tasks:

• Starting WebLogic Server or the WebLogic Server Examples
• Shutting Down WebLogic Server
• Configuring the WebLogic Server Node Manager
• Building Examples with Ant

Starting WebLogic Server or the WebLogic Server Examples

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

Log in to the bea account.
Choose one of the following operations:

• Start WebLogic Server interactively:
• $ SET DEFAULT BEA_HOME:[user_projects.domains.mydomain]
$ @startWebLogic

Enter the WebLogic Server username:

Enter the Weblogic Server password:

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

• WebLogic Server 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/console from your browser.

• During startup a startwls_environment.log is produced 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 example 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 

Then, 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 Admin Server Console, complete the following procedure:

Log in to the bea account.
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 the WL_HOME:[common.nodemanager.config]nodemanager.hosts file in a text editor, and add the IP address of the Admin Server to the end of the file. For example:

# localhost, loopback
localhost
127.0.0.1
22.33.44.55

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 Admin Server 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 Admin Server Console.

Building Examples with Ant

Log in to the bea account.
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