Skip to content

build.rst

Latest commit

 

History

History
60 lines (44 loc) · 2.49 KB

build.rst

File metadata and controls

60 lines (44 loc) · 2.49 KB

Build Instructions

The following are build instruction for the CALDERA agent and Crater. They should not be necessary for normal users.

Cagent Build Instructions

  1. Install Python 3.5

    Install Python 3.5 can be acquired from the Operating System's package manager or from https://www.python.org/ . The standard installation is straightforward.

  2. Upgrade to setuptools 24.0 or later

    The python package setuptools, version 24.0 or later must be installed. Setuptools comes with Python 3.5, but some versions may not be up to date. To update it, run

    pip install --upgrade setuptools
  3. Install Visual C++ 2015 Build Tools

    Install the Visual C++ 2015 Build Tools. During install check Windows 8.1 SDK and Windows 10 SDK options.

    Note

    If Visual Studio 2015 is already installed, Visual C++ 2015 Build Tools should not need to be installed

  4. Install PyWin32 v.220

    PyWin32 v.220 must be installed

  5. Install py2exe

    A modified version of py2exe must be installed. It should be provided with CALDERA and installed by executing easy_install py2exe-0.9.2.2-py3.5.egg

  6. Install additional Python Dependences

    Additional Python dependencies are downloaded and installed automatically by running the following command within the caldera/dep/caldera-agent/ directory

    pip install -r requirements.txt
  7. Compile Caldera Agent

    Compile the Caldera agent by running the following command twice within the caldera/dep/caldera-agent/caldera_agent/ directory:

    python setup.py

After running the above command twice the caldera agent executable will be built and located at caldera/dep/caldera-agent/caldera_agent/dist/cagent.exe

Crater Build Instructions

Crater must be compiled on a Windows system. If the Caldera server is installed on a Linux system, Crater must be built on Windows and then copied to its build location: caldera/dep/crater/crater/CraterMain.exe

  1. Install Mono
    Download and install Mono.
  2. Run build.bat
    Navigate to the caldera/dep/crater/crater and execute build.bat