Developers EMAIL:
Alessandro Bonfanti
Massimiliano Torregiani

sourceforge.net Logo

ISTRICE DOCUMENTATION
ISTRICE QUICK START
ISTRICE QUICK START


ISTRICE REQUIREMENTS

Istrice requre libxml2 , omniOrb and the GNU Common C++ , please install these packages (if necessary) before ISTRICE installation.

ISTRICE COMPONENTS

Istrice is componed by four packages:

istriceMS required It is the 'brain' of the ISTRICE enviromnent , one MS is sufficient to control all SLS in your network.
istriceSLS required SLS is the process that compile the sources and must be start on all the machines of your network. Major is the number of SLS machine minor will be the compilation time in case of parallel compilation.
gcc wrappers
required This package contain the wrapper ftp gcc and g++.
istriceGUI optional This package contain istriceConfig and IstriceConsole . (require KDE3 or QT3)


DOWNLOAD AND COMPILE THE SOURCE CODE

Download ISTRICE and uncompress it:

tar --bunzip2 -xvf istrice_1_5.tar.bz2

and follow the istruction to compile it.


INSTALLING THE DAEMONS


On the MS host use make
install_ma_daemon to install the MS startup script, on SLS hosts use make install_sls_daemon to install the SLS startup script.


CONFIGURE ISTRICE

Remember that MS is the brain of the system,SLSs are host where the compilation is forwarded and ISTRICE CLIENT are host able to use the istrice environment to compile.

EXAMPLE:




In this example the ISTRICE MS is running on server.localdomain and its SLSs are host1.localdomain, host2.localdomain and host3.localdomain. Users on host1.localdomain and host2.localdomain can compile using ISTRICE , host3.localdomain is only a SLS and is used only as a slave compiler.



From the MS host start the istriceConfig program and select the "Master server" tab.

/usr/local/bin/istriceConfig

  ic

Add the allowed SLS using "Add" button in "Allowed SLS" section of "Master server" pad, in our example host1, host2 and localhost.localdomain must must be added.
Now these host are used for the compilation.

Add the allowed clients using "Add" button in "Allowed Clients" section of "Master server" pad, only allowed client can compile using ISTRICE, in our example host1.localdomain and host2.
localdomain must be added.

Use "SAVE" button to commit and save the changes.

From the SLS hosts start the istriceConfig program and select "SLS" tab.

/usr/local/bin/istriceConfig

  ic3

  Update the "Master Server" section with the correct hostname and IP and use "SAVE" button.

  From the ISTRICE CLIENT hosts start the istriceConfig program and select "Istrice client" tab

  /usr/local/bin/istriceConfig

  ic4

Update the "Master Server" section with the correct hostname and IP and use "SAVE" button.


NOTE:
IstriceMS and IstriceSLS must be restarted after configuration changes.


TEST THE CONFIGURATION

Use istriceConsole to look the configuration or check all configured/registered SLS.






Now you are ready to compile using ISTRICE ...

gccwrapper -c a.c

If no SLS is registered the compilation will fail with the error:

ISTRICE ERROR : No SLS found !

If target Master Server is wrong configured the error will be:

Connect to Master Server failed ! error:Connection refused
Check your configuration !
ISTRICE ERROR : Connection failed !