Skip to content

Commit

Permalink
Merge pull request #78 from TheTorProject/feature/ooniprobe-v2
Browse files Browse the repository at this point in the history
Update ChangeLog, README
  • Loading branch information
anadahz authored Sep 14, 2016
2 parents 38b0be1 + d010b92 commit 7c9aca2
Show file tree
Hide file tree
Showing 2 changed files with 53 additions and 34 deletions.
13 changes: 13 additions & 0 deletions ChangeLog.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,16 @@
# Lepidopter v0.3.0-beta [2016-09-14]

- Add ooniprobe Web User Interface (2.0.0-rc.2)
- Add lepidopter-updater
- Significantly reduce image size
- Add pluggable transports dependencies
- Add support for mDNS/DNS-SD (#46)
- Add Raspberry Pi 3 wireless firmware support (#43)
- Improve versioning (#58)
- Set timezone to UTC (#52)
- Ensure that filesystem repair is triggered without physical attendance
- Reduce tor bootstrap and save network bandwidth (#45)

v0.2.1-alpha
------------
* Cleanup ooniprobe logrotated files
Expand Down
74 changes: 40 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ distribution.

```
.
├── Changelog.rst
├── ChangeLog.md
├── conf
│   ├── lepidopter-image.conf
│   └── tor-pt.conf Tor bridges and pluggable transports configuration file
Expand All @@ -22,44 +22,47 @@ distribution.
│   │   ├── apt
│   │   │   └── apt.conf.d
│   │   │   └── 02compress-indexes
│   │   ├── avahi
│   │   │   └── services
│   │   │   ├── ooniprobe.service
│   │   │   └── ssh.service
│   │   ├── cron.daily daily cronjobs
│   │   │   ├── remove_old_logs
│   │   │   ├── remove_upl_reports
│   │   │   ├── run_ooniprobe_deck
│   │   │   └── upload_reports
│   │   │   └── remove_old_logs
│   │   ├── crontab
│   │   ├── cron.weekly weekly cronjobs
│   │   │   ├── remove_inc_reports
│   │   │   └── update_ooniprobe_deck
│   │   ├── default
│   │   │   ├── hwclock
│   │   │   └── rcS
│   │   ├── dpkg
│   │   │   └── dpkg.cfg.d
│   │   │   └── 01_nodoc
│   │   ├── init.d
│   │   │   └── regenerate_ssh_host_keys
│   │   ├── lepidopter-update
│   │   │   └── version
│   │   ├── lepidopter_version
│   │   ├── logrotate.d
│   │   │   ├── lepidopter-update
│   │   │   └── ooniprobe
│   │   ├── motd.head Lepidopter MOTD ASCII logo
│   │   ├── network
│   │   │   └── if-up.d
│   │   │   └── run_oonideckgen
│   │   ├── ooniprobe
│   │   │   ├── ooniconfig.sh
│   │   │   ├── oonideckconfig
│   │   │   ├── ooniprobe.conf
│   │   │   └── oonireport.conf
│   │   │   └── ooniconfig.sh
│   │   ├── ooniprobe.conf
│   │   ├── systemd
│   │   │   └── system
│   │   │   ├── lepidopter-update.service
│   │   │   └── ooniprobe.service
│   │   └── update-motd.d
│   │   └── 50-lepidopter
│   ├── opt
│   │   └── ooni
│   │   ├── decks
│   │   ├── remove-inc-reports.sh
│   │   ├── remove-upl-reports.sh
│   │   ├── reports
│   │   ├── run-ooniprobe.sh
│   │   ├── tor_data_dir
│   │   ├── update-deck.sh
│   │   ├── update-ooniprobe.sh
│   │   └── upload-reports.sh
│   │   ├── lepidopter-update
│   │   │   ├── public.asc
│   │   │   ├── updater.py
│   │   │   └── versions
│   │   └── tor_data_dir
│   ├── remove_ssh_host_keys.sh
│   ├── setup-ooniprobe.sh
│   └── var
Expand All @@ -70,26 +73,23 @@ distribution.
├── README.md you are currently reading it
├── scripts external scripts
│   ├── lepidopter-sign.sh
│   ├── release
│   └── setup.sh install dependencies needed to create and build the image
└── Vagrantfile
```

### Supported Hardware

The image is targeted mainly for the Raspberry Pi devices currently all
hardware variant are being supported (armel architecture).
It should be fairly easy to create the same image for different
The image is targeted for the Raspberry Pi devices.
Lepidopter supports all Raspberry Pi hardware variants that use the armel
architecture). It should be fairly easy to create the same image for different
architectures, and OS distributions.

Supported hardware (tested):
Supported (tested) devices:
* Raspberry Pi 1 Model B
* Raspberry Pi 1 Model B+
* Raspberry Pi 2 Model B

Possible supported hardware (untested):
* Beaglebone
* Cubietruck
* Wandboard
* Raspberry Pi 3 Model B

## Installation

Expand Down Expand Up @@ -121,9 +121,9 @@ Optionally you could install lepidopter dependencies via the setup script
```
./scripts/setup.sh
```
To compress the image as well you should use::
To compress the image with XZ you should use::
```
./scripts/setup.sh --compress
./scripts/setup.sh -c xz
```

To perform an unattended lepidopter image build you could use this in Debian::
Expand Down Expand Up @@ -204,15 +204,21 @@ qemu-system-arm -M versatilepb -cpu arm1136-r2 \
-kernel kernel-qemu-4.1.7-jessie \
-hda lepidopter-armel.img -m 256 \
-append "root=/dev/sda2 rootfstype=ext4 rw" \
-net nic -net user,hostfwd=tcp:127.0.0.1:2222-:22
-net nic -net user,hostfwd=tcp::2222-:22,hostfwd=tcp::8080-:80
```

2) You can now connect to lepidopter SSH (default password is `lepidopter`):
2) You can now connect to:


* Lepidopter SSH (default password is `lepidopter`):

```
ssh -P 2222 lepidopter@localhost
```

* Connect to ooniprobe's Web User Interface (in a web browser open):
[http://localhost:8080](http://localhost:8080)

## Read this before running Lepidopter!

Running ooniprobe is a potentially risky activity. This greatly depends on the
Expand Down

0 comments on commit 7c9aca2

Please sign in to comment.