Bläddra i källkod

Beginning of updating the documentation

Bob Mottram 10 år sedan
förälder
incheckning
5ee0efa542
2 ändrade filer med 18 tillägg och 20 borttagningar
  1. 7
    9
      README.md
  2. 11
    11
      doc/installation.org

+ 7
- 9
README.md Visa fil

31
 
31
 
32
 You will also need to know, or find out, the IP address of your internet router and have a suitable static IP address for the Beaglebone on your local network. The router should allow you to forward ports to the Beaglebone (often this is under firewall or "advanced" settings).
32
 You will also need to know, or find out, the IP address of your internet router and have a suitable static IP address for the Beaglebone on your local network. The router should allow you to forward ports to the Beaglebone (often this is under firewall or "advanced" settings).
33
 
33
 
34
-Check that within *initial_setup.sh* the router IP address and static IP for the Beaglebone are set correctly.
34
+Plug the microSD card into your laptop/desktop and then run the *freedombone-prep* command. For example:
35
 
35
 
36
-Plug the microSD card into your laptop/desktop and then run the *initial_setup.sh* script. For example:
37
-
38
-    ./initial_setup.sh /dev/sdX
36
+    freedombone-prep -d /dev/sdX --ip <static LAN IP> --iprouter <router LAN IP>
39
 
37
 
40
 where /dev/sdX is the device name for the microSD card. Often it's /dev/sdb or /dev/sdc, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient.
38
 where /dev/sdX is the device name for the microSD card. Often it's /dev/sdb or /dev/sdc, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient.
41
 
39
 
42
-When the initial setup is done follow the instructions on screen to run the main Freedombone script. You can either edit the variables within the *install-freedombone.sh* script directly, or create a separate configuration file called *freedombone.cfg* which contains those variables. Variables which you might want to put into a *freedombone.cfg* file are:
40
+When the initial setup is done follow the instructions on screen to run the main Freedombone script. You can create a separate configuration file called *freedombone.cfg* which contains those variables. Variables which you might want to put into a *freedombone.cfg* file are:
43
 
41
 
44
     MY_EMAIL_ADDRESS=
42
     MY_EMAIL_ADDRESS=
45
     MY_NAME=
43
     MY_NAME=
66
 
64
 
67
 The FreeDNS subdomain codes can be found under "Dynamic DNS" and "quick cron example". On the last line it will be the string located between the '?' and the '==' characters.
65
 The FreeDNS subdomain codes can be found under "Dynamic DNS" and "quick cron example". On the last line it will be the string located between the '?' and the '==' characters.
68
 
66
 
69
-The syntax of the *install-freedombone.sh* script is:
67
+The syntax of the *freedombone* command is:
70
 
68
 
71
-    ./install-freedombone.sh [domain name] [username] [FreeDNS subdomain code] [optional variant type]
69
+    freedombone --bbb -d [domain name] -u [username] -c [FreeDNS subdomain code] -s [optional variant type]
72
 
70
 
73
-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 as *install-freedombone.sh*.
71
+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.
74
 
72
 
75
 Installation 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.
73
 Installation 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.
76
 
74
 
82
 
80
 
83
 Non-Beaglebone hardware
81
 Non-Beaglebone hardware
84
 =======================
82
 =======================
85
-It's also possible to install Freedombone onto other hardware. Any system with a fresh installation of Debian Jessie will do. Just make sure that you change the variable INSTALLING_ON_BBB to "no" within *freedombone.cfg* or the *install-freedombone.sh* script. Obviously, you don't need to run the *initial_setup.sh* script on non-Beaglebone systems.
83
+It's also possible to install Freedombone onto other hardware. Any system with a fresh installation of Debian Jessie will do. Just make sure that you change the variable INSTALLING_ON_BBB to "no" within *freedombone.cfg* or do not include the *--bbb* option within the *freedombone* command. Obviously, you don't need to run the *freedombone-prep* command on non-Beaglebone systems.

+ 11
- 11
doc/installation.org Visa fil

9
 #+END_CENTER
9
 #+END_CENTER
10
 | [[file:index.html][Home]] | [[Download the code]] | [[On a Beaglebone Black]] | [[On a laptop/PC/netbook]] | [[Internet Router]] |
10
 | [[file:index.html][Home]] | [[Download the code]] | [[On a Beaglebone Black]] | [[On a laptop/PC/netbook]] | [[Internet Router]] |
11
 
11
 
12
-* Download the code
12
+* Download and install the code
13
 Firstly you'll need to download the code as follows:
13
 Firstly you'll need to download the code as follows:
14
 
14
 
15
 #+BEGIN_SRC bash
15
 #+BEGIN_SRC bash
16
 sudo apt-get install git
16
 sudo apt-get install git
17
 git clone https://github.com/bashrc/freedombone
17
 git clone https://github.com/bashrc/freedombone
18
 cd freedombone
18
 cd freedombone
19
+make install
19
 #+END_SRC
20
 #+END_SRC
20
 * On a Beaglebone Black
21
 * On a Beaglebone Black
21
 To get started you will need:
22
 To get started you will need:
32
 
33
 
33
 You will also need to know, or find out, the IP address of your internet router and have a suitable static IP address for the Beaglebone on your local network. The router should allow you to forward ports to the Beaglebone (often this is under firewall or "advanced" settings).
34
 You will also need to know, or find out, the IP address of your internet router and have a suitable static IP address for the Beaglebone on your local network. The router should allow you to forward ports to the Beaglebone (often this is under firewall or "advanced" settings).
34
 
35
 
35
-Check that within *initial_setup.sh* the router IP address and static IP for the Beaglebone are set correctly.
36
-
37
-Plug the microSD card into your laptop/desktop and then run the *initial_setup.sh* script. For example:
36
+Plug the microSD card into your laptop/desktop and then run the *freedombone-prep* command. For example:
38
 
37
 
39
 #+BEGIN_SRC bash
38
 #+BEGIN_SRC bash
40
-./initial_setup.sh /dev/sdX
39
+freedombone-prep -d /dev/sdX --ip <static LAN IP> --iprouter <router LAN IP>
41
 #+END_SRC
40
 #+END_SRC
42
 
41
 
43
 where */dev/sdX* is the device name for the microSD card. Often it's */dev/sdb* or */dev/sdc*, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient.
42
 where */dev/sdX* is the device name for the microSD card. Often it's */dev/sdb* or */dev/sdc*, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient.
44
 
43
 
45
-When the initial setup is done follow the instructions on screen to run the main Freedombone script. You can either edit the variables within the *install-freedombone.sh* script directly, or create a separate configuration file called *freedombone.cfg* which contains those variables. Variables which you might want to put into a *freedombone.cfg* file are:
44
+When the initial setup is done follow the instructions on screen to run the main Freedombone script. You can create a separate configuration file called *freedombone.cfg* which contains those variables. Variables which you might want to put into a *freedombone.cfg* file are:
46
 
45
 
47
 #+BEGIN_SRC bash
46
 #+BEGIN_SRC bash
48
 MY_EMAIL_ADDRESS=<your email address>
47
 MY_EMAIL_ADDRESS=<your email address>
72
 
71
 
73
 The [[https://freedns.afraid.org/][FreeDNS]] subdomain codes can be found under "Dynamic DNS" and "quick cron example". On the last line it will be the string located between the '?' and the '==' characters.
72
 The [[https://freedns.afraid.org/][FreeDNS]] subdomain codes can be found under "Dynamic DNS" and "quick cron example". On the last line it will be the string located between the '?' and the '==' characters.
74
 
73
 
75
-The syntax of the *install-freedombone.sh* script is:
74
+The syntax of the *freedombone* command is:
76
 
75
 
77
 #+BEGIN_SRC bash
76
 #+BEGIN_SRC bash
78
-./install-freedombone.sh <your wiki domain name> <your username> <your wiki FreeDNS domain code> [optional variant type]
77
+freedombone --bbb -d [domain name] -u [username] -c [FreeDNS subdomain code] -s [optional variant type]
79
 #+END_SRC
78
 #+END_SRC
80
 
79
 
81
-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 as *install-freedombone.sh*.
80
+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.
82
 
81
 
83
 Installation 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.
82
 Installation 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.
84
 
83
 
91
 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.
90
 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.
92
 
91
 
93
 * On a laptop/PC/netbook
92
 * On a laptop/PC/netbook
94
-It's also possible to install Freedombone onto other hardware, including other types of single board computer. Any system with a fresh installation of Debian Jessie will do. Just make sure that you change the variable INSTALLING_ON_BBB to "no" within *freedombone.cfg* or the *install-freedombone.sh* script. Obviously, you don't need to run the *initial_setup.sh* script on non-Beaglebone systems.
93
+It's also possible to install Freedombone onto other hardware, including other types of single board computer. Any system with a fresh installation of Debian Jessie will do. Just make sure that you change the variable INSTALLING_ON_BBB to "no" within *freedombone.cfg* or do not include the *--bbb* option within the *freedombone* command. Obviously, you don't need to run the *freedombone-prep* command on non-Beaglebone systems.
95
 
94
 
96
  * Download the [[https://www.debian.org/devel/debian-installer][Debian Jessie "netinst" installer]]
95
  * Download the [[https://www.debian.org/devel/debian-installer][Debian Jessie "netinst" installer]]
97
  * Use [[https://apps.ubuntu.com/cat/applications/usb-creator-gtk/][Startup Disk Creator]] or [[https://en.wikipedia.org/wiki/UNetbootin][Unetbootin]] to copy the netinst image to a USB thumb drive
96
  * Use [[https://apps.ubuntu.com/cat/applications/usb-creator-gtk/][Startup Disk Creator]] or [[https://en.wikipedia.org/wiki/UNetbootin][Unetbootin]] to copy the netinst image to a USB thumb drive
110
 apt-get install git
109
 apt-get install git
111
 git clone https://github.com/bashrc/freedombone
110
 git clone https://github.com/bashrc/freedombone
112
 cd freedombone
111
 cd freedombone
112
+make install
113
 nano freedombone.cfg
113
 nano freedombone.cfg
114
 #+END_SRC
114
 #+END_SRC
115
 
115
 
141
 
141
 
142
  * Save and exit, then run:
142
  * Save and exit, then run:
143
 #+BEGIN_SRC bash
143
 #+BEGIN_SRC bash
144
-./install-freedombone.sh <your wiki domain name> <your username> <your wiki FreeDNS domain code>
144
+freedombone -d <your wiki domain name> -u <your username> -c <your wiki FreeDNS domain code>
145
 #+END_SRC
145
 #+END_SRC
146
 
146
 
147
 * Internet Router
147
 * Internet Router