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

=== ===

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

236

237

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

238

239

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.

240

241

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

Port: 22

User Name: **root**

Password: **dragino** (default)

248

249

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

250

251

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

256

257

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

258

259

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

260

261

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

262

263

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

264

265

Select the **"1 ext4"**

266

267

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

268

269

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

270

271

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

272

273

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

274

275

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

276

277

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

278

279

280

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

281

282

283

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

284

285

286

=== 2.4.1 View SD card information ===

287

288

(% class="box infomessage" %)

(((

fdisk -l

)))

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

294

295

296

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

297

298

299

(% class="box infomessage" %)

(((

df -h

)))

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

305

306

307

=== 2.4.3 Mount SD card ===

308

309

310

(% class="box infomessage" %)

(((

mkdir /mnt/sd

mount /dev/mmcblk0p1 /mnt/sd

315

)))

316

317

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

318

319

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

320

321

322

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

323

324

(% class="box infomessage" %)

325

(((

326

mkfs.ext4 /dev/mmcblk0p1

327

)))

328

329

== 2.5 Default Built Version ==

330

331

332

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

333

334

335

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

336

337

338

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

339

340

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

341

342

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

343

344

345

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

346

347

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

348

349

(% class="box infomessage" %)

(((

**npm install -g n**

)))

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

356

357

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

358

359

(% class="box infomessage" %)

(((

**n lts**

)))

#Remove all downloaded versions except the installed version

366

367

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

368

369

(% class="box infomessage" %)

(((

**n prune**

)))

(% class="box infomessage" %)

376

(((

377

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

)))

Check the current version

382

383

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

384

385

(% class="box infomessage" %)

(((

**node -v**

)))

== 2.7 How to install Grafana and influxdb ==

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

(% class="box infomessage" %)

398

(((

399

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

400

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

401

apt update && apt install grafana

)))

Check the running status:

406

407

408

(% class="box infomessage" %)

409

(((

410

systemctl status grafana-server

)))

configuration path:

(% class="box infomessage" %)

418

(((

419

/etc/grafana/grafana.ini

)))

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

424

425

426

(% class="box infomessage" %)

427

(((

428

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

429

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

430

apt update && apt install influxdb

)))

Check the running status:

435

436

437

(% class="box infomessage" %)

438

(((

439

systemctl status influxdb

)))

configuration path:

(% class="box infomessage" %)

447

(((

448

/etc/influxdb/influxdb.conf

)))

= 3. Package Management =

453

454

== 3.1 Default Package Maintain System ==

455

456

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

457

458

459

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.

460

461

462

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

463

464

* Devices will check for updates for every boot.

465

* Devices will check for updates on every day midnight.

466

467

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

468

469

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

470

471

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

472

473

dragino-ui ~-~- Gateway Web UI package

474

475

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

476

477

draginoups ~-~- Miscellaneous between different versions

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

482

483

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

484

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

485

486

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

487

488

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

489

490

491

[[image:1661305025451-220.png]]

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

496

497

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

498

499

500

[[image:1661305258501-636.png]]

501

502

503

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

504

505

506

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

507

508

509

[[image:1661305328295-218.png]]

510

511

512

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

513

514

515

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

516

517

518

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

519

520

=== 3.2.1 Overview ===

521

522

523

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.

524

525

526

=== 3.2.2 Install Apache2 HTTP server ===

527

528

529

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

530

531

532

=== 3.2.3 Creating Package Directories ===

533

534

535

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

536

537

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

538

539

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

566

567

568

=== 3.2.4 Get deb packages ===

569

570

571

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

572

573

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

574

575

576

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

577

578

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

579

580

581

=== 3.2.5 Generate Package Index file ===

582

583

584

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

585

586

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

587

588

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

589

590

591

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

592

593

594

=== 3.2.6 Generate Release file ===

595

596

597

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

598

599

600

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

601

602

603

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

604

605

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

606

607

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

608

609

610

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

611

612

613

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

614

615

616

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

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

621

622

623

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

624

625

626

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

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

631

632

633

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

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

638

639

640

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

641

642

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

643

644

645

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

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

650

651

652

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

653

654

655

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

664

665

666

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

667

668

669

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

674

675

676

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

677

678

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

683

684

685

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

686

687

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