network-setup

network-setup

net-status Index Level network-status
Syntax network-setup {{command}}
Category TCL
Type Verb
Description allows the setup and control of a D3 network. If no arguments are supplied, a menu is displayed. This is the normal  form of operation. See the section "network, General", for a discussion of the important notions of the network configuration.

Using the menus :
All operations are controlled through menus. If the terminal allows it, arrow keys can be used where indicated:
ENTER   Validate the highlighted choice.
number  From 0 to 9. Select the corresponding choice. '0' selects the option 10.
CTRL-N  Move cursor down. (down arrow)
CTRL-B  Move cursor up. (up arrow)
CTRL-X  Cancel. Applicable only when input is requested.
ESC     Quit. Go back to previous menu, or back to TCL. This key can be used to terminate all menus.
Q       Quit. Go back to previous menu.
X       Exit. Go back to TCL from any menu.

When the cursor is moved to a new field, a short help is displayed in the message area.


Screen layout :
The screen is divided in two sections:
- The menu section, where menus are displayed.
- The message section, where results, messages or help are displayed.


Definitions :
host
 A definition for a local or remote D3 machine.  There should be one for each system.


Main Menu
1 Start network servers
 Starts up all local network servers.  Before running this command, it is necessary to define the network using the "Define local hosts" and "Define remote host" options.  The server status is automatically displayed after network servers are started.

2 Stop network servers
 Stops all local network servers.

3 Server status
 Displays the status of all local servers.

4 Server statistics
 Displays transaction statistics for all local server processes, such as reads & writes per second.

5 Server pid status
 Displays the Unix process status of each server process.  Note that the Unix processes all appear to have been spawned by Unix command which started the primary server.  This is due to the way the servers are configured and does not indicate an error.

6 Network status
 Displays remote files open by each process.

7 Define the network
 Allows the user to define the way the network is set up.  This sub-menu is documented below.

8 Exit
 Exits back to TCL.


Network Definition Menu

1 List all hosts
 Displays an access listing of all defined hosts, both the local and all remotes.

2 Print all hosts
 Lists all hosts to the currently selected printer.

3 Define local host
 Configure the local network hosts. If you are defining an entire network, use option 9 Define all hosts.  The following input fields are requested:

Host Name           :
 Any alpha-numeric string. This will be the D3 name of the local host. This field defaults to the name of the Unix machine if no local host is defined.
Optional Host Description  :
 An optional description of the host.  The physical description of the machine or a description of it's location, or the name and number of it's system administrator would be helpful here.
TCP Name/Address           :
 The TCP Name/Address where the D3 machine exists. For the server, this should be the local Unix host name.
TCP Service Name/Number    :
 The TCP service number.  Normally, the default of "pnfs" is correct as this is the default D3 service name. An alternate service is only necessary if there is more than one D3 virtual machine on the same Unix box.
Security Options           :
 These tune the security parameters of the server.  Without any parameters, remote users may connect and disconnect freely and are given the same permissions as they have on their original client machines.  Each open request from a client machine passes the retrieval and updates keys assigned to the user on that client to the server.  The server then utilizes those client keys to open the requested file.
If the "A" option is used, then the client retrieval and update keys are ignored, and the connection is refused completely if the passed user name and password do not match a user/password combination on the local server. The server looks for "ClientHostName:ClientUserName" or simply "ClientUserName" when looking for a user match.
If the user name and/or password must be different on the local server than on the remote client, then the client user can utilize the "SET-REMOTE-USER" command to perform automatic user/password mapping when connecting to that server.
If the "H" option is not used, then the server disconnects unused connections after a certain time period.  In this situation, it may be unclear to the administrator which connections are being utilized by which remote users.  If the "H" option is set, then all connections are held until the remote client logs off.  This requires one server for each remote client, but helps prevent "snooping" and "spoofing" security problems, and makes system administration simpler as the list-users command always shows the connected users.
Transmit timeout           :
 Time (in seconds) allowed for each remote operation.  After this time, the client assumes the server is down and follows the error path.  This value should be increased when the server is slow and 'no response' errors are randomly encountered.
Accept Timeout             :
 Time (in seconds) during which a server process remains bound to a client when no operations are performed.  A setting of 0 disconnects after every operation and is not recommended.   For most situations, a value between 1 and 10 will provide a good balance between too many TCP connection in TIMEWAIT state and too few server processes.  Note that server process remain bound to it's client when it holds item locks for that client, regardless of the Accept Timeout value.
Initial Server Processes   :
 The number of server processes that are started when the network is started.  To change the number of servers, you must shut down the network, change this number, and then restart the network.
Host ID Number             :
 The host ID number is used to differentiate between different virtual machines on the same Unix host.  If you only have one D3 virtual machine on each Unix machine, this number is not needed.  If you have more than one D3 virtual machine on a Unix host, then pick small numbers (less than 128) for each virtual machine on that host.
Confirm (y/n/q)            :
 'y' to confirm the host modification. 'n' to go back to any of the previous fields. 'q' to quit and abandon.

boxx > 4 Define remote host
 Configure the remote network hosts. After choosing this option, another menu appears asking which host to edit as well as a "New Host" option to create a new host.  Select the "New Host" option when intially configuring a network.  Next, the following input fields are requested:

Host Name           :
 Any alpha-numeric string. This will be the D3 name of this remote host.
Optional Host Description  :
 An optional description of the host.  The physical description of the machine or a description of its location, or the name and number of its system administrator would be helpful here.
TCP Name/Address           :
 The TCP Name/Address where the D3 machine exists.
TCP Service Name/Number    :
The TCP service number.  Normally, the default of "pnfs" is correct as this is the default D3 service name. An alternate service is only necessary if there is more than one D3 virtual machine on the same Unix box.
Options                    :
 These are driver-specific options.  These may be left blank in the simplest case.

 The host ID number is used to differentiate between different virtual machines on the same Unix host.  If you only have one D3 virtual machine on each Unix machine, this number is not needed.  If you have more than one D3 virtual machine on a Unix host, then pick small numbers (less than 128) for each virtual machine on that host.
Confirm (y/n/q)            :
 'y' to confirm the host modification. 'n' to go back to any of the previous fields. 'q' to quit and abandon.

5 Define all host
 Configure all hosts on a D3 network.  Use this option to configure an entire D3 network from one station.  This option, when combined with the next three, allow a user to enter configuration data for all hosts, both this local one and all remotes, then dump the information to tape.  That tape is then loaded on each seperate virtual D3 machine.  See menu option 7 for details for each prompt.

6 Dump host file
 A tape is selected, and network items in the dm,hosts, file are dumped to it.

7 Load host file
 A tape is selected, and items prepared by option 10 above are loaded from that tape.

8 Declare local host
 After network host items are loaded from tape during option 11 above, the user must tell the system which host item describes the local D3 virtual machine. This option presents the user with a list of hosts, the user picks one the one that describes this machine.

9 Back to main menu
 Exits back to the main menu.

Non Menu Operation :
It is possible to perform some operations from TCL by specifying a 'command' on the TCL line. This for is useful to perform some automatic commands in macros.

'command':

start
 Start the local server processes.

stop
 Stop all local server processes.

status
 Display the status information for all local server processes.

statistics
 Display the transaction statistics for all local server processes.
Options Q  Quiet. Valid only for the non menu operation. Supresses all messages.
See Also :kill-network :start-network :kill-node :restart-node :init-network net-status network-status set-remote-user
Example
Warnings
Compatibility D3 7.0 D3 7.1
net-status Index Level network-status