www.jacques.com.

au

JCN-0306

NETWORK CONFIGURATION FOR A JELINUX SERVER

The network configuration for JELinux hosts can be changed as follows:

CONFIGURE THE IP ADDRESS

1. Log into the server’s Webconfig page using a web browser.

2. Navigate to HOSTS > NETWORK. The NETWORK page displays the current configured network
parameters.

• The TCH-2MX and JSC-5L system controllers have two network interfaces each (listed as
eth0 and eth1).
• A virtual machine version may have one or two network interfaces configured by the virtual
machine host.

3. From the NETWORK CONFIGURATION subpage, identify the network interface to update (usually
eth0), press the corresponding E DIT button.
The EDIT NETWORK INTERFACE page opens. The option is given to either configure for DHCP or
enter static IP address details.

Configure Static IP

4. Enter network configuration details:

• IP Address
• Subnet Mask length1
• Gateway Address

5. Press the SUBMIT button. The NETWORK STATUS subpage displays the updated parameters.
6. RESTART the network service, in the COMMANDS section, press the RESTART button.

If changes are made to the network settings;

• The NETWORK page title will change to NETWORK-MODIFIED

• A COMMIT button will appear below the RESTART button.

7. Press the COMMIT button to accept the changes. The header of the page will change back to
NETWORK.

Check other menus for instances where they refer to the Jccpserver address or
Bind Address and correct where they occur. Generally, you can select either
“default server address” or “eth0” to have these fields filled automatically.
Custom “ini” configuration files may also be affected.
Jacques highly recommends rebooting the system using the Reboot menu after
changing a network IP Address.
Configure as DHCP Client

Release Date | 2018-09-21 Revision | 2.2 Page 1 of 4

Requires a third party DHCP server

8. Tick the GET IP ADDRESS VIA DHCP option and press the SUBMIT button.
9. On network RESTART the interface should obtain an IP address from the DHCP server.

Note that, as a JCCP server, it is a requirement the IP address to be consistent for

the intercoms and client devices to register. If setting a JCCP server IP address by
DHCP it is strongly recommended to set up a reserved address on your DHCP
server using the MAC address. If this host is a client to another jccpserver you
may also need to set the JCCPserver address in Hosts

1Mask length refers to the subnet mask as the number of bits. E.g. 255=8 bits, therefore the subnet
mask “255.255.255.0” is 24bits in length

ADDING A DNS ADDRESS.

As of JELinux version 7.95 you can enter a DNS address under N AME SERVERS
1. Under Names Servers click ADD
2. In the Add a Name Server dialogue enter the IP address of the Domain Name Server.
3. Click COMMIT
4. Click COMMIT to restart the network for the change to take effect.

DNS servers are configured in /etc/resolv.conf

• Click VIEW to “View /etc/resolv.conf “
• If any interfaces are configured using DHCP, some DNS information may be provided by the
DHCP server.
• You can have multiple DNS servers. When looking up a host each DNS entry will be tried in
order until the lookup succeeds.

Deleting a Name server

To delete a Name Servers entry,

1. Click DELETE on the row and click OK when prompted.
2. When the Success message is shown click REFRESH
3. Click COMMIT; the network will restart
4. Click REFRESH to return to the Network menu.

Release Date | 2018-09-21 Revision | 2.2 Page 2 of 4

ADVANCED NETWORK OPTIONS

The following options are only required in special cases.

Network Configuration

ADD – Add available network interfaces. Options normally include bond0, br0 and eth1 depending on
hardware.

NETWORK DESCRIPTION
INTERFACE
Bond0 used to create a redundant network connection using two or more physical
interfaces
Br0 Bridge. Not used.
Eth1 The second network interface.

To Create A Network Bond

1. Add the interfaces “bond0” and “eth1” and click COMMIT

2. EDIT the bond0 interface
a. Fill in the IP address, mask length and gateway address fields
b. Check the boxes next to eth0 and eth1 to include them in the bond
3. Click SUBMIT.
4. Click COMMIT.

With bonding enabled connect both ethernet ports to the network. If the
connection to eth0 fails, eth1 will take over.
For added redundancy you could connect each port to a separate switch on the
network.

SETTING UP TAGGED VLAN

Tagged VLAN might be used on a virtual machine when it is required for the virtual Jacques server to
be on a different VLAN to the Virtual Machine host.

In network setting check the “Interface used as vlan host” option to enable tagged vlan on the
selected interface.
Click ADD to add a VLAN

SETTING DESCRIPTION

VLAN tag Enter the tag for this vlan id (default 1)

Get IP address via DHCP Select to enable DHCP on the vlan interface

IP address Enter the ip address.

Mask length Enter the subnet mask in bitlength format.

Gateway Enter the gateway address.

Release Date | 2018-09-21 Revision | 2.2 Page 3 of 4

Adjusting MTU

When using tagged vlan on a virtual machine that is hosted on a Windows server it is necessary to
account for the larger ethernet frame. You can either
• Enable jumbo frames on the Windows interface (recommended) or
• Adjust the MTU on the JELinux interface.

To lower the MTU it is necessary to change the interface attribute in localhost.xml. Use the following
commands via PuTTY/ssh,
syscfg attribute network/interface -i name=eth0 mtu=1496
jrp.backup syscfg
• Tagged VLAN adds 4 bits to the ethernet packet, therefore lower the mtu to 1496 so that the
maximum packet size of 1500 is not exceeded.

CHANGE THE IP ADDRESS USING THE COMMAND LINE

1. log into the system

user = root
password = jacques

2. The syscfg network command is used to change the IP address. Enter “syscfg” on the command
line to see full usage text.
Usage: syscfg MODE [ OPTIONS ]
Where:
MODE := { network | jccpserver | webpass | touchscreen | boot |
attribute }
OPTIONS
network
-i, --interface <interface> MANDATORY
-a, --address <ip_address|dhcp> MANDATORY
-g, --gateway <ip_address>
-m, --masklen <mask_lengh>
jccpserver
-a, --address <ip_address|default> MANDATORY

The most basic network command is

syscfg network -i eth0 -a 10.7.0.10

• This sets the IP address to 10.7.0.10

• The subnet mask will default to 24 bits (255.255.255.0)
• The gateway address defaults to 10.7.0.1
3. To set specific subnet mask and gateway see the following example

syscfg network -i eth0 -a 10.8.0.1 -g 10.8.0.253 -m 21

Interface=eth0
IP Address=10.8.0.1
Net mask= 21 (255.255.248.0)
Gateway=10.8.0.253

4. To change the IP address for JCCPserver

syscfg jccpserver -a 10.9.0.1

• Use if jccpserver is on a different host.

Release Date | 2018-09-21 Revision | 2.2 Page 4 of 4