Difference between pages "DFNEXT Modem Installation" and "Taking the Wiki Offline"

From DFN Wiki
(Difference between pages)
Jump to: navigation, search
(Tag: visualeditor)
 
(→‎Install Kiwix Reader)
(Tag: visualeditor)
 
Line 1: Line 1:
−
Slide bracket to the rightThe DFNEXT observatories usually ship without modems as many of them are deployed with WiFi or Ethernet connectivity and different areas of the world require different modems.
+
These instructions were tested on Debian 9 "Stretch", but should work on any POSIX-compliant system.
  
−
If you wish to network your DFNEXT observatory via mobile broadband instead of WiFi or Ethernet you need to source a modem and request a modem installation care package from [[Getting Help|DFN Camera Help]].
+
=== Install mwoffliner ===
 +
Following the instructions here: https://github.com/openzim/mwoffliner.
  
−
The recommended modems are the [https://www.sierrawireless.com/-/media/iot/pdf/datasheets/sierrawireless_airprime_mc_series_datasheet.pdf Sierra Wireless AirPrime MC Series] MC7455 (for the Americas, Europe, the Middle East and Africa) and the MC7430 (for Asia Pacific including Australia).
+
=== Set Up redis-server for mwoffliner ===
  
−
= Installation Steps =
+
Modify the <code>Unix socket</code> section of the redis-server config (<code>/etc/redis/redis.conf</code>) so that the unix socket is created and has the correct permissions.
−
Once you have the modem, installation care package (containing the modem adaptor board, USB cable, modem bracket and screws) and a SIM card, you can install the modem by following the steps bellow.
+
 
−
[[File:Modem cable connector.jpg|none|thumb|Connect the modem USB cable to the modem.|640x640px]]
+
unixsocket /dev/shm/redis.sock
−
[[File:Insert modem.jpg|none|thumb|Insert the modem into the adaptor board.]]
+
unixsocketperm 777
−
[[File:Fasten modem.jpg|none|thumb|Press modem down and fasten with the two small screws.]]
+
(assuming you're on debian)
−
[[File:Insert sim.jpg|none|thumb|Insert the 2FF sized SIM into the spring loaded SIM card slot in the modem adaptor board.]]
+
 
−
[[File:Modem bracket.jpg|none|thumb|Take the modem bracket and two large screws.]]
+
=== Run mwoffliner ===
−
[[File:Screw in modem bracket.jpg|none|thumb|Fasten the modem bracket using the two large screws and the threaded holes below the PCB.]]
+
mwoffliner --mwUrl=https://wiki.dfn.net.au --adminEmail=-adminEmail=foo@bar.net --mwApiPath=/api.php --mwWikiPath=/ --mwModulePath=/load.php
−
[[File:Slide bracket to the right.jpg|none|thumb|Ensure the bracket is installed as far to the right as possible to allow the connector to clear the PCB standoff above the modem bracket.]]
+
This will create a .zim file from the wiki.
−
[[File:Bend usb cable using hot air gun.jpg|none|thumb|Use a hot air gun to bend the USB cable out of the way of the modem.]]
+
 
−
[[File:Install modem with connector under pcb.jpg|none|thumb|Lift one side of the PCB to clear the modem's USB connector which should face upwards.]]
+
'''Note: many pages aren't being scraped correctly using this method as of April 2019.'''
−
[[File:Installed modem.jpg|none|thumb|Firmly slide the modem into the bracket ensuring it reaches the bottom. (The slots in the bracket may require some filing.)]]
+
 
−
[[File:Attach gsm antenna pigtail to main antenna port.jpg|none|thumb|Attach the short GSM antenna pigtail to the main antenna port on the modem using your fingers or some needle-nose pliers.]]
+
=== Install Kiwix Reader ===
−
[[File:Rf cable connected.jpg|none|thumb|Ensure the U.FL connector is seated correctly.]]
+
Install Kiwix Reader: https://www.kiwix.org/en/downloads/kiwix-reader/ on the on the device you want to take offline, and copy the .zim file from the previous step to the device. Test the wiki in Kiwix before you go offline.
−
[[File:Connect usb cable to pc.jpg|none|thumb|Tuck the excess USB cable under the PCB and connect the USB header connector to the PC.]]
+
 
−
[[File:Connected usb cables.jpg|none|thumb|Ensure that the USB header connector is well seated and that the adjacent connectors have not been knocked out.]]
+
Using chrome or firefox kiwix extension makes it easier.
 +
 
 +
__NOTOC__

Latest revision as of 20:43, 10 April 2019

These instructions were tested on Debian 9 "Stretch", but should work on any POSIX-compliant system.

Install mwoffliner

Following the instructions here: https://github.com/openzim/mwoffliner.

Set Up redis-server for mwoffliner

Modify the Unix socket section of the redis-server config (/etc/redis/redis.conf) so that the unix socket is created and has the correct permissions. 

unixsocket /dev/shm/redis.sock
unixsocketperm 777

(assuming you're on debian)

Run mwoffliner

mwoffliner --mwUrl=https://wiki.dfn.net.au --adminEmail=-adminEmail=foo@bar.net --mwApiPath=/api.php --mwWikiPath=/ --mwModulePath=/load.php

This will create a .zim file from the wiki.

Note: many pages aren't being scraped correctly using this method as of April 2019.

Install Kiwix Reader

Install Kiwix Reader: https://www.kiwix.org/en/downloads/kiwix-reader/ on the on the device you want to take offline, and copy the .zim file from the previous step to the device. Test the wiki in Kiwix before you go offline.

Using chrome or firefox kiwix extension makes it easier.


Retrieved from ‘https://wiki.dfn.net.au/index.php?title=DFNEXT_Modem_Installation&oldid=527’