Changes

This is [[Deployment_Platform/Deployment|one of possible]] deployment scenarios of [[Deployment_Platform]]. This page is intended to describe procedures for school servers that behave as gateways for school students.

This is [[Deployment_Platform/Deployment|one of possible]] deployment scenarios of [[Deployment_Platform]]. This page is intended to describe procedures for school servers that behave as gateways for school students.

=== Targeting environment ===

<big>'''Targeting environment'''</big>

The standard targeting environment, final environment might be similar, assumes:

The standard targeting environment, final environment might be similar, assumes:

* School server;

* Dedicated hardware for school server;

* Client machines connected via Intranet to the server.

* Client machines connected via Intranet to the server.

=== Run Sugar Network node ===

=== Run Sugar Network node ===

[[Sweets_Distribution#Add_repository|Attach]] ''Factory'' [[Sweets Distribution]] repository and install {{Code|sugar-network}} package.

[[Sweets_Distribution#Add_repository|Attach]] 0.94:SugarNetwork [[Sweets Distribution]] repository and install the {{Code|sugar-network}} package.

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

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

  [main]

  [main]

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

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

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

The {{Code|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 {{Code|sugar-network-sync}} shell script (which will be created by {{Code|offline-sync}} command in targeting path) in environment with Internet connectivity. Then, re-run {{Code|offline-sync}} command specifying path with new file synchronization files.

== Client side ==

== Client side ==

=== Configuration ===

<big>'''Configuration'''</big>

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

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

  [client]

  [client]

  api-url = http://''SCHOOL-SERVER-HOST-HERE'':8000

  api-url = http://''SCHOOL-SERVER-HOST-HERE'':8000

=== Run Sugar Network clients ===

<big>'''Run Sugar Network clients'''</big>

Right now, the easiest way to get working Sugar Network clients is using Sugar Shell with embedded Sugar Network support.

Follow the [[Sugar_Network#On_desktop|Try it]] install instructions to setup Sugar Network client.

On XO laptops, use [[Deployment_Platform/XO_reference_distribution#Try_reference_implementation|one of reference images]] or final deployment ones like from [http://pe.sugarlabs.org/go/Proyecto_Piloto_Hexoquinasa Hexoquinasa] project.

While working, Sugar Network client logs can be found {{Code|~/.sugar/default/logs/sugar-network-client}} file. Logging verbosity level depends on [[BugSquad/Get_Logs#Enabling_Sugar_debug_logging|global Sugar setting]].

 

 

 

Sugar Network client logs can be found {{Code|~/.sugar/default/logs/sugar-network-client}} file. Logging verbosity level depends on [[BugSquad/Get_Logs#Enabling_Sugar_debug_logging|global Sugar setting]].