 

NetBeansTM Version 3.6 for OpenVMS Alpha  


INSTALLATION GUIDE 


June 2004 


This document contains instructions for installing NetBeans Version 3.6 on the OpenVMS 
Alpha operating system. 


                          Operating System: OpenVMS Alpha Version 7.3-1 or higher 
                          Software Version: NetBeans Version 3.6 for OpenVMS 
       


Hewlett-Packard Development Company, L.P. 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



  

CONTENTS 
         Purpose of This Document                                                3 
                 Conventions                                                     3 
1.     SYSTEM REQUIREMENTS                                                       4 
                 Operating System                                                4 
                 Software                                                        4 
                 Hardware                                                        4 
                 Performance Recommendations                                     5 
                 Using X Window System                                           5 
2.     INSTALLATION PREREQUISITES                                                6 
                 Authorized Privileges                                           6 
                 Disk Storage Space                                              6 
                 Quotas                                                          6 
                 Backing Up Your System Disk                                     7 
3.     INSTALLING NETBEANS FOR OPENVMS                                           8 
                 1. Installing NetBeans using the PCSI installation utility      8 
                 2. NetBeans post-installation tasks                             9 
                 Running NetBeans                                               10 
                 Installing Plug-in Modules                                     10 
4.     REPORTING AND RESOLVING PROBLEMS                                         11 
        APPENDIX                                                                12 
                 A. Sample Installation                                         12 
                   Install the PCSI Kit                                         12 
                 B. Files Installed on Your System                              14 
        
 
             
  












                                                                                       2 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 




Purpose of This Document 
      This document contains instructions for installing NetBeansTM for OpenVMS on Alpha 
      systems. It is intended primarily for system administrators. General usage information is 
      contained in: 
                   NETBEANS36_RELEASE_NOTES_OPENVMS.TXT|PS|PDF|HTML 
  
Conventions 
 
      The following conventions are used in this document: 

      UPPERCASE/lowercase   	Since JavaTM is a case-sensitive language 
                                and NetBeans requires an ODS-5 disk, 
                                commands are mixed-case as required. 
      
      $                         Indicates the DCL prompt. This prompt 
                                may be different on your system. 
      
      [optional-name]           Square brackets indicate that the 
                                enclosed item is optional (unless 
                                within a file specification). 
      
      <variable-name>       	Angled brackets indicate a placeholder 
                                for a command-line option, a system- 
                                specific name, or some other variable. 
  












                                                                                              3 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



 

1. SYSTEM 
                   REQUIREMENTS 
 NetBeans for OpenVMS is available for the Alpha platform only. It requires the following 
products to be preinstalled and properly configured. 

Operating System 
 
     *  OpenVMS Alpha Version 7.3-1 or higher  

Software 
 
     *  Software Development Kit (SDK) v 1.4.2 (or higher) for the OpenVMS Alpha 
        Operating System for the JavaTM Platform (Includes Fast VM) 
 
                               Available free of charge from the 
                               Java Technology Software Download Page 
                               http://h18012.www1.hp.com/java/download/index.html 
                                For information about required operating system patches (ECOs) 
                               http://h18012.www1.hp.com/java/download/ovms/1.4.2/sdk1.4.2_patches.html 
                                
        Important: By default, NetBeans 3.6 uses Java 1.4.2 or the JVM. If you have an 
        earlier version of Java installed on your system, you must set the 
        NETBEANS$JDK_HOME logical to point to that JVM. See the Release Notes for more 
        information. 
 

Hardware 
 
     *  500MHz minimum Alpha processor  
     *  128MB minimum RAM  
     *  75,000 blocks minimum free disk space on an ODS-5 disk 
         ODS-5 Disk Required 
        NetBeans must be installed on an ODS-5 disk.  If NetBeans is installed on an ODS-2 
        disk, it will not operate properly. 
                               See the OpenVMS System Manager's Manual: 
                               Initializing a New Volume with ODS-5 Format 
                               http://h71000.www7.hp.com/doc/72final/6017/6017pro_031.html 

         The NetBeans user directory must be on an ODS-5 disk. This directory is set the first 
        time you start NetBeans. By default, the directory is automatically created by 
        NetBeans as a subdirectory under your SYS$LOGIN directory. You may specify a 
        different directory on the command line. The default is [.NETBEANS3_6] under your 
        SYS$LOGIN directory. 
 




                                                                                                     4 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



Performance Recommendations 
 
     Systems that do not meet the minimum memory requirement of 128MB per concurrent 
     NetBeans user will exhibit poor performance. 
        For best performance 
        The memory and CPU speed recommendations are: 
            *  At least 256MB of memory per concurrent user 
            *  At least a 667MHz Alpha processor 

Using X Window System 
 
        Maximum performance is obtained by using NetBeans on an OpenVMS workstation 
        without hosting the display across a local area network to another machine. Hosting 
        an X Window display on a different workstation from the OpenVMS machine running 
        NetBeans may result in performance degradation due to network traffic. 
        eXcursion Fonts 
        If you are an eXcursion user, to ensure that the appearance of the NetBeans user 
        interface is optimal, the following font sets should be installed in eXcursion: 
               Speedo 
               Type 1 
               Misc 
               100dpi 
               75dpi 
        Check their presence by opening the eXcursion Control Panel and selecting the 
        Fonts tab. 
        If one or more font sets is not present, you can reinstall eXcursion (and choose the 
        option to install all fonts) or you can do the following: 
            1.  Locate the directory location of the font sets that come with the eXcursion kit. 
            2.  Open the eXcursion Control Panel and select the Fonts tab. 
            3.  Specify the full path of each missing font set in the New Font Path 
               Elements group box and click Add.  
            4.  Once you have all five sets installed and activated, restart the eXcursion 
               server. 
        On your Alpha system, do the following: 
            1.  Copy the eXcursion font properties file to your LOGIN directory. 
               The standard location for this file is 
               SYS$COMMON:[JAVA$142.JRE.LIB]FONT_PROPERTIES.EXCURSION 
            2.  Copy it to SYS$LOGIN:FONT.PROPERTIES 
               See the SDK Release Notes for important information about Java, eXcursion, 
               and fonts. (http://h18012.www1.hp.com/java/documentation/index.html) 







                                                                                                 5 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



 

2. INSTALLATION 
                                PREREQUISITES 
 

Authorized Privileges 
 To install NetBeans for OpenVMS, you must be logged in to an account that has at least the 
following authorized privileges: 
     BYPASS* 
     CMKRNL 
     GRPNAM* 
     SYSLCK 
     SYSNAM* 
     SYSPRV 
  *These privileges must be enabled prior to beginning the installation. If these privileges 
     are authorized but not enabled by your process, you should use the following command 
     to enable them: 
           $ SET PROCESS/PRIVILEGE=<privilege_name> 
 

Disk Storage Space 
 NetBeans requirements for free disk storage space are slightly greater during installation 
than after installation: 
     Blocks Needed During Installation 90,000 
     Blocks After Installation              75,000 
 
     To determine the number of free disk blocks on the ODS-5 disk where you will be 
     installing NetBeans, enter the following command: 
        $ SHOW DEVICE <dev_name> 
        where <dev_name> is the actual device name to check. 
 

Quotas 
 The recommended minimum quotas for the account installing and using NetBeans are: 
        ASTLM            300 
        BIOLM            1024 
        BYTLM            2000000 
        DIOLM            1024 
        ENQLM            2000 
        FILLM            1000 
        JTQUOTA 60000 
        PGFLQUOTA 1500000 
        PRCLM            10 
        TQELM            400 


                                                                                                 6 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 


         WSEXTENT 524288 
 The recommended SYSGEN values are: 
          CHANNELCNT  at least 2000 
         WSMAX           at least the value of WSEXTENT 
 See NetBeans for OpenVMS Release Notes for information about performance tuning. Also 
see the SDK Release Notes. (http://h18012.www1.hp.com/java/documentation/index.html) 
 

Backing Up Your System Disk 
 
     HP recommends that you do a system disk backup before installing any software. 
     Use the backup procedures that are established at your site. For details on performing a 
     system disk backup, see the OpenVMS System Management Utilities Reference Manual 
     Chapter 7: Backup Utility. 
     http://h71000.www7.hp.com/doc/73final/6048/6048pro.html 










































                                                                                            7 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



 

3.        INSTALLING NETBEANS FOR OPENVMS 
 Before proceeding, review the installation requirements and release notes. 
1. Installing NetBeans using the PCSI installation utility 
 Important NetBeans must be installed on an ODS-5 disk to work properly. 
Be sure to specify this disk type as the destination device. 
          To initialize an ODS-5 disk, select a nonsystem disk, move all data to other disks, 
          and use the following command: 
          $ INITIALIZE /STRUCTURE_LEVEL=5 <device-name> <volume-label> 
           

Choosing an installation destination 
Before you run the PRODUCT INSTALL command, decide on the installation destination. 
There are two ways you can specify where NetBeans should be installed. The third option 
(not specifying and permitting the default installation) is valid only if SYS$SYSDEVICE is an 
ODS-5 disk. If this is not the case, you must choose the first or second option: 

             Use the /DESTINATION=<DIR_SPEC> on the installation command line. This option 
               overrides the use of the PCSI$DESTINATION logical name. 
             If you do not use the /DESTINATION=<DIR_SPEC> and do define the logical name 
               PCSI$DESTINATION, the value of this logical is used as the destination device for 
               the kit. 
             If you do not use the /DESTINATION=<DIR_SPEC> and do not define the 
               PCSI$DESTINATION logical, the kit will be installed to 
               SYS$SYSDEVICE:[VMS$COMMON.]  
 Running PRODUCT INSTALL 
To install NetBeans to either the location pointed to by PCSI$DESTINATION or the default 
location, run the command: 
       $ PRODUCT INSTALL NETBEANS36 
To install to a specified destination, run the command: 
       $ PRODUCT INSTALL NETBEANS36/DESTINATION=<ODS5$DISK>:[<DIRECTORY>] 
Respond to the PCSI installation questions. 
[See Appendix A for a representative installation procedure.] 
 Incomplete requirements 
If the installation process detects that your system does not fulfill the installation 
requirements and prerequisites, it will give you the opportunity to cancel the installation. 
For example, the following message may appear: 
          Java is either not installed on your system or its version is 


                                                                                                  8 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 


          below the minimum necessary to run NetBeans. If you choose to 
          continue the installation, NetBeans cannot be used until the 
          appropriate version of Java is installed. Terminating is 
          strongly recommended.  Do you want to terminate? [YES] 
 License Agreements 
     You must accept the license agreements, which are displayed during the installation 
     process. If you decline the agreements, the installation will terminate with no files 
     moved to the destination. 
     The following software products found in the NetBeans Build are governed by the Binary 
     Code License Agreement including its applicable Supplemental Terms and Conditions 
     ("BCL") set out in the scroll window displayed during the installation: 
                  XML Parser 1.1 (jaxp and parser) 
                  JavaHelp 2.0 
                  JavaC Compiler  
                  JavaMake 
                  J2EE Deployment APIs 1.1 
                  J2EE Management 1.0 
                  EJB Enterprise JavaBeans 2.0 
                  JMX 1.2 
                  J2EE Editor 
                  XML Resolver 1.0 
     The Ant, Crimson, Jasper, Regexp, Webserver and Xerces software products included in 
     the NetBeans Build are governed by the terms of the Apache Software License found at 
     http://www.apache.org/LICENSE.txt.  
     The Ant software product included in the NetBeans Build is governed by the terms of the 
     Apache Software License found at http://www.apache.org/licenses/LICENSE-2.0. 
     The Flute 1.1 and SAC 1.1 software products included in the NetBeans Build are 
     governed by the terms of the W3C SOFTWARE NOTICE AND LICENSE found at 
     http://www.w3.org/Consortium/Legal/copyright-software-19980720. 

     The JUnit v.3.8.x software products included in the NetBeans Build are governed by the 
     terms of the Common Public License Version 1.0 found at 
     http://www.opensource.org/licenses/cpl.php. 

     The Xalan-Java v.2.6.x (including SAX and DOM APIs) and Xerces2 Java Parser v.2.x 
     (including SAX and DOM APIs) software products included in the NetBeans Build are 
     governed by the terms of following three licenses: 

                  Apache Software License found at http://www.apache.org/LICENSE.txt 
                  DOM License found at http://www.w3.org/Consortium/Legal/copyright-software-19980720 
                  SAX License found at http://www.saxproject.org/?selected=pd 
           
     All other code is governed by the terms of the Sun Public License ("SPL"), the full text of 
     which can be found at http://www.netbeans.org/about/legal/spl.html. The source code licensed 
     by the SPL can be found at http://www.netbeans.org/. 
      

2. NetBeans post-installation tasks 
 


                                                                                                      9 



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



If you want to create a symbol so that all users on the system can simply type 
NETBEANS to start the IDE, add the following lines to SYS$MANAGER:SYLOGIN.COM: 
       $ NetBeans :== @<DEVICE>[<DIRECTORY>.BIN]RUNIDEOPENVMS.COM 
      Example: 
     
      $ NetBeans :== @EFS$:[NETBEANS36.BIN]RUNIDEOPENVMS.COM 
     
If the Java 2 SDK for OpenVMS is not installed in its default location, or if you want to use a 
version of the Java 2 SDK other than 1.4.2, define NETBEANS$JDK_HOME so NetBeans can 
find the Java directory: 
         Example: 
 
         $ DEFINE/SYSTEM NETBEANS$JDK_HOME <jdk_installation_dir> 
 
         Replace <jdk_installation_dir> with the actual location of the Java product 
         installation. Defining this logical is necessary so that NetBeans can find the Java 
         directory. 
          
 

Running NetBeans 
 Instructions for running NetBeans for OpenVMS are contained in the 
NETBEANS36_RELEASE_NOTES_OPENVMS.TXT|PS|PDF|HTML. 
See Section 3: Importing from Previous Versions for information about importing existing 
projects and settings. 
 

Installing Plug-in Modules 
 NetBeans for OpenVMS provides access to both the NetBeans Update Center and the 
NetBeans for OpenVMS Update Center. The OpenVMS Update Center contains modules that 
are designed to enhance the usability and productivity of NetBeans for OpenVMS customers. 

For installation information, see NetBeans for OpenVMS Release Notes: Downloading and 
Installing NetBeans Plug-in Modules. 
         NetBeans for OpenVMS Modules Page 
         http://h71000.www7.hp.com/openvms/products/ips/netbeans/modules.html 














                                                                                                 10



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



 

4.                REPORTING AND RESOLVING PROBLEMS 
 Support for NetBeans for OpenVMS is provided under existing OpenVMS service agreements 
through standard support channels. 
       http://www.hp.com/country/us/eng/contact_us.html 
 As an open-source application, NetBeans is also supported through peer-support channels. 
NetBeans.org is home to the NetBeans Open Source project and is the best resource for 
general support information and links to peer-support groups. 
 
             To ask questions or give feedback 
             Send your technical questions and feedback about NetBeans for OpenVMS directly to 
             the engineering team at: 
                  NetBeans@hp.com 
 
             To participate in peer groups 
             NetBeans.org provides a variety of mailing lists and newsgroups that can answer 
             most user questions. 
                  http://www.netbeans.org/community 
 
             To report bugs 
             NetBeans.org provides a bug-entering system called IssueZilla, which you can use to 
             enter and track issues. The submission form includes an operating system selection 
             field that lists OpenVMS. 
                  http://www.netbeans.org/community 
 
             General Comments and Feedback 
             If you would like to provide comments or general feedback about the e-business 
             offerings for OpenVMS Alpha, please send mail to: 
                    OpenVMS.eBusiness@hp.com  
              
 
                                                   
         

                                                                                                     11



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



 

APPENDIX 
 

A.       Sample Installation 
 The following is a representative installation of NetBeans for OpenVMS: 
Install the PCSI Kit 
 $ PRODUCT INSTALL NETBEANS36/DEST==EFS$:[000000]   
 The following product has been selected: 
    NETBEANS AXPVMS NETBEANS36 V3.6        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. 
  
NETBEANS AXPVMS NETBEANS36 V3.6: NetBeans IDE 
   .  . .   .   . .   .   [LICENSE AGREEMENTS]   .   . .   .   . .   . 
 I have read and accept the above licenses, including the Binary Code License 
and Supplemental Terms and Conditions. 
 [Y = I Accept, N = I Reject]: y   
 * This product does not have any configuration options. 
  
    ODS-5 device 
  
    NetBeans must be installed on an ODS-5 device to work properly. If 
    you have specified a non-ODS-5 device as the destination, you should 
    terminate the installation now. Then, restart the installation and 
    specify an ODS-5 device as the destination using the /DESTINATION 
    qualifier with the PRODUCT INSTALL command. 
     
    Example: $ PRODUCT INSTALL NETBEANS36 /DESTINATION=ODS5$DEV:[000000] 
     
    Do you want to continue? [YES]    
    The installation will now continue without requesting further user input. 
  
Execution phase starting ... 
 The following product will be installed to destination: 
    NETBEANS AXPVMS NETBEANS36 V3.6        ODS5$DISK:[000000.] 
  
 Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% 

                                                                             12



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 


 The following product has been installed: 
    NETBEANS AXPVMS NETBEANS36 V3.6        Layered Product 
  
NETBEANS AXPVMS NETBEANS36 V3.6: NetBeans IDE 
  
    Quotas 
  
    For NetBeans to work properly, the following system and user process 
    parameters must be set: 
     
      System parameter CHANNELCNT greater than or equal to 2000 
      Process parameter ASTLM greater than or equal to 300 
      Process parameter BIOLM greater than or equal to 1024 
      Process parameter BYTLM greater than or equal to 2000000 
      Process parameter DIOLM greater than or equal to 1024 
      Process parameter ENQLM greater than or equal to 2000 
      Process parameter FILLM greater than or equal to 1000 
      Process parameter JTQUOTA greater than or equal to 60000 
      Process parameter PGFLQUOTA greater than or equal to 1500000 
      Process parameter PRCLM greater than or equal to 10 
      Process parameter TQELM greater than or equal to 400 
      Process parameter WSEXTENT greater than or equal to 524288 
     
  
    Defining a NetBeans symbol 
  
    If desired, a symbol may be defined in the system-wide login command 
    file to start NetBeans. To do this, insert the following line in 
    SYS$MANAGER:SYLOGIN.COM: 
     
      $ NetBeans :== @<dev>:[<dir>.BIN]RUNIDEOPENVMS.COM 
     
    Where <dev> and <dir> comprise the location where NetBeans was installed. 
     
    Example: 
     
      $ NetBeans :== @EFS$:[NETBEANS36.BIN]RUNIDEOPENVMS.COM 
     
    Please refer to the release notes for additional information. 
     
    Even if you have already installed and used a previous version of NetBeans 
    for OpenVMS Alpha, please review the release notes included  
    with this release for important new information.













                                                                             13



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 


 
 

B.       Files Installed on Your System 

The following command shows the files installed by the NetBeans for OpenVMS installation: 
 
       $ PRODUCT SHOW OBJ */PRODUCT=NETBEANS36 
  





















                                                                                        14



NETBEANS VERSION 3.6 FOR OPENVMS ALPHA - INSTALLATION GUIDE 



 
 2004 Hewlett-Packard Development Company, L.P. 
NetBeans, Java, and all Java-based marks are trademarks of Sun Microsystems, Inc. in the 
U.S. and/or other countries. 
All other product names mentioned herein may be trademarks of their respective 
companies. 
Confidential computer software. Valid license from Hewlett-Packard required for possession, 
use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, 
Computer Software Documentation, and Technical Data for Commercial Items are licensed 
to the U.S. Government under vendor's standard commercial license.  
Hewlett-Packard shall not be liable for technical or editorial errors or omissions contained 
herein. The information is provided "as is" without warranty of any kind and is subject to 
change without notice. The warranties for Hewlett-Packard products are set forth in the 
express limited warranty statements accompanying such products. Nothing herein should be 
construed as constituting an additional warranty.  
             


                                                                                                 15



