Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 4446e70154

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
Failed to load latest commit information.
README.md
edoc-info
erlang.png
overview.edoc
setup.md
setup_gen.md
stylesheet.css
template.conf

README.md

The setup application

The setup application

Generic setup utility for Erlang-based systems

Introduction

.

Authors: Ulf Wiger (ulf.wiger@erlang-solutions.com).Generic setup utility for Erlang-based systems

Introduction

While Erlang/OTP comes with many wonderful applications, including the Mnesia DBMS, there is no standard or convention for installing a system. Erlang/OTP provides tools for building a boot script, and rules for setting environment variables, etc., and Mnesia offers an API for creating and modifying the database schema.

However, with no convention for when these tools and API functions are called - and by whom - application developers are left having to invent a lot of code and scripts, not to mention meditate over chapters of Erlang/OTP documentation in order to figure out how things fit together.

This utility offers a framework for initializing and configuring a system, with a set of conventions allowing each component to provide callbacks for different steps in the installation procedure.

The callbacks are defined through OTP application environment variables, which can easily be overriden at install time.

The setup_gen utility

The setup_gen utility is a simple tool to generate .rel file and boot script for an Erlang-based system. It fetches configuration options from a .conf file (read using file:script/2). As an example of a very simple build, see examples/gproc.conf':

[{apps, [kernel,
stdlib,
sasl,
gproc]}].

This configuration file simply lists the applications to start from the boot script. The setup_gen script can either be called from within Erlang as:

Eshell V5.8.1  (abort with ^G)
1> setup_gen:run([{conf,"gproc.conf"},{outdir,"."},{name,"gproc"}]).
Options = [{conf,"gproc.conf"},{outdir,"."},{name,"gproc"}]
Paths = []
add path Res = ok
app_vsn(kernel) -> "2.14.1"
app_vsn(stdlib) -> "1.17.1"
app_vsn(sasl) -> "2.1.9.2"
app_vsn(gproc) -> "0.01"
Rel: {release,{"gproc","tmp"},
{erts,"5.8.1"},
[{kernel,"2.14.1"},
{stdlib,"1.17.1"},
{sasl,"2.1.9.2"},
{gproc,"0.01"}]}
entering directory .
Path = []
make_script() -> ok
ok

...or as an escript:

escript ~/git/setup/ebin/setup_gen.beam gproc gproc.conf .

If the option -install true is given, the setup_gen utility will generate an installation boot script, and install.config file, which can be used to install the system, using a command like:

erl -sys install -boot install

This boot script will run kernel, stdlib and sasl, then load all other applications, and finally run the setup application, which will find and execute any setup hooks.

If the option -setup stop_when_done true is added to the command line, the setup application will terminate the Erlang VM when finished.

Modules

setup
setup_gen
Something went wrong with that request. Please try again.