HP OpenVMS systems

· Distributed NetBeans Client for OpenVMS, which is a plug-in for NetBeans 5.5.1 running on your desktop. You install the NetBeans IDE (from NetBeans.org) and the Distributed NetBeans Client for OpenVMS on your desktop system.

· IDE Server for OpenVMS, which runs on OpenVMS and provides remote services for the client plug-in. You install the IDE Server on your OpenVMS system. (You do not need to install the NetBeans for OpenVMS IDE or any additional plug-in modules on your OpenVMS system.)

Communication between the client system and the remote server system is encrypted using SSL.

How to use Distributed NetBeans is explained in the online help that is available through the NetBeans JavaHelp system when you install the NetBeans client module.

This help is fully integrated with the standard NetBeans JavaHelp and may be opened from the Help menu. (The HelpSet option in the Help menu lists installed module help files.)

JavaHelp texts may be copied and pasted into an external text editor or printed. URL links provided in JavaHelp can be copied and pasted into a browser's address field.

New Features in Version 5.5

· You are prompted for parameters before remote execution of DCL command procedures,

MMS files, Bash shell scripts, and EXE files.

· You can now re-use folders that contain an NBPROJECT subdirectory. The project that

previously referenced the NBPROJECT directory must be closed and removed from the

IDE open project cache.

New Features in Version 5.5 FT3

· NetBeans 5.5.1 is now supported.

· FT3 includes support for debugging non-Java applications (C/C++, Fortran, Pascal, COBOL, and Basic) running on the OpenVMS machine remotely from inside the NetBeans IDE.

· New features have been added to the Distributed NetBeans Client and to the IDE Server to provide better security for passwords.

· SMB file shares are now supported for the use with remote projects. The supported SMB products on the OpenVMS machine are Advanced Server and HP OpenVMS Common Internet File System (CIFS) Version 1.0, based on Samba V3.0.24. Earlier versions of Samba are not supported. The share on the remote OpenVMS machine must be a STREAM_LF share.

· Remote Execute – Foreign Command Support. The use of a foreign command is now supported for remote program execution.

· Remote Execute – Prompt for Runtime Arguments. You can have the IDE prompt for runtime arguments for remote execution of .EXE files.

· 3GL file properties support has been expanded. 3GL settings are now supported on a per file, per project, and global basis.

New Features in Version 5.5 FT2

· Sun’s C/C++ module can now be used with Distributed NetBeans. Individual file remote compilation is missing, but all other remote file options are available.

· 3GL and remote Ant compilation settings have been expanded to include "per project" settings. See the Distributed NetBeans JavaHelp for more information.

· The latest OpenVMS Java 1.5 kits are now supported.

· Improvements have been made to the Distributed menu items on the Project right-mouse click menu.

· The Distributed NetBeans plug-in now works with Mac OS.

· Problem with the Distributed NetBeans plug-in on Linux have been fixed.

· Extra source directories in a project are now supported during initial remote project conversion.

1 Before Installing Distributed NetBeans

Hardware Prerequisites - Client

For NetBeans IDE desktop system hardware and software prerequisites, see the Readme file at http://www.netbeans.org/community/releases/55/1/relnotes.html#SystemRequirements.

Hardware Prerequisites - IDE Server

The Distributed NetBeans IDE Server requires the following:

» 500MHz minimum Alpha or I64 processor

» 256MB of memory

» 2000 blocks minimum free disk space on your system disk

» ODS-5 or ODS-2 disk (ODS-5 is required to use the Java SDK with Distributed NetBeans)

Software Prerequisites - Client

» NetBeans 5.5.1 (from NetBeans.org) running on your desktop system

» Java Standard Edition v 1.4.2-07 or higher (Note: JSE v 1.6-04 is not supported.)
(from http://developers.sun.com/downloads/ running on your desktop system)

» (Optional) X Windows Server (such as eXcursion) running on your desktop system

Note Distributed NetBeans 5.0 FT2 for OpenVMS was the last release on which NetBeans 5.0 is supported.

An X Windows Server is required to run remote Java applications that use Swing, and to use some of the features of the Distributed NetBeans Client (such as "Use XTerm for Compile" and "Use XTerm for Execution").

Software Prerequisites - IDE Server on OpenVMS Alpha

» OpenVMS Alpha Version 8.2 or higher
» Software Development Kit (SDK) v 1.4.2-7 (or higher) for OpenVMS Alpha

for the Java Platform

» All required ECOs for the Java SDK

» Required Debug ECOs (See Remote 3GL Debug Notes)

» HP TCP/IP Services for OpenVMS Version 5.4 ECO 4 or higher

» FTP Service in TCP/IP Services for OpenVMS enabled and started (see FTP Notes)

» (Optional) BASIC, C/C++, FORTRAN, COBOL, or PASCAL compiler for OpenVMS

Software Prerequisites - IDE Server on OpenVMS I64

» OpenVMS I64 Version 8.2 or higher
» Software Development Kit (SDK) v 1.4.2-7 (or higher) for OpenVMS I64

for the Java Platform

» All required ECOs for the Java SDK

» Required Debug ECOs (See Remote 3GL Debug Notes)

» HP TCP/IP Services for OpenVMS Version 5.5 or higher

» FTP Service in TCP/IP Services for OpenVMS enabled and started (see FTP Notes)

» (Optional) BASIC, C/C++, FORTRAN, COBOL, or PASCAL compiler for OpenVMS

FTP Notes

Before you can use the FTP as your remote file access provider in Distributed NetBeans, the TCP/IP FTP Service must be enabled and started. Enter the following command:

$ @SYS$MANAGER:TCPIP$CONFIG

select 3 - Server components

select 5 - FTP

select 2 - Enable and Start

See HP TCP/IP Services for OpenVMS Installation and Configuration for more information.

Remote 3GL Debug Notes

For Remote 3GL Debug support, the following kits are required:

For OpenVMS Alpha:

· VMS82A_DEBUG-V0200 or later (for V8.2)

· VMS83A_DEBUG-V0100 or later (for V8.3)

· ACRTL Facility Patch Kit VMS83A_ACRTL-v0400 (for V8.3)

For OpenVMS I64:

· VMS821I_DEBUG-V0300 or later (for V8.2)

· VMS83I_DEBUG-V0100 or later (for V8.3)

· Version 8.3-1H1 does not require an ECO kit.

2 Downloading and Installing Distributed NetBeans

Downloading the NetBeans Client and IDE Server Kits

Point your browser to the Distributed NetBeans for OpenVMS download page.

Save the IDE Server file HP-xxxVMS-IDESERVER-V0505--1.PCSI_xxxEXE (where xxx is AXP or I64) to any location accessible to the OpenVMS system on which you will install the IDE Server. If applicable, copy or FTP the file(s) to the OpenVMS system.

Expand the IDE Server file by entering:

$ RUN HP-AXPVMS-IDESERVER-V0505--1.PCSI_AXPEXE ! for OpenVMS Alpha

$ RUN HP-I64VMS-IDESERVER-V0505--1.PCSI_I64EXE ! for OpenVMS I64

The file expands to HP-xxxVMS-IDESERVER-V0505--1.PCSI$COMPRESSED.

Save the NetBeans client to your desktop system:

distnbopenvms55_v55_100.nbm for NetBeans 5.5.1.

Note: The downloaded .nbm file must have an extension of nbm. The case must match exactly. The downloaded file should be named distnbopenvms55_v55_100.nbm.

Installing the NetBeans Client Kit

You must have NetBeans 5.5.1 (from NetBeans.org) installed on your desktop system before you install the Distributed NetBeans for OpenVMS client.

To install the Distributed NetBeans client, perform the following steps.

1. Save the client module to a folder on your desktop system. (The client module is available from the Distributed NetBeans download page on the Distributed NetBeans web site.)

2. Start NetBeans on your desktop system.

3. Open the NetBeans Update Center wizard (choose Update Center from the Tools menu).

4. Select the Install Manually Downloaded Modules option.

5. Follow the instructions on the wizard for completing the installation.

6. After clicking Finish, if you are prompted to restart NetBeans, you must choose Restart the IDE to complete installation of the module.

The Distributed NetBeans client module contains support for the following features on OpenVMS.

• Distributed OpenVMS File Access

• Distributed BASIC Support for OpenVMS

• Distributed C/C++ Support for OpenVMS

• Distributed COBOL Support for OpenVMS

• Distributed FORTRAN Support for OpenVMS

• Distributed PASCAL Support for OpenVMS

• Distributed DCL Support for OpenVMS

• EDTkeypad Support (disabled by default)

To enable EDTkeypad support, from the Tools menu, select Options, the press the keymap button on the left. Select edtkeypad from the Profile: drop down menu. The Distributed Client can be disabled or uninstalled, or both, from the Module Manager on the Tools menu.

Installing the IDE Server Kit

$ PRODUCT INSTALL IDESERVER

Install the server .PCSI$COMPRESSED file by entering the following command from the SYSTEM account or another privileged account. (Do not expand the .PCSI$COMPRESSED file before installing it; PCSI installs from the compressed kit directly.)

$ PRODUCT INSTALL IDESERVER

The IDE Server is installed into SYS$COMMON by default. To specify a different installation location, use the /DESTINATION qualifier on the PRODUCT INSTALL command line, or set the PCSI$DESTINATION logical name to a different location.

Following is a sample installation of the IDE Server on OpenVMS Alpha.

$ PRODUCT INSTALL IDESERVER

The following product has been selected:

HP AXPVMS IDESERVER V5.5 Layered Product

Do you want to continue? [YES]

Configuration phase starting ...

You will be asked to choose options, if any, for each selected product and for

any products that may be installed to satisfy software dependency requirements.

HP AXPVMS IDESERVER V5.5: OpenVMS IDE Server

The IDE Server includes the JAR files for Jakarta Ant.

You must agree to the terms of the Ant license agreement

in order to use the IDE Server.

Press return to display the license

* Apache License

* Version 2.0, January 2004

* http://www.apache.org/licenses/

* ...

I have read and accept the above license.

[Y = I Accept, N = I Reject]: y

* This product does not have any configuration options.

The installation will now continue without requesting further user input.

Execution phase starting ...

The following product will be installed to destination:

HP AXPVMS IDESERVER V5.5 DISK$ALPHASYS:[VMS$COMMON.]

The following product will be removed from destination:

HP AXPVMS IDESERVER T5.5-FT3 DISK$ALPHASYS:[VMS$COMMON.]

Portion done: 0%...10%...20%...40%...50%...60%...70%...80%...90%

%PCSI-I-PRCOUTPUT, output from subprocess follows ...

%INSTALL-W-NOPREV, no previous entry exists - new entry created for JESSE$DKA0:[SYS0.SYSCOMMON.][IDE$SERVER.SYSLIB]IDE$VMS_AUTH_MOD.EXE;1

%INSTALL-W-NOPREV, no previous entry exists - new entry created for JESSE$DKA0:[SYS0.SYSCOMMON.][IDE$SERVER.SYSLIB]IDE$DBGLIBSHR.EXE;1

Portion done: 100%

The following product has been installed:

HP AXPVMS IDESERVER V5.5 Layered Product

The following product has been removed:

HP AXPVMS IDESERVER T5.5-FT3 Layered Product

HP AXPVMS IDESERVER V5.5: OpenVMS IDE Server

Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM:

@SYS$STARTUP:IDE$STARTUP.COM

Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM:

@SYS$STARTUP:IDE$SHUTDOWN.COM

ACCOUNT QUOTAS

The IDE Server requires the modifications to system parameters as follows:

System parameter CHANNELCNT must be greater than or equal to 2000

USER ACCOUNTS that will use Distributed NetBeans will require quotas as

follows in order for the IDE$USER server to start:

WSEXTENT greater than or equal to 30000

JTQUOTA greater than or equal to 60000

PGFLQUO greater than or equal to 500000

Higher values of other quotas may be required depending on the commands you

will be executing in your IDE$USER server.

KEYSTORE CONFIGURATION

The keystore for SSL uses a default account and password. If you would

like to modify these values, please see the Release Notes for information

on changing the keystore values.

3 After Installing Distributed NetBeans

Importing Settings from NetBeans 5.0 to 5.5

When you start NetBeans 5.5 for the first time, NetBeans may prompt you about whether to import user settings from NetBeans 5.0. If you answer yes, and the Distributed NetBeans V5.0 FT1 or FT2 kit was already installed in NetBeans 5.0, the import wizard will not copy the Distributed NetBeans module files into the NetBeans 5.5 new user directory. You will see errors when you attempt to open Distributed NetBeans projects.

To correct this problem, install the Distributed NetBeans V5.5 client module into NetBeans 5.5.

IDE Server Startup and Shutdown

After you install the IDE Server, add the following line to SYS$STARTUP:SYSTARTUP_VMS.COM:

$ @SYS$STARTUP:IDE$STARTUP.COM

Then add the following line to SYS$MANAGER:SYSHUTDWN.COM:

$ @SYS$STARTUP:IDE$SHUTDOWN.COM

HP OpenVMS Systems