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

9
2
SYSTEM SETUP
DDdsipsvd.conf screen description
— Communication Port Number —
qPORT_SEARCH
Sets the port number of the IP address managing
server for call sign inquiry (UDP).
Use the default setting.
wPORT_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 —
eCMDMODE_STD
Sets the command processing mode.
Use the default setting.
— Backup Param. —
rFILE_SWEEP_HOLD
Sets the backup file preservation period (unit: sec-
ond). (default: 86400 sec.)
tFILE_SWEEP_CHECK
Sets the backup file check interval for the file delet-
ing (unit: second). (default: 3600 sec.)
yBACKUPDIR_PATH
Sets the directory for saving the backup file.
The directory “/var/dsipsvd”is the default.
— IP Server comm. Info.—
uTRUST_SERVER
Sets the IP address of the “TRUST SERVER”to ac-
quire the user information in MNG, GIP and RIP
table when starting up the repeater first time.
iPORT_SYNC
Sets the port number for the user information in
MNG, GIP and RIP table synchronization. (TCP)
Use the default setting.
oSEND_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 xin DSetup 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.
qw
e
rt
y
ui
o
!0 !1
!2
!3

10
2SYSTEM SETUP
■IP server operation
DDCommand operation
Sets the command input and output using with the
“FIFO”(/tmp/dsipsvd-cmdin, /tmp/dsipsvd-cmdout).
qStart up 2 Terminals, Terminal-1 and Terminal-2
with the following mouse operation.
wEnter the following command in the Terminal-1 to
make an output terminal of the “FIFO.”
#cat /tmp/dsipsvd-cmdout
Command
zClick
cClick
xSelect
• Format
Mark Description
YYSpace (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
DDLocal IP address reservation
qEnter the following command in the Terminal-2.
#echo “reserve”>/tmp/dsipsvd-cmdin
•The command processing result outputs to Terminal-1.
wThe 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
DDStation 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 “re-
serve”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)
DDStation 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 per-
formed.
DDData 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
2SYSTEM SETUP
DDData base maintenance
The maintained data will be restored when the gate-
way 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.
qRead out the “TRUST SERVER”data with the
“write”command.
•Used the same format for the file name as the “Backup
file”as described above.
wDeactivate the all programs that are connected to
the gateway server.
eEvacuate the all files in the backup directory in the
connected gateway server into the desired loca-
tion.
rMove the file that is read out at step qinto the
backup directory.
tEdit the file using a editor application.
yStart up the “TRUST_SERVER.”
uStart up another gateway servers one by one to
read the “TRUST_SERVER”data.
NOTE: When starting up the server with brand-
new condition, start up the server with the con-
dition that the backup directory is emptied.
DDDeleting a station registration
➥Enter the following command in the Terminal-2.
#echo “del ID1000”> /tmp/dsipsvd-
cmdin
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.
DDBackup file
A backup file is made with the following file name and
contents into the directory that is specified in “BACK-
UPDIR_PATH”in IP server’s parameter.
The latest file is re-loaded when re-starting the pro-
gram.
(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]Reg-
istered time[tab]Effective flag

3
13
SOFTWARE UNINSTALLATION
■Uninstallation
Refer to the following instructions when uninstalling the
software.
qDelete the following directories.
•/dstar
•/var/dsipsvd
wDelete 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
eRestore 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.