Korenix JetBox9500 series User manual

JetOS95

User Manual

www.korenix.com

2

Overview | Korenix

Copyright Notice

Reproduction without permission is prohibited.

Information provided in this manual is intended to be accurate and reliable. However, the

original manufacturer assumes no responsibility for its use, or for any infringements upon the

rights of third parties that may result from its use.

The material in this document is for product information only and is subject to change without

notice. While reasonable efforts have been made in the preparation of this document to assure

its accuracy, Korenix assumes no liabilities resulting from errors or omissions in this document,

or from the use of the information contained herein.

Korenix reserves the right to make changes in the product design without notice to its users.

Acknowledgments

Korenix is a registered trademark of Korenix Technology Co., Ltd.

All other trademarks or registered marks in the manual belong to their respective

manufacturers.

Table of Content

Copyright Notice .................................................................................................................... 2

Acknowledgments.................................................................................................................. 2

Table of Content .................................................................................................................... 3

Chapter 1 Overview ........................................................................................................................ 6

1-1 Applied Models .............................................................................................................. 6

Chapter 2 Getting Start ................................................................................................................... 7

2-1 System login ................................................................................................................... 7

2-1-1 Serial Console ......................................................................................................... 7

2-1-2 Telnet Console ....................................................................................................... 8

2-1-3 SSH Console............................................................................................................ 9

2-2 Configure Ethernet Interface ....................................................................................... 10

2-2-1 Modifying Network Settings with the Serial Console .......................................... 10

2-2-2 Static and Dynamic IP address ............................................................................. 12

2-2-3 Modifying Network Settings over the Network ................................................... 12

2-3 Test Program Developing – Hello.c .............................................................................. 13

2-3-1 Installing the Toolchain (Linux) ............................................................................ 14

2-3-2 Compiling Hello.c ................................................................................................. 14

2-3-3 Uploading “test” to JetBox9500 and Running the Program ................................ 15

Chapter 3 System Feature ............................................................................................................ 17

3-1 System Version............................................................................................................. 17

3-2 Enable/Disable Daemons ............................................................................................. 17

3-3 Setting Run-Level ......................................................................................................... 19

3-4 Setting System Time..................................................................................................... 19

3-5 Adjust System Time...................................................................................................... 20

3-5-1 NTP Client ............................................................................................................. 20

3-5-2 NTP Server ............................................................................................................ 21

3-6 Cron Daemon (Schedule jobs) ..................................................................................... 21

3-7 Connect Peripherals ..................................................................................................... 22

Chapter 4 Network Feature .......................................................................................................... 24

4-1 Telnet ........................................................................................................................... 24

4-2 sshd .............................................................................................................................. 24

4-3 FTP ................................................................................................................................ 25

4-4 DNS ............................................................................................................................... 25

4-5 Web Server ................................................................................................................... 26

4-6 IPTABLES....................................................................................................................... 27

4-7 NAT ............................................................................................................................... 29

4-8 Dail-up Service ............................................................................................................. 30

4

Overview | Korenix

4-9 PPPoE ........................................................................................................................... 30

4-10 NFS ............................................................................................................................... 32

4-11 E-Mail ........................................................................................................................... 32

4-12 SNMP ............................................................................................................................ 33

4-13 OpenVPN ...................................................................................................................... 33

4-14 OpenSwan .................................................................................................................... 34

4-15 PPTP Client ................................................................................................................... 35

4-16 PPTP Server .................................................................................................................. 37

4-17 Routing -- Zebra Daemon ............................................................................................. 37

4-18 Ser2net ......................................................................................................................... 40

4-19 fastpath ........................................................................................................................ 41

4-20 keepalived .................................................................................................................... 42

4-21 PTPD ............................................................................................................................. 47

4-22 PTPDv2 ......................................................................................................................... 48

Chapter 5 Korenix Feature ............................................................................................................ 51

5-1 Ethertool ...................................................................................................................... 51

5-2 Vconfig ......................................................................................................................... 52

5-3 Diocfg ........................................................................................................................... 53

5-4 Poecfg ........................................................................................................................... 54

Chapter 6 Programmer’s Guide .................................................................................................... 55

6-1 Toolchain Introduction ................................................................................................ 55

6-1-1 Compiling Applications and Libraries................................................................... 56

6-1-2 Tools Available in the Host Environment ............................................................. 56

6-2 Device API .................................................................................................................... 57

6-3 RTC ............................................................................................................................... 57

6-4 Watch Dog Timer ......................................................................................................... 58

Chapter 7 Appendix ...................................................................................................................... 60

7-1 Firmware Upgrade ....................................................................................................... 60

7-2 JetView ......................................................................................................................... 60

7-2-1 Overview .............................................................................................................. 60

7-2-2 JetView for JetBox 9500 ....................................................................................... 60

7-3 USB Driver for GSM modems ....................................................................................... 61

7-4 Change RS485 mode on JetCard 1608 ......................................................................... 61

7-5 Software Specification ................................................................................................. 62

7-6 Busybox command ....................................................................................................... 64

7-7 Ser2net Manual ............................................................................................................ 69

7-8 Revision history ............................................................................................................ 73

7-9 Customer Service ......................................................................................................... 73

Korenix | Overview

5

6

Overview | Korenix

Chapter 1 Overview

The advantage of adopting Korenix JetBox series is ready-to-use. Korenix is devoted

to improve the usability of embedded computer in industrial domain. Besides

operating system, Korenix provides device drivers, protocol stacks, system utilities,

supporting services and daemons to make system integration simple. Further,

Korenix provides application development toolkits for users to build up their own

applications easily.

The stylish JetBox 9500 series is an industrial layer-3 router with

power-over-Ethernet technology and Linux computing. It is a gateway to connect

different network groups (Ethernet, fieldbus, serial or IO control) in a complex

networking architecture and manage peripherals at the front-end site through its

Linux programs or Java applications. It is reliable (network redundancy, system

recovery) and robust (passive cooling, protected against the dusts and spills, shock &

vibration resistance) to adopt in severe industrial vertical markets, such as

transportation, substation, or hazardous environment.

1-1 Applied Models

JetBox9500 series

JetBox9400 series

JetBox5400 series

JetCard5400

Note: SW features might be different according to different products

Korenix | Getting Start

7

Chapter 2 Getting Start

2-1 System login

Users can enter the JetBox Linux environment via the user name: root and no

password is required.

login : root

password : (none)

2-1-1 Serial Console

The serial console port gives users a convenient way of connecting to JetBox console utility.

This method is particularly useful when using JetBox for the first time. The signal is

transmitted over a direct serial connection, so you do not need to know either of JetBox’s

IP address in order to connect to the serial console utility.

Use the serial console port settings shown below.

Baud rate

115200bps

Parity

None

Data bits

8

Stop bits

1

Flow Control

None

Serial console port setting

Once the connection is established, the following windows will open.

8

Getting Start | Korenix

Serial console screen

To log in, type the Login name and password as requested. The default values as

following.

Login: root

Password: none

2-1-2 Telnet Console

If you know IP addresses and netmasks, then you can use Telnet to connect to JetBox9500.

The default IP address and Netmask for each port is given below:

Default IP address

Netmask

LAN

192.168.10.1

255.255.255.0

WAN

DHCP

Default IP address and Netmask

Use a cross-over Ethernet Cable to connect directly from your PC to JetBox 8100. You

should first modify your PC’s IP address and netmask so that your PC is on the same

subnet as JetBox.

To connect to a hub or switch connected to your local LAN, use a straight-through

Ethernet cable. The default IP address and netmasks are shown above. To login, type the

Login name and password as requested. The default values as following:

Korenix | Getting Start

9

Login: root

Password: none

Telnet console screen

You can proceed with the configuration of JetBox9500’s network settings when you reach

the bash command shell. Configuration instructions are given in the next section.

2-1-3 SSH Console

Start from firmware v1.3, JetBox9500 supports an SSH Console to offer users with better

security options.

Click on the link putty to download PuTTy(freeware) and set up an SSH console for

JetBox 9500 in a Windows environment. The following figure shows an example of the

configuration that is required.

10

Getting Start | Korenix

Windows PuTTy setting

2-2 Configure Ethernet Interface

JetBox9500 network setting can be modified with the serial console, or over the network.

2-2-1 Modifying Network Settings with the Serial Console

In this section, we use the serial console to modify JetBox9500’s network settings

 Change Network Configuration

Follow the instructions given in a previous section to access JetBox9500’s Console

Utility via the serial Console port, and then type 'vi /etc/network/interfaces' to edit

network configuration file with vi editor.

Korenix | Getting Start

11

Edit Network configuration file

 Static and Dynamic IP address

Static IP address:

As shown in below, 4 fields must be modified: address, netmask, broadcast and

network. The default IP addresses are 192.168.10.1.

iface lan inet static

address 192.168.10.1

netmask 255.255.255.0

broadcast 192.168.10.255

network 192.168.10.0

Dynamic IP addresses:

By default, the Jetbox9500 is configured for “static” IP addresses on LAN port and

12

Getting Start | Korenix

dhcp on WAN interface. To configure LAN port to request an IP address dynamically,

remove the original settings and add the following line.

iface lan inet dhcp

Default setting for LAN port

Default setting for WAN port

iface lan inet static

address 192.168.10.1

netmask 255.255.255.0

broadcast 192.168.10.255

network 192.168.10.0

iface wan inet dhcp

Default Gateway:

When static IP Address setting is used, add a default gateway is to set another

keyword “gateway”. For example:

iface wan inet static

address 192.168.1.2

netmask 255.255.255.0

broadcast 192.168.1.255

network 192.168.1.0

gateway 192.168.1.1 # This will set default gateway to

#192.168.1.1 on WAN port

2-2-2 Static and Dynamic IP address

After the /etc/network/interfaces file have been modified, issue the following command

to apply the network settings immediately:

/etc/init.d/network restart

2-2-3 Modifying Network Settings over the Network

Same the previous section, IP settings can be modified over the network, too. There is

another way to change the IP address without modifying the file /etc/network/interfaces,

but the new settings will not be saved to the flash disk.

Korenix | Getting Start

13

For example, type the command #ifconfig lan 192.168.10.2 to change the IP address of

LAN interface to 192.168.10.2.

Network Setting over the Network

2-3 Test Program Developing – Hello.c

In this section, we use the standard “Hello” programming example to illustrate how to develop

a program for the JetBox9500. In general, program development involves the following seven

steps.

Step 1:

Connect the JetBox9500 to a Linux PC.

Step 2:

Install Toolchain on the Linux PC.

Step 3:

Set the cross compiler and PATH environment variables.

Step 4:

Code and compile the program.

14

Getting Start | Korenix

Step 5:

Download the program to the JetBox9500 via FTP.

Step 6:

Debug the program

 If bugs are found, return to Step 4.

 If no bugs are found, continue with Step 7.

Step 7:

Back up the user directory (distribute the program to additional JetBox9500 units if needed).

2-3-1 Installing the Toolchain (Linux)

The Linux Operating System must be pre-installed in the PC before installing the

JetBox9500 Toolchain. Fedora core or compatible versions are recommended. The

Toolchain requires approximately 208 MB of hard disk space on your PC. The JetBox9500

Toolchain is included with JetBox9500 SDK, which can download from Korenix web site.

To install the Toolchain, it is simply a matter of extracting a tarball at the proper place:

tar jxvf jetbox9500-toolchains.tar.bz2 –C /

NOTE

 To install the Toolchain, you must grant root permission.

 Toolchains used to not be relocatable! You must install them in the

location they were built for.

Install toolchain is simple, just extract to the /opt directory with the command.

We have include the /opt dir in the tarball, so just uncompress it to /. Next, set up the

PATH environment variable, add the toolchain path with export command. The PATH is a

variable of your current SHELL. This is also the default search path of Linux command.

export PATH=/opt/korenix/toolchains/armeb-linux/usr/bin/:$PATH

Setting the PATH allows you to run the compiler from any directory.

2-3-2 Compiling Hello.c

If you have been compiling a program on X86, then you will find the only difference is the GCC

command is start with armeb-linux-.

That is because we want to differentiate with the stand GCC compiler, and the prefix also tell

Korenix | Getting Start

15

you – it is for arm, big-endian platform program.

Below is a simple hello.c program:

To compile the helo.c, use our Toolchain to compile the hello.c:

armeb-linux-gcc hello.c -o helloworld

The output executable file is the helloworld.

2-3-3 Uploading “test” to JetBox9500 and Running the Program

Use the following command to upload helloworld to the JetBox9500 via FTP.

1. From the PC, type:

# ftp xxx.xxx.xxx.xxx

2. Use bin command to set the transfer mode to Binary mode, and the put command to initiate

the file transfer:

ftp> bin

ftp> put test

[root@server ~]# ftp 192.168.10.1

Connected to 192.168.10.1 (192.168.10.1).

220 ProFTPD 1.3.1 Server (ProFTPD TEST Installation) [::ffff:192.168.10.1]

Name (192.168.10.1:root): root

331 Password required for root

Password:

230 User root logged in

Remote system type is UNIX.

Using binary mode to transfer files.

ftp> cd /home/

250 CWD command successful

ftp> put helloworld

local: helloworld remote: helloworld

16

Getting Start | Korenix

227 Entering Passive Mode (192,168,1,176,19,6).

150 Opening BINARY mode data connection for helloworld

226 Transfer complete

4455 bytes sent in 4.1e-05 secs (108658.54 Kbytes/sec)

ftp> exit

221 Goodbye.

3. From the JetBox9500 console, type:

# chmod +x helloworld

# ./helloworld

The word hello world will be printed on the screen.

Please read Chapter 6 for more detail about Toolchain.

Chapter 3 System Feature

This chapter includes information about version control, deployment, updates, and peripherals.

The information in this chapter will be particularly useful when you need to run the same

application on several JetBox units.

3-1 System Version

To determine the hardware capability of your JetBox, and what kind of software functions are

supported, check the version numbers of your JetBox’s hardware, kernel, and user file system.

Contact Korenix to determine the hardware version. You will need the Production S/N (Serial

number), which is located on the JetBox9500’s back label.

To check the firmware version, type:

# version

Figure 3-1 Firmware version

3-2 Enable/Disable Daemons

The following daemons are enabled when the JetBox 9500 boots up for the first time.

Service name

Description

inetd

internet daemons

telnetd

telnet daemon

sshd

secure shell daemon

crond

schedule jobs daemon

Type the command “ps” to list all processes currently running.

18

System Feature | Korenix

daemons status

The /etc/init.d directory is the repository for all available init scripts. The

/etc/rc<n>.d/ only contains links to the /etc/init.d/.

Here is an example of starting and stopping the ssh daemon:

You can start the service by adding the first argument start, and stop the service by adding the

Korenix | System Feature

19

first argument stop

3-3 Setting Run-Level

The “run level” setting can be configuring at the file /etc/inittab. Conventionally, seven

runlevels exist, numbered from zero to six; though up to ten, from zero to nine, may be used.

You can change the number to boot JetBox into different runlevel.

id:3:initdefault:

In this example, runlevel 3 is the default and the scripts that define runlevel 3 can be found in

/etc/rc3.d/.

NOTE

Scripts are run in file name lexical order. Just use ls -l to find out the start

order.

3-4 Setting System Time

The JetBox9500 has two time settings. One is the system time, and the other is the RTC (Real

Time Clock) time kept by the JetBox9500’s hardware.

Use the #date command to query the current system time or set a new system time.

#date MMDDhhmmYYYY

MM = Month

DD = Date

hhmm = hour and minute

YYYY = Year

Use #hwclock to query the current RTC time

Use the following command to set system time from hardware clock:

#hwclock -s

The following figure illustrates how to update the system time and set the RTC time.

20

System Feature | Korenix

Setting the Time Manually

3-5 Adjust System Time

If you only wish to synchronize your clock when the device boots up, you can use ntpdate. This

may be appropriate for some devices which are frequently rebooted and only require

infrequent synchronization.

Using ntpdate at boot time is also a good idea for devices that run ntpd. The ntpd program

changes the clock gradually, whereas ntpdate sets the clock, no matter how great the

difference between a device's current clock setting and the correct time.

3-5-1 NTP Client

The JetBox has a built-in NTP (Network Time Protocol) client that is used to initialize a time

request to a remote NTP server.

Use #ntpdate to update the system time.

#ntpdate time.stdtime.gov.tw

#hwclock –w

NTP client request

Visit http://www.ntp.org for more information about NTP and NTP server addresses.

Page is loading ...

Korenix JetBox9500 series User manual

This manual is also suitable for

Korenix JetBox9500 series User manual

Related papers

Other documents