Armbian OS instruction

**Run command clone dragino-fwd package: (% style="background-color:yellow; color:green" %)git clone https:~/~/github.com/dragino/dragino_fwd_src.git(%%)**

41

42

43

[[image:image-20220527151010-1.png]]

44

45

46

=== (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) ===

47

48

49

**After cloning is complete, Run the command starts compiling:**

50

51

(% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c**

52

53

54

The following example compilers HP0C fwd.

55

56

[[image:image-20220527153913-3.png]]

When the compilation is complete a** (% style="color:blue" %)draginofwd-*.deb(%%) **package is generated.

61

62

[[image:image-20220527154311-4.png||height="385" width="773"]]

63

64

65

=== (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) ===

**Run command:**

(% style="background-color:yellow; color:green" %)**dpkg -i draginofwd-*.deb **

71

72

73

[[image:image-20220527154811-5.png]]

74

75

76

=== (% style="color:blue" %)**Step 4. Test**(%%) ===

77

78

79

**Check the dragino_fwd log:**

80

81

(% style="background-color:yellow; color:green" %)**journalctl -u draginofwd -f**

82

83

84

[[image:image-20220527165221-7.png||height="182" width="931"]]

85

86

87

**Start/stop dragino_fwd via systemctl:**

88

89

(% style="background-color:yellow; color:green" %)**systemctl start draginofwd**

90

91

(% style="background-color:yellow; color:green" %)**systemctl stop draginofwd**

92

93

94

== 2.2 How to clone Complete OS on the EMMC to SD card ==

95

96

97

**2.2.1 Prepare a USB flash drive/SD card and plug it into the USB port of the gateway.**

98

99

100

**2.2.2 Mounting a USB Flash Drive/SD Card in the Linux CLI**

101

102

103

(% id="cke_bm_13244S" style="display:none" %) [[image:image-20241107100929-2.png||height="208" width="669"]]

104

105

mount /dev/sda1 /mnt/

106

107

108

**2.2.3 Using the dd command, copy Emmc as an img file**

109

110

111

[[image:image-20241107100901-1.png||height="269" width="994"]]

112

113

114

dd if=/dev/mmcblk2 of=/mnt/custom.img bs=1M count=3686 status=progress

115

116

117

**2.2.4 Export the img file and follow the steps in 2.3 for burning**

== 2.3 How to flash a new image(OS) to the gateway(LPS8V2) ==

122

123

124

Since the gateway has a large system, you need to use the sd card to reflash the system for the gateway

125

126

127

//2.3.1: Making an SD card with the new image//

128

129

//2.3.2: Instal the SD card to the gateway//

130

131

//2.3.3: Flash the image to the gateway's built memory from the SD card//

132

133

//2.3.4: Finished the process of flash and power cycle the gateway//

134

135

136

==== (% style="background-color:yellow" %)**//Preparations~://**(%%) ====

137

138

1. Prepare an SD card

139

1. Prepare a card reader device

140

1. Download the OS image from the release.image~: **[[draginolps8v2-release-v1.7>>http://repo.dragino.com/release/hp0c-image/]]**

141

1. A Flash software tool ( Such as v1.7.9 from [[balenaEtcher>>url:https://www.balena.io/etcher/]] )

142

1. SD Card [[format>>url:http://repo.dragino.com/release/tool/PanasonicSDFormatter.zip]] tool

143

144

=== **2.3.1 Making an SD Card with the new image** ===

145

146

147

==== Step 1. Formatting the SD Card ====

148

149

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609111027-9.png?rev=1.1||alt="image-20220609111027-9.png" height="318" width="292"]]

150

151

152

==== Step 2. Select the OS image ====

153

154

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104907-8.png?rev=1.1||alt="image-20220609104907-8.png" height="435" width="689"]]

155

156

157

==== Step 3. Select the target ====

158

159

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104637-2.png?rev=1.1||alt="image-20220609104637-2.png" height="436" width="690"]]

160

161

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104701-3.png?rev=1.1||alt="image-20220609104701-3.png" height="436" width="690"]]

162

163

164

==== Step 4. Flash start ====

165

166

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104727-4.png?rev=1.1||alt="image-20220609104727-4.png" height="435" width="689"]]

167

168

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104741-5.png?rev=1.1||alt="image-20220609104741-5.png" height="434" width="687"]]

=== **2.3.2 Instal the SD card to the gateway** ===

173

174

1. Open the device's enclosure, and put the SD card into the SD card slot

175

176

[[image:image-20230712201032-1.png]]

177

178

179

2. Power the gateway with 5V2A, and access the gateway's Ethernet port to your PC

180

181

[[image:image-20230712201458-3.png||height="649" width="832"]]

182

183

184

Note: The PWR LED on red

The LAN LED blink

The SYS LED on red

=== **3.2.3 Flash the image to the gateway's built memory from the SD card(LPS8v2)** ===

193

194

195

Access the gateway Linux CLI to flash the image to the gateway's built memory

196

197

198

* **Use the IP address to access the gateway CLI**

199

200

Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.

201

202

203

IP address: IP address of gateway or **Fallback IP**(172.31.255.254)

Port: 22

User Name: (% style="color:blue" %)**root**

208

209

Password: (% style="color:blue" %)**dragino**(%%) (default)

210

211

//After logging in, you will be in the gateway CLI and can enter commands as shown below.//

212

213

214

[[image:image-20230508155357-1.png||height="225" width="634"]]

**Run command:**

draginolps8v2-release-chirpsrtack-v1.7-240725 image :

220

221

(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-ChirpStack-240725-1.img **

222

223

draginolps8v2-release-ttnstack-v1.7-240712 image :

224

225

(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-TTN-231124.img**

226

227

[[image:image-20241008091850-2.png]]

228

229

(% style="color:red" %)**Note: Note: After the flash is completed, please power off the device (run the command halt) and disconnect the power supply, and then unplug the SD card.**

230

231

232

=== **3.2.4 Flash the image to the gateway's built memory from the SD card(MS48-LR/LG01v2)** ===

233

234

235

Download the OS image from the release.image~: **[[MS48-LR-image>>https://www.dropbox.com/scl/fi/ug25bbwyk6gnqjnsee2m1/dragino-MS48-LR-231124.rar?rlkey=bqva7hkeft0m3haiui5uj12sv&st=ii6mp2g7&dl=0]] [[LG01v2-image>>https://www.dropbox.com/scl/fi/g0si61lcrvdjyto4ma951/dragino-lg01v2-1.7-0210.zip?rlkey=t03oqo493r2p7ign488rs2jsv&dl=0]]**

236

237

238

Access the gateway Linux CLI to flash the image to the gateway's built memory

239

240

* **Use the IP address to access the gateway CLI**

241

242

Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.

243

244

IP address: IP address of gateway or **Fallback IP**(172.31.255.254)

Port: 22

User Name: **root**

Password: **dragino** (default)

251

252

//After logging in, you will be in the gateway CLI and can enter commands as shown below.//

253

254

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20230508155357-1.png?rev=1.1&width=634&height=225||alt="image-20230508155357-1.png" height="225" width="634"]]

**Run command:**

**nand-sata-install**

259

260

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112051-1.png?rev=1.1||alt="image-20220602112051-1.png"]]

261

262

Select the **"Boot from eMMC - system on eMMC".**

263

264

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112058-2.png?rev=1.1&width=646&height=292||alt="image-20220602112058-2.png" height="292" width="646"]]

265

266

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112106-3.png?rev=1.1&width=643&height=301||alt="image-20220602112106-3.png" height="301" width="643"]]

267

268

Select the **"1 ext4"**

269

270

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112113-4.png?rev=1.1&width=642&height=271||alt="image-20220602112113-4.png" height="271" width="642"]]

271

272

It takes 4-5 minutes to burn from SD card to eMMC

273

274

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112119-5.png?rev=1.1&width=641&height=309||alt="image-20220602112119-5.png" height="309" width="641"]]

275

276

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112125-6.png?rev=1.1&width=640&height=281||alt="image-20220602112125-6.png" height="281" width="640"]]

277

278

[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112131-7.png?rev=1.1&width=638&height=241||alt="image-20220602112131-7.png" height="241" width="638"]]

279

280

**Note: After the flash is complete, power off the device and then remove the SD card.**

281

282

283

== 2.4 How to extend the gateway size of memory with SD card ==

284

285

286

Users can use the SD card slot to expand the gateway memory size by following the steps below

287

288

289

=== 2.4.1 View SD card information ===

290

291

(% class="box infomessage" %)

(((

fdisk -l

)))

[[image:image-20230831150518-3.png]]

297

298

299

=== 2.4.2 Displays the current file system disk usage statistics on Linux systems ===

300

301

302

(% class="box infomessage" %)

(((

df -h

)))

[[image:image-20230831150341-2.png]]

308

309

310

=== 2.4.3 Mount SD card ===

311

312

313

(% class="box infomessage" %)

(((

mkdir /mnt/sd

mount /dev/mmcblk0p1 /mnt/sd

318

)))

319

320

After the mount is successful to check the file system disk usage on the Linux system again:

321

322

[[image:image-20230831151432-4.png]]

323

324

325

If the mount fails, you can format the file system and try the mount again

326

327

(% class="box infomessage" %)

328

(((

329

mkfs.ext4 /dev/mmcblk0p1

330

)))

331

332

== 2.5 Default Built Version ==

333

334

335

[[image:image-20220902155621-1.png]]

336

337

338

== 2.6 How to upgrade the nodejs version to the latest. ==

339

340

341

By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old.

342

343

[[image:image-20221112145029-2.png]]

344

345

**If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.**

346

347

348

#install n, which is an Interactively Manage Your Node.js Versions

349

350

[[image:image-20221112154230-3.png||height="89" width="689"]]

351

352

(% class="box infomessage" %)

(((

**npm install -g n**

)))

#Install the latest LTS Node.js release (downloading if necessary)

359

360

[[image:image-20221112154418-4.png||height="184" width="893"]]

361

362

(% class="box infomessage" %)

(((

**n lts**

)))

#Remove all downloaded versions except the installed version

369

370

[[image:image-20221112154456-5.png||height="139" width="899"]]

371

372

(% class="box infomessage" %)

(((

**n prune**

)))

(% class="box infomessage" %)

379

(((

380

**apt remove nodejs -y && apt autoremove -y && reboot**

)))

Check the current version

385

386

[[image:image-20221112154724-6.png]]

387

388

(% class="box infomessage" %)

(((

**node -v**

)))

== 2.7 How to install Grafana and influxdb ==

=== **Grafana:** ===

(% class="box infomessage" %)

401

(((

402

curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null

403

echo "deb [signed-by=/usr/share/keyrings/grafana-archive-keyrings.gpg] https:~/~/packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.list

404

apt update && apt install grafana

)))

Check the running status:

409

410

411

(% class="box infomessage" %)

412

(((

413

systemctl status grafana-server

)))

configuration path:

(% class="box infomessage" %)

421

(((

422

/etc/grafana/grafana.ini

)))

=== **Influxdb:** ===

427

428

429

(% class="box infomessage" %)

430

(((

431

curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null

432

echo "deb [signed-by=/usr/share/keyrings/influxdb-archive-keyring.gpg] https:~/~/repos.influxdata.com/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

433

apt update && apt install influxdb

)))

Check the running status:

438

439

440

(% class="box infomessage" %)

441

(((

442

systemctl status influxdb

)))

configuration path:

(% class="box infomessage" %)

450

(((

451

/etc/influxdb/influxdb.conf

)))

= 3. Package Management =

456

457

== 3.1 Default Package Maintain System ==

458

459

=== 3.1.1 How Package-Auto-Update works? ===

460

461

462

By default, LPS8v2 / MS20 series products have an auto-update feature for main packages. The device will connect to Dragino's auto-update server and check for updates.

463

464

465

(% style="color:blue" %)**When devices will check for updates**?

466

467

* Devices will check for updates for every boot.

468

* Devices will check for updates on every day midnight.

469

470

(% style="color:blue" %)**What packages will be checked for updates**?

471

472

dragino-httpd ~-~- Main Web UI http configuration

473

474

dragino-sid ~-~- SN write and read tool

475

476

dragino-ui ~-~- Gateway Web UI package

477

478

draginofwd ~-~- UDP packet forwarder, LoRa Base Station

479

480

draginoups ~-~- Miscellaneous between different versions

(% style="color:blue" %)**Location and changelog for packages**:

485

486

* Location: http:~/~/repo.dragino.com/release/tool/

487

* Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]]

488

489

(% style="color:blue" %)**How to view auto-updated log**

490

491

You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.**

492

493

494

[[image:1661305025451-220.png]]

(% style="color:blue" %)**Can I disable package-auto-update?**

499

500

You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.

501

502

503

[[image:1661305258501-636.png]]

504

505

506

=== 3.1.2 How to manually update core packages? ===

507

508

509

You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages.

510

511

512

[[image:1661305328295-218.png]]

513

514

515

=== 3.1.3 How to manually update other packages? ===

516

517

518

For the other packages, you have to access the device's CLI to do it via the apt command.

519

520

521

== 3.2 Set up a 3^^rd^^ party package maintain server ==

522

523

=== 3.2.1 Overview ===

524

525

526

Customers can use their own package maintenance system instead of using the default one from Dragino. They need to set up a package maintenance system for Debian. Lots of instructions are available in Internet, below is a reference instruction.

527

528

529

=== 3.2.2 Install Apache2 HTTP server ===

530

531

532

(% style="background-color:yellow; color:green" %)**apt install apache2**

533

534

535

=== 3.2.3 Creating Package Directories ===

536

537

538

**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)**

539

540

**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)**

541

542

**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)**

**Tree Structure:**

(% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.**

└── debian

└── release

├── dists

│ └── stable

│ └── main

│ └── binary-armhf

└── pool

└── main

└── d

└── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.**

569

570

571

=== 3.2.4 Get deb packages ===

572

573

574

The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)**

575

576

Below is an example package(testing-0808.deb) for test purpose:

577

578

579

**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)**

580

581

**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)**

582

583

584

=== 3.2.5 Generate Package Index file ===

585

586

587

(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/**

588

589

(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages**

590

591

(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz**

592

593

594

(% style="color:red" %)**Note: Every time a package has been update, above comments need to be executed in the server to get the up-to-date package list.**

595

596

597

=== 3.2.6 Generate Release file ===

598

599

600

==== (% style="color:blue" %)**Create the generated script:**(%%) ====

601

602

603

(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**

604

605

606

(% style="background-color:yellow; color:green" %)**wget [[http:~~/~~/repo.dragino.com/release/tool/unimportant/generate-release.sh>>url:http://repo.dragino.com/release/tool/unimportant/generate-release.sh]]**

607

608

(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh**

609

610

(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release**

611

612

613

=== 3.2.7 Sign the Release file with gpg and generating Inrelease file ===

614

615

616

==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ====

617

618

619

(% style="background-color:yellow; color:green" %)**apt install gnupg**

==== (% style="color:blue" %)**generate gpg key**(%%) ====

624

625

626

(% style="background-color:yellow; color:green" %)**gpg -gen-key**

627

628

629

(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.**

==== (% style="color:blue" %)**Check the gen-key**(%%) ====

634

635

636

(% style="background-color:yellow; color:green" %)**gen -list-key**

==== (% style="color:blue" %)**Generate the release.gpg**(%%) ====

641

642

643

(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**

644

645

(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release**

646

647

648

(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release**

==== (% style="color:blue" %)**Generate the public key**(%%) ====

653

654

655

(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>**

656

657

658

**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]]

=== 3.2.8 Add url as apt source in LPS8v2 / MS20 ===

==== (% style="color:blue" %)**Add the public key**(%%) ====

667

668

669

(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/**

670

671

672

(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.**

==== (% style="color:blue" %)**Add the apt source list**(%%) ====

677

678

679

Add the apt source list url and name this as test_server.list

680

681

(% style="background-color:yellow; color:green" %)**echo "deb http:~/~/<IP_address or hostname>/debian/release stable main" | tee /etc/apt/sources.list.d/test_server.list**

==== (% style="color:blue" %)**Validate the apt repository**(%%) ====

686

687

688

Get and install the testing package (download testing-0808.deb and test)

689

690

(% style="background-color:yellow; color:green" %)**apt update && apt install testing**