The following contains instructions to use omniORB2 under ETS-Kernel. The information is provided by David MorgenLender <[email protected]> and Jon Kristensen <[email protected]>.
- Select the platform x86_ets in config/config.mk.
- This platform is based on the NT 4.0 platform, and uses several of the NT 4.0 binaries located in the <:top>:/bin/x86_win32 directory of a binary distribution for x86_nt_4.0. Before proceeding with building this platform, make sure that you have the required NT platform binaries in <:top>:/bin/x86_win32. Among the binaries required is the omniORB2 IDL compiler (omniidl2.exe) and some of the compiler wrapper functions.
- Build the libraries by following the instructions given in "Building omniORB2 from the source files" in README.win32. Only the libraries will be built and installed in <top>\lib\x86_ets
Note! If you are building both the NT 4.0 and ETS kernel versions, a "make clean" is required each time you switch configuration. Otherwise the make utility may not recompile all files with the required compiler switches. A "make clean" will remove all temporary object files, but not the libraries and binary executables.
- ETS-Kernel does not support the registry. The default setup is to read the root context of the COSNaming service from a configuration file (C:\OMNIORB.CFG).
ORBInitialHost=192.168.1.1
ORBInitialPort=58000
Another option is to use command line switches, but this is only practical when debugging.
- The ETS-Kernel application should be built using the static version of omniORB (-D_WINSTATIC must be specified.) See mk/platforms/x86_ets.mk for an example. Also __ETS_KERNEL__ must be defined.
- Currently, there is a bug in ETS-Kernel: bind() does not select a port, if it's given a port value of 0. PharLap is working on a fix for this. So for now, the app cannot depend upon omniORB to determine the port to use. As a workaround, I specify a port # to use via a command line argument to the app. This bug seems to have been fixed in either ETS kernel v9.1 or in any of the later patches.
- omniORB requires that a hostname be specified, but ETS-Kernel does not support a pre-defined hostname. The workaround is to specify a hostname via an environment variable (OMNIORB_USEHOSTNAME), which can be set during the initialisation of the app. An example that reads the IP address from the device driver and uses it as the HOST name is given below:
// This code should go at the top of function main()
#ifdef __ETS_KERNEL__
char envstr[40];
IN_ADDR ip;
/* Obtain TcpIP configuration for Ether0 */
DEVHANDLE hEth0 = EtsTCPGetDeviceHandle( "ether0" );
EK_TCPIPCFG* pTcpCfg = EtsTCPGetDeviceCfg( hEth0 );
if (NULL == pTcpCfg)
{
cerr << "Unable to Get device configuration for ether0" << endl;
exit(1);
}
ip.S_un.S_addr = TcpCfg.nwIPAddress;
strcpy( envstr, "OMNIORB_USEHOSTNAME=" );
strcat( envstr, inet_ntoa(ip) );
if (_putenv( envstr ) != 0)
{
cerr << "Unable to set host name" << endl;
exit(1);
}
cerr << "Hostname set to " << getenv( "OMNIORB_USEHOSTNAME" ) << endl;
#endif
- It's critical that ETS-Kernel is configured properly regarding the network card, IP information, etc. The appropriate network card driver must be linked into the app. The appropriate configuration information (e.g. IP address) must be configured into the ETS-Kernel monitor (which functions as a loader for the app).
|