# Copyright (C) 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 # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 of the License. # # This library is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public # License along with this library; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com # ------------------ Quick overview and installation instructions ----------------- 1. SIMANIO library provides interaction of SALOME modules with SIMAN (SALOME Simulation Data Manager) server using Web Services and based on WSO2 Web Services Framework for C++ (wso2-wsf-cpp-x.x.x). This library building is based on CMake build system (http://www.cmake.org/) So, you have to check (or install if needed) the dependant software programs on your system: - CMake build system version 2.4 or newer - C++ compiler with standard libraries - WSO2 Web Services Framework for C++ (wso2-wsf-cpp-2.1.0) If these required software are installed on your system, you should set the proper shell environment to get access to the software components (env_build.sh script). 2. The Generating Web Service Client Stubs using WSO2 Web Services Framework for C++ The properly, completelly built and installed WSO2 includes the java based tool to generate the required web services client stubs with the other supporting files from on SIMAN wsdl file. Use following parameters to generate the Axis2/C client stub code with ADB (Axis Data Binding) support : $ ./siman_service_code_generator.sh -uri ${wsdl_location} -d adb -u The provided SIMANIO script (siman_service_code_generator.sh) generates the client stub files .h and .cpp from the given SIMAN wsdl file (/resources/SimanSalomeService.wsdl) and added them to the /src directory. 3. Then you can perform the next steps to build and install the SIMANIO library: $ mkdir $ cd $ cmake -D CMAKE_INSTALL_PREFIX= $ make install That's all. Note : To build SALOME KERNEL in the mode with SIMAN the SIMANIO_ROOT_DIR variable should be defined and points to the directory containing the preliminarily built and installed SIMANIO library (. The setting the SIMANIO_ROOT_DIR variable is provided by executing (. env_build.sh/). It can be also achieved by using the build option -DSALOME_USE_SIMAN=ON during building SALOME KERNEL. Then, the SALOME components GEOM, MED, SMESH, ... implementing correpondent can be built as usual. All SALOME modules indended for communication with SIMAN should implement required interfaces as decribed in documentation (SIMAN_Integration_of_SALOME_Modules_vx.y). The next section provides you with some additional info. --------------------- Additional info ---------------------- 1. Building and installing the library basing on SALOME installation The source codes of the SIMANIO library are delivered as part of the offcial SALOME installation or can be get from CVS SIMAN repository as usual : cvs -d :pserver:@cvs.opencascade.com:/home/server/cvs/SIMAN checkout -r V7_main SIMANIO_SRC The building the library is performed using the SALOME environment and build scripts provided during SALOME installation: build.sh - SALOME build script env_build.sh - SALOME build environment script env_products.sh - SALOME run environment script The dependencies and pre-requisite products as well as generation of the service clint stubs and other required files are controlled and provided by SIMANIO cmake procedure. The building and installation of the SIMANIO library using the scripts are performed in accordance with the steps described above. 2. Testing The set of the tests using this library for accesing to SIMAN server is developing and delivered separatelly. They can be properly executed when SIMAN web and database servers are configured and run. 3. Additional scripts The directory /scripts contains environment and start scripts used for running specific SALOME modules communicatiing with SIMAN. These scripts are copied to SALOME installation root directory by the build procedure and should be adjusted if necessary (including setting the run permissions) : run_salome_siman.sh - the script used by SIMAN for SALOME running in SIMAN mode castem_env_products.sh - CASTEM module run time environment (CEA DEN request) eficas_aster_env_products.sh - EFICAS & ASTER modules run time environment (EDF R&D request) syrthes_env_products.sh - SYRTHES modules run time environment (EDF R&D request) 4. Additional customers modules communicating with SIMAN - Optional These specific customers modules are delivered separatelly from SALOME installation and built in accordance with instructions provided by module responsible developers. If necessary, build CEA DEN CASTEM SALOME module using the lastest modified CASTEM_SRC codes include necessary updates of script scripts (e0_donnees.py, CASTEM.py) in usual manner. Set proper value of CASTEM solver binaries location in e0_donnees.py, for example : castem_exe = modele("castem_exe" , "</bin/castem10") If necessary, build and configure EDF R&D EFICAS, ASTER and SYRTHES SALOME modules and the tools used by them : Eficasv1 (TOOL), EFICAS (MODULE used by SALOME_MECA), CODE_ASTER (TOOL), ASTER_MODULE and CODE_SYRTHES (TOOL), MODULE_SYRTHES in usual manner. 5. Test running SALOME without and with SIMAN mode For properly built SIMANIO and SALOME modules you can check manually runnability of SALOME in two modes without and with SIMAN after setting run time environment with the escript env_products.sh as follwoing: . env_products.sh . castem_env_products.sh (if necessary) . eficas_aster_env_products.sh (if necessary) . syrthes_env_products.sh (if necessary) runSalome runSalome --siman 6. Configuration of SIMAN web server and SIMAN database server Please see all necessary details concerning the configuration and running of SALOME SIMAN client and SIMAN Web server with SIMAN database in the SIMAN Administration Guide (SIMAN_AdminGuide_vX.Y). 7. Basic working mode of using SALOME with SIMAN server If installation and configurations have been performed successfully the SIMAN server. can be accesible on SALOME client side from your browser using URL : "http://:8080/siman" Normally displaying the the SIMAN start page SALOME in the mode with SIMAN is run automatically from the browser accessing to the SIMAN server providing all functionality defined in the SIMAN Detailed Functional Specifications for current version. (SIMAN_Functional_Specifications_vx.y).