Deployment Platform/Gateway

Background
This is one of the possible deployment scenarios for Deployment Platform. This page is intended to describe procedures for school servers that behave as gateways for school students.

Targeting environment

The standard targeting environment assumes:

The final environment might be similar.
 * Dedicated hardware for school server;
 * Client machines connected via Intranet to the server.

Run Sugar Network node
Attach 0.94:SugarNetwork Sweets Distribution repository and install the sugar-network package.

Before running installed server, populate the /etc/sugar-network/config configuration file with content similar to the following (to get the full list of configuration options, call the sugar-network-node config command):

[main] debug = 3 logdir = /var/log/sugar-network rundir = /var/run/sugar-network cachedir = /var/cache/sugar-network [node] host = 0.0.0.0 port = 8000 data-root = /var/lib/sugar-network/db files-root = /var/lib/sugar-network/files stats-root = /var/lib/sugar-network/stats trust-users = True
 * 1) debug logging level; 0 means only warning and errors
 * 1) path to a directory to place log files
 * 1) path to a directory to place pid files
 * 1) if specified, use this directory for cached files; such files might take
 * 2) considerable number of bytes
 * 1) directories to place server data
 * 1) switch off user credentials check; disabling this option will require
 * 2) OpenSSH-5.6 or later

Make sure that all directories in the config file are created and the current user has write permissions there.

Run node server:

sugar-network-node start

Server will start serving Sugar Network API for clients from host:port specified in configuration file.

Synchronization with master node
Note that the newly installed Sugar Network node will be empty, its content should be fetched from the master node.

If school server has Internet connectivity, launch sugar-network-node and start online synchronization:

sugar-network-node online-sync

If only sneakernet is available:

sugar-network-node offline-sync PATH-TO-PLACE-SYNCHRONIZATION-FILES

The PATH-TO-PLACE-SYNCHRONIZATION-FILES path will contain files that should be uploaded to the master to download response. Postponed synchronization will happen by running the sugar-network-sync shell script (which will be created by offline-sync command in targeting path) in environment with Internet connectivity. Then, re-run offline-sync command specifying path with new file synchronization files.

Client side
Configuration

Clients should be pointed to the Sugar Network node launched on a school server. Populate the /etc/sweets.conf configuration file with the following options:

[client] api-url = http://SCHOOL-SERVER-HOST-HERE:8000

Run Sugar Network clients

Follow the Try it install instructions to setup Sugar Network client.

While working, Sugar Network client logs can be found in the ~/.sugar/default/logs/sugar-network-client file. The logging verbosity level depends on the global Sugar setting.