From f9f1daa34e7bfa49faab9e3d9c02f63d4e32702b Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Sun, 1 Feb 2015 21:36:32 +0000 Subject: [PATCH] Update the documentation on installation --- README.md | 49 ++++--------------------------------------- man/freedombone.1.gz | Bin 3595 -> 3856 bytes 2 files changed, 4 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index 806ba76d..4dd5598e 100644 --- a/README.md +++ b/README.md @@ -84,52 +84,11 @@ Now the easiest way to install the system is via the interactive setup. You can select which variant you wish to install and then enter the details as requested. -Non-Interactive Setup -===================== -If you don't want to install interactively then it's possible to manually create a configuration file as follows: +Other types of setup +==================== +See the manpage for details on other kinds of non-interactive setup. -On the system where freedombone is to be installed create a configuration file. - - ssh username@freedombone_IP_address - su - sudo apt-get update - apt-get install git - git clone https://github.com/bashrc/freedombone - cd freedombone - make install - nano /home/username/freedombone/freedombone.cfg - -Add the following, and set the values as needed. - - MY_EMAIL_ADDRESS= - MY_NAME= - MY_BLOG_TITLE= - MY_BLOG_SUBTITLE= - FULLBLOG_DOMAIN_NAME= - MICROBLOG_DOMAIN_NAME= - REDMATRIX_DOMAIN_NAME= - OWNCLOUD_DOMAIN_NAME= - WIKI_DOMAIN_NAME= - WIKI_TITLE= - ENABLE_CJDNS=no - LOCAL_NETWORK_STATIC_IP_ADDRESS= - ROUTER_IP_ADDRESS= - -Both of the IP addresses are local IP addresses, typically of the form 192.168.x.x, with one being for the system and the other being for the internet router. - -Save the configuration file and exit from your editor. - -Now you can begin the installation. If you are doing this on a Beaglebone Black: - - freedombone --bbb -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password] - -Or on any other system don't include the *--bbb* option. - - freedombone -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password] - -The above command should be run in the same directory in which your configuration file exists. You can use any of your domains as the default one, but typically the default domain is the same as the one for your wiki. - -Also see the manpage for additional options which can be used instead of a configuration file. If you don't specify a variant type with the final option then everything will be installed. If you have a *freedombone.cfg* file then it should be in the same directory from which the *freedombone* command is run. + man freedombone Post-Setup ========== diff --git a/man/freedombone.1.gz b/man/freedombone.1.gz index 9dfc94dd4ae75906825d91ed800b5fb19821976d..86899008cc9ba11b3d0ff66fb9322c28af82a992 100644 GIT binary patch literal 3856 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 SFz(wttM%VAk6B2WCjbBpy{TdV literal 3595 zcmV+m4)pOKiwFSDl+IKD1Jzk;a~ek${m!rG(iiV~4YK5ytlDe^BrFjlpcoX#>rJ`l z(ZED7J(=ziB9+?TzUSWV8F~2^ny(~nm zvU$2Fi_oMhbJK#)qwypd1V=4_&!65-#25Sy)9h!_F2$D;t7PF?;x8?}=&d$#EzCBT zKR;{nN8p{!46I6Tx}mA~GT ztEx>FuT+`T!^f`S@bE$=>(CVGLp6R{H9W?P!FZFxvKzXvqaeowFoZG8hJoNwT9rlY zZKd_H2_kC9RbfO{t|MRJt5loD$VnNkpaJZ}cEkP6d&CM*@~4b=O~Tg2P*8(hTFaA}(ZTuoLMYhCw_}r`+dy5%exzh^RCo)!8!xSg%u> zhO?MuXrRvmBwMb+LM+1~*@OjlgGdTonEn-Wxq%jO3PQ?#Sm0DfcZianiw`A);7)#C zIUOzJz1$jHalwOb0Om+NoQrPeknQBc_rIE437N&kHs_m@)O`!&6)uQc&f#zAMCAGO z3mTLeA_eFmT*)lK1!!`tAjC+)O|nQ56_;?!M#v;J)rkTXry&k(|1aPUfap8gl8*#- z!l9X-XvM41ts7~tgO$Q_F)d+AYx>RCNn@Zym+_ML>2f&gl7RD72yK@dtO6wwl9Z-H zZOO=CpEQZr{8T_E#ksgvum(2z5f&_* z-2-rznL_1T=N>vjbOBVd>M~1XwlQsW&5NrC#=5L!8*QN;8_+;|5Cjb?BrQNlv-3GF zTN;z=^W)=48fcK`tBxubY(v0mAvZ)65Qs+(fQHIo!stN+xpypQ$C-p8by#efLN$vG z^AcQ(<_U#C#K!TRG%$xWUgxw+l4_!K{|Yax-ZbA)Lq_OLGw-%g@7mpyv6ov%cqgsq zte@Rx@v=}EmbVNQL$?~3w!WCI(-A$Krp)a|;YzFB9#-u!G!sd&Qm|OEh(fNFk>HZ< z9#!t3K^vH-2^xBah=~m$I?x5jc{C83pBqbNz<8URYB!Kddq&#-o+_yQ!$%BiKMV>i)d0*95G_5$&8nFIGWa;ciC2@6;%c#s&2 z>@;ZuxTF{+Ou^j<4v8h4v7lvHMjZ(1I12T$h>v~U(wsOE`%UZcuFjsED7&|pgV|9l zNVAwk1?8k#gnL-pEK{)ZCdEM`Qdb7csvV%05VS4WNzHR&GF?W$)FavAYzC17vV1ux z?KiNIb~~^)mE@CPYHdgnd2G5S#W@3kP?akXV;$dEV}_j;P`~pO4q20Ff6|?@ zjfxNBsp$2)SHpg9JnD6__^~g7{_J+b zNm-+8cBsxrk}f&wsY5fD53MPVrcE^LD)TvZ!jHPC{Si!az+HMG_GT=AY<0Zz_ix@6Ls0VL{Y z*47tuBrgjW8d-`9N#AfAI8#k$qw%PH07VY)i6Y-u*=HT+?C!AI+RfN$`<$@mLUf&N zAA|%QXs#%f*ND#k-{AJY!WlJWA^dHV0sM9R-<^04*mM&cs#@`at!y4a3`@=T;i{Aj z2qI8M18sBj`D_2CI~acLUS3Z7LGWGGN)HM3AHCuD>g#MU8}2m)w>_`*!|ia$&6i^= zIr5hnTujG@yQclio9=8n_~~)i_|xcOIKI7n-1BMhaqvW|cb@*J+Z*=3a>eeuOmW+A ze9;|#9rb6Q#?y~qkzLFN7le$)^{3-om`9_z)k6|lg|)j$463Z?kkL{0_W+=>qvpKT zMxY%_X;q{ZA?C>3`hH61sDW;pC>!_Ks>S2b?ffyf*(Vo%M|%A5@#s;>J}!Joo_jUilr@PyXOR&h- z>xfh@T|iHRy*razfMh$jc~Zf}J;=V{rgSdjbWRysWMixHUD;Uex!9$eq>wt58V9qs^Tz=PY}E^% z4e7knLmk{#fk%OG;hsd`>LJ?ZY)1TArtzJ128qlO_-R|Vc^p{8OQp1>3l@3JG7*|K zX=0WgDh`4%04~z!l1fDoLt)FPNOZg+w>#nCQhOb1dL4~(mx+aD zNBmsHr2E*L@GC$yfzAu46m>QJqm9COr9f+u5$ZzqP&3b&BiRY+`>^-`PvycLsjv>({U9 z&HxtZ&m^tZo%~GUb)LL``SQumvs15=pB?zu8!XuA;J>d9blUID>D%`QXP&*JnP(?; z=U{r#IPKfF@83Py`5s^0d6k-G=j)TRy0h;dS$E<)ee-nZo3nRMcfNl6jhXM??}Whb zF}u#Uuiw3*1360U1_5HVOQhtJ9n4ixQ(~U4>i2-1-24jP#V=T#Qv z2!I}Jh}gEitMDw5?a=#JMs5OMc)@HQYMXcr@ZSJ^^aC3Dq54P$??_X>Rj}@@6S&A zug