orber

MODULE

orber

MODULE SUMMARY

The main module of the Orber application

DESCRIPTION

This module contains the functions for starting and stopping the application. It also have some utility functions to get some of the configuration information from running application.

EXPORTS

start() -> ok

Starts the Orber application (italso starts mnesia if it's not running).

stop() -> ok

Stops the Orber application.

domain() -> string()

This function returns the domain name of the current Orber domain as a string.

iiop_port() -> int()

This function returns the portnumber which is used by the IIOP protocol. It can be configured by setting the application variable iiop_port, if it's not set it will have the default number 4001.

bootstrap_port() -> int()

This function returns the portnumber which is used by the CORBA bootstrappiung protocol. This protocol is used to fetch an initial reference from another ORB. It can be configured by setting the application variable bootstrap_port, if it's not set it will use the iiop port.

Note: In the future it will use the port number which is set in the standard (the suggestion is 900). Because the standard isn't ready in this area we in the meantime uses a port number which don't require root permissions in Unix.

orber_nodes() -> RetVal

Types:
RetVal = [node()]

This function returns the list of nodenames that this orber domain consists of.

install(NodeList) -> ok
install(NodeList, Options) -> ok

Types:
NodeList = [node()]
Options = [Option]
Option = {install_timeout, Timeout} | {ifr_storage_type, TableType}
Timeout = infinity | integer()
TableType = disc_copies | ram_copies

This function installs all the necessary mnesia tables and load default data in some of them.

Preconditions:

• a mnesia schema must exist before the installation
• mnesia is running on the other nodes if the new installation shall be a multinode domain

Mnesia will be started by the function if it's not already running on the installation node and if it was started it will be stopped afterwards.

The options that can be sent to the ionstallation program is:

• {install_timeout, Timeout} - this timeout is how long we will wait for the tables to be created. The Timeout value can be infinity or an integer number in milli seconds. Default is infinity.
• {ifr_storage_type, TableType} - this option sets the type of tables used for the interface repository. The TableType can be disc_copies or ram_copies. Default is disc_copies. (All other tables in Orber are ram copies).

AUTHORS

Lars Thorsén -