General
- Install cygwin (http://www.cygwin.com/): ensure to have make, autoconf, automake included. You require it for the DWARF deployment to your machine. Cygwin is a UNIX shell emulation for Windows - you'll like it
- Cygwin packages: Devel.automake, Devel.autoconf, Devel.make, Devel.cmake, Devel.libtool
- Shut down every firewall you have running. Firewalls prohibit CORBA communication between the ServiceManager and Services as well as between Servcies.
- When using Python, the
configure scripthas to be called with prefix as a Windows style path (e.g. --prefix=c:/<install path> and not --prefix=/cygdrive/c/<install path>). This is because another Python installation is used than the one installed with Cygwin. - When using C++ the configuration is done via CMake instead of autoconf.
Using Java
- Delete /usr/bin/jar.exe from the cygwin internal path. This is the GNU
jar, which does not implement all opttions of sun'sjar, but has the same name nevertheless. Tryjar -uto see. This sucks! - Install newest version of Java which is available from http://java.sun.com. Maybe you have to set the environment variable
JAVA_HOME. Maybe you'll run intopathproblems. Try to calljava -version. If it corresponds to your previous installation, everything is right. If not, refactor thepathand place your installationbindirectory at the beginning. - Copy all jars from one of our lab linux machines out of the directory
/usr/lib/java2/jre/lib/extto %JAVA_HOME%jre/lib/ext. One of these jars is the CORBA implementation. (We should make a tar-ball ... Remind us, if you need the jars...)
Testing if Java works
Before you can test, if Java is working properly, you have to follow the steps in the DwarfBuildTutorial to make a concrete installation of DWARF. After this you can do the following:- Start a ServiceManager on another computer of your choice
- Start DIVE on this machine, too
- Start e.g. the
TestStringSenderJAVA :java -DserviceManager=<hostname> -jarTestStringSenderJAVA .jar - Press View->Update and you should see the Service (but it is announced as running on the ServiceManager's computer)
- Now start the
TestStringReceiver :./TestStringReceiver- It's a C++ Service
- After several seconds press View->Update again. You should see both services interconnected. When looking at the
TestStringReceiverterminal window, you should see logging information, that data arrives
Using C++
When installing to use C++, there are a couple of things that needs to be noted. First that everything have to be compiled with the same version of the VC++ compiler, and secondly that everything has to be compiled indebug mode since DWARF is compiled so and uses the debug libraries of third party products. Futhermore it has to be noted, that both CMake and Autoconf creates a non-identical config.h file in the build directory, and therefore the install has to take place just after configuration with both tools.
Last but not least, a lot of patience is required.It takes a long while to get and install all the third party products, but it takes even longer to compile everything.
- Install MS Visual Studio .NET
- Install MSDN
- Add to system environment variable
path: The"c:\programme\microsoft visual studio .NET2003\Vc7\bin"directory or where the bin directory is located
- Add to system environment variable
path: The"c:\programme\microsoft visual studio .NET2003\Common7\IDE"directory or where the IDE directory is located
- Add to user environment variable
INCLUDE: The"c:\Programme\Microsoft Visual Studio .NET 2003\Vc7\PlatformSDK\Include"directory or where the platform include directory is located
- Also add to INCLUDE:
C:\Programme\Microsoft Visual Studio .NET 2003\Vc7\Include - Add to user environment variable
LIB: The"c:\Programme\Microsoft Visual Studio .NET 2003\Vc7\PlatformSDK\Lib"directory or where the platform lib directory is located
- Also add to LIB:
C:\Programme\Microsoft Visual Studio .NET 2003\Vc7\Lib - Install
omniORB,omniNotify,CMake,XercesCandopenSLPas described in the sections below. (The two last is only nescesary if the service manager has to run)
Testing if C++ works
- Try compiling the Service Manager and the debug executables
- Get it to run together (Se the using ServiceManager section below)
Using Python
Since the Python version preinstalled in cygwin has trouble with loading the .pyd library files in omniORB, it is nescessary to make a external installation of Python.(Note the comment about the configure script in the
General section.)
- Delete or move the python.exe and python23.exe in the /usr/bin/ in Cygwin.
- Download newest version of Python for Windows and install it (http://www.python.org/download/)
- Add to system environment variable
path: The"c:\python23\"directory or where Python was installed
- Install
omniORBpyas described in the omniORB section.
Testing if Python works
Installing omniORB
If you are not going to use C++, then you can just get the precompiled version, install that and follow the last three points. Also note that if you plan on using DWARF with Python, then you have to use an extern Python installation and notomniPython
- Download
omniORBin newest (4.0.5 or newer) version from (http://omniorb.sourceforge.net/). - Unpack and move to desired loaction. The .../omniORB-x.x.x/ directory is here called <omni-top>.
- Uncomment the line "platform = x86_nt_4.0_vs_7" in the file
/config/config.mk - Uncomment and set the PYTHON variable in
/mk/platforms/x86_nt_4.0_vs_7.mk to where your Python install as a Cygwin pathis (e.g. "PYTHON = /cygdrive/c/Python22/python") - Add to system environment variable
path: The"<omni-top>\bin\x86_win32"directory
- Add to user environment variable
INCLUDE: "<omni-top>/include" (e.g. c:\Programme\omniORB-4.0.5\include) - In Cygwin goto <omni-top> and write "make export" - then take a cup of coffee and wait
Using omniPython
- Download a precompiled version of omniPython (http://omniorb.sourceforge.net/)
- Unpack and move the folders in the omniPython directory into the <omni-top> direcotry.
Installing omniORBpy
- Install omniORB on your system as described above.
- If you want to use C++ you need the non-precompiled version otherwise download
omniORBpyin newest precompiled version from (http://omniorb.sourceforge.net/). - With the non-precompiled move the unpacked source to
<omni-top>/src/liband in goto/src/lib/omniORBpy2.4/ and "make export" (do not use the configure script as described in the README). Otherwise with the precompiled omniORBpy just unpack and move into the unpacked files and directories into the <omni-top> directory - overwriting several older files. - Add to system environment variable
PYTHONPATH: = <omni-top>/lib/x86_win32;<omni-top>/lib/python/-.
(e.g. c:/Programme/omniORB-4.0.5/lib/x86_win32;c:/Programme/omniORB-4.0.5/lib/python/)
Installing omniNotify
- Install omniORB as described above
- Download latest version of omniNotify and follow the README (http://omninotify.sourceforge.net/).
NOTE: If you use MS Visual C++ in version from 7.1 there is no longer support for several header files as <iostream.h> (Now just <iostream>). You then need to change several files inomniNotify(at least in version 2.1 and older) to include the non-.h headers and afterwards write'using namespace std;'to make the export.
To help a bit there is a patch file in the dwarf/win32/ directory. Just copy the patchfileMSv71-omniNotify.patchto the<omni-top>/src/services/omniNotify/directory and in cygwin type 'patch -p1 < MSv71-omniNotify.patch' and you should be able to compile.
Using CMake
Do not use the internal Cmake in Cygwin, instead- Get the newest precompiled version of CMake (version 2.0.5 or newer) at (http://www.cmake.org/).
- Install and if the CMake bin directory is not already in your enviroment
Pathvariable then add it. - Run this Cmake (Not through Cygwin), and in the box "Where is the source code" set the DWARF root directory (e.g c:\dwarf), and "Where to build the binaries" to dwarfs build directory (e.g c:\dwarf\build)
- Press the Configure button, set any variables you would like to change and then press the configure button again.
- Last press the OK buttion, this will create all the project files for VC++, with the root in the DWARFs build directory. Which means you should just open the
DWARF.slnin the build directory into VC++ and compile.
Using Xercesc
- Get the source code for Xercesc at http://xml.apache.org/xerces-c/download.cgi
- Unpack and move the code to desired location
- Open the
<Xerces-root>/Projects/VC<X;>/Xerces-all/Xerces-all.sln(<X;> is your version of VC++) in VC++ and compile theXercesLibproject (debug version) - Copy DLL's from <Xerces-root>/build/win32/VC<X;>/debug to <Xerces-root>/bin, and LIB's into <Xerces-root>/lib
- Rename the <Xerces-root>/src to <Xerces-root>/include
- Set the enviroment variable
XERCESCROOTto your <Xerces-root> path - Add the <Xerces-root>/bin to your PATH enviroment variable
Using openSLP
- Download openSLP at http://www.openslp.org/
- Unpack and move to desired location
- Open
<SLP-root>/win32/openslp.dswin VC++ and compile all (debug version) - Move the
<SLP-root>/win32/slpd/Debug/slpd.exe,<SLP-root>/win32/slptool/Debug/slptool.exeand<SLP-root>/win32/libslp/Debug/slp.dllto<SLP-root>/bin - Move the
<SLP-root>/win32/libslp/Debug/lp.libto<SLP-root>/lib - Move the
<SLP-root>/libslp/slp.hto<SLP-root>/include - Add
<SLP-root>/binto your enviroment variable PATH - Add
<SLP-root>/libto your user enviroment variable LIB - Add
<SLP-root>/includeto your user enviroment variable INCLUDE - Move the
slp.conf,slpd.logandslp.regfrom<SLP-root>/ect/to the Windows directory.
slpd -start and after the service manager finished call slpd -stop before starting the service manager again.
Using Coin and SoWin
If you want to use the Viewer you will need to have Coin and SoWin running.- Download Coin2 and SoWin in there latest non-precompiled versions (SoWin has to be in a
laterversion than 1.2.0, or get the latest night build)http://www.coin3d.org/download/ - Put the bin directory in your Coin install directory in your PATH enviroment variable (e.g
c:/Coin/bin) - Follow the install instructions as described on the download page,
butinstall with the extra configure option--with-msvcrt=multithread-dynamic-debug(e.g./configure --prefix=c:/Coin/ --with-msvcrt=multithread-dynamic-debug) - Create a new enviroment variable called
COIN3DDIRand set it to you Coin root directory (e.gc:/Coin)
Using a local ServiceManager
- Get C++ to work
- Use cmake to configure, and VC++ to compile the serviceManager
- Start/restart the slp deamon (e.g.
slpd -start) - From the install/bin directory call the run-servicemgr script (If something fails, try and restarting the slp deamon and then the script)
Testing if the ServiceManager works
- Compile the debug executable (option in CMake)
- Try to start the ServiceManager:
./run-servicemgr - Start and connect the TestStringReciever and TestStringSender to the servicemanager
- If it runs and your services communicate with each other, then the service manager works
-- FrimorTroels? - 28 Nov 2004
History (these are not deleted for convenice, but do not follow these steps, when installing DWARF on your platform)
History 1: Previous Twiki page
Steps (not necessarily in perfect order)- get latest omniorb for Win32
- hack configure to remove am__fastdeb problem
- run configure (get a beverage of choice)
- run make (get another beverage of choice)
- use dsw file from win32
- remove dependencies on
ServiceTestStringSend (should be the other way round) - add missing Dwarf stubs to stubs library
- add omni orb include dir
- add omni orb lib dir
- add build include dir to common for config.h
- add build include dir to
ServiceTestStringSend for config.h - fix in
ServiceTestStringSend service DEBUGSTREAM to THROWDEBUGSTREAM - fix __x86__ define in
ServiceTestStringSend project file - compile stubs
- compile corba
- compile common
- compile
ServiceTestStringSend
- never use _WINSTATIC as define !
- use -DserviceManager=othermachine to configure a foreign ServiceManager (The ServiceManager is currently not working on windows). For Java services you have to define the -D option as a virtual machine argument and not as a program argument. Example:
java -DserviceManager=atbruegge43 -jar TestStringSenderJava.jar
