Compaq PATHWORKS for OpenVMS
Server Installation and Configuration Guide


Previous Contents Index


Chapter 3
Configuring the PATHWORKS Advanced Server

This chapter describes how to configure the PATHWORKS Advanced Server and consists of the following sections:

3.1 About the Advanced Server Configuration Procedure

The Advanced Server initial configuration procedure, PWRK$CONFIG.COM, is installed by the PATHWORKS Advanced Server installation procedure. Like the installation procedure, the configuration procedure asks you a series of questions (by displaying prompts). The procedure uses your answers to configure the PATHWORKS Advanced Server.

You can use the PWRK$CONFIG.COM configuration procedure to reconfigure the server at any time later. Note that the script contents change after the first configuration.

3.1.1 What the Configuration Procedure Does

PWRK$CONFIG.COM is a command procedure that:

After you install the server, you must run PWRK$CONFIG.COM before you can start the server. In an OpenVMS Cluster, before you start the server on any node, you must run PWRK$CONFIG.COM on each node where you plan to run the server. Although the nodes in an OpenVMS Cluster function as a single unit in a domain, treat them as individual units for purposes of configuration.

3.2 Before You Start the Advanced Server Configuration Procedure

Before you start the PWRK$CONFIG.COM command procedure, check that the ENQLM quota system process parameter for the user account from which you will run the PWRK$CONFIG.COM procedure is set to a value of 500 or greater. For information on how to determine the current setting and how to increase the value, see Section 1.9.7, Step 7: Check ENQLM Process Quota. In addition, check the system parameters discussed in Section 1.9.6, Step 6: Check System Parameters.

Be prepared to answer the questions discussed in the following sections. The questions asked by PWRK$CONFIG.COM depend on the options you select and on such factors as server role and whether you are configuring the server to join a new or existing domain.

3.2.1 On What OpenVMS Disk Device Do You Want to Store the Advanced Server Data Files?

The data files include:

By default, the configuration procedure copies the data files to the system device (SYS$SYSDEVICE). However, you can specify any existing OpenVMS disk device that has at least 85,000 free blocks of disk space. The amount needed depends on the components installed.

When you select a disk for the Advanced Server data files, keep the following in mind:

3.2.2 Do You Want to Change the System Configuration Parameters Now?

If you respond "YES" to the prompt to change the system configuration parameters, the Configuration Manager starts. The Configuration Manager is a utility that allows you to modify and verify the system environment configuration parameter settings, such as the maximum number of clients that can connect to the server, the percentage of physical memory the server can use, and which network transports the server uses.

You can change the system configuration parameter settings after starting the Advanced Server by using the Configuration Manager (invoking the Configuration Manager with the ADMINISTER/CONFIGURATION command at the DCL prompt). For more information, refer to the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide. Section B.2, Sample Server Configuration, shows the basic Configuration Manager screen displayed when you opt to change the system configuration parameter settings during use of PWRK$CONFIG.COM.

3.2.2.1 Configuring Transports for a Backup Domain Controller or Member Server

If you are configuring a server as a backup domain controller (BDC) or a member server, you must select at least one transport that is also used by the primary domain controller (PDC). Otherwise, the configuration will fail.

When you select the transports to run on a server that will participate in wide area networking, keep the following in mind:

To enable any of the wide area networking implementations, select them using the Configuration Manager, as described in the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide.

3.2.3 Do You Want to Change Any of the Server Configuration Settings?

The server configuration settings determine:

For more information about changing configuration settings, see Section 3.5, How to Change Default Configuration Settings.

For more information about each server configuration setting, refer to the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide.

3.2.4 What Do You Want the Administrator Account Password to Be?

If you are configuring a PDC, the configuration procedure prompts you to specify the password to be set for the domain Administrator account. If you are configuring a member server, the configuration procedure prompts you for the member server's local Administrator account password to be set. The member server's local Administrator account password gives access to the member server's local security account database. As with Windows NT, there may be situtations where you would like to allow certain people to manage a member server's local database without giving them the ability to manage the entire domain.

Passwords are case sensitive and can contain up to 14 characters. Valid characters are alphanumeric characters and any of the following special characters:

! # $ % & () - . ^ _ ` { } ~

3.2.5 Are You Going to Supply Account/Password Information?

If you are configuring your server to join an existing domain (as a BDC or member server), you can either:

The former option is useful if the domain administrator does not wish to give out the user name and password of the Administrator account in the domain to the person configuring this server to join the domain. The domain administrator can use the ADMINISTER ADD COMPUTER command or the Windows NT Server Manager to add the computer to the domain. If this is the case, answer NO to this prompt, and you will not be prompted for account/password information.

With the latter option, the configuration procedure requests the domain's PDC to add the computer to the domain. You will be prompted for a domain administrator account user name and password, as explained in Section 3.2.6, What Is the Domain Administrator Password?.

3.2.6 What Is the Domain Administrator Password?

When you choose to have the computer added automatically by the configuration procedure, you are prompted for a domain administrator account user name and password. As noted in Section 3.2.5, Are You Going to Supply Account/Password Information?, the PDC is requested to add the computer to the domain. The PDC validates the account user name and password on behalf of the configuration procedure. Enter the password, observing the rules specified in Section 3.2.4, What Do You Want the Administrator Account Password to Be?.

3.2.7 Do You Want to Enter a New Administrator Account Password?

In certain cases, you are prompted whether you want to enter a new Administrator password. This gives you the opportunity to change the password.

3.2.8 Do You Want to Start the Server?

The configuration procedure asks you if you want to start the Advanced Server. If you do not want to start the Advanced Server at this time, you can do so later from the command line after the configuration procedure completes.

Before you start the server on any OpenVMS Cluster member, Compaq recommends that you configure the Advanced Server on each cluster member that you want to use as a server. You can then use the SYSMAN utility to start the server on all cluster members. If you choose to start the server individually on each cluster member, make sure that you do so from the SYSTEM account (or a similar account) on each server node. For more information, see Section 5.3.5, How to Start the PATHWORKS Advanced Server in an OpenVMS Cluster.

For detailed information on alternate ways to start the server, see Section 5.3, Starting the PATHWORKS Advanced Server.

3.3 How to Start the Advanced Server Configuration Procedure

After the installation procedure completes, the OpenVMS system prompt ($) is displayed. If the system was rebooted following installation, log in to the SYSTEM account or an equivalent account. If the system was not rebooted, ensure that you are logged in to such an account. Then, start the configuration procedure by entering:


$ @SYS$UPDATE:PWRK$CONFIG 

In an OpenVMS Cluster, PWRK$CONFIG.COM must be run on each member node on which the server is to run. If you first start the server at any node, and then attempt to run the PWRK$CONFIG.COM configuration procedure, the procedure will shut down the server.

3.4 How to Respond to Advanced Server Configuration Prompts

Table 3-1, PATHWORKS Advanced Server Configuration Prompts, tells you how to respond to the prompts that PWRK$CONFIG.COM displays.

Note

Table 3-1 shows only the prompts PWRK$CONFIG.COM displays; it does not show any informational messages. For a complete sample configuration script, see Appendix B, Sample Complete Server Installation and Configuration.

Table 3-1 PATHWORKS Advanced Server Configuration Prompts
Prompt Desired Result Your Response
Do you want to continue with configuration [YES]: 1 Shut down the server or, if your server is part of an OpenVMS Cluster, all servers in the cluster Press the Return key
  Abort the configuration procedure NO
     
Enter disk device name where PATHWORKS data files will be stored [ default_device]: Copy the PATHWORKS on-disk structure to the default OpenVMS disk device displayed.

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

Press the Return key
  Copy the PATHWORKS on-disk structure to an OpenVMS disk device different from the default displayed device_name
     
Do you want to change the server configuration parameters now? [YES]: Access the Configuration Manager tool to change parameters affecting the system environment for the server Press the Return key

For detailed information about using the Configuration Manager, refer to the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide.

  Complete the configuration without entering the Configuration Manager NO
     
Enter item number, or RETURN to use these values [DONE]: Accept the server configuration parameters displayed (these are the ten or so parameters that directly affect or define the server software configuration) Press the Return key
  Change the configuration settings displayed The number associated with a setting you want to change.

For detailed information on changing these default configuration settings, see Section 3.5, How to Change Default Configuration Settings.

     
Are you going to supply account/password information? [YES]: 4 Have the computer added automatically by PWRK$CONFIG.COM, prompting you for a domain administrator account user name and password Press the Return key
  Have the computer added manually (for example, by the domain administrator) so that the domain administrator's password need not be divulged NO
     
Enter the name of the primary domain controller for domain domain-name 4 Enter the name of the primary domain controller (PDC) for the domain your server is joining. PDC-name
     
Enter Administrator account password: 3 Associate a password with the Administrator account password

Enter the password to be set for the domain's existing Administrator account.

     
Do you want to enter a new Administrator account password [NO]: 2,3 Keep the existing Administrator account password Press the Return key
  Prompt you to enter a new Administrator account password YES
     
Re-enter to verify password 3,4,5:   password
     
Enter a password for this member server's local Administrator account: 5 Associate a password with the member server's local Administrator account password

Enter the password to be set for the member server's local Administrator account.

     
Enter the account password in the required case 4   password

Enter the password in the proper case, matching the current domain account password.

     
Do you want to start PATHWORKS V6.1 for OpenVMS on node node_name now [YES]: 6 Start the server automatically after the installation procedure completes Press the Return key
  Not start the server NO


1This prompt is displayed only if the server is running.
2This prompt is displayed if you ran PWRK$CONFIG.COM previously.
3This prompt is displayed if you are configuring a primary domain controller.
4This prompt is displayed if you are configuring a BDC or member server (joining an existing domain).
5This prompt is displayed if you are configuring a member server.
6This prompt is displayed only if the Advanced Server can be started without first executing AUTOGEN or rebooting the system.


Previous Next Contents Index