Icom RS-RP2C Manual

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
DPC ......................................................................... 1
DInternet line ............................................................ 1
DFixed IP address ................................................... 1
DRouter .................................................................... 1
■Linux®down loading .................................................. 1
DDown loading the OS ............................................ 1
DRecording the CD .................................................. 1
■Linux®OS installation ................................................ 2
■DNS name server installation ................................... 2
2 SYSTEM SETUP ........................................... 3–11
■Gateway server connections .................................... 3
DConnecting to the ID-RP1 system ......................... 3
DConnecting to the ID-RP2 system ......................... 3
■Router settings .......................................................... 4
DIP address setting .................................................. 4
DPort forwarding setting .......................................... 4
■Server settings .......................................................... 4
DLAN card settings .................................................. 4
DNamed setting ....................................................... 5
DDNS function verification ....................................... 6
■Gateway control software ......................................... 6
DInstallation ............................................................. 6
DSyslog setting ........................................................ 6
DStarting up the control software ............................. 6
DData base directory ............................................... 7
■System setup ............................................................ 7
DSetup example ...................................................... 7
■Control software settings .......................................... 8
Ddsgwd.conf screen description .............................. 8
Ddsipsvd.conf screen description ............................ 9
■IP server operation ...................................................10
DCommand operation ............................................ 10
DLocal IP address reservation ............................... 11
DStation registration ............................................... 11
DStation data synchronization ............................... 11
DData output .......................................................... 11
DDeleting a station registration .............................. 12
DBackup file ........................................................... 12
DData 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 in-
structions for the RS-RP2C.

1
1
PREPARATION
■System requirements The following units and/or environments are required
to build D-STAR gateway server.
DDPC
• 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)
DDInternet line
• Line speed : 750 kbps or more (recommended effec-
tive speed*) for both uplink/downlink
*Ask the ISP for effective speed.
DDFixed IP address
• Apply to the ISP to acquire a fixed global IP address.
DDRouter
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.
DDDown loading the OS
Down load the Linux®OS ISO images from the ap-
propriate distributor’s site.
See p. 2 for the address.
DDRecording 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 writ-
ing 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
1PREPARATION
✔ 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.
qOpen “Add/Remove Applications” with the follow-
ing mouse operation.
wClick “DNS name Server” to add a check mark,
“✔,” and then click “Details.”
eClick “≈≈” mark beside “Extra Packages” then click
to apply check mark, “✔,” at “caching-nameserver.”
• Click [×Close] after the setting.
rClick [Update] to start the installation.
Click
zClick
xClick to add “✔.”
cClick
Click to add “✔.”Click
zClick
xSelect
cClick

2
3
SYSTEM SETUP
■Gateway server connections
DDConnecting to the ID-RP1 system
DDConnecting 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 [10BASE-T]
to eth1
to eth0
LAN card: eth1
LAN card: eth0
Gateway server
ID-RP2 (Zone repeater)
to Internet
Router
Modem

4
2SYSTEM SETUP
■Router settings
DDIP 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.
DDPort forwarding setting
Set the following port number with protocol to transfer-
ring 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
DDLAN 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.
qOpen “Network Configuration”screen with the fol-
lowing mouse operation.
wSelect [eth0] or [eth1] to select router or repeater
side respectively, then click [Edit].
•The “Ethernet Device”screen appears as right above.
eSelect [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.
rClick [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
zClick
cClick
xSelect

5
2
SYSTEM SETUP
DDNamed setting
IMPORTANT!: Master the basis of BIND with a ref-
erence book of Linux, before starting the named
setting.
qAdd local zone setting file (dstar.local.) to
“/etc/named.conf.”
• e.g.; /etc/named.conf
wCreate 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.”
eOpen “Service Configuration”screen with the fol-
lowing mouse operation.
rClick the check box beside “named,”then save the
changed setting if no check mark, “✔,”is added.
tSelect “named”item, then click [Restart] to restart
the named setting.
zSelect
xClick
zClick to add check mark, “✔.”
xClick
cClick to save
zClick
vClick
cSelect
xSelect
Full stop period
Full stop period
Separator
Full stop period
Add

6
2SYSTEM SETUP
DDDNS function verification
qStart up “Terminal”with the following mouse oper-
ation.
wThe local DNS operation can be verified by enter-
ing the following command.
# dig router.dstar.local
eWhen 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
zClick
cClick
xSelect
For your convenience:
Set the syslog if desired.
By setting the syslog, easy log management is pro-
vided 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
DDSyslog setting
■Gateway control software
DDInstallation
qInsert the RS-RP2C CD into the drive.
wExpands 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)
eCopy the both “dsgwd.conf”and “dsipsvd.conf”
files, expanded in the “/dstar/conf”directory, into
the “/etc”directory.
rOpen the copied files, then edit the contents to
suits the network.
•See page 8 and 9 for details.
DDStarting 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 de-
scribed 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 yBACKUPDIR_PATH (p. 9)
DDData base directory
■System setup
DDSetup example
InternetInternet
Modem Router
Gateway server
IP address
veth0 (for router):10.0.0.2
beth1 (for repeater) :172.16.0.20
Zone repeater
nIP 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
xLAN: 10.0.0.1
cWAN:The fixed IP address
specified by the ISP
ID-RP2
ID-RP1
z

8
2SYSTEM SETUP
■Control software settings
DDdsgwd.conf screen description
— Zone Repeater’s Information —
qZR_ADDR
Sets the zone repeater’s IP address (the IP address
nin 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.
wZR_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.
eZR_PORT
Sets the zone repeater’s transmit/receive port num-
ber (the port number nin DSetup 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 —
rDNS_ADDR
Sets the zone DNS server’s IP address (the IP ad-
dress cin DSetup Example).
tDNS_MAC
Sets the zone DNS server’s MAC address (the MAC
address cin DSetup Example).
Set the MAC address of the connected router with
dividing by hyphen (-).
— GW’s Information —
yGW_ETHIFNAME
Sets the interface name of the LAN card (the inter-
face name vin DSetup Example).
The interface name can be confirmed with the “if-
config”command.
uGW_VCPORT
Sets the port number for voice operation (UDP).
Use the default setting.
iGW_DTPORT
Sets the port number for data operation (TCP).
Use the default setting.
oGW_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 mak-
ing 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 con-
nections to another gateway in data mode opera-
tion.
Use the default setting.
qw
e
rt
yu
io
!0 !1
!2 !3
!4