DGRP_GUI(8)

NAME
dgrp_gui - Digi RealPort Manager

SYNOPSIS
/usr/bin/dgrp/config/dgrp_gui

DESCRIPTION
dgrp_gui is an X application that allows you to add, delete, and configure Digi RealPort-enabled products, as well as start and stop Digi RealPort daemons. One can also monitor the modem status of selected ports. As part of the RealPort driver package, this package is a graphic user interface for dgrp_cfg_node(8), and those who are not using X, or do not have access to a tcl interpreter should use this text based script instead.

THE MAIN SCREEN: Digi RealPort Manager
This is the list box view of all RealPort-enabled products currently configured for use on the machine.

How To Add a Product
There are two ways to register a new remote device. Either press the Add button that appears on the bottom of the main screen, or choose the RealPort->Add New menu option. You will then need to specify values for each of the fields in the Digi RealPort Device Settings window. When you are done, press the Commit button and you will see the RealPort Command Logger window with the appropriate dgrp_cfg_node command. Press the Run it button to finish adding and initializing your Digi One, EtherLite, or PortServer. Watch for any errors in the log window.

You can press Cancel at any time in the RealPort Device Settings window, or Exit in the Command Logger to cancel the addition.

  RealPort Device Settings

id  must be one or two alphanumeric character, for example "aa" or "P". This id must be unique to your system, so that no two devices are to use the same id.

address
    may be specified as an IP number, or IP name. No name look up is done to see if the machine can connect to the specified address.

ports
    is a decimal indicating the number of device files which should be created for this particular unit. This does not have to match the physical number of ports, but physical ports beyond the number specified will not be available. Maximum is 64.

IP Port
    RealPort port number (if not default).

Encrypt
    Option to always use encryption, or never. (default is never).

Encrypt IP Port
    RealPort with encryption port number (if not default).

Access Mode
    Set the file protection mode.

Owner
    Set the user ID of the file owner. Value must be an integer.

Group
    Set the group ID of the file owner. Value must be an integer.

Link Speed
    Set the link speed string. The default is "auto". See the drpd(8) man page for information on the custom speed parameters.

How To Delete a Product
First highlight the fated unit in the list box, then either press the Delete button that appears on the bottom of the main screen, or choose the RealPort->Delete / Uninitialize menu option. This will bring up the Digi RealPort Device Settings window, where you can view the current settings for the chosen unit. To confirm your choice, press the Remove button, and you will then be presented with the RealPort Command Logger window with the appropriate dgrp_cfg_node command. Press the Run it button to complete the removal of the product along with all it's device nodes.

You can press Cancel at any time in the RealPort Device Settings window, or Exit in the Command Logger to cancel the removal.

  WARNING
Be sure that none of the ports are being used before trying to remove the device.

How To Configure an Existing Product
First select the product to be modified by higlighting it in the main window's list box. Then either press the Configure button in the bottom right hand corner, or pull down the RealPort->Configure / Initialize menu option. This will display the Digi RealPort Device Settings window, where you can modify any of the values you wish except the major number and id. To commit your changes, press the Commit button, and you will see the RealPort Command Logger window with the dgrp_cfg_node command reflecting your changes. Press the Run it button to make the changes.

Pressing Exit from the Command Logger will cancel your modifications, as will Cancel from the RealPort Device Settings window. Also, if after changing some of the text entry fields you decide you want to start again from the original settings, pressing Revert in the RealPort Device Settings window will display the original settings and ignore any modification of the text fields.

Starting and Stopping Daemons
To start a daemon for a selected PortSever, first highlight the entry in the main screen list box, then choose the pull down menu option Daemon->Start Daemon. The Command Logger screen will be displayed with the appropriate dgrp_cfg_node command. Pressing Run it will attempt to start a daemon for the unit, quitting quietly if it detects a daemon is already running.

Choose the Daemon->Stop Daemon pull down menu option to stop a daemon running for the selected device.

Viewing the Port Status
First select the unit that you are interested in from the main screen's list box. By choosing the menu option View->Ports you can view the current status of this unit's ports.

THE PORTS WINDOW: Digi RealPort Manager -- Ports
This is the list box view of all the ports for the selected product. Press the Refresh box at any time to update the port configuration list.

  Port Configuration

Port
    refers to the port number

Status
    is one of OPEN, CLOSED, or WAITING. A port has the WAITING status when it is already in use, and there are others waiting on open. (?????)

Speed
    If the port has been open and its speed set, the speed value is shown in bps. If not, the value 0 is shown.

Description
    This will be one of tty or cu corresponding to the port having an OPEN status for one of these devices. If the port is not open, or the type is undetermined, this column will show NA. (This field is not yet active and will always show NA.)

How to Check a Port's Status
First highlight the port number of intrest by clicking your mouse on it. Note that you can only view the status of one port at a time. Then choose the pull down menu option Ports->Modem Status to view the current status of its modem flags. (This is not yet correct for a closed port.) You will see the Port Status window showing a red checkbox for on, and a grey checkbox for off. You can change the update delay by using the sliding scale along the bottom of the window.

REQUIRES
/usr/bin/dgrp/config/dgrp_cfg_node
/usr/bin/dgrp/config/dgrp_mk_spec
/usr/bin/dgrp/config/dgrp_mk_specs
/usr/bin/dgrp/config/dgrp.gif
/usr/bin/dgrp/config/dgrp_gui
/usr/bin/wish or some other tcl interpreter

FILES
/etc/dgrp.backing.store
/proc/dgrp/config
/proc/dgrp/ports/<id>

HISTORY
First released in January, 2000

SEE ALSO
ditty-rp(1), drpd(8), dgrp(8), dgrp_cfg_node(8)