Name

bstrcl_setup − Defines the configuration parameters for the host on which you wish to run BASEstar Open Client and creates the BASEstar Open work tree. 
 

Syntax

bstrcl_setup[-l location] [-y] [-adv] [-v] [-first_lns_serverhost] [-default_lns_server_port port] [-work_root path] [-work_tree_owner user] [-work_tree_group group] [-work_tree_protection P]

Description

To configure BASEstar Open Client, you must specify the name of at least one host where BASEstar Open Server is (or will be) installed. The Watchdog contacts sequentially the LNS server of each specified host to locate the Communication Server for a given Realm. You can specify up to eight LNS servers.  It is only possible to access Realms that are served by one of the specified LNS servers.

Options

-l locationPathname of the installation directory for the kit that you wish to set up (if different from the default directory). Enter an absolute pathname. 

This option is only useful if BASEstar Open Client is installed on a diskless machine. 

-ySimplified setup procedure. The bstrcl_setup command assumes the default values for all parameters. 

-advAdvanced setup procedure. The bstrcl_setup command prompts you to supply the UDP/IP port number of the LNS server and the protection mode for the BASEstar Open work subdirectories. 

-vThis option displays additional information on the execution of the command. 

-first_lns_server hostThe hostname of the first LNS server. 

-default_lns_server_port port
The UDP/IP port for the LNS server (the default value is 6101). You can also specify this parameter if you perform the advanced setup procedure (-adv). 

-work_root pathnameThe pathname of the BASEstar Open work root directory. If you do not specify this parameter, the bstrcl_setup command prompts you for the information. 

-work_tree_owner username
The username of the owner of the BASEstar Open work subdirectories. If you do not specify this parameter, the bstrcl_setup command prompts you for the information. 
 

-work_tree_group group
The group authorized to access the BASEstar Open work subdirectories. If you do not specify this parameter, the bstrcl_setup command prompts you for the information. 

-work_tree_protection NNN
An octal value representing the protection mode of the BASEstar Open work subdirectories (the default value is 775). You can also specify this parameter if you perform the advanced setup procedure (-adv). 

Usage Notes

The bstrcl_setup command creates the following files:

•$BSTR_ETC/bstrclusers.[c]sh

•/etc/bstrclusers.[c]sh

•$BSTR_ETC/bstrclusers.[c]sh.h_$HOST. 

It also creates the BASEstar Open work tree starting from the root directory that you specified, and records the location of the work root in the $BSTR_ETC/installation_file.h_$HOST file together with the Log Server configuration. 

The command saves a list of the LNS servers in the $BSTR_ETC/BSTRCOM_$HOST.CFG file. You can also store information in this file (in the [COM SERVERS] section)that allows the client to identify the Communication Server for each Realm that you wish to access. If the client locates this information for a given Realm, it connects directly to the Communication Server in question (without attempting to contact the LNS server).  If you use bstrcl_setup to configure a host, you cannot use the same command to alter the configuration. Instead, you must use bstrcl_unset(1) to remove the configuration, and then reconfigure the host from scratch with bstrcl_setup. 

See Also