X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=INSTALL;h=761286a500a4d4ee02380d7fbeacad607703d858;hb=4c6338d719c5637e8ded33f49a9302781c93756c;hp=d0a4c601d736268930e808ee3102c5fec67e9514;hpb=f52e8524c7f4ba4849499d6fd1ec99b372acc0f0;p=tools%2Flibbatch.git diff --git a/INSTALL b/INSTALL index d0a4c60..761286a 100644 --- a/INSTALL +++ b/INSTALL @@ -1,4 +1,4 @@ -# Copyright (C) 2007-2008 CEA/DEN, EDF R&D, OPEN CASCADE +# Copyright (C) 2007-2013 CEA/DEN, EDF R&D, OPEN CASCADE # # Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN, # CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS @@ -109,9 +109,12 @@ The build system creates a test target that can be used to automatically test some features of the library. The test coverage for this library is currently quite poor. Remember that since the tests use connections to remote batch systems, the first causes of failure are network and authentication errors. To -run the tests, you will first have to set several variables in the cache -(execution host, ...), with ccmake for instance. Then to execute those tests, -just go to your build directory and type: +run the tests, you will first have to enable them by setting CMake variable +TEST_ENABLED to ON. Then copy the file src/Core/Test/batchtest.conf to your +home directory for instance. Edit this file according to your local +configuration. Set the environment variable BATCH_TEST_CONFIG_FILE to the path +to your own configuration file. To execute the autotests, just go to your build +directory and type: $ make test @@ -132,3 +135,31 @@ directory and type: $ cmake ../libBatch-X.X.X (X's are version numbers) $ make package (for binary package) $ make package_source (for source package) + + +5. Note for the users of Microsoft Windows operating system + + +The support for this library on Windows operating system is still partial and +experimental. Some features are not and will not be implemented for this +system. Nevertheless it is possible to compile the library and launch some +batch jobs from a computer running Windows. This section only gives some +guidelines, without any warranty, to install libBatch on Windows. + +First you will need to install a library providing pthread implementation. For +this we tested Pthreads-win32 (http://sourceware.org/pthreads-win32/) but other +implementations may exist. + +You will also need a compiler for Win32 platform. We tested MinGW with MSYS +environment (http://www.mingw.org/), and Microsoft Visual C++ 2005 Express. +Other compilers might also work but it is not guaranteed. + +Then you will have to install and run CMake, and you should be able to compile +libBatch and run some basic examples. + +If you need to use SSH protocol to submit jobs to your cluster, you will need +a SSH implementation for Windows operating system. PuTTY is a good choice for +that (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html). Once +installed, add the path to your PuTTY installation in the PATH environment +variable and run CMake. The build system will detect it and the libBatch will +use it for SSH-based transfers with the server.