Recent changes to InstallationFromSource

InstallationFromSource modified by James Edmondson

James Edmondson — Sat, 05 Aug 2017 01:59:07 -0000

--- v30
+++ v31
@@ -584,7 +584,7 @@
 ~~~~~~
 python
 import madara
-knowledge # madara.knowledge_engine.KnowledgeBase ()
+knowledge = madara.knowledge.KnowledgeBase ()
 knowledge.print ()
 ~~~~~~

InstallationFromSource modified by James Edmondson

James Edmondson — Fri, 23 Jun 2017 22:54:41 -0000

--- v29
+++ v30
@@ -413,7 +413,7 @@
 %ACE_ROOT%\bin\mwc.pl -type vc12 ace.mwc

 cd %MADARA_ROOT%
-mwc.pl -type vc12 MADARA.mwc
+mwc.pl -type vc12 -features opensplice=1 MADARA.mwc
 ~~~~~~

 Open the ACE.sln file inside of %ACE_ROOT%\ace and hit build in Visual Studio. Once finished, ACE will be installed. Then open the MADARA.sln file inside of C:\madara and hit build in Visual Studio. Once finished, Madara will be installed.

InstallationFromSource modified by James Edmondson

James Edmondson — Tue, 14 Mar 2017 21:45:45 -0000

--- v28
+++ v29
@@ -711,9 +711,11 @@
 ~~~~~~
 cd $MADARA_ROOT
 svn update
-perl $ACE_ROOT/bin/mwc.pl -type gnuace MADARA.mwc
-make tests=1 -j $CORES
-~~~~~~
+perl $ACE_ROOT/bin/mwc.pl -type gnuace -features <features you="" installed=""> MADARA.mwc
+make tests=1 <features you="" installed=""> -j $CORES
+~~~~~~
+
+"features you installed" can be any of the features you previously installed. For instance, "zmq=1" or "docs=1" for doxygen documentation. If you are not installing any extra features, simply remove the "-features " part of the perl command but keep in the MADARA.mwc.

 ----

InstallationFromSource modified by James Edmondson

James Edmondson — Tue, 14 Mar 2017 21:43:14 -0000

--- v27
+++ v28
@@ -25,7 +25,7 @@

 Doing the following will install MADARA with just the best effort IP multicast and broadcast transports. Here's the complete step-by-step:

-## MADARA baseline for Linux
+## MADARA Baseline for Linux

 Copy and paste the following into a terminal. You can move the export statements into your .bashrc file and type ". ~/.bashrc" to reload the file, if you like. This assumes 4 cores. If you have less or more than this, you can change the CORES variable accordingly. All it's basically doing is causing make to create $CORES jobs to run the build process in parallel (which will be faster on multiple cores). Also, this will install everything in the $HOME directory. If you would like to install somewhere else, change all instances of $HOME to a variable that represents your target directory.

@@ -62,7 +62,7 @@

 ----

-## MADARA baseline for ARM Linux
+## MADARA Baseline for ARM Linux

 Compiling MADARA for any architecture is the same as compiling ACE for any architecture. The main change from the above is that you will need to download an ARM toolchain that is appropriate for the target architecture. An example location to obtain a generic ARM gcc toolchain is from http://www.gnuarm.com (you would have to build gcc from here), or you could use the guide from the Chumby Wiki (http://wiki.chumby.com/index.php?title=GNU_Toolchain). For Parrot AR.Drone 2.0 toolchains, you will probably have to download a different ARM toolchain like the one from Sourcery CodeBench (http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/, requires site registration). Which toolchain you need will depend on the architecture you are compiling for.

@@ -121,7 +121,7 @@

 ----

-## MADARA without DDS for Android Linux
+## MADARA Baseline for Android Linux

 PREPPING THE INSTALL

@@ -167,7 +167,7 @@

 ----

-## MADARA without DDS for Windows
+## MADARA Baseline for Windows

 The installation now defaults to not include DDS. If you want to include DDS, you'll need to edit the default.features file inside of %MADARA_ROOT% and enable the opensplice, ndds or kats features. However, installation on Windows looks something like this:

InstallationFromSource modified by James Edmondson

James Edmondson — Tue, 14 Mar 2017 21:38:24 -0000

--- v26
+++ v27
@@ -21,11 +21,11 @@

 ----

-# MADARA without DDS
+# MADARA Baseline

 Doing the following will install MADARA with just the best effort IP multicast and broadcast transports. Here's the complete step-by-step:

-## MADARA without DDS for Linux
+## MADARA baseline for Linux

 Copy and paste the following into a terminal. You can move the export statements into your .bashrc file and type ". ~/.bashrc" to reload the file, if you like. This assumes 4 cores. If you have less or more than this, you can change the CORES variable accordingly. All it's basically doing is causing make to create $CORES jobs to run the build process in parallel (which will be faster on multiple cores). Also, this will install everything in the $HOME directory. If you would like to install somewhere else, change all instances of $HOME to a variable that represents your target directory.

@@ -62,7 +62,7 @@

 ----

-## MADARA without DDS for ARM Linux
+## MADARA baseline for ARM Linux

 Compiling MADARA for any architecture is the same as compiling ACE for any architecture. The main change from the above is that you will need to download an ARM toolchain that is appropriate for the target architecture. An example location to obtain a generic ARM gcc toolchain is from http://www.gnuarm.com (you would have to build gcc from here), or you could use the guide from the Chumby Wiki (http://wiki.chumby.com/index.php?title=GNU_Toolchain). For Parrot AR.Drone 2.0 toolchains, you will probably have to download a different ARM toolchain like the one from Sourcery CodeBench (http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/, requires site registration). Which toolchain you need will depend on the architecture you are compiling for.

@@ -198,6 +198,121 @@
 ~~~~~~

 Open the ACE.sln file inside of %ACE_ROOT%\ace and hit build in Visual Studio. Once finished, ACE will be installed. Then open the MADARA.sln file inside of C:\madara and hit build in Visual Studio. Once finished, Madara will be installed.
+
+----
+
+
+# MADARA with ZeroMQ
+
+MADARA includes support for [ZeroMQ](http://zeromq.org/) for reliable transports using TCP, multicast, interprocess, etc.
+
+Doing the following will install MADARA with reliable ZeroMQ.
+
+## MADARA with ZeroMQ for Linux
+
+Copy and paste the following into a terminal. You can move the export statements into your .bashrc file and type ". ~/.bashrc" to reload the file, if you like. This assumes 4 cores. If you have less or more than this, you can change the CORES variable accordingly. All it's basically doing is causing make to create $CORES jobs to run the build process in parallel (which will be faster on multiple cores).
+
+~~~~~~
+
+export ZMQ_ROOT=/usr/local
+export ACE_ROOT=$HOME/ace/ACE_wrappers
+export MADARA_ROOT=$HOME/madara
+export LD_LIBRARY_PATH=$ACE_ROOT/lib:$MADARA_ROOT/lib:$ZMQ_ROOT/lib:$LD_LIBRARY_PATH
+export PATH=$ACE_ROOT/bin:$MADARA_ROOT/bin:$PATH
+
+export CORES=4
+
+#Make the ace and madara directories in $HOME
+
+mkdir $HOME/ace $HOME/madara
+
+#ACE
+
+svn co svn://svn.dre.vanderbilt.edu/DOC/Middleware/sets-anon/ACE $HOME/ace
+cd $ACE_ROOT/ace
+echo "#include \"ace/config-linux.h\"" > config.h
+cd $ACE_ROOT/include/makeinclude
+echo "include \$(ACE_ROOT)/include/makeinclude/platform_linux.GNU" > platform_macros.GNU
+cd $ACE_ROOT/ace
+perl $ACE_ROOT/bin/mwc.pl -type gnuace ace.mwc
+make -j $CORES
+
+#ZeroMQ
+
+sudo apt-get update
+sudo apt-get install
+sudo apt-get install git libtool pkg-config build-essential autoconf automake uuid-dev
+
+git clone https://github.com/zeromq/libzmq
+cd libzmq
+./autogen.sh && ./configure && make -j 4
+make check && sudo make install && sudo ldconfig
+
+
+#MADARA
+
+git clone git://git.code.sf.net/p/madara/code $HOME/madara
+cd $MADARA_ROOT
+perl $ACE_ROOT/bin/mwc.pl -type gnuace -features zmq=1 MADARA.mwc
+make tests=1 zmq=1 -j $CORES
+~~~~~~
+
+
+----
+
+## MADARA with ZeroMQ for Windows
+
+To install MADARA with ZeroMQ, you'll have to download ZeroMQ separately. However, installation on Windows looks something like this (assuming you install ZeroMQ to C:\zeromq:
+
+Set your environment variables to:
+
+~~~~~~
+PROJECTS_DIR=C:
+MADARA_ROOT=%PROJECTS_DIR%\madara\code
+ACE_ROOT=%PROJECTS_DIR%\ace
+ZMQ_ROOT=C:\zeromq
+PATH=%ACE_ROOT%\lib;%ACE_ROOT%\bin;%MADARA_ROOT%\lib;%MADARA_ROOT%\bin;%ZMQ_ROOT%\lib
+~~~~~~
+
+Setting environment variables in Windows is done by going to your Start menu, right clicking Computer, then clicking Properties, clicking Advanced System Systems, and then Environment Variables. 
+
+~~~~~~
+cd %ZMQ_ROOT%
+cd builds\msvc\vs2013
+libzmq.sln
+~~~~~~
+
+Build the ZMQ project with the settings you will be using. We recommend setting the project to Release and x64 output targets. 
+
+~~~~~~
+mkdir %ZMQ_ROOT%\lib
+
+::if you have compiled for Release x64 output
+cp %ZMQ_ROOT%\bin\x64\Release\v120\dynamic\libzmq.dll %ZMQ_ROOT%\lib\zmq.dll
+cp %ZMQ_ROOT%\bin\x64\Release\v120\dynamic\libzmq.lib %ZMQ_ROOT%\lib\zmq.lib
+
+::if you have compiled for Debug x64 output
+cp %ZMQ_ROOT%\bin\x64\Debug\v120\dynamic\libzmq.dll %ZMQ_ROOT%\lib\zmqd.dll
+cp %ZMQ_ROOT%\bin\x64\Debug\v120\dynamic\libzmq.lib %ZMQ_ROOT%\lib\zmqd.lib
+cp %ZMQ_ROOT%\bin\x64\Debug\v120\dynamic\libzmq.pdb %ZMQ_ROOT%\lib\libzmq.pdb
+
+::you can compile for both in Visual Studio
+~~~~~~
+
+Now, we're going to install MADARA from source. Create a new directory in %PROJECTS_ROOT% called "madara" (C:\madara, if %PROJECTS_ROOT% is set to C:). If using Tortoise Git on Windows, you will want to right click on C:\madara, select Git Clone and put git://git.code.sf.net/p/madara/code into the appropriate input location. If you're using cygwin, you'll get into a terminal and type "git clone git://git.code.sf.net/p/madara/code /madara".
+
+Now, open a terminal ("cmd" at the run prompt in your start menu) and type:
+
+~~~~~~
+cd %ACE_ROOT%\ace
+echo "#include \"ace/config-win32.h\"" > config.h
+%ACE_ROOT%\bin\mwc.pl -type vc12 ace.mwc
+
+cd %MADARA_ROOT%
+mwc.pl -type vc12 -features zmq=1 MADARA.mwc
+~~~~~~
+
+Open the ACE.sln file inside of %ACE_ROOT%\ace and hit build in Visual Studio. Be sure to select settings that you had used in the ZeroMQ installation (e.g., Release and x64 targets). Once finished, ACE will be installed. Then open the MADARA.sln file inside of C:\madara and hit build in Visual Studio. Once finished, Madara will be installed

 ----

InstallationFromSource modified by James Edmondson

James Edmondson — Mon, 01 Jun 2015 06:44:06 -0000

--- v25
+++ v26
@@ -321,7 +321,7 @@
 export MADARA_ROOT=~/madara

 #JAVA_HOME will change depending on your system, make sure to set the correct value
-export JAVA_HOME=/usr/lib/jvm/java-8-oracle/include
+export JAVA_HOME=/usr/lib/jvm/java-8-oracle

 export LD_LIBRARY_PATH=$ACE_ROOT/lib:$MADARA_ROOT/lib:$LD_LIBRARY_PATH
 export PATH=$ACE_ROOT/bin:$MADARA_ROOT/bin:$PATH

InstallationFromSource modified by James Edmondson

James Edmondson — Sun, 24 May 2015 17:59:09 -0000

--- v24
+++ v25
@@ -475,6 +475,90 @@

 ----

+# MADARA with OpenSSL
+
+Doing the following will install MADARA for use with OpenSSL encryption options. Here's the complete step-by-step:
+
+## MADARA with SSL for Windows
+
+
+The installation defaults to not include SSL. If you want to include SSL, you'll need to compile OpenSSL for Windows (or find a distribution at https://www.openssl.org/related/binaries.html that includes /include and /lib folders).
+
+### Setting up OpenSSL
+
+Feel free to either use a binary distribution or compile your own. Either is relatively easy to do.
+
+OpenSSL Binary Distributions
+
+If using a binary distribution, create the following folders (helps with following the later parts to use same directories we are):
+
+~~~~~~
+# Copy the include directory to this location
+%PROJECTS_DIR%\openssl\include
+
+# Copy the .dll and/or .lib files to here
+%PROJECTS_DIR%\openssl\libs
+~~~~~~
+
+Make sure you download the appropriate architecture (e.g. 32 bit SSL or 64 bit SSL, depending on what you want to compile MADARA as).
+
+Alternatively, you can do OpenSSL Source Compilation. Move on to "Set your environment variables" if you have already done the above Binary Distribution step.
+
+OpenSSL Source Compilation
+
+Download a source tarball from https://www.openssl.org/source/ and open it with 7zip or some other zip program that can handle .tar.gz. Extract the source to a directory (preferably %PROJECTS_DIR%\openssl, which should result in something like %PROJECTS_DIR%\openssl\openssl-1.0.2a).
+
+Inside of the source tarball are a set of INSTALL files. We assume you want to build 64 bit SSL here (INSTALL.W64), but the 32 bit SSL instructions can be found in INSTALL.W32. The compilation system for OpenSSL uses the Visual Studio nmake program, which is only really usable via the Visual Studio Command Line Tools (usually accessible via the Start Menu). For instance, Visual Studio 2013 has the command line tool available at "C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\Tools\Shortcuts" and is called "VS2013 x64 Cross Tools Command Prompt". Find the x64 Cross Tools Command Prompt on your system, and then do the following in a terminal window (cmd at Start->Run):
+
+~~~~~~
+# change this change directory to be wherever the OpenSSL tar
+cd %PROJECTS_DIR%\openssl\openssl-1.0.2a
+perl Configure VC-WIN64A
+ms\do_win64a
+nmake -f ms\ntdll.mak
+~~~~~~
+
+If you compiled everything correctly with no errors, you should see a inc32 and out32dll directory inside of your %PROJECTS_DIR%\openssl\openssl-1.0.2a directory (or wherever else you might have installed things to).
+
+Set your environment variables to:
+
+~~~~~~
+PROJECTS_DIR=C:
+MADARA_ROOT=%PROJECTS_DIR%\madara\code
+ACE_ROOT=%PROJECTS_DIR%\ace
+
+# if SSL binaries, set this type of location (or wherever your include and lib dirs are that you create)
+SSL_ROOT=%PROJECTS_DIR%\openssl
+
+# if SSL compilation, try something like the following (this directory should have
+# inc32 and out32dll directories inside of it)
+SSL_ROOT=%PROJECTS_DIR%\openssl\openssl-1.0.2a
+
+PATH=%ACE_ROOT%\lib;%ACE_ROOT%\bin;%MADARA_ROOT%\lib;%MADARA_ROOT%\bin;%SSL_ROOT%\out32dll;%SSL_ROOT%
+~~~~~~
+
+Setting environment variables in Windows is done by going to your Start menu, right clicking Computer, then clicking Properties, clicking Advanced System Systems, and then Environment Variables. See the following image for an example of setting the above variables.
+
+[Setting environment variables](http://i.imgur.com/574VCbg.png "Setting environment variables")
+
+Now, we're going to install MADARA from source. Create a new directory in %PROJECTS_ROOT% called "madara" (C:\madara, if %PROJECTS_ROOT% is set to C:). If using Tortoise Git on Windows, you will want to right click on C:\madara, select Git Clone and put git://git.code.sf.net/p/madara/code into the appropriate input location. If you're using cygwin, you'll get into a terminal and type "git clone git://git.code.sf.net/p/madara/code \madara".
+
+Now, open a terminal ("cmd" at the run prompt in your start menu) and type:
+
+~~~~~~
+cd %ACE_ROOT%\ace
+echo "#include \"ace/config-win32.h\"" > config.h
+%ACE_ROOT%\bin\mwc.pl -type vc12 ace.mwc
+
+cd %MADARA_ROOT%
+mwc.pl -type vc12 -features ssl=1 MADARA.mwc
+~~~~~~
+
+Open the ACE.sln file inside of %ACE_ROOT%\ace and hit build in Visual Studio. Once finished, ACE will be installed. Then open the MADARA.sln file inside of C:\madara and hit build in Visual Studio. Once finished, Madara will be installed.
+
+
+----
+
 # Verifying the installation

 Open two terminals.

InstallationFromSource modified by James Edmondson

James Edmondson — Sat, 16 May 2015 08:12:24 -0000

--- v23
+++ v24
@@ -438,7 +438,7 @@
 ~~~~~~
 cd %BOOST_ROOT%
 .\bootstrap
-.\b2 --with-python link=static link=shared threading=multi address-model=64 runtime-link=shared stage
+.\b2 --with-python link=static link=shared threading=multi address-model=64 stage
 ~~~~~~

 Setup MADARA normally (but change your mwc.pl to the following:

InstallationFromSource modified by James Edmondson

James Edmondson — Sat, 16 May 2015 05:40:00 -0000

--- v22
+++ v23
@@ -431,7 +431,6 @@
 using msvc : 12.0 ;
 # Python configuration:
 using python : 3.4 : C:\\Python34 : C:\\Python34\\include : C:\\Python34\\libs ;
-;
 ~~~~~~

 Perform the following actions (in a new terminal with the BOOST_ROOT, PYTHON_ROOT, PYTHON_VERSION and BOOST_VERSION variables set

InstallationFromSource modified by James Edmondson

James Edmondson — Sat, 16 May 2015 05:34:04 -0000

--- v21
+++ v22
@@ -439,7 +439,7 @@
 ~~~~~~
 cd %BOOST_ROOT%
 .\bootstrap
-.\b2 --with-python link=static threading=multi address-model=64 runtime-link=shared stage
+.\b2 --with-python link=static link=shared threading=multi address-model=64 runtime-link=shared stage
 ~~~~~~

 Setup MADARA normally (but change your mwc.pl to the following: