== Minimal Installation of ILCSoft for MarlinTPC ==
In case you want to use or develop in MarlinTPC, you need the ILCSoft installation. If you work on one of the officially supported systems on the [[https://confluence.desy.de/display/IS/NAF+-+National+Analysis+Facility|NAF2]] from the ILCSoft team, you can simply follow the instructions there. This should be your default choice, as these systems are being maintained with great effort. Non-graphic operation can be done via ssh connections. A usable graphics operation is better done via a [[https://confluence.desy.de/display/IS/NAF+Login,+WGS+and+remote+Desktop|FastX2 remote desktop connection]]. This even works well over long distances, such as Japan - Germany.

If you work on a different system, then you might run into trouble. <<BR>> On this page you can find a set of minimal installation configuration files that you can try. There is no guarantee that your system has all the needed components, and if you aren't the administrator of the system you still might not be able to install everything. In case the installation doesn't work, please try the mailing list ilcsoft-marlintpc@desy.de or the [[http://forum.linearcollider.org/index.php?t=threadt&frm_id=39|forum]] to ask for help.

== ilcinstall usage ==
The attached files all work with the official tool of ILCSoft software installations: ilcinstall. For any version of the software, you need to download via --(svn)-- git the matching version of ilcinstall. The most recent version right now is '''v02-00-02''' (change appropriately), thus you would download from https://github.com/iLCSoft/iLCInstall and follow the instructions there.

----
Here, for reference, is the '''outdated method via svn:'''

{{{
svn co https://svnsrv.desy.de/public/ilctools/ilcinstall/tags/v01-17-04
}}}
This is a python based installation routine. Change to the directory, the executable is called

{{{
ilcsoft-install
}}}
As argument a configuration file is passed. The templates for different versions of ILCSoft are given below.

Please note: starting with version v01-17-04, please move/copy the configuration file into the releases/vXX-YY-ZZ/ folder in the ilcinstall directory; and also invoke ilcsoft-install with the prepended path. E.g.

{{{
ilcsoft-install releases/v01-17-04/minimal_ilcinstall_for_marlintpc-v01-17-04.cfg
}}}
== Configuration templates ==
The list of template files are:
||ILCSoft version ||file ||comment ||
||v01-17-04 ||[[attachment:minimal_ilcinstall_for_marlintpc-v01-17-04.cfg]] ||uses GBL; note new installation call ||
||v01-15 ||[[attachment:minimal_ilcinstall_for_marlintpc-v01-15.cfg]] || ||
||v01-14-01 ||[[attachment:minimal_ilcinstall_for_marlintpc-v01-14-01.cfg]] || ||
||v01-13-06 ||[[attachment:minimal_ilcinstall_for_marlintpc-v01-13-06.cfg]] ||no default CED viewer ||




Download the file and change the settings in the file accordingly to your system setup. The changes you probably need to make are in the first block of the configuration file:

{{{
  # version number - is included in the path name
   ilcsoft_release='v01-17-04'

  ilcsoft_install_prefix = "/scratch/ilcsoft/"

  MySQL_path = "/usr"
  Java_version = "1.6.0"
}}}
By default, the CEDViewer is installed as well with the newer versions of the configuration file. You can disable the installation by commenting out the following lines in the config file:

{{{
ilcsoft.module("CED").envcmake['CED_SERVER']='ON'
ilcsoft.install( CEDViewer( CEDViewer_version ))
}}}
If you have the right root version (5.34.05 or higher), it's optional to change the line

{{{
 ilcsoft.install( ROOT( ROOT_version ))
}}}
to

{{{
 ilcsoft.use( ROOT( '''$PATH_TO_YOUR_ROOT_INSTALLATION''' ))
}}}
'''Please read the error message if the installation doesn't work out of the box.''' Usually there are clear hints or indications why it doesn't work. If you can't figure it out, then please don't hesitate to ask via the usual channels.

== Needed system software ==
You need working installations of

 * python (for the installer)
 * Java (for LCIO)
 * MySQL (for LCCD)
 * build environment (gcc, make, etc.)

In case you want the CEDViewer, you also need

 * glut