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.**

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

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

108

109

110

dd if=/etc/sidmem of=/dev/mmcblk2p2 bs=1M count=1

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

115

116

117

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

118

119

120

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

121

122

123

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

124

125

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

126

127

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

128

129

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

130

131

132

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

133

134

1. Prepare an SD card

135

1. Prepare a card reader device

136

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

137

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

138

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

139

140

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

141

142

143

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

144

145

[[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"]]

146

147

148

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

149

150

[[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"]]

151

152

153

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

154

155

[[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"]]

156

157

[[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"]]

158

159

160

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

161

162

[[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"]]

163

164

[[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** ===

169

170

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

171

172

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

173

174

175

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

176

177

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

178

179

180

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)** ===

189

190

191

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

192

193

194

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

195

196

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.

197

198

199

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

Port: 22

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

204

205

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

206

207

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

208

209

210

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

**Run command:**

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

216

217

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

218

219

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

220

221

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

222

223

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

224

225

(% 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.**

226

227

228

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

229

230

231

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]]**

232

233

234

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

235

236

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

237

238

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.

239

240

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

Port: 22

User Name: **root**

Password: **dragino** (default)

247

248

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

249

250

[[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**

255

256

[[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"]]

257

258

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

259

260

[[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"]]

261

262

[[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"]]

263

264

Select the **"1 ext4"**

265

266

[[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"]]

267

268

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

269

270

[[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"]]

271

272

[[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"]]

273

274

[[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"]]

275

276

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

277

278

279

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

280

281

282

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

283

284

285

=== 2.4.1 View SD card information ===

286

287

(% class="box infomessage" %)

(((

fdisk -l

)))

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

293

294

295

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

296

297

298

(% class="box infomessage" %)

(((

df -h

)))

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

304

305

306

=== 2.4.3 Mount SD card ===

307

308

309

(% class="box infomessage" %)

(((

mkdir /mnt/sd

mount /dev/mmcblk0p1 /mnt/sd

314

)))

315

316

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

317

318

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

319

320

321

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

322

323

(% class="box infomessage" %)

324

(((

325

mkfs.ext4 /dev/mmcblk0p1

326

)))

327

328

== 2.5 Default Built Version ==

329

330

331

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

332

333

334

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

335

336

337

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

338

339

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

340

341

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

342

343

344

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

345

346

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

347

348

(% class="box infomessage" %)

(((

**npm install -g n**

)))

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

355

356

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

357

358

(% class="box infomessage" %)

(((

**n lts**

)))

#Remove all downloaded versions except the installed version

365

366

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

367

368

(% class="box infomessage" %)

(((

**n prune**

)))

(% class="box infomessage" %)

375

(((

376

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

)))

Check the current version

381

382

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

383

384

(% class="box infomessage" %)

(((

**node -v**

)))

== 2.7 How to install Grafana and influxdb ==

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

(% class="box infomessage" %)

397

(((

398

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

399

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

400

apt update && apt install grafana

)))

Check the running status:

405

406

407

(% class="box infomessage" %)

408

(((

409

systemctl status grafana-server

)))

configuration path:

(% class="box infomessage" %)

417

(((

418

/etc/grafana/grafana.ini

)))

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

423

424

425

(% class="box infomessage" %)

426

(((

427

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

428

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

429

apt update && apt install influxdb

)))

Check the running status:

434

435

436

(% class="box infomessage" %)

437

(((

438

systemctl status influxdb

)))

configuration path:

(% class="box infomessage" %)

446

(((

447

/etc/influxdb/influxdb.conf

)))

= 3. Package Management =

452

453

== 3.1 Default Package Maintain System ==

454

455

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

456

457

458

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.

459

460

461

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

462

463

* Devices will check for updates for every boot.

464

* Devices will check for updates on every day midnight.

465

466

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

467

468

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

469

470

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

471

472

dragino-ui ~-~- Gateway Web UI package

473

474

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

475

476

draginoups ~-~- Miscellaneous between different versions

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

481

482

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

483

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

484

485

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

486

487

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

488

489

490

[[image:1661305025451-220.png]]

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

495

496

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

497

498

499

[[image:1661305258501-636.png]]

500

501

502

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

503

504

505

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

506

507

508

[[image:1661305328295-218.png]]

509

510

511

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

512

513

514

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

515

516

517

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

518

519

=== 3.2.1 Overview ===

520

521

522

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.

523

524

525

=== 3.2.2 Install Apache2 HTTP server ===

526

527

528

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

529

530

531

=== 3.2.3 Creating Package Directories ===

532

533

534

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

535

536

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

537

538

**~ (% 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.**

565

566

567

=== 3.2.4 Get deb packages ===

568

569

570

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

571

572

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

573

574

575

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

576

577

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

578

579

580

=== 3.2.5 Generate Package Index file ===

581

582

583

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

584

585

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

586

587

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

588

589

590

(% 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.**

591

592

593

=== 3.2.6 Generate Release file ===

594

595

596

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

597

598

599

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

600

601

602

(% 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]]**

603

604

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

605

606

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

607

608

609

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

610

611

612

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

613

614

615

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

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

620

621

622

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

623

624

625

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

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

630

631

632

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

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

637

638

639

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

640

641

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

642

643

644

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

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

649

650

651

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

652

653

654

**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**(%%) ====

663

664

665

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

666

667

668

(% 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**(%%) ====

673

674

675

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

676

677

(% 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**(%%) ====

682

683

684

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

685

686

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