8.1 Supported Configurations: HP OpenVMS 7.3 on Alpha
This section provides the following information:
http://h71000.www7.hp.com/
This section provides recommendations and workarounds for the following problems that occur in WebLogic Server 8.1 SP1:
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
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.
WebLogic Server 8.1 does not support any WLS native libraries. For example, there is no support for jDriver or pollmuxer.
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:
http://download.oracle.com/docs/cd/E13222_01/wls/docs81/upgrade/index.html
.XML
file that is accessed by WebLogic Server 8.1, and make the following modifications: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:Path="/WLDISK/BEA/user_projects/mydomain/applications"
To: Path="/wldisk/bea/user_projects/mydomain/applications"
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"
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.
This section provides instructions for the following tasks:
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:
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
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:
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).
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
.
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
.
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]
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:
$ 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")
$ @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.
To download WebLogic Server to your system, complete the following procedure:
From the SYSTEM
account, install the WebLogic Server kit as follows:
$ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]pj_server811_generic.jar
$ SET FILE/ATTR=(RFM=STMLF) wldisk:[kits]wls811_OpenVMS_supp.jar
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 ...
$
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
$ 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.
$
$ 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! ****
$
$ 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.
The installation and configuration of WebLogic Server 8.1 SP1 on your HP OpenVMS 7.3 system are now complete.
http://commerce.bea.com/index.jsp
OpenVMS_apache_plugins.jar
. For details, see Downloading the WebLogic Server Software and Supplementary JAR File.$ cd $WL_HOME/server/lib/openvms
$ jar -xvf OpenVMS_apache_plugins.jar
This section provides instructions for the following tasks:
The following procedures are working examples of how to start WebLogic Services on OpenVMS. Start the server as follows:
$ SET DEFAULT BEA_HOME:[user_projects.domains.mydomain]
$ @startWebLogic
<Notice> <WebLogicServer> <BEA-000360> <BEA-Server started in running mode>.
To access the console invoke http://
*node-name-here*
:7001/console
from your browser.
startwls_environment.log
is produced in the directory.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).
startWebLogicDetached.log
:<Notice> <WebLogicServer> <BEA-000360> <BEA-Server started in running mode>.
startwls_environment.log
is produced in the BEA_HOME:[user_projects.domains.mydomain]
directory.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.
$ 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
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:
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
Note: For an overview of the WebLogic Server Node Manager, seehttp://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:
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"
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:$ SET DEFAULT WL_HOME:[server.bin]
$ @startNodeManagerProcess
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.