Command Line

The current version of HefeWeizen can be installed, run, and removed by a list of shell scripts. These are listed here.

Some notes about the features:

  • It is possible to have two parties setup in one HefeWeizen system and send ebXML messages between the two parties. This is great for testing and learning the system.
  • It is possible to run one party in one HefeWeizen system and start a second HefeWeizen system with the second party in a chroot and have the two exchange ebXML messages. This is also great for testing and learning the system.

How to install the system

There are two parts. The base system and a test system (consisting of two example parties).

Currently there is only one way to install the system and that is via a svn checkout (getting the source directly with a subversion client program).

The installation procedures will check for required software dependencies. See the [DependencyPage] for all required libraries, tools etc.

How to install the base and the test system

% cd HefeWeizen/bin
% sh make-install-all.sh

It is possible to pass the -p option to install only one party of the example parties of the test system (-p Coronation).

To remove an old installation and install a new installation use:

% sh make-reinstall.sh

How to install the base system

% cd HefeWeizen/bin
% sh make-install.sh

How to install the test system

There are two test parties in the package. The first party is called Coronation and the second party is called Gnaraloo.

% cd HefeWeizen/bin
% sh make-install-test-system.sh

To install only one party add the -p option. For example to only install the Coronation party do:

% cd HefeWeizen/bin
% sh make-install-test-system.sh -p Coronation

The -p parameter also works for the make-install-all.sh and the make-reinstall.sh scripts.

How to remove the system

To install everthing simply:

% cd HefeWeizen/bin
% sh make-uninstall-all.sh

How to start the system

% cd HefeWeizen/bin
% sh run-hefeweizen.sh --show-log

This will start the system and not return the command line prompt. The log file (file /home/hefeweizen-env/var/log/hefeweizen/HefeWeizen.log) will be displayed to screen. To stop the system simply hit "Ctrl C" to abort the process. This will cause the system to properly shutdown.

The control center

There is a simplistic command line driven control center. This is useful for testing the test system. Basically it allows to create some directives that trigger the sending of an ebXML message (user message with payload or a simple ping ebXML message). There is a dynamic part that looks at the CPA to list what is possible to be sent.

The control center also uses the statistics which reports about open and closed transactions as well ebXML messages of the sample partie.