[an error occurred while processing this directive]

HP OpenVMS Systems

Content starts here

HP Advanced Server for OpenVMS
Server Installation and Configuration Guide


Previous Contents Index

3.12 Next Steps

You can start the Advanced Server automatically as part of the configuration procedure.

If you are ready to start the server, see Chapter 5, After You Install the Advanced Server, for instructions.


Chapter 4
Configuring and Starting the Standalone License Server

The License Server is a software program that you can run on an OpenVMS system to grant licenses to clients.

This chapter describes how to configure and start the standalone License Server, and consists of the following sections:

4.1 About the License Server

The Advanced Server for OpenVMS License Server can provide license verification for clients requiring access to PATHWORKS (LAN Manager) servers, PATHWORKS for OpenVMS (Advanced Server) servers, and Advanced Server for OpenVMS servers.

The License Server is required for client-based licensing. If you are using server-based licensing, you do not have to run the License Server.

Each LAN needs only one License Server to support client-based licenses. The same License Server can manage licenses for client access to any of the following types of file servers:

  • PATHWORKS V5 for OpenVMS (LAN Manager)
  • PATHWORKS V6 for OpenVMS (Advanced Server)
  • Advanced Server for OpenVMS

The License Server included with Advanced Server for OpenVMS will not issue or manage PATHWORKS for OpenVMS (NetWare) licenses. If you have clients using NetWare networking software, maintain the existing version of the License Server on a different system from the one that is running the Advanced Server.

You can install the License Server:

  • Separately from the Advanced Server
  • In conjunction with the Advanced Server

HP recommends that you install the License Server on a designated OpenVMS system without the Advanced Server. Therefore, the Advanced Server for OpenVMS kit allows you to install the standalone License Server separately from the file server. Alternatively, you can run the License Server on an OpenVMS Cluster with the Advanced Server, where cluster failover provides reliability. (You can also run the License Server on an OpenVMS Cluster without the Advanced Server.)

In an OpenVMS Cluster, the PAKs must be loaded into a shared license database. For detailed information on managing licenses, refer to the HP Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses.

4.2 Before You Begin to Configure the Standalone License Server

You install the standalone License Server from the same software kit that you use to install the Advanced Server. The procedures are described in Chapter 2, Installing Advanced Server for OpenVMS Software.

4.3 Configuring the Standalone License Server

You must configure the standalone License Server to provide licenses to clients in the LAN. Therefore, you select the appropriate transports used by the clients. You can configure the License Server to use the following transports:

  • DECnet
  • NetBEUI
  • TCP/IP

Because the License Server supports all these types of transports, the startup and shutdown procedures have been carefully designed to prevent unexpected interruptions in service. You can start and shut down the License Server using the file server command procedures PWRK$STARTUP.COM and PWRK$SHUTDOWN.COM. For more information on starting a standalone License Server, see Section 4.6, How to Start the Standalone License Server.

The following table shows details about the PWRK$STARTUP.COM procedure:

If the following is configured Then the following is started
DECnet DECnet transport
NetBEUI NetBEUI transport
TCP/IP TCP/IP transport
DECnet DECnet transport for Advanced Server mail notification
License Server License Server component

4.4 Configuring the Transports

The following section describes how to use the configuration command procedure to configure the transports for the standalone License Server.

After the installation procedure completes, the OpenVMS system prompt ($) is displayed. If the system was rebooted following installation:

  1. Ensure that you are logged in to the SYSTEM account.
  2. Start the configuration procedure by entering:


    $ @SYS$UPDATE:PWRK$CONFIG
    
  3. Respond to the configuration prompts.

4.5 How to Respond to License Server Configuration Prompts

Table 4-1, License Server Configuration Prompts, tells you how to respond to the prompts displayed by PWRK$CONFIG when you configure the standalone License Server.

Note

Table 4-1 shows only the prompts that PWRK$CONFIG displays; it does not show any informational messages. For a complete sample configuration script, see Appendix C, Sample Standalone License Server Installation and Configuration.

Table 4-1 License Server Configuration Prompts
Prompt Desired Outcome How to Respond
Enter disk device name where the Advanced Server data files will be stored [ default_device]: Copy the server on-disk structure to the default OpenVMS disk device displayed; you need 5,000 free blocks of disk space to store these data files.

(If you ran PWRK$CONFIG previously, the default disk device is the one you specified the last time you configured the server.)

[Return]
  Copy the Advanced Server on-disk structure to an OpenVMS disk device different from the default displayed device_name
     
Do you want to serve client-based licenses over DECnet [YES]: 1 Allow licenses to be served over DECnet [Return]
  Not allow licenses to be served over DECnet NO
     
Do you want to serve client-based licenses over NetBEUI [NO]: 1 Allow licenses to be served over NetBEUI YES
  Not allow licenses to be served over NetBEUI [Return]
     
Do you want to serve client-based licenses over TCP/IP [NO]: 1 Allow licenses to be served over TCP/IP YES
  Not allow licenses to be served over TCP/IP [Return]
     
Do you want to start the Advanced Server License Server now [YES]: Start the server automatically after the configuration procedure completes [Return]
  Complete the configuration procedure without starting the server NO

1Default answers may differ if you ran the License Server configuration procedure previously.

4.6 How to Start the Standalone License Server

You can start the License Server in any of the following ways:

4.6.1 How to Start the License Server Manually

If you did not start the License Server during the configuration procedure, you can start it manually using the following command:


$ @SYS$STARTUP:PWRK$STARTUP [Return]

The License Server will use DECnet, NetBEUI, TCP/IP.
Process NETBIOS created with identification 0000011E
Process PWRK$NBDAEMON created with identification 00000120
Process PWRK$KNBDAEMON created with identification 00000122
Process PWRK$LICENSE_S created with identification 00000124
$

4.6.2 How to Start the License Server Automatically

To make sure that the License Server starts automatically each time you boot your OpenVMS system:

  1. Edit the system startup file, SYS$STARTUP:SYSTARTUP_VMS.COM.
  2. Add the startup command, as shown in the following example. Add the command to the file below all lines that start network transports. The following example shows how to edit the file.


    $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE") .NES. ""
    $ THEN @SYS$MANAGER:STARTNET
    $ ENDIF
    .
    .
    .
    
    $ @SYS$STARTUP:PWRK$STARTUP
    

4.6.3 How to Start the License Server in an OpenVMS Cluster

If you installed and configured the License Server on multiple members of the same OpenVMS Cluster, HP suggests that you use the SYSMAN utility to start the server manually and simultaneously on all cluster members. To do so:

  1. Make sure that you are logged in to the SYSTEM account on one of the nodes in the OpenVMS Cluster.
  2. Start the SYSMAN utility by entering:


    $ RUN SYS$SYSTEM:SYSMAN
    
  3. Define all the cluster members on which you want to start the standalone License Server. For example, if you want to start the License Server on nodes SPEEDY, SPIN, and SPAN, enter the following at the SYSMAN> prompt:


    SYSMAN> SET ENVIRONMENT/NODE=(SPEEDY,SPIN,SPAN)
    
  4. Start the License Server on the nodes you defined. At the SYSMAN> prompt, enter the following command:


    SYSMAN> DO @SYS$STARTUP:PWRK$STARTUP
    


Chapter 5
After You Install the Advanced Server

This chapter describes tasks you can perform after you install the Advanced Server and consists of the following sections:

5.1 Before You Begin Postinstallation Tasks

Before you start the Advanced Server, make sure you have:

5.2 Verifying the Advanced Server Installation

If the installation verification procedure (IVP) did not run when you installed the Advanced Server, you can run it now (or anytime later) to make sure that the server installed successfully. (When you specify the /NOTEST qualifier with the PRODUCT INSTALL command, the IVP procedure does not run.)

To run the IVP, enter the following command:


$ @SYS$TEST:PWRK$PCSI_IVP

Table 5-1, IVP Indications and Steps You Should Take, indicates the steps to take according to the status of the installation indicated by IVP.

Table 5-1 IVP Indications and Steps You Should Take
Installation Status IVP Indication Steps to Take
Succeeded The message: %PWRK-I-NORMAL, IVP completed successfully
    Start the server, as described in Section 5.3, Starting the Advanced Server.
Failed An error message, followed by:
-PWRK-E-IVPFAIL, IVP has failed
    Reinstall the software, as described in Chapter 2, Installing Advanced Server for OpenVMS Software.

5.3 Starting the Advanced Server

The following sections describe when and how to start the Advanced Server (manually or automatically), and what the startup procedure does.

5.3.1 When to Start the Advanced Server

You must configure the Advanced Server before you can start it for the first time. After running the configuration procedure, you can start and stop the Advanced Server at any time.

5.3.2 What the Startup Procedure Does

The startup procedure:

  1. Checks for the required privileges
  2. Verifies that required configuration files are available
  3. Verifies that the server has been configured, and exits if it has not
  4. If a reboot is required, verifies that it was performed, and exits if it was not
  5. Loads transport drivers
  6. Installs images
  7. Starts transport support processes
  8. Starts the OpenVMS Registry Server, if necessary
  9. Starts each of the components:
    • License Registrar
    • License Server (if configured)
    • File server
  10. Records a list of all Advanced Server parameters that are set in the OpenVMS Registry (see Section 5.4.5, Determining Initial Advanced Server Parameter Values Stored in the OpenVMS Registry)

5.4 Ways to Start the Advanced Server

You can start the Advanced Server:

5.4.1 How to Start the Advanced Server Manually

If you did not start the Advanced Server during the configuration procedure, you can start it now by entering:


$ @SYS$STARTUP:PWRK$STARTUP

The Advanced Server starts, and messages similar to the following are displayed:


The file server will use DECnet, NetBEUI, TCP/IP.
Advanced Server mail notification will use DECnet.
Process NETBIOS created with identification 00000248
Process PWRK$NBDAEMON created with identification 0000024A
Process PWRK$KNBDAEMON created with identification 0000024C
Process PWRK$LICENSE_R created with identification 0000024E
Checking to see if the OpenVMS Registry Services are available...
The Advanced Server is configured to support 20 PC clients.
Process PWRK$MASTER created with identification 00000251
The master process will now start all other Advanced Server
processes.

5.4.2 How to Start the Advanced Server Automatically

To make sure that the Advanced Server starts automatically each time you boot your OpenVMS system, edit the site-specific startup file, SYS$STARTUP:SYSTARTUP_VMS.COM. Add the Advanced Server startup command to the file below all lines that start network transports. For example:


$ @SYS$STARTUP:TCPIP$STARTUP.COM
.
.
.

$ @SYS$STARTUP:PWRK$STARTUP

5.4.3 How to Start the Advanced Server in an OpenVMS Cluster

If you installed and configured the Advanced Server on multiple members of the same OpenVMS Cluster, HP recommends that you use the SYSMAN utility to start the Advanced Server manually and simultaneously on all cluster members.

To start the Advanced Server on all cluster members at the same time, make sure you are logged in to the SYSTEM account on one of the member nodes, then run SYSMAN as follows:

Enter this command... To...
$ RUN SYS$SYSTEM:SYSMAN Start the SYSMAN utility.
SYSMAN> SET ENVIRONMENT/NODE=(SPEEDY,SPIN,SPAN)
  Define the OpenVMS Cluster members on which to start the server. For example, SPEEDY, SPIN, and SPAN.
SYSMAN> DO @SYS$STARTUP:PWRK$STARTUP
  Start the Advanced Server on all the nodes you defined in the previous command.
SYSMAN> EXIT Exit the SYSMAN utility.

Note

If you are using the STARTUP feature of the SYSMAN utility to start Advanced Server, you must pass a P1 parameter of " " (null or space). For example:


SYSMAN> STARTUP ADD FILE PWRK$STARTUP.COM/PARAMETER=P1:" "

For more information on using the SYSMAN utility's STARTUP feature, refer to the OpenVMS System Management Utilities Reference Manual.

5.4.4 Troubleshooting the Startup

Some of the problems that prevent the Advanced Server from starting are discussed in the following sections:

5.4.4.1 SYLOGIN.COM Contains Commands Not Suitable for Detached Processes

Advanced Server processes are detached processes. During startup, all detached processes must execute the site-specific system login procedure (by default, SYS$MANAGER:SYLOGIN.COM).

If Advanced Server startup does not complete successfully, check the SYLOGIN.COM procedure. Make sure that only commands that should be executed by detached processes are executed during Advanced Server startup.

In SYLOGIN.COM, you can use the DCL lexical function F$MODE or F$GETJPI to conditionalize DCL commands, such as $SET TERM/INQUIRE, that should be executed only by nondetached processes, so that they are not executed during Advanced Server startup. Refer to the OpenVMS DCL Dictionary for more information.

5.4.4.2 OpenVMS Registry Services Not Available

The Advanced Server will start only if the OpenVMS registry services are available. For information about starting the Registry Server, refer to the OpenVMS System Manager's Manual or the COM, Registry, and Events for OpenVMS Developer's Guide (included in the OpenVMS Documentation CD-ROM).

If the Registry Server is started as part of Advanced Server startup, a message similar to the following is displayed by the startup procedure:


Checking to see if the OpenVMS Registry Services are available...
%RUN-S-PROC-ID, identification of created process is 0000023B

If the Registry Server cannot be started, the following message is displayed and the startup procedure is terminated:


    SYS$REGISTRY must be defined to start the VMS Registry.

%PWRK-F-NOREGISTRY, OpenVMS Registry services not configured for
this system
%PWRK-F-STARTERR, severe error encountered during start-up

    OpenVMS Registry Services are not available on this system.

    Some file server parameters are stored in the OpenVMS Registry.
    For the file server or file server utilities to be able to access
    these parameters, OpenVMS Registry Services must be available
    on this system.  Without them the file server cannot start.

$

5.4.5 Determining Initial Advanced Server Parameter Values Stored in the OpenVMS Registry

The Advanced Server startup procedure records a list of all Advanced Server parameters that are set in the OpenVMS Registry. You can use this list as a reference if you should ever need the latest parameter values. The list is stored in the following location, where nodename is the name of your server node:


PWRK$PARAMS:PWRK$REGISTRY_PARAMS_nodename.LIS

5.5 Stopping the Advanced Server

You can stop the Advanced Server at any time for any reason, which can include the following:

  • When you want to change server configuration parameters
  • As part of an orderly system shutdown
  • As needed to troubleshoot server problems

To stop the Advanced Server, enter the following command:


$ @SYS$STARTUP:PWRK$SHUTDOWN
Shutting down the currently running server(s)...

For a cluster server, enter:


$ @SYS$STARTUP:PWRK$SHUTDOWN CLUSTER

To stop the Advanced Server as part of an orderly system shutdown, add the shutdown command to the site-specific system shutdown procedure. In addition, prior to shutting down the server, announce the planned shutdown to connected users by using the ADMINISTER SEND/USERS command, as in the following example, which alerts all users connected to server WOODMAN:


LANDOFOZ\\TINMAN> SEND/USERS/SERVER=WOODMAN "Shutdown @ 1pm today!!!"


Previous Next Contents Index