free
/
freedombone
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update the website

This commit is contained in:
Bob Mottram 2015-02-01 21:47:33 +00:00
parent f9f1daa34e
commit 4b200a9992
3 changed files with 59 additions and 57 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
doc/EN/installation.org
View File

@ -68,7 +68,7 @@ scp -r ~/.gnupg username@freedombone_IP_address:/home/username
The interactive server configuration setup is recommended for most users. On the system where freedombone is to be installed create a configuration file. The interactive server configuration setup is recommended for most users. On the system where freedombone is to be installed create a configuration file.
#+BEGIN_SRC bash #+BEGIN_SRC bash
ssh username@freedombone_IP_address ssh myusername@freedombone_IP_address
su su
sudo apt-get update sudo apt-get update
apt-get install git dialog build-essential apt-get install git dialog build-essential
@ -91,32 +91,41 @@ If you don't want to install interactively then it's possible to manually create
On the system where freedombone is to be installed create a configuration file. On the system where freedombone is to be installed create a configuration file.
#+BEGIN_SRC bash #+BEGIN_SRC bash
ssh username@freedombone_IP_address ssh myusername@freedombone_IP_address
su su
sudo apt-get update sudo apt-get update
apt-get install git build-essential apt-get install git build-essential
git clone https://github.com/bashrc/freedombone git clone https://github.com/bashrc/freedombone
cd freedombone cd freedombone
make install make install
nano /home/username/freedombone/freedombone.cfg nano /home/myusername/freedombone/freedombone.cfg
#+END_SRC #+END_SRC
Add the following, and set the values as needed. Add the following, and set the values as needed. Note that for a full install DOMAIN_NAME should be the same as the wiki domain name.
#+BEGIN_SRC bash #+BEGIN_SRC bash
MY_EMAIL_ADDRESS= MY_USERNAME=myusername
MY_NAME= DOMAIN_NAME=mywikidomain
MY_BLOG_TITLE= SYSTEM_TYPE=full
MY_BLOG_SUBTITLE= INSTALLING_ON_BBB=no
FULLBLOG_DOMAIN_NAME= DDNS_PROVIDER=default@freedns.afraid.org
MICROBLOG_DOMAIN_NAME= DDNS_USERNAME=ddnsusername
REDMATRIX_DOMAIN_NAME= DDNS_PASSWORD=ddnspassword3471326
OWNCLOUD_DOMAIN_NAME= MY_NAME=MyFullNameOrNick
WIKI_DOMAIN_NAME= MY_EMAIL_ADDRESS=myusername@mywikidomain
WIKI_TITLE= LOCAL_NETWORK_STATIC_IP_ADDRESS=192.168.1.60
ROUTER_IP_ADDRESS=192.168.1.254
ENABLE_CJDNS=no ENABLE_CJDNS=no
LOCAL_NETWORK_STATIC_IP_ADDRESS= DEBIAN_REPO=ftp.us.debian.org
ROUTER_IP_ADDRESS= NAMESERVER1=85.214.73.63
NAMESERVER2=213.73.91.35
WIKI_TITLE=my wiki title
WIKI_DOMAIN_NAME=mywikidomain
MY_BLOG_TITLE=my blog
FULLBLOG_DOMAIN_NAME=myblogdomain
MICROBLOG_DOMAIN_NAME=mymicroblogdomain
REDMATRIX_DOMAIN_NAME=myredmatrixdomain
OWNCLOUD_DOMAIN_NAME=myownclouddomain
#+END_SRC #+END_SRC
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. 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.
@ -126,18 +135,12 @@ Save the configuration file and exit from your editor.
Now you can begin the installation. If you are doing this on a Beaglebone Black: Now you can begin the installation. If you are doing this on a Beaglebone Black:
#+BEGIN_SRC bash #+BEGIN_SRC bash
freedombone --bbb -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password] freedombone -c freedombone.cfg
#+END_SRC #+END_SRC
Or on any other system don't include the *--bbb* option. The above command should be run in the same directory in which your configuration file exists.
#+BEGIN_SRC bash Also see the manpage for additional options which can be used instead of a configuration file.
freedombone -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password]
#+END_SRC
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.
* Post-Setup * Post-Setup
Setup of the server and installation of all the relevant packages is not quick, and depends upon which variant you choose and your internet bandwidth. Allow about three hours for a full installation on the Beaglebone Black. On the Beaglebone installation is in two parts, since a reboot is needed to enable the hardware random number generator and zram. Setup of the server and installation of all the relevant packages is not quick, and depends upon which variant you choose and your internet bandwidth. Allow about three hours for a full installation on the Beaglebone Black. On the Beaglebone installation is in two parts, since a reboot is needed to enable the hardware random number generator and zram.
@ -145,7 +148,7 @@ Setup of the server and installation of all the relevant packages is not quick,
When done you can ssh into the Freedombone with: When done you can ssh into the Freedombone with:
#+BEGIN_SRC bash #+BEGIN_SRC bash
ssh username@domain -p 2222 ssh myusername@domain -p 2222
#+END_SRC #+END_SRC
Any manual post-installation setup instructions or passwords can be found in /home/username/README. You should remove any passwords from that file and store them within a password manager such as KeepassX. Any manual post-installation setup instructions or passwords can be found in /home/username/README. You should remove any passwords from that file and store them within a password manager such as KeepassX.

BIN
man/freedombone.1.gz
View File

Binary file not shown.

61
website/EN/installation.html
View File

@ -4,7 +4,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head> <head>
<title></title> <title></title>
<!-- 2015-01-25 Sun 22:51 --> <!-- 2015-02-01 Sun 21:46 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" /> <meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" /> <meta name="author" content="Bob Mottram" />
@ -308,7 +308,7 @@ The interactive server configuration setup is recommended for most users. On the
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">ssh username@freedombone_IP_address <pre class="src src-bash">ssh myusername@freedombone_IP_address
su su
sudo apt-get update sudo apt-get update
apt-get install git dialog build-essential apt-get install git dialog build-essential
@ -347,36 +347,45 @@ On the system where freedombone is to be installed create a configuration file.
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">ssh username@freedombone_IP_address <pre class="src src-bash">ssh myusername@freedombone_IP_address
su su
sudo apt-get update sudo apt-get update
apt-get install git build-essential apt-get install git build-essential
git clone https://github.com/bashrc/freedombone git clone https://github.com/bashrc/freedombone
<span class="org-builtin">cd</span> freedombone <span class="org-builtin">cd</span> freedombone
make install make install
nano /home/username/freedombone/freedombone.cfg nano /home/myusername/freedombone/freedombone.cfg
</pre> </pre>
</div> </div>
<p> <p>
Add the following, and set the values as needed. Add the following, and set the values as needed. Note that for a full install DOMAIN_NAME should be the same as the wiki domain name.
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash"><span class="org-variable-name">MY_EMAIL_ADDRESS</span>= <pre class="src src-bash"><span class="org-variable-name">MY_USERNAME</span>=myusername
<span class="org-variable-name">MY_NAME</span>= <span class="org-variable-name">DOMAIN_NAME</span>=mywikidomain
<span class="org-variable-name">MY_BLOG_TITLE</span>= <span class="org-variable-name">SYSTEM_TYPE</span>=full
<span class="org-variable-name">MY_BLOG_SUBTITLE</span>= <span class="org-variable-name">INSTALLING_ON_BBB</span>=no
<span class="org-variable-name">FULLBLOG_DOMAIN_NAME</span>= <span class="org-variable-name">DDNS_PROVIDER</span>=default@freedns.afraid.org
<span class="org-variable-name">MICROBLOG_DOMAIN_NAME</span>= <span class="org-variable-name">DDNS_USERNAME</span>=ddnsusername
<span class="org-variable-name">REDMATRIX_DOMAIN_NAME</span>= <span class="org-variable-name">DDNS_PASSWORD</span>=ddnspassword3471326
<span class="org-variable-name">OWNCLOUD_DOMAIN_NAME</span>= <span class="org-variable-name">MY_NAME</span>=MyFullNameOrNick
<span class="org-variable-name">WIKI_DOMAIN_NAME</span>= <span class="org-variable-name">MY_EMAIL_ADDRESS</span>=myusername@mywikidomain
<span class="org-variable-name">WIKI_TITLE</span>= <span class="org-variable-name">LOCAL_NETWORK_STATIC_IP_ADDRESS</span>=192.168.1.60
<span class="org-variable-name">ROUTER_IP_ADDRESS</span>=192.168.1.254
<span class="org-variable-name">ENABLE_CJDNS</span>=no <span class="org-variable-name">ENABLE_CJDNS</span>=no
<span class="org-variable-name">LOCAL_NETWORK_STATIC_IP_ADDRESS</span>= <span class="org-variable-name">DEBIAN_REPO</span>=ftp.us.debian.org
<span class="org-variable-name">ROUTER_IP_ADDRESS</span>= <span class="org-variable-name">NAMESERVER1</span>=85.214.73.63
<span class="org-variable-name">NAMESERVER2</span>=213.73.91.35
<span class="org-variable-name">WIKI_TITLE</span>=my wiki title
<span class="org-variable-name">WIKI_DOMAIN_NAME</span>=mywikidomain
<span class="org-variable-name">MY_BLOG_TITLE</span>=my blog
<span class="org-variable-name">FULLBLOG_DOMAIN_NAME</span>=myblogdomain
<span class="org-variable-name">MICROBLOG_DOMAIN_NAME</span>=mymicroblogdomain
<span class="org-variable-name">REDMATRIX_DOMAIN_NAME</span>=myredmatrixdomain
<span class="org-variable-name">OWNCLOUD_DOMAIN_NAME</span>=myownclouddomain
</pre> </pre>
</div> </div>
@ -394,26 +403,16 @@ Now you can begin the installation. If you are doing this on a Beaglebone Black:
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone --bbb -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password] <pre class="src src-bash">freedombone -c freedombone.cfg
</pre> </pre>
</div> </div>
<p> <p>
Or on any other system don't include the <b>&#x2013;bbb</b> option. The above command should be run in the same directory in which your configuration file exists.
</p>
<div class="org-src-container">
<pre class="src src-bash">freedombone -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password]
</pre>
</div>
<p>
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.
</p> </p>
<p> <p>
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 <b>freedombone.cfg</b> file then it should be in the same directory from which the <b>freedombone</b> command is run. Also see the manpage for additional options which can be used instead of a configuration file.
</p> </p>
</div> </div>
</div> </div>
@ -431,7 +430,7 @@ When done you can ssh into the Freedombone with:
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">ssh username@domain -p 2222 <pre class="src src-bash">ssh myusername@domain -p 2222
</pre> </pre>
</div> </div>