2. Example Procedures

 

 

This chapter contains example procedures that show the prompts you encounter when registering the PAK and during the installation procedure. The user responses, which appear in reversed bold typeface, are provided only to illustrate how you may respond. Do not use these responses for your installation! Use the configuration information you gathered in Step 1 of Chapter 1.

Installing a License PAK

This section presents an example dialog showing how to use the VMSLICENSE REGISTER option with a PAK (Product Authorization Key).

The values shown below are only examples. When you use the VMSLICENSE REGISTER option, use the actual values provided with your PAK.

 

Note: Refer to the section in Chapter 1 titled Load the PAK (Product Authorization Key) for the procedure to use for registering the PAK on software upgrades.

 

 

Refer to the VMS License Management Utility Manual for more information about PAKs.

Registering and Loading a PAK:

$ @SYS$UPDATE:VMSLICENSE
VMS License Management Utility Options:
1. REGISTER a Product Authorization Key
2. AMEND an existing Product Authorization Key
3. CANCEL an existing Product Authorization Key
4. LIST the Product Authorization Keys
5. MODIFY an existing Product Authorization Key
6. DISABLE an existing Product Authorization Key
7. DELETE an existing Product Authorization Key
8. COPY an existing Product Authorization Key
9. MOVE an existing Product Authorization Key
10. ENABLE an existing Product Authorization Key
11. SHOW the licenses loaded on this node
12. SHOW the unit requirements for this node

 

99. EXIT this procedure

 

Type '?' at any prompt for a description of the information requested.  Press Ctrl/Z at any prompt to exit this procedure.
Enter one of the above choices [1] 1
Do you have your Product Authorization Key? [YES] RETURN

 

Use the REGISTER option to add a new license to a license database.  A Product Authorization Key (PAK) provides the product name and information you need to register the license.  You must enter all the information provided by your PAK exactly as it appears.

 

Issuer [DEC]: PROCESS SOFTWARE
Authorization Number []: B-400-17904
Product Name [ ]: MULTINET
Producer [DEC]: PROCESS SOFTWARE
Number of Units []: 100
Version []: RETURN
Product Release Date []: 23-MAR-2020
Key Termination Date []: RETURN
Availability Table Code []: F
Activity Table Code []: RETURN
Key Options []: NO_SHARE

 

This Product Authorization Key (PAK) has been provided with the NO_SHARE option.  If it is to be used by a node in a cluster, this PAK must be restricted to a specific node.

 

If this PAK is to be used by a standalone system, answer NO to the following question.

 

Is this PAK restricted to a cluster member node? [YES]: RETURN

 

Note:  For the majority of systems, the SCS node name is the same as the DECnet node name.

 

Node this PAK is restricted to (SCS Node name) []: BIGBOOTE
Product Token []: AB-400-17904
Hardware-Id []: RETURN
Checksum []: 4-IPMA-KEIL-PCOP-HNNJ

 

Here is a list of the license information just entered:

 

Issuer:  PROCESS SOFTWARE
Authorization:  B-400-17904
Producer:  PROCESS SOFTWARE
Units:  100
Release Date:  23-MAR-2020
Version:
Termination Date:
Availability:  F
Activity:
Options:  NO_SHARE
Token:  AB-400-17904
Hardware ID:
Checksum:  4-IPMA-KEIL-PCOP-HNNJ

 

This authorization key is restricted to: BIGBOOTE
Is that correct? [YES] RETURN
Do you want to LOAD this license on this system? [YES] RETURN

 

VMS License Management Utility Options:
1. REGISTER a Product Authorization Key
2. AMEND an existing Product Authorization Key
3. CANCEL an existing Product Authorization Key
4. LIST the Product Authorization Keys
5. MODIFY an existing Product Authorization Key
6. DISABLE an existing Product Authorization Key
7. DELETE an existing Product Authorization Key
8. COPY an existing Product Authorization Key
9. MOVE an existing Product Authorization Key
10.ENABLE an existing Product Authorization Key
11.SHOW the licenses loaded on this node
12.SHOW the unit requirements for this node

 

99.EXIT this procedure

 

Type '?' at any prompt for a description of the information requested.  Press Ctrl/Z at any prompt to exit this procedure.

 

Enter one of the above choices [1] 99

 

Printing the Consolidated Release Notes

The example below shows how to print the Release Notes.

 

Note: The VMSINSTALL kit has first been copied to the directory DUA0:[SWDIST].

 

 

$ @SYS$UPDATE:VMSINSTAL MULTINET056 DUA0:[SWDIST] OPTIONS N
OpenVMS AXP Software Product Installation Procedure V8.4
It is 08-MAR-2020 at 11:10.
Enter a question mark (?) at any time for help.
* Are you satisfied with the backup of your system disk [YES]? RETURN
The following products will be processed:
MULTINET V5.6
Beginning installation of MULTINET V5.6 at 11:10
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
Release notes included with this kit are always copied to SYS$HELP.
Additional Release Notes Options:
1. Display release notes
2. Print release notes
3. Both 1 and 2
4. None of the above
* Select option [2]: RETURN
* Queue name [SYS$PRINT]: SYS$PRINT
Job MULTINET056 (queue SYS$PRINT, entry 1023) started on LPA0:
* Do you want to continue the installation [NO] ? RETURN
%VMSINSTAL-I-RELMOVED, The product’s release notes have been successfully moved to SYS$HELP.
VMSINSTAL procedure done at 11:11

 

Sample Installation Dialog

This section contains two examples of MultiNet installation procedures:

·         The Sample New Installation shows a new installation from CD-ROM. (Some messages may vary with the operating system version.)

·         The Sample Upgrade Installation shows how to upgrade from an older version of MultiNet to the current release. (Some messages may vary with the operating system version.) You must reboot your system after upgrading the software.

 

 

Note: The values shown in the dialogs are samples and for illustration purposes only! When you install MultiNet, use the actual values appropriate for your system.

 

 

Sample New Installation

$ @SYS$UPDATE:VMSINSTAL MULTINET056 DKB300:[MULTINET056]
OpenVMS VAX Software Product Installation Procedure V8.4
It is 2-FEB-2020 at 14:29
Enter a question mark (?) at any time for help.
* Are you satisfied with the backup of your system disk [YES] ?
RETURN
The following products will be processed:
MULTINET V5.6
Beginning installation of MULTINET V5.6 at 14:30
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
%VMSINSTAL-I-RELMOVED, Product’s release notes have been moved to SYS$HELP.
* Where do you want to install MultiNet [SYS$SYSDEVICE:[MULTINET]]:
RETURN
* What do you want to call the system-specific directory [HOBBES]: RETURN
MultiNet  (R)
ALL RIGHTS RESERVED USER THE COPYRIGHT LAWS OF THE UNITED STATES

 

This licensed material is the valuable property of Process Software. Its use, duplication, or disclosure is subject to the restrictions set forth in the License Agreement.

 

Other use, duplication or disclosure, unless expressly provided for in the license agreement, is unlawful.

 

Installing MultiNet V5.6 Rev A
* Do you want to install the TCP/IP applications [YES]?
RETURN
* Do you want to install the SSH software [YES]? RETURN
* Do you want to install the NFS Client software [YES]? RETURN
* Do you want to install the NFS Server software [YES]? RETURN
* Do you want to install the online documentation [YES]? RETURN
  The PDF documentation requires 30,000 blocks.
* Do you want to install the include and library files [YES]?
RETURN

The MultiNet base networking software will be installed with these selected components:
* TCP/IP applications
* SSH
* NFS client
* NFS server
* Online documentation
* Include and library files
* Would you like to change your selection [NO]?
RETURN
* Do you want to install the user commands in DCLTABLES [YES]? RETURN
* Do you want to purge files replaced by this installation [YES]? RETURN
* Configure MultiNet TCP/IP after installation [NO]?
YES
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.SPOOL].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.HELP].
%VMSINSTAL-I-...This product creates... MU$SPECIFIC_ROOT:[MULTINET.LOADABLE_IMAGES].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.SPOOL].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.HELP].
%VMSINSTAL-I-...This product creates... MU$COMMON_ROOT:[MULTINET.LOADABLE_IMAGES].
The installation will now proceed with no further questions.
%VMSINSTAL-I-RESTORE, Restoring product save set B...
%VMSINSTAL-I-RESTORE, Restoring product save set C...
%MULTINET-I-INSTALLING, Installing MultiNet base files
%VMSINSTAL-I-RESTORE, Restoring product save set E...
%MULTINET-I-INSTALLING, Installing MultiNet driver files
%VMSINSTAL-I-RESTORE, Restoring product save set G...
%VMSINSTAL-I-RESTORE, Restoring product save set H...
%MULTINET-I-INSTALLING, Installing MultiNet TCP/IP application files
%VMSINSTAL-I-RESTORE, Restoring product save set J...
%VMSINSTAL-I-RESTORE, Restoring product save set K...
%MULTINET-I-INSTALLING, Installing MultiNet NFS files
%VMSINSTAL-I-RESTORE, Restoring product save set M...
%VMSINSTAL-I-RESTORE, Restoring product save set P...
%MULTINET-I-INSTALLING, Installing the online documentation files
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.DECW$BOOK].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.DECW$BOOK].
%VMSINSTAL-I-RESTORE, Restoring product save set Q...
%VMSINSTAL-I-RESTORE, Restoring product save set R...
%MULTINET-I-INSTALLING, Installing the include and library files
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.ARPA].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.NET].
%VMSINSTAL-I-...This product creates... MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.NETINET].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.NETNS].
%VMSINSTAL-I-...This product creates... MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.NETWARE].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.NFS].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.RPC].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.SYS].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.INCLUDE.VMS].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.LIBRARY].
%VMSINSTAL-I-...This product creates...MU$SPECIFIC_ROOT:[MULTINET.EXAMPLES].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.ARPA].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.NET].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.NETINET].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.NETNS].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.NETWARE].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.NFS].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.RPC].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.SYS].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.INCLUDE.VMS].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.LIBRARY].
%VMSINSTAL-I-...This product creates...MU$COMMON_ROOT:[MULTINET.EXAMPLES].

%MULTINET-I-INSTALLING, Installing MultiNet HELP library
%MULTINET-I-DELETING, Deleting obsolete MultiNet files
% VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
* System Specific directory name: [DKA500:[MULTINET.BIGBOOTE]]:
RETURN
* Enter your Internet host name: BIGBOOTE.EXAMPLE.COM
* Enter the Internet (IP) Address for interface EWA0: 10.1.2.3
* Enter the Subnet mask for interface EWA0 (optional): 255.255.255.0
Configure other network devices after installation using the $ MULTINET CONFIGURE utility.
* Enter the Internet (IP) Address of your default route (optional):
10.1.1.126
* Use Domain Nameservice instead of host tables [YES]? RETURN
* Enter your local timezone: EST
To have MultiNet start automatically when your system boots, add the following command to your system startup procedure:

$ @DISK$HOBBES:[MULTINET.BIGBOOTE.MULTINET]START_MULTINET.COM

MultiNet Network Configuration Utility V5.6 (102)
[Reading in MAXIMUM configuration from MULTINET:MULTINET.EXE]
[Reading in configuration from MULTINET:NETWORK_DEVICES.CONFIGURATION]
[Writing Startup file MULTINET:START_MULTINET.COM]

Installation of MultiNet completed at 14:49

Adding history entry in VMI$ROOT:[SYSUPD]MULTINET056.VMI_DATA

Creating installation data file: VMI$ROOT:[SYSUPD]MULTINET056

VMSINSTAL procedure done at 14:50

 

Sample Upgrade Installation:

$ @SYS$UPDATE:VMSINSTAL MULTINET056 DKB400 OPTIONS N
OpenVMS AXP Software Product Installation Procedure V8.4
It is 2-NOV-2019 at 12:12.
Enter a question mark (?) at any time for help.
* Are you satisfied with the backup of your system disk [YES]?
RETURN
The following products will be processed:
MULTINET V5.6
Beginning installation of MULTINET V5.6 at 12:12
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
%VMSINSTAL-I-RELMOVED, Product’s release notes have been moved to SYS$HELP.
The logical names MULTINET_ROOT and MULTINET_COMMON_ROOT are already defined, with the following values:
DKA100:[BOS1.][MULTINET]
DKA100:[BOS1.SYSCOMMON.][MULTINET]
You may either upgrade the version of MultiNet installed in this location, or install a fresh copy of MultiNet in another location.
* Do you want to upgrade your MultiNet installation [YES] ?
YES
MultiNet (R)
ALL RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES
This licensed material is the valuable property of Process Software. Its use, duplication, or disclosure is subject to the restrictions set forth in the License Agreement.
Other use, duplication or disclosure, unless expressly provided for in the license agreement, is unlawful.

 

Installing MultiNet V5.6
* Do you want to install the TCP/IP applications [YES]?
RETURN
* Do you want to install the SSH software [YES]?
RETURN
* Do you want to install the NFS Client software [YES]?
RETURN
* Do you want to install the NFS Server software [YES]?
RETURN
* Do you want to install the online documentation [YES]?
RETURN
* Do you want to install the include and library files [YES]?
RETURN

 

The MultiNet base networking software will be installed with these selected components:
* TCP/IP applications
* SSH
* NFS Client
* NFS Server
* Online documentation
* Include and library files
* Would you like to change your selections [NO]?
RETURN
* Do you want to install the user commands in DCLTABLES [YES]?
RETURN
* Do you want to purge files replaced by this installation [YES]?
RETURN
* Configure MultiNet TCP/IP after installation [NO]?
RETURN

 

The installation will now proceed with no further questions.
%VMSINSTAL-I-RESTORE, Restoring product save set B...
%VMSINSTAL-I-RESTORE, Restoring product save set D...
%MULTINET-I-INSTALLING, Installing MultiNet base files
%VMSINSTAL-I-RESTORE, Restoring product save set F...
%MULTINET-I-INSTALLING, Installing MultiNet driver files
%VMSINSTAL-I-RESTORE, Restoring product save set G...
%VMSINSTAL-I-RESTORE, Restoring product save set I...
%MULTINET-I-INSTALLING, Installing MultiNet TCP/IP application files
%VMSINSTAL-I-RESTORE, Restoring product save set J...
%VMSINSTAL-I-RESTORE, Restoring product save set L...
%MULTINET-I-INSTALLING, Installing MultiNet NFS files
%VMSINSTAL-I-RESTORE, Restoring product save set M...
%VMSINSTAL-I-RESTORE, Restoring product save set P...
%MULTINET-I-INSTALLING, Installing the online documentation files
%VMSINSTAL-I-RESTORE, Restoring product save set Q...
%VMSINSTAL-I-RESTORE, Restoring product save set S...
%MULTINET-I-INSTALLING, Installing the include and library files
%MULTINET-I-INSTALLING, Installing the MultiNet HELP library
%MULTINET-I-MERGING, Merging SERVICES.MASTER_SERVER file
%MULTINET-I-DELETING, Deleting obsolete MultiNet files
%VMSINSTALL-I-MOVEFILES, Files will now be moved to their target directories...

 

MultiNet Network Configuration Utility V5.6 (102)
[Reading in MAXIMUM configuration from MULTINET:MULTINET.EXE]
[Reading in configuration from MULTINET:NETWORK_DEVICES.CONFIGURATION]
[Writing Startup file MULTINET:START_MULTINET.COM]
Installation of MULTINET V5.6 completed at 12:30
Adding history entry in VMS$ROOT:[SYSUPD]VMSINSTAL.HISTORY
Creating installation data file: VMI$ROOT:[SYSUPD]MULTINET056.VMI_DATA
VMSINSTAL procedure done at 12:32

 

 

Note: Remember to reboot your system after upgrading the software.