happner/docs/starting.md

distributed application engine with evented storage and mesh services

[◀](data.md) data api | system components [▶](system.md)

## Starting a Mesh Node.

MeshNode startup has been divided into two steps.

##### Initialize

* Starts all local internal infrastructure
* Begins listeing on the network.
* Generates local module and componentInstances per the config
* Begins connection attempts to remote MeshNodes (endpoints)
* Assembles the exchange and event api layers
* Ammends the exchange and event api with each established connection to remote MeshNodes
* Reports initialized! (runlevel 20)

##### Start

* Calls the start method on any components that specified one. This allows components an initialization step that occurs after all mesh connections have been made.
* Reports started! (runlevel 40)

These two steps can be done separately (by hand).

```javascript
var Happner = require('happner');

var config = {};
var mesh = new Happner();

mesh.initialize(config, function(err) {
  if (err) ... process.exit(1);

  /* MeshNode is up */

  /* Maybe do some things to mesh before "start" */ 

  mesh.start(function(err) {
    if (err) ... process.exit(2);

    /* MeshNode is up - AND running */

  });
});

```

Alternatively, there may be no reason to get inbetween the runlevels, so one call to the 'factory' will do.

```javascript
var Happner = require('happner');
var config = {};

Happner.create(config, function(err, mesh) {
  /* _ */
});
```