GATEWAY CONTROL SOFTWARE
rs- rp2c
Set Up Instructions
i
IMPORTANT
Icom, Icom Inc. and the logo are registered trademarks
of Icom Incorporated (Japan) in the United States, the United
Kingdom, Germany, France, Spain, Russia and/or other
countries.
Linux is a registered trademark of Mr. Linus Torvalds in the
United States and/or other countries.
Other brands and model name are registered trademark(s)
or trademark(s) of the respective holders.
TABLE OF CONTENTS
IMPORTANT ............................................................. i
TABLE OF CONTENTS ............................................ i
1 PREPARATION .............................................. 1– 2
■ System requirements ................................................ 1
D PC ......................................................................... 1
D Internet line ............................................................ 1
D Fixed IP address ................................................... 1
D Router .................................................................... 1
■ Linux
®
down loading .................................................. 1
D Down loading the OS ............................................ 1
D Recording the CD .................................................. 1
■ Linux
®
OS installation ................................................ 2
■ DNS name server installation ................................... 2
2 SYSTEM SETUP ........................................... 3–11
■ Gateway server connections .................................... 3
D Connecting to the ID-RP1 system ......................... 3
D Connecting to the ID-RP2 system ......................... 3
■ Router settings .......................................................... 4
D IP address setting .................................................. 4
D Port forwarding setting .......................................... 4
■ Server settings .......................................................... 4
D LAN card settings .................................................. 4
D Named setting ....................................................... 5
D DNS function verification ....................................... 6
■ Gateway control software ......................................... 6
D Installation ............................................................. 6
D Syslog setting ........................................................ 6
D Starting up the control software ............................. 6
D Data base directory ............................................... 7
■ System setup ............................................................ 7
D Setup example ...................................................... 7
■ Control software settings .......................................... 8
D dsgwd.conf screen description .............................. 8
D dsipsvd.conf screen description ............................ 9
■ IP server operation ...................................................10
D Command operation ............................................ 10
D Local IP address reservation ............................... 11
D Station registration ............................................... 11
D Station data synchronization ............................... 11
D Data output .......................................................... 11
D Deleting a station registration .............................. 12
D Backup file ........................................................... 12
D Data base maintenance ...................................... 12
3 SOFTWARE UNINSTALLATION ...................... 13
■ Uninstallation .......................................................... 13
READ THIS INSTRUCTION MANUAL
CAREFULLY before attempting to operate the re-
peater.
SAVE THIS INSTRUCTION MANUAL. This
manual contains important safety and operating instructions for the RS-RP2C.
1
1
PREPARATION
■ System requirements The following units and/or environments are required
to build D-STAR gateway server.
DD
PC
• OS : Linux
®
(updated)
Compatible distribution:
Fedora Core 2 or RedHat®Linux®9
Compatible software version
Linux®Kernel 2.4.20 or later
glibc 2.3.2 or later
BIND 9.2.1 or later
• CPU : Pentium®grade 2.4 GHz or faster
• Memory : At least 512 MB
• LAN board : 2 (NIC from Intel
®
is recommended)
• HDD : At least 10 GB of free space (incl. OS
installation)
DD
Internet line
• Line speed : 750 kbps or more
(recommended effec-
tive speed*)
for both uplink/downlink
*Ask the ISP for effective speed.
DD
Fixed IP address
• Apply to the ISP to acquire a fixed global IP address.
DD
Router
Following functions are required for the router.
•Remote access function (the port forward, DMZ etc.)
•Capability of setting a fixed IP address, such as
PPPoE for WAN
• NAT/IP masquerade
• Static IP masquerade/DMZ
• IP filtering function
• DNS answering function
• Static DHCP server setting for LAN
•Class A subnet mask
(255.0.0.0) can be set for LAN
(For your information: The router, WRV54G from
LINKSYS, covers all the requirements as above.)
*Ask the ISP for recommended router model.
DD
Down loading the OS
Down load the Linux®OS ISO images from the appropriate distributor’s site.
See p. 2 for the address.
DD
Recording the CD
Records the down loaded ISO image into the CD.
The ISO image is the same format as the recorded in
a CD. When this ISO image is recorded in CD as a
file, OS cannot be installed with the CD.
NOTE: See the instruction manual of the CD writing software about a detailed operation, the ISO
image recording procedures, etc.
■ Linux®down loading
NOTE: If you have Linux OS CD (specified distribu-
tion and software version), skip this instruction and
refer to “■ Linux®OS installation”
(p. 2).
The following hardware and software are required for
Linux
®
OS down loading.
• Another PC
The PC must be connected to internet.
• CD-R drive
• CD writing software
The software have capability to burning
a CD with an ISO image.
2
1
PREPARATION
✔
For your information (*The following addresses may delete or change without notice.)
• Fedora Core 2
http://fedoraproject.org/
http://fedora.redhat.com/
• RedHat®Linux®9
- OS down load site
http://ftp.redhat.com/pub/redhat/linux/9/en/iso/i386/
- ISO images necessary
shrike-i386-disc1.iso, shrike-i386-disc2.iso, shrike-i386-disc3.iso
- Installation description
http://www.redhat.com/docs/manuals/linux/RHL-9-Manual
• Fedora Legacy Project
http://www.fedoralegacy.org/
■ Linux®OS installation
Refer to the appropriate distributor’s home page about
the details of the OS installation.
See the addresses listed below for your information.
After the installation, update the OS.
Any support from RedHat has already been finished,
however, the update package is supplied from Fedora
legacy Project.
■ DNS name server installation
Install the DNS name server if not installed.
q Open “Add/Remove Applications” with the follow-
ing mouse operation.
w Click “DNS name Server” to add a check mark,
“✔,” and then click “Details.”
e Click “≈≈” mark beside “Extra Packages” then click
to apply check mark, “✔,” at “caching-nameserver.”
• Click [× Close] after the setting.
r Click [Update] to start the installation.
Click
z Click
x Click to add “✔.”
c Click
Click to add “✔.” Click
z Click
x Select
c Click
2
3
SYSTEM SETUP
■ Gateway server connections
DD
Connecting to the ID-RP1 system
DD
Connecting to the ID-RP2 system
to [10BASE-T]
to eth1
Coupler
to eth0
LAN card: eth1
LAN card: eth0
Gateway server
ID-RP1D (Zone repeater)
to Internet
Router
Modem
to Internet
Modem
Router
to eth0
ID-RP2 (Zone repeater)
Gateway server
LAN card: eth0
LAN card: eth1
to [10BASE-T]
to eth1
4
2
SYSTEM SETUP
■ Router settings
DD
IP address setting
Set the specified IP addresses for both WAN and LAN
as follows.
IP address (WAN) : Enter the fixed global IP address
that is specified from the ISP.
IP address (LAN) : 10.0.0.1
NOTE: The same IP address (for LAN; 10.0.0.1) is used
for all gateways. NEVER use other private IP address.
DD
Port forwarding setting
Set the following port number with protocol to transferring to the IP address “10.0.0.2.”
NOTE: IP filter must be set to allowing Internet re-
mote access to local IP address “10.0.0.2.”
Otherwise the D-STAR gateway will not work due to
the firewall.
Port No.
Usage File location
/Protocol
20005/TCP
IP server synchro- PORT_SYNC
nization (/etc/dsipsvd.conf)
40000/UDP Voice transfer
GW_VCPORT
(/etc/dsgwd.conf)
40001/TCP Data transfer
GW_DTPORT
(/etc/dsgwd.conf)
■ Sever settings
DD
LAN card settings
NOTE: The fixed value for both the IP address and
subnet mask must be set to both eth0 and eth1.
Otherwise the gateway server cannot communicate
to another D-STAR gateway.
q Open “Network Configuration” screen with the fol-
lowing mouse operation.
w Select [eth0] or [eth1] to select router or repeater
side respectively, then click [Edit].
• The “Ethernet Device” screen appears as right above.
e Select [Statically set IP address], then enter the
specified IP address, subnet mask and default
gateway (router side; eth0 setting only), as below.
Click [OK], then close “Ethernet Device” screen.
r Click [DNS] tub in “Network Configuration” screen,
then enter the address “127.0.0.1” (fixed value)
into “Primary DNS” column.
Click
Primary DNS:
127.0.0.1
Click
Select
eth0: 10.0.0.2
eth1:172.16.0.20
eth0: 255.0.0.0
eth1: 255.255.255.0
eth0: 10.0.0.1
eth1: Blank
Displays the LAN card name
that is selected in steps w.
For router
Click
For repeater
z Click
c Click
x Select
5
2
SYSTEM SETUP
DD
Named setting
IMPORTANT!: Master the basis of BIND with a ref-
erence book of Linux, before starting the named
setting.
q Add local zone setting file (dstar.local.) to
“/etc/named.conf.”
• e.g.; /etc/named.conf
w Create database, /var/named/dstar.local.db, for
local D-STAR as the following example.
NOTE: A full-stop period must be applied into
2nd, 3rd and 10th lines. And set the separator
as below at the end of the line.
;##DSTAR A RECORD
• e.g.; /var/named/dstar.local.db
✔
For your information
When “Fedora Core 2” is used, the database location
is “/var/named/chroot/var/named/dstar.local.db.”
e Open “Service Configuration” screen with the fol-
lowing mouse operation.
r Click the check box beside “named,” then save the
changed setting if no check mark, “✔,” is added.
t Select “named” item, then click [Restart] to restart
the named setting.
z Select
x Click
z Click to add check mark, “✔.”
x Click
c Click to save
z Click
v Click
c Select
x Select
Full stop period
Full stop period
Separator
Full stop period
Add
6
2
SYSTEM SETUP
DD
DNS function verification
q Start up “Terminal” with the following mouse oper-
ation.
w The local DNS operation can be verified by enter-
ing the following command.
# dig router.dstar.local
e When the correct router IP address “10.0.0.1” is
displayed in the answer section as below, the GW
setup is succeeded.
Router IP address
Enter the command
z Click
c Click
x Select
For your convenience:
Set the syslog if desired.
By setting the syslog, easy log management is provided because of the independent log.
➥ Add the following contents in “etc/syslog.conf.”
# for D-STAR
local0.* /var/log/dsgwd.log
local2.* /var/log/dsipsvd.log
DD
Syslog setting
■ Gateway control software
DD
Installation
q Insert the RS-RP2C CD into the drive.
w Expands the file into the “/dstar” directory using
with the following command, or double-click the file
during the CD content is displayed.
Command: # tar zxvf dstar-xxxx.tar.gz
(XXXX=revision number)
e Copy the both “dsgwd.conf” and “dsipsvd.conf”
files, expanded in the “/dstar/conf” directory, into
the “/etc” directory.
r Open the copied files, then edit the contents to
suits the network.
• See page 8 and 9 for details.
DD
Starting up the control software
Execute script “/dstar/exec-mgsv” when starting up
the gateway control software.
When starting up the control software and the system
at the same time, add the command as above in the
“/etc/rc.d/rc.local.”
And we recommend to set the server condition as described at right above to improve the gateway server
performance.
• Deactivate all the services except below
anacron, apmd, atd, crond, keytable, named,
network, ntpd, random, sshd, syslog, xinetd
•Do not start up the X-Window System when
starting up the gateway server
Change the “Default runlevel” in “/etc/inittab” from
5 to 3.
*The X-Window System start up manually with the
“startx” command.
7
2
SYSTEM SETUP
Make the directory for data base backup in the “/var.”
“/var/dsipsvd” is specified as the default setting.
• Refer to y BACKUPDIR_PATH (p. 9)
DD
Data base directory
■ System setup
DD
Setup example
InternetInternet
Modem Router
Gateway server
IP address
v eth0 (for router):10.0.0.2
b eth1 (for repeater):172.16.0.20
Zone repeater
n IP address: 172.16.0.1
Gateway server
(TRUST SERVER)
Port No.
40000
40001
20005
Voice Receive
Data Receive
Data sync.
Protocol
UDP
TCP
TCP
Router
IP address
x LAN: 10.0.0.1
c WAN:The fixed IP address
specified by the ISP
ID-RP2
ID-RP1
z
8
2
SYSTEM SETUP
■ Control software settings
DD
dsgwd.conf screen description
— Zone Repeater’s Information —
q ZR_ADDR
Sets the zone repeater’s IP address
(the IP address
n in DSetup Example)
.
The same IP address that is programmed in “IP”
(for
the ID-RP1D maintenance)
or “IP Address” (for the util-
ity for ID-RP2C)
cell in “Communication Settings”
should be set.
w ZR_CALLSIGN
Sets the zone repeater’s call sign.
The same call sign that is programmed in “Callsign”
cell in “General” of the ID-RP1D maintenance or the
utility for ID-RP2C should be set.
e ZR_PORT
Sets the zone repeater’s transmit/receive port number
(the port number n in D Setup Example).
The same port number that is programmed in “Port”
cell in “Communication Settings” of the ID-RP1D
maintenance or the utility for ID-RP2C should be set.
— DNS Server’s Information —
r DNS_ADDR
Sets the zone DNS server’s IP address (the IP ad-
dress c in D Setup Example)
.
t DNS_MAC
Sets the zone DNS server’s MAC address
(the MAC
address c in D Setup Example)
.
Set the MAC address of the connected router with
dividing by hyphen (-).
— GW’s Information —
y GW_ETHIFNAME
Sets the interface name of the LAN card
(the inter-
face name v in D Setup Example)
.
The interface name can be confirmed with the “ifconfig” command.
u GW_VCPORT
Sets the port number for voice operation (UDP).
Use the default setting.
i GW_DTPORT
Sets the port number for data operation (TCP).
Use the default setting.
o GW_ZRPORT
Sets the port number of the gateway server self for
the communication with the zone repeater (UDP)
.
Use the default setting.
— IP Server’s Information —
!0 MGSV_QRPORT
Sets the port number of the IP address managing
server for call sign inquiry
(UDP).
Use the default setting.
!1 MGSV_UDPORT
Sets the port number of the IP address managing
server for updated location information request
(UDP)
.
Use the default setting.
— GW connection —
!2 CON_WAIT_INTERVAL
Sets the application timer.
The application timer is the waiting timer
(unit: sec-
ond)
until the connection is succeeded when making a new connection to another gateway in data
mode operation.
Use the default setting.
!3 CON_REFRESH_INTERVAL
Sets the decide timer (unit: second) to impossible to
connect to the gateway which is failed in connection
once in data mode operation.
Use the default setting.
!4 CON_MAX_GW
Sets the maximum number of simultaneous connections to another gateway in data mode operation.
Use the default setting.
q
w
e
r
t
y
u
i
o
!0
!1
!2
!3
!4
9
2
SYSTEM SETUP
DD
dsipsvd.conf screen description
— Communication Port Number —
q PORT_SEARCH
Sets the port number of the IP address managing
server for call sign inquiry (UDP).
Use the default setting.
w PORT_RENEWAL
Sets the port number of the IP address managing
server for updated location information request
(UDP).
Use the default setting.
— Command In/Out Mode —
e CMDMODE_STD
Sets the command processing mode.
Use the default setting.
— Backup Param. —
r FILE_SWEEP_HOLD
Sets the backup file preservation period (unit: sec-
ond)
. (default: 86400 sec.)
t FILE_SWEEP_CHECK
Sets the backup file check interval for the file deleting (unit: second). (default: 3600 sec.)
y BACKUPDIR_PATH
Sets the directory for saving the backup file.
The directory “/var/dsipsvd” is the default.
— IP Server comm. Info.—
u TRUST_SERVER
Sets the IP address of the “TRUST SERVER” to acquire the user information in MNG, GIP and RIP
table when starting up the repeater first time.
i PORT_SYNC
Sets the port number for the user information in
MNG, GIP and RIP table synchronization.
(TCP)
Use the default setting.
o SEND_RECV_TIMEOUT
Sets the time-out period for the user information in
MNG, GIP and RIP table synchronization.
Use the default setting.
— My IP Server Info. —
!0 ZR_CALLSIGN
Sets the call sign of the zone repeater.
The same call sign that is programmed in
“ZR_CALLSIGN” in “dsgwd.conf” file should be set.
!1 IPSV_ADDR
Sets the fixed IP address (global address) of the IP
server (the IP address x in D Setup example).
!2 DNS_ZONE_FILE_PATH
Specifies the DNS zone file for D-STAR.
— Named Pid File Name —
!3 NAMED_PID_FILE
Sets the PID (Process ID) of the named setting.
q
w
e
r
t
y
u
i
o
!0
!1
!2
!3
10
2
SYSTEM SETUP
■ IP server operation
DD
Command operation
Sets the command input and output using with the
“FIFO” (/tmp/dsipsvd-cmdin, /tmp/dsipsvd-cmdout).
q Start up 2 Terminals, Terminal-1 and Terminal-2
with the following mouse operation.
w Enter the following command in the Terminal-1 to
make an output terminal of the “FIFO.”
#cat /tmp/dsipsvd-cmdout
Command
z Click
c Click
x Select
• Format
Mark Description
YY Space
(ASCII code: 0x20)
| Vertical line (ASCII code: 0x7c)
[CS(T/A/Z)] 8-character call sign (T: Target, A: Area repeater, Z: Zone repeater)
When the entered call sign does not fulfil 8-character, fill using a space. (ASCII code: 0x20)
[DB] Enter one of “GIP,” “RIP” or “MNG.”
(Capital letters only)
[GWIP] Enter the global IP address of the gateway divided by full stop (.).
[TIP] Enter the local IP address of the target server divided by full stop (.).
[HNAME] Enter the target HOST name that is used for DNS.
Usable characters: A-Z, a-z, 0-9, _, /, [, ], +
[FNAME] Enter the file name that is specified by the absolute path.
11
2
SYSTEM SETUP
DD
Local IP address reservation
q Enter the following command in the Terminal-2.
#echo “reserve”>/tmp/dsipsvd-cmdin
• The command processing result outputs to Terminal-1.
w The reserved IP addresses are displayed when the
“reserve” command operation is succeeded.
• 32 of local IP addresses are reserved in consecutive
numbers.
Reserved IP addresses
Command
DD
Station registration
➥ Enter the following command in the Terminal-2.
#echo“add ID1000|RPT000|RPT000|
XXX.XXX.XXX.XXX|10.22.179.96|id1000”
> /tmp/dsipsvd-cmdin
*XXX.XXX.XXX.XXX=global IP address
Format:
addYY[CS(T)]|[CS(A)]|[CS(Z)]|[GWIP]|[TIP]|
[HNAME]
• Local IP addresses must be reserved using with “reserve” command in advance.
• The command processing result outputs to Terminal-1.
<The station registration confirmation>
➥ Enter the following command in the Terminal-2.
#dig id1000.dstar.local
• The registration is succeeded when the registered local
IP address is displayed in answer section.
Command
Confirmed staion
IP address
Command (example only)
DD
Station data synchronization
➥ Enter the following command in the Terminal-2.
#echo “push_mng”> /tmp/dsipsvd-cmdin
• The registered station information will be registered to
another gateway’s IP server when this command is performed.
DD
Data output
➥ Enter the following command in the Terminal-2.
#echo “write MNG /tmp/mng.txt”>
/tmp/dsipsvd-cmdin
Format:
writeYY[DB]YY[FNAME]
• The functioning data in the memory is output into the
specified file.
12
2
SYSTEM SETUP
DD
Data base maintenance
The maintained data will be restored when the gateway server synchronized with another gateway even
if the data has been deleted because of the IP servers
are synchronized each other.
Follow the maintenance instructions as at right.
q Read out the “TRUST SERVER” data with the
“write” command.
• Used the same format for the file name as the “Backup
file” as described above.
w Deactivate the all programs that are connected to
the gateway server.
e Evacuate the all files in the backup directory in the
connected gateway server into the desired location.
r Move the file that is read out at step q into the
backup directory.
t Edit the file using a editor application.
y Start up the “TRUST_SERVER.”
u Start up another gateway servers one by one to
read the “TRUST_SERVER” data.
NOTE: When starting up the server with brandnew condition, start up the server with the condition that the backup directory is emptied.
DD
Deleting a station registration
➥ Enter the following command in the Terminal-2.
#echo “del ID1000”> /tmp/dsipsvdcmdin
Format:
delYY[CS(T)]
NOTE: A delete flag is applied to the deleted station
data in the MNG.
(The record is not deleted, the
delete flag “1” is added only.)
The deleted call sign is usable when “add”
command is used.
DD
Backup file
A backup file is made with the following file name and
contents into the directory that is specified in “BACKUPDIR_PATH” in IP server’s parameter.
The latest file is re-loaded when re-starting the program.
(YYYY: Year), (MM: Month), (DD: Day),
(HH: Hour), (mm: Minutes), (ss: Second),
(uuuuuu: micro second)
• Global IP address table
(gip_YYYYMMDD_HHmmss_uuuuuu.dat)
File contents:
[GWIP][tab]Registered time[tab]Communication
permission[tab]Effective flag
• Target information table
(mng_YYYYMMDD_HHmmss_uuuuuu.dat)
File contents:
[GWIP][tab][CS(Z)][CS(A)][tab][CS(T)][tab]
[HNAME][tab][TIP][tab]Registered time[tab]Delete
flag[tab]CommandExec.Time
• Reserved IP address table
(rip_YYYYMMDD_HHmmss_uuuuuu.dat)
File contents:
[Reserved head IP address][tab][GWIP][tab]Registered time[tab]Effective flag
3
13
SOFTWARE UNINSTALLATION
■ Uninstallation
Refer to the following instructions when uninstalling the
software.
q Delete the following directories.
• /dstar
• /var/dsipsvd
w Delete the following files.
• /etc/dsgwd.conf
• /etc/dsipsvd.conf
• /var/named/dstar.local.db
• /var/log/dsgwd.log
• /var/log/dsipsvd.log
• /tmp/dsipsvd-cmdin
• /tmp/dsipsvd-cmdout
e Restore the following files.
• /etc/named.conf
• /etc/syslog.conf
• /etc/rc.d/rc.local
1-1-32 Kamiminami, Hirano-ku, Osaka 547-0003, Japan
A-6433I-1EX-q
Printed in Japan
© 2005–2006 Icom Inc.
Loading...