temip_config(1) — Commands

NAME

temip_config − TeMIP Framework configuration program

SYNOPSIS

temip_config [−h] [−ce director_name |−l remote_director_name |−mdlR]
[−M mode] [−n retries_number] [−t time_number]
[−r max_remote_directors] [−a max_applications] [−p max_processes]
[−D directive_port] [-P monitoring_port]
[−u user_name] [−H hostname]
[−w process_polling_period] [-W rdm_polling_period]
[−T rdm_echo_timer] [-S rdm_start_msg_timeout]
[−s hostname] [-x hostname]

DESCRIPTION

The temip_config command invokes the TeMIP Framework configuration program. This program, depending on the option chosen, registers a new director for the local host (-c option) , un-registers the local director (-d option), modifies the director information (-m option), erases a director (-e option), or lists information on the local or remote director (-l option) . The TeMIP Framework configuration program must be used to define a local director before running any TeMIP Framework Application or Management Module.

FLAGS

The following options are interpreted by temip_config :

-c director_name
Registers a new director as local director on the local host.
This option is only supported if there is no local director already registered for the same machine. The temip_config command creates two application entities, Framework AM and FCL PM, which are needed for minimum operation of the system.

-d Deregisters the local director.
This option is only supported if there is a local director already registered for the local machine. It deregisters the local director from the global Namespace and from the local config file.

-e director_name
Erases a director.
This option is provided as a repair function in case of mismatch between the global Namespace and the local config file. It can only be used for a director whose hostname attribute matches the local hostname. This option erases all information relating to this director from the global Namespace and from the local config file.

-l Lists attributes of the local director.
This option lists all the attributes of the director, except the director state. This option is only supported if there is a local director already registered for the local machine.

-l [remote_director_name]
Lists attributes of the remote director.
This option lists all TNS attributes of the specified director.

-m Modifies the attributes of the local director.
This option is only supported if there is a local director already registered for the local machine.

-R Re-creates the 2 applications needed for minimum operation of the system.
This command re-creates the two application entities, Framework AM and FCL PM needed for minimum operation of the system, that is to be able to create all other application entities and to manage the system. It is provided as a repair function in case all PM applications have been deleted.
This option is only supported if there is a local director already registered for the local machine.

The following options must be used in conjunction with -c -m :

-a value
Specifies the value of the maximum number of applications that can be defined for this director.
The maximum number of applications is used in the Kernel for reserving resources for Application entries. The default value, when the option is not specified, is 64 and the maximum is 256.

-D value
Specifies the port number to use for directives sent to this director.
The default value, when the option is not specified, is 5000.

-M mode
Specifies the Distribution Mode.
The possible values are :
The default, when the option is not specified, is the most privileged mode allowed by the license present on the system.
If there is a valid distribution license on the system, the default is S. If there is a valid client license, but no distribution license, the default is C. Otherwise the default is N.

-n value
Specifies the maximum number of retries if this director is not reachable.
The default value, when the option is not specified, is 0, which means no retry.

-p value
Specifies the value of the maximum number of processes that can run concurrently for this director.
The maximum number of processes is used in the Kernel for reserving resources for Process entries. The default value, when the option is not specified, is 256 and the maximum is 1024.

-P value
Specifies the port number to use for mutual director surveillance.

-r value
Specifies the value of the maximum number of Remote Directors that can be defined for this director.
The maximum number of Remote Directors is used in the Kernel for reserving resources for Remote Director entries. The default value, when the option is not specified, is 50 and the maximum is 256.

-t value
Specifies the time interval to wait between 2 retries when the director is not
reachable.
The value is expressed in seconds.
The default value, when the option is not specified, is 10 seconds.

-u username
Specifies the username associated with the director.
The default is to use the username of the user executing the temip_config command (that is root).

-w process polling period
Specifies the ’value’ of the Polling period for process monitoring . The number of seconds to wait before monitoring again the set of processes.

-W rdm polling period
Specifies the ’value’ of the Polling period for remote director monitoring . The number of seconds to wait before monitoring again the set of remote directors.

-T rdm echo timer
Specifies the ’value’ of the ECHO message timer for this director. This timer is used by remote director in the dynamic polling of this local director.

-S rdm start message timeout
Specifies the ’timeout’ used by a remote RDM to wait a START message from this local director. This timeout value is very dependency of the network.

The following options must be used in conjunction with -m :

-H Change the Director host to the local hostname.

-H [hostname]
Change the Director host to hostname.

-s Add the local hostname to the Support hosts list
(DECsafe ASE environment).

-s [hostname]
Add hostname to the Support hosts list (DECsafe ASE environment).

-x Remove the local hostname from the Support hosts list
(DECsafe ASE environment).

-x [hostname]
Remove the hostname from the Support hosts list
(DECsafe ASE environment).

Environment setting

temip_config uses two environment variables :

MCC_CONFIG_LOCATION
is an environment variable that can override the default location of the MIR files ( default : /var/mcc ).

MCC_DNS_SELECTION
is an environment variable that specifies the use of TNS or local MIR
( default : MIR ).

EXAMPLES

1. To create the local director ’.temip.unitel_director’ , enter :
temip_config -c .temip.unitel_director

2. To create the local director ’.temip.unitel_director’ with temipusr
as director username, enter :
temip_config -c .temip.unitel_director -u temipusr

3. To delete the local director ’.temip.unitel_director’ , enter :
temip_config -d

4. To modify the maximum number of processes on the director, enter :
temip_config -m -p 20

5. To create a local host in DECsafe ASE environment :
To create the director ’.temip.europe_director’ with ’bermud’ (virtual host) as Director host and ’mytho’ and ’balear’ as support hosts, enter :

a. To create the director ’.temip.europe_director’ enter :

mytho> temip_config -c .temip.europe_director

b. To change the Director host to the virtual host ’bermud’, enter :

mytho> temip_config -m -H bermud

c. To add the machine ’mytho’ as support host of the director ’.temip.europe_director’, enter :

mytho> temip_config -m -s

d. To add the machine ’balear’ as support host of the director ’.temip.europe_director’, enter :

mytho> temip_config -m -s balear

e. To delete the director ’.temip.europe_director’ with the support hosts ’mytho’ and ’balear’, enter :
mytho> temip_config -d

temip_config: The director "LOCAL_NS:.temip.europe_director" has been deleted from MIR.
temip_config: The director "LOCAL_NS:.temip.europe_director" has been deleted from TNS.

6. To list all the TNS attribute for the remote director ’.temip.balear_director’, enter :
             temip_config -l .temip.balear_director
Director                           .temip.balear_director
Director host                      balear.vbo.dec.com
Mode                               Server
Directive port                     5000
Max retries                        0
Time between retries               10 sec
Monitor port                       5001
RDM ECHO polling period            30
RDM Timeout to read a START-MSG    5
Creation time                      Thu Jun 1 14:58:51
Modification time                  Thu Jun 1 14:58:51

RESTRICTIONS

temip_config can only be run under super-user, except for the -l option.
Temip_config requires access to the namespace.
The username and user-id associated with the director are used by temip_config and should not be modified in the password file or in the Bind server without re-running temip_config.
Temip_config requires that no Management Module is running on the system if one of the options -c, -d, -m, -e is used.

FILES

/var/mcc/repostab.lck -
/var/mcc/repostab.idx -
/var/mcc/repostab.dat -
/var/mcc/dDIRECT_i.lck -
/var/mcc/iDIRECT_i.lck -
/var/mcc/dDIRECT_i.dat -
/var/mcc/iDIRECT_i.dat -
/var/mcc/dDIRECT_i.log -
/var/mcc/iDIRECT_i.log -
/var/mcc/dDIRECT_i.idx -
/var/mcc/iDIRECT_i.idx -
Director configuration files

Museum

Related Articles