Korenix JetBox5400 series User manual

Category
Networking
Type
User manual

This manual is also suitable for

JetOS95
User Manual
www.korenix.com
2
Overview | Korenix
Copyright Notice
Copyright© 2011 Korenix Technology Co., Ltd.
All rights reserved.
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 JetBoxs
IP address in order to connect to the serial console utility.
Use the serial console port settings shown below.
Baud rate
Parity
Data bits
Stop bits
Flow Control
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 PCs 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 JetBox9500s 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 JetBox9500s network settings
Change Network Configuration
Follow the instructions given in a previous section to access JetBox9500s 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 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73

Korenix JetBox5400 series User manual

Category
Networking
Type
User manual
This manual is also suitable for

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI