IIAB/local vars.yml: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
No edit summary
Line 15: Line 15:
# Original Idea: branch github.com/xsce/xsce-local for your deployment
# Original Idea: branch github.com/xsce/xsce-local for your deployment


# WILL CHANGE to iiab_admin_user: iiab-admin ??
# xsce_admin_user: xsce-admin
# xsce_admin_user: xsce-admin


# WILL CHANGE to iiab_admin_passwd_hash ??
# Obtain a password hash with: python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")'
# Obtain a password hash with: python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")'
# xsce_admin_passw_hash:
# xsce_admin_passw_hash:


# WILL CHANGE to {iiab_hostname, iiab_domain} ??
xsce_hostname: box
xsce_hostname: box
xsce_domain: lan
xsce_domain: lan


# WILL CHANGE to iiab_home_url ??
xsce_home_url: /home
xsce_home_url: /home
host_ssid: "Internet in a Box"
host_ssid: "Internet in a Box"
Line 30: Line 34:
hostapd_password: MYPASSWORD
hostapd_password: MYPASSWORD


# WILL CHANGE to iiab_gateway_enabled ??
xsce_gateway_enabled: False
xsce_gateway_enabled: False


Line 52: Line 57:
wondershaper_enabled: False
wondershaper_enabled: False


# 4-server-options
# 4-SERVER-OPTIONS

authserver_install: False
authserver_install: False
authserver_enabled: False
authserver_enabled: False
Line 61: Line 67:
# The following seems necessary on CentOS:
# The following seems necessary on CentOS:
# openvpn_cron_enabled: True
# openvpn_cron_enabled: True
# If changing the above, remember to run "cd /opt/schoolserver/iiab; ./runtags openvpn"
# If changing the above, remember to run "cd /opt/iiab/iiab; ./runtags openvpn"


samba_install: False
samba_install: False
Line 73: Line 79:
cups_enabled: False
cups_enabled: False


# 5-xoservices
# 5-XO-SERVICES


# Change calibre_port from 8080 to 8010 below, if you enable idmgr !
# Change calibre_port from 8080 to 8010 below, if you enable idmgr !
Line 85: Line 91:
ejabberd_enabled: False
ejabberd_enabled: False


# 6-generic-aps
# 6-GENERIC-APPS


# WARNING: both below WILL be ignored, per others apps needs!
# WARNING: both below WILL be ignored, per other apps' needs!
mysql_install: True
mysql_install: True
mysql_enabled: False
mysql_enabled: False
Line 106: Line 112:
dokuwiki_enabled: False
dokuwiki_enabled: False


# 7-edu-aps
# 7-EDU-APPS


# For OpenStreetMap. Rename to {iiab_install, iiab_enabled} in future?
# Renamed to {iiab_install, iiab_enabled} for OpenStreetMap
iiab_install: True
osm_install: True
iiab_enabled: True
osm_enabled: True
#iiab_install: True
#iiab_enabled: True


kiwix_serve_install: True
kiwix_serve_install: True
Line 134: Line 142:
pathagar_enabled: False
pathagar_enabled: False


# 8-mgmt-tools
# 8-MGMT-TOOLS


schooltool_install: False
schooltool_install: False

Revision as of 01:37, 9 June 2017

This IIAB XSCE content does not reflect the opinion of OLPC. These pages were created by members of a volunteer community supporting OLPC and deployments.

Below is an EXAMPLE /opt/schoolserver/xsce/vars/local_vars.yml derived from Tim Moody's of February 24, 2017: (for IIAB/XSCE 6.2 on Raspberry Pi 3 especially!)

To understand how and why you may want to modify local_vars.yml (to override default_vars.yml) please read IIAB Architecture.

Please also ask directly on our support channels, like http://iiab.io forums, the server-devel mailing list, and live irc chat.

Or return to our Internet-in-a-Box (IIAB/XSCE) Frequently Asked Questions, within question "What is local_vars.yml and how do I customize it?"

# Put variables for your installation that override defaults here

# PLEASE READ http://wiki.laptop.org/go/XS_Community_Edition/local_vars.yml
# SEE EXAMPLE http://download.iiab.io/6.3/rpi/local_vars.yml

# Original Idea: branch github.com/xsce/xsce-local for your deployment

# WILL CHANGE to iiab_admin_user: iiab-admin ??
# xsce_admin_user: xsce-admin

# WILL CHANGE to iiab_admin_passwd_hash ??
# Obtain a password hash with: python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")'
# xsce_admin_passw_hash:

# WILL CHANGE to {iiab_hostname, iiab_domain} ??
xsce_hostname: box
xsce_domain: lan

# WILL CHANGE to iiab_home_url ??
xsce_home_url: /home
host_ssid: "Internet in a Box"
host_wifi_mode: g
host_channel: 6
hostapd_secure: False
hostapd_password: MYPASSWORD

# WILL CHANGE to iiab_gateway_enabled ??
xsce_gateway_enabled: False

# Enables "campus access" to kiwix (3000), kalite (8008) & calibre (8010) via server's WAN.
# See github.com/iiab/iiab/blob/master/roles/network/templates/gateway/xs-gen-iptables
services_externally_visible: True

dns_jail_enabled: False

# 3-BASE

squid_install: True
squid_enabled: False

dhcpd_install: True
dhcpd_enabled: False

dansguardian_install: True
dansguardian_enabled: False

wondershaper_install: False
wondershaper_enabled: False

# 4-SERVER-OPTIONS

authserver_install: False
authserver_enabled: False

# SECURITY WARNING: See http://wiki.laptop.org/go/XS_Community_Edition/Security
openvpn_install: True
openvpn_enabled: False
# The following seems necessary on CentOS:
# openvpn_cron_enabled: True
# If changing the above, remember to run "cd /opt/iiab/iiab; ./runtags openvpn"

samba_install: False
samba_enabled: False

postgresql_install: True
postgresql_enabled: False

# WARNING: Josh Dennis [April 2017] warns that CUPS printing can block Ansible
cups_install: True
cups_enabled: False

# 5-XO-SERVICES

# Change calibre_port from 8080 to 8010 below, if you enable idmgr !
idmgr_install: False
idmgr_enabled: False

xo_services_install: False
xo_services_enabled: False

ejabberd_install: False
ejabberd_enabled: False

# 6-GENERIC-APPS

# WARNING: both below WILL be ignored, per other apps' needs!
mysql_install: True
mysql_enabled: False

phpmyadmin_install: False
phpmyadmin_enabled: False

elgg_install: True
elgg_enabled: False

owncloud_install: True
owncloud_enabled: True

wordpress_install: True
wordpress_enabled: True

dokuwiki_install: True
dokuwiki_enabled: False

# 7-EDU-APPS

# Renamed to {iiab_install, iiab_enabled} for OpenStreetMap
osm_install: True
osm_enabled: True
#iiab_install: True
#iiab_enabled: True

kiwix_serve_install: True
kiwix_serve_enabled: True

kalite_install: True
kalite_enabled: True
kalite_cron_enabled: True

# might stall MongoDB on Power Failure: https://github.com/xsce/xsce/issues/879
sugarizer_install: True
sugarizer_enabled: True

calibre_install: True
calibre_enabled: True
# Change calibre_port to 8010 if you're using XO laptops needing above idmgr !
calibre_port: 8080

moodle_install: True
moodle_enabled: False

pathagar_install: False
pathagar_enabled: False

# 8-MGMT-TOOLS

schooltool_install: False
schooltool_enabled: False

debian_schooltool_install: False
debian_schooltool_enabled: False

sugar_stats_install: False
sugar_stats_enabled: False

ajenti_install: False
ajenti_enabled: False

munin_install: True
munin_enabled: True

monit_install: False
monit_enabled: False

xovis_install: False
xovis_enabled: False

teamviewer_install: False
teamviewer_enabled: False

vnstat_install: True
vnstat_enabled: True

awstats_install: True
awstats_enabled: True

activity-server_install: False
activity_server_enabled: False