Deployment Platform/Gateway: Difference between revisions

Line 3:

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:

* ~~School~~ server;

* Dedicated hardware for school server;

* Client machines connected via Intranet to the server.

Line 14:

=== 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]

Line 63:

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 ==

~~===~~ 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]

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]].

~~On regular desktops:~~

* [[Sweets_Distribution#Add_repository|Attach]] ''Factory'' [[Sweets Distribution]] repository;

* [[Sweets_Distribution#Installation|Install]] {{Code|sweets-desktop}} package;

* [[Sweets_Distribution#Usage|Run]] newly installed Sugar Shell;

* By default, Sugar Shell looks the same as in pristine Glucose. To start using Sugar Network related improvements in the Shell UI, go to the Sweets Distribution component in the Control Panel, enable the integration checkbox, and restart Sugar. After restarting, [[Platform_Team/Sugar_Network/Web_UI|Web UI]] client will be available from the Activities tray and the F8 shortcut key. [[Sugar_Network/Contributor_Hub|Contributor Hub]] client can be launched from F8 as regular Sugar Network application.

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]].

@@ Line 3: / Line 3: @@
 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:
-* School server;
+* Dedicated hardware for school server;
 * Client machines connected via Intranet to the server.
@@ Line 14: / Line 14: @@
 === 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]
@@ Line 63: / Line 63: @@
   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 ==
-=== 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]
   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]].
-On regular desktops:
-* [[Sweets_Distribution#Add_repository|Attach]] ''Factory'' [[Sweets Distribution]] repository;
-* [[Sweets_Distribution#Installation|Install]] {{Code|sweets-desktop}} package;
-* [[Sweets_Distribution#Usage|Run]] newly installed Sugar Shell;
-* By default, Sugar Shell looks the same as in pristine Glucose. To start using Sugar Network related improvements in the Shell UI, go to the Sweets Distribution component in the Control Panel, enable the integration checkbox, and restart Sugar. After restarting, [[Platform_Team/Sugar_Network/Web_UI|Web UI]] client will be available from the Activities tray and the F8 shortcut key. [[Sugar_Network/Contributor_Hub|Contributor Hub]] client can be launched from F8 as regular Sugar Network application.
-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]].