IHsl IM7 0310 en
IHsl IM7 0310 en
___________________
___________________
Configuring the system 2
___________________
Service and diagnostics 3
SINUMERIK
___________________
Appendix A
SINUMERIK 840D sl
NCU operating system (IM7)
Commissioning Manual
Valid for:
03/2010
6FC5397-1DP10-5BA0
Legal information
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
with a safety alert symbol, indicates that minor personal injury can result if proper precautions are not taken.
CAUTION
without a safety alert symbol, indicates that property damage can result if proper precautions are not taken.
NOTICE
indicates that an unintended result or situation can occur if the corresponding information is not taken into
account.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation for the specific task, in particular its warning notices and
safety instructions. Qualified personnel are those who, based on their training and experience, are capable of
identifying risks and avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be adhered to. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of the Siemens AG. The remaining trademarks in this
publication may be trademarks whose use by third parties for their own purposes could violate the rights of the
owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.
Scope of validity
This document is valid for all systems that are supplied with Linux as operating system on
the CompactFlash Card, such as all NCUs of the type NCU 7x0.
Directory Use
/siemens Reserved for Siemens system software
/addon Reserved for Siemens add-on software
/oem Additional software and configurations of the machine manufacturer
/user Storage of user data
Configuring the HMI application
Data that are created using the HMI application when commissioning
the system.
/system Linux operating system
/user/system/etc File basesys.ini (modifications possible)
/user/common/tcu TCU configuration files
/var/log/messages System log file (same as event.log under Windows)
Files in the directory under /user always have priority over files with the same name in the
directory /oem → /addon → /siemens.
NOTICE
Suitable editors for Linux
In most Linux system files, lines may only be ended with LF, and not with CRLF as in
Windows. Please take note of this when selecting an editor. The HMI application editor
under "Commissioning” is suitable.
In the Linux operating system, the UNIX editor vi is available.
Please take note that the Linux operating system is case-sensitive.
Preset users
The following users have already been set up:
Overview
The NCU has two twist buttons in the lower section of the front panel.
● NCK start-up switch with label SIM/NCK
● PLC mode selector switch with label PLC
The switch positions are marked with even numbers or letters; the uneven numbers are
represented by dots due to space limitations.
6,01&. 3/&
Figure 1-1 Startup and mode selector switch
Sequence
To ensure unproblematic booting of the NCU, the CompactFlash Card must be inserted.
When the NCU is booting up, visual information on the current operating system is provided
using the following displays:
● The RDY-LED flashes slowly yellow when the CF card is accessed.
● During booting, the 7-segment display outputs different codes that indicate, for example,
when the BIOS is started, when the CompactFlash Card is accessed, etc.
When the booting has been completed successfully, the following is displayed:
● The PLC LED lights up green.
● The 7-segment display shows "6." with a flashing dot.
● The RDY-LED lights up green. All other LEDs are not illuminated.
See also
How do you create a service system for the NCU? (Page 53)
Load BIOS
7-segment Meaning
display
00 Before loading the Master Boot Record (MBR) from the CompactFlash Card
01 Before starting the Master Boot Record (MBR) codes
02 Master Boot Record (MBR) code started
03 Second stage of the boot loader started, before reading the configuration file
04 Before loading the kernel
05 Before starting the kernel
NRK/NCK outputs
7-segment Meaning
display
1 Not applicable.
2 Not applicable.
3 Debugger was initialized.
4 NRK operating system was successfully activated.
5 NRK operating system has booted, init task is being processed (→ the application
boots).
6 Initialization was successfully performed; the control is in cyclic operation.
with flashing point: The control is in cyclic operation and the cycles are active.
6.
F Internal error: Can only be read via additional diagnostics.
1 or 2 CompactFlash Card and SRAM data do not match. To resolve this problem, a
general reset is required by booting with switch position 1 or 2.
Lxx=yyy Internal error when starting NCK, "xx" is the line number in the mcsystem.ini, "yyy"
is a unique error code for the code position.
System error
7-segment Meaning
display
Permanent error:
C "crash": The operating system crashes (this approximately corresponds to a Blue
Screen for Windows); details can be found in the system log file.
P "partition": Error when repartitioning
Temporary error:
E "error": A read or write error has occurred on the CompactFlash Card (an additional
point is displayed for a write error). It is possible that the CompactFlash Card is
defective and should be replaced.
F "full": The CompactFlash Card is too full, so it is probable that not all of the services
will be able to be successfully started.
When booting, this error is displayed for 1 minute; the system then continues to
boot, however, it can be assumed that problems will occur.
Supplementary conditions
For the operation of an NCU:
● No more than one NCU may be operated as a DHCP server on the system network.
● An additional external keyboard is required for uppercase/lowercase letters and a mouse
is needed when using the System Network Center.
Network interface
The network interface is an interface that enables network communication. These are the
Ethernet interfaces on the NCU.
Reference
Operator Components and Networking Manual
See also
Generic elements (Page 33)
Storage path
For a Linux basic system, the original file can be found on the CompactFlash Card at
/system/usr/etc; OEM versions are stored under /oem/system/etc as well as
/oem_i/system/etc and user versions under /user/system/etc.
Use
Settings are made in the basesys.ini file that specify the behavior of the system in the
network.
To edit the basesys.ini file:
● Comments are introduced by ';' or '#' at the beginning of the line, and span the width of
the line. Empty lines are also handled as comments.
● The sections that start with a "[NAME]" line are ignored by the basic system itself, but are
sometimes used by the HMI.
● Variable definitions are written in the form "NAME=VALUE". Blanks are permitted around
the '=' character. The value may also be enclosed in double quotation marks, but this is
optional.
NOTICE
Only the basesys.ini file parameters described in this chapter can be changed.
The "System Network Center" can also be used for this purpose. Use the "sc start snc"
command to call this program. To operate it, you will need a mouse.
Description
In this section, the parameters and settings for the external Ethernet interface are defined.
For an NCU7x0, this is X130 (Eth1). If the external interface is in DHCP mode, i.e. the value
of ExternalIP is empty or not defined, then all parameters listed here, with the exception of
"DHCPClientID", are accepted by the DHCP server as long as the server provides a value
for the parameter.
ExternalIP
If ExternalIP is not empty, the fixed IP address specified there is used on the company
network interface. The ExternalNetMask then also needs to be set, as well as the gateway,
name servers, host name, and domain if required.
Value: IP address
Default: Empty
ExternalNetMask
ExternalNetMask must be set together with ExternalIP, in order to define the size of the
network.
Gateway
If the value of gateway is not empty, the host specified there is used as the default gateway,
which means that all IP packages that cannot be directly assigned are sent here for routing.
If no gateway is specified, only the networks that are directly connected are accessible.
Value: IP address
Default: Empty
Nameservers
If DNS name servers are specified here, then these must be used to resolve symbolic host
names, i.e. at most of the points where an IP address is expected, a computer name can
also be used instead.
The name server setting is also sent to your DHCP client (TCU, PG) via the DHCP server of
the NCU, so that this can also work with symbolic names.
Timeservers
Here you can specify a list of NTP servers (UDP/123) that can be used by the NTPD on the
NCU for time synchronization.
Hostname
Here you can define a name for the local host. This manually assigned name takes priority
over all other names.
Value: Name
Default: Empty
Domain
These variables can be used to configure the DNS domain. The effect is that names in this
domain can be resolved without qualification (e.g. if the domain is "test.local", you can also
specify the name "computer1.test.local" as "computer1").
Value: Name
Default: Empty
DHCPClientID
With these variables, you can influence which ClientID the DHCP client presents to its
server. This ID can be used by the server to assign certain parameters to the client, for
example a static IP address.
Usually, the MAC address of the Ethernet interface is used for this purpose. This is also the
default setting. Alternatively, you can also use the host name ("@NAME"), which must then
be defined in the basesys.ini, in order to be recognized before the DHCP request. It is also
possible to use an arbitrary string for ClientID.
Description
In the section [InternalInterface] the data is specified for synchronization of the DHCP server
in the system network.
Note
This section of the basesys.ini file is on Linux systems (e.g. NCU, PCU 321) and, from PCU
base software V8.1, also on Windows systems (e.g. PCU 50.3).
InternalIP
Use this variable to set the fixed IP address in the system network. InternalIP should always
be used together with InternalNetMask.
Value: IP address
Default: 192.168.214.1
InternalNetMask
Specifies the subnet mask for InternallP and should always be used together with it.
InternalIP_Alias
Use this variable to define an additional alias IP address for the interface of the system
network (X120); this is practical in certain application cases.
Value: IP address
Default: Empty
InternalIP_Alias should always be used together with InternalNetMask_Alias.
InternalNetMask_Alias
This variable specifies the subnet mask for InternallP_Alias and should always be used
together with it.
SyncModeDHCPD_SysNet
If this variable is not set on "OFF" then the DHCP servers synchronize themselves in the
system network (X120) so that only one of them actively assigns addresses. This makes it
possible to operate multiple NCUs or PCUs 50.3concurrently without having to adjust the
network settings.
Note
Compatibility with earlier versions
The priority level "ON_LOW" is used automatically if the DHCP server was previously
switched off with the no longer available variable DisableDHCPDeth0=1. Such an NCU
then indeed does have a (standby) DHCP server and keeps a backup of the lease data,
however normally it does not become an active server.
InternalDynRangeStart
With the two variables InternalDynRangeStart and InternalDynRangeEnd, you can explicitly
specify the range of IP address assigned by the DHCP server. The number band of the
presetting should normally suffice.
Value: IP address
Default: First address in the system network + 10 or +2 (if ≤ 16 addresses)
InternalDynRangeEnd
Value: IP address
Default: Last address in the system network - 15 or -1 (if ≤ 16 addresses)
DHCPDNoMasterWait
If a synchronizing DHCP server has once seen a master server in the past, then it waits for
synchronization until the time specified here elapses before it becomes the active server.
This additional pause makes it possible for the intended DHCP master to become the active
DHCP server without displacement even if it is shortly switched on thereafter, or takes longer
to boot than other controllers.
InternalDNSDomain
This is used to specify the Top Level Domain (TLD) name that is used in the system
network. The DNS server of the NCU assigns names to the devices in the system network in
this zone. Name requests for all other zones are forwarded to an external name server in the
company network.
As presetting the "local" recommended by the RFC1035 is used for local networks, to avoid
conflicts with globally defined domain names. Recommendation: The preset should be
maintained.
Description
The settings in this section affect interface X127.
EnableDHCP_IBNNet
If this variable is set to 0 then this prevents the start of the DHCP server on the
commissioning interface (X127).
Value: Empty, 0 or 1
Default: Empty
EnableSysNetToIBNForwarding
If this variable is set to 1, it is possible to transmit packages from the system network (X120)
to X127. A firewall usually prevents this.
It is important to remember that there is no NAT involved, and the sender is responsible for
ensuring (with a suitable routing entry, for example) that packages sent to the PG or service
PC on X127 with the address 192.168.215.x only reach the NCU to which the device is
connected.
Value: Empty, 0 or 1
Default: Empty
DisableIBNForwarding
If this variable is set to 1, the NAT transfer of packages from the service connection X127 to
the system network (X120) is deactivated.
Value: Empty, 0 or 1
Default: Empty
Description
Character strings delivered via SNMP (Simple Network Management Protocol) are entered
here. This is a way of giving out information.
SNMPLocation
This string is used for the standard OID SNMPv2-MIB::sysLocation. It is possible to specify a
location here, which can be subsequently called with an SNMP client.
SNMPContact
This string is used for the standard OID SNMPv2-MIB::sysContact. It is possible to specify a
contact address here, which can be subsequently called with an SNMP client.
SNMPAutLocation
This string is used for the Siemens-specific OID
automationSystemIdent.automationLocationTag. It is possible to specify an additional
location here, which can be subsequently called with an SNMP client. This is similar to
SNMPLocation in terms of the MIB description, although it is intended for entries relating to
automation.
SNMPFunction
This string is used for the Siemens-specific OID
automationSystemIdent.automationFunctionTag. It is possible to specify a function
designation here, which can be subsequently called with an SNMP client.
See also
Example: Configuration file 'basesys.ini' (Page 27)
Description
The parameters in this section define the properties of the DCP protocol (Discovery and
Basic Configuration Protocol) e.g. that are used in the menu item "Accessible participants" of
STEP 7 is used.
InternalDcpEnabled
This can be used to switch-on and switch-off the DCP in the system network (X120); for the
NCU, the value is also used for X127.
Value: 0 or 1
Default: 1
ExternalDcpEnabled
This can be used to switch-on and switch-off the DCP in the company network (X130).
Value: 0 or 1
Default: 0
Description
The parameters in this section define the properties of the LLDP protocol (Link Layer
Discovery Protocol), which is used by several applications for network diagnostics.
InternalLldpEnabled
This can be used to switch-on and switch-off LLDP in the system network (X120); for the
NCU, the value is also used for X127.
Value: 0 or 1
Default: 1
ExternalLldpEnabled
This can be used to switch-on and switch-off LLDP in the company network (X130).
Value: 0 or 1
Default: 0
InternalLldpTLVsTxEnabled
Using this parameter, additional information in the LLDP packages are enabled at
X120/X127, which are normally not included.
The value is a bit field, i.e. the total value is obtained as a sum (total) of the specified
numbers, if the corresponding information is to be sent:
1: port description
2: system name
4: system description
8: capabilities
ExternalLldpTLVsTxEnabled
Using this parameter, additional information in the LLDP packages is enabled at X130, which
are normally not included.
Description
Additional setting possibilities of the Linux system are combined in this section.
NOTICE
Power on the PLC in switch setting 3: "MRES"
With "memory reset" the time of the PLC clock remains intact and is not reset.
If the PLC is switched on in switch position 3 "MRES" then the time will be reset. In this
case the valid time is taken over from the Linux system and does not need to be reset.
Timezone
The time zone set here is used by the system to convert UTC time into local time. The time
zone is also sent to all applications via the environment variable TZ, and is taken into
account by the libc function localtime().
The time zone influences all time entries in the basic system, particularly for the command
"date", for "ls -l", and in the system log file (on the CompactFlash Card under
/var/log/messages).
LogFileLimit
The size of the system logfile /var/log/messages can be restricted with the help of this
variable. By entering "Zero", the logfile has no size limitations.
The specified limit is no hard limit for reasons of efficiency but rather a sort of limit value. If
the logfile reaches a limit value times factor 1.5, then it is reduced to around 75% of the limit
value. A check is carried out every two minutes maximum to see if the file has become too
large.
Value: Size in KB
Default: 100 KB
FirewallOpenPorts
Here you can specify a list of the ports which is to be enabled in the firewall of the external
network interface. Always enabled are TCP/22 (ssh) and TCP/102 (S7 communications).
Logfile is "TCP" or "UDP", the port is the (numerical) port number of the service to be
enabled.
DisableSubsystems
Using this variable, you can suppress mounting and starting of certain subsystems (CFS
systems). Several subsystem names, too, can be specified - separated by blanks.
The names can either be simple CFS basic names (e.g. "nck") - ignoring all CFS systems
with this name - or you specify an absolute path (e.g. /siemens/sinumerik/nck) referring
specifically to this CFS system.
It is also possible to set "DisableSubsystems=all" whereby not a single CFS system can be
mounted or started any more.
DisablePLCTimeSync
If this variable is set to 1, synchronization of the system time with the PLC time (in both
directions) will not be executed.
Value: 0 or 1
Default: 0
EnableCoreDumps
If this variable is set as equal to 1, a logfile for processes is created and stored under
/var/tmp. The protocol file contains a memory print of the process that has crashed or that
has terminated.
Value: Empty, 0 or 1
Default: 0
[InternalInterface]
; With InternalIP and InternalNetMask (both must be set together),
; you can change the address on the internal/TCU/automation net.
; This should not be needed normally.
;InternalIP=192.168.214.1
;InternalNetMask=255.255.255.0
; This is the range of dynamic IPs given out by the DHCP server
; Defaults should be sensible
InternalDynRangeStart=192.168.214.10
InternalDynRangeEnd=192.168.214.239
; If once a DHCP master was seen, the DHCP server waits this many
; seconds for the master to show up before trying to become the
; active server.
;DHCPDNoMasterWait=120
[IBNInterface]
; Setting EnableDHCPD_IBNNet to 0 suppresses that a DHCP server
; is started on that interface.
;EnableDHCPD_IBNNet=0
[SNMP]
; The following variables define strings which are delivered
; on certain SNMP requests.
; SNMPLocation and SNMPContact are reported for the standard OIDs
; SNMPv2-MIB::sysLocation and SNMPv2-MIB::sysContact, resp.
; SNMPAutLocation and SNMPFunction are used in the Siemens specific
; AUTOMATION-SYSTEM-MIB as automationSystemIdent.automationLocationTag
; and automationSystemIdent.automationFunctionTag, resp.
SNMPLocation="not specified"
SNMPContact="not specified"
SNMPAutLocation="not specified"
SNMPLocation="not specified"
[DCP]
; These variables en/disable the DCP protocol on X120/X127
and X130, resp.
;InternalDcpEnabled=0
;ExternalDcpEnabled=1
[LLDP]
; These variables en/disable the LLDP protocol on X120/X127
and X130, resp.
;InternalLldpEnabled=0
;ExternalLldpEnabled=1
[LinuxBase]
; Keep size of /var/log/messages around this value (not followed
; exactly for performance reasons)
LogfileLimit=102400
; Properties of local time zone: names, offset, start and end day
; Some examples:
; Europe: WET0WEST,M3.5.0,M10.5.0
; CET-1CEST,M3.5.0,M10.5.0
; EET-2EEST,M3.5.0,M10.5.0
; USA: EST5EDT,M4.1.0,M10.5.0
; CST6CDT,M4.1.0,M10.5.0
; MST7MDT,M4.1.0,M10.5.0
; PST8PDT,M4.1.0,M10.5.0
; China: CST-8
; Japan: JST-9
Timezone=UTC
Overview
The service command 'sc' is a tool used for performing a range of service tasks on a
SINUMERIK NCU. The required action is written in the command line after the 'sc', e.g.: sc
help
This action produces a list of all actions with a short description. After the action, further
parameters or options can follow.
'sc' is available in both the NCU basic system and the service system (mostly in the form of a
USB memory.) However, some actions are only useful in one of the two systems
(NCU/Service). This is noted for each action.
See also
The most important terms and abbreviations are explained in the glossary.
Privilege levels
The 'sc' command can execute its actions using more privileges than are normally granted to
the calling user. For example, starting or stopping subsystems requires root privileges, but
'sc' allows every user who belongs to the ‘service’ group to do this.
Each action of 'sc' is assigned a “privilege level”. This is a user group to which the user must
belong in order to execute the action. As the groups are hierarchically nested, members of
“higher” groups can also use the action in question. For example, the group 'manufact' is
above 'service', which means that members of the group 'manufact' can call all actions that
require the privilege level 'service'.
The privilege level that the caller requires is noted for each individual action. The possible
levels are (in ascending order):
● none
● operator
● user
● service
● manufact
Example:
An action with the privilege level 'user' can also always be executed by members of the
groups 'service' and 'manufact'. Actions with privilege level ‘none’ can be called by all users.
If a user does not have the required privileges, the following error message is output:
Action 'ACTION' needs at least GROUP privilege level.
Description
'sc' in the command line is essentially not case-sensitive.
The following entries are therefore interpreted as identical:
sc help show
SC help SHOW
sc HeLp sHoW
In some cases, however, upper/lower case can make a difference, for example in file or user
names. This is avoided wherever possible.
The conventions used are as follows:
● Names completely in upper case represent objects to be used depending on the
situation.
Example: sc help ACTION
In this case, ACTION is to be replaced by the action for which you want a description. If
written in lower case, however, the entry should be entered as specified.
● Square brackets indicate optional entries.
Example: sc help [ACTION]
In this case the specification of an action is optional, which means that you can enter an
action, but do not have to. Square brackets may also be nested:
... [USERNAME[/DOMAIN]] ...
In this case, USERNAME and DOMAIN are both optional, but you can only enter a
DOMAIN if you have also entered the USERNAME.
● Alternatives are separated with '|'.
Example: sc start all|system|SUBSYSTEM
Overview
This sections describes the syntax elements that are used by several actions.
Subsystem
A subsystem is a CFS that not only contains a collection of files, but also executes a
program, for example, at runtime. To do this, the CFS contains a script that is used to control
the starting and stopping of this program.
For this reason, only administrators are permitted to set up NFS file systems, and NFS is
usually only implemented in uniformly administrated environments. Exported file systems on
the server are addressed directly on the server via their path.
2.5.1 Help
Description
sc help enable
enable hmi|nck|SUBSYSTEM...
DHCPSvr -INTERFACE
2.5.2 Check-cf
Description
Syntax: sc check-df
Alternative names: checkcf
Privilege level: user
With this action, the CF card is checked reading to see whether it contains defective sectors.
If errors occur, this is noted in the file /var/log/messages.
2.5.3 Clear
Description
Various actions can be performed with the "clear" command; only the "clear dhcp" command
is relevant here.
clear dhcp
Note
The clearing of the Lease data does not delete the entire file, but only the data contained
therein. This action also increments the version number, so that available standby DHCP
servers can also perform the deletion.
2.5.4 Closeport
Description
Syntax: sc closeport ID
Alternative names: ---
Privilege level: service
Mode of operation
This command closes a port in the firewall opened previously with the "sc openport"
command. This is only necessary when the port is to be closed manually before the time set
with "sc openport" expires. Otherwise the port is closed automatically when the port service
life expires.
ON parameter is the ID number of the firewall rule output by "sc openport".
2.5.5 Connect
Description
NOTICE
Note that when entering this command, the password appears on the screen in plain text
according to the specified syntax.
For path names, use the slash “/” and not the backslash “\”.
SMB: //[USERNAME[/DOMAIN][%PASSWORD]@]SERVER/SHARE
The fixed share is: //SERVER/SHARE
The server name can of course also be a numeric IP address. SHARE is the name of the
release on the server. Note that the character '$', which often occurs in this type of name,
must be preceded by a backslash ('\') in the command line. Otherwise, the system tries to
expand a variable.
A user name can also be entered in front of the server name, separated with a '@' character.
If necessary, the user name can also be extended by adding '/' followed by the Windows
domain to which it belongs. The password belonging to this user is normally queried
interactively, so that it is not visible on the screen. ´
For some applications, however, it may be necessary to write the password on the command
line. (For example, programs started from WinSCP cannot read from the keyboard.) In this
case, you can append an additional '%' character, followed by the password. If this contains
any special characters that are interpreted by the shell (<, >, &, ;, ", ', $, (, ), |), you should
shield these by preceding them with a backslash. Commas in SMB passwords cannot be
interpreted.
NFS: SERVER:/PATH
In NFS, entering the user is not required, which just leaves the two components SERVER
and PATH. As before, SERVER is the name of the file server. In contrast to SMB, PATH is a
path name that exists on the server, and not an arbitrarily assigned name.
The command "sc show drives SERVER" shows the file systems offered by a particular
server in the correct notation. For SMB, if required, the user name etc. still need to be added.
After the entry of the remote file system, you can also specify the required directory
('MOUNTPOINT') in which the remote files will become visible locally. This should be an
empty directory to which you have write access. If MOUNTPOINT is omitted, 'sc' itself
generates a suitable directory. The name is /tmp/drvNN (numbered consecutively), and is
displayed when the connection is successful.
The option "-ro" connects the remote file system in read-only mode, which means that you
can only read and do not have write access. This can be useful if you want to exclude
changes that originate from the controller, or if the server only allows read-only connections.
As explained above, an SMB file system is connected as the specified user. To prevent a
third user from executing file operations on the controller in the name of the connected user,
the local directory can normally only be accessed by the latter (and all members of the same
group).
However, if you do want to make the remote directory available to further local users, you
can use the option "-public" to make the MOUNTPOINT belong to the "operator" group, and
this access is therefore guaranteed.
2.5.6 Disable
Description
See also:
Parameters "InternalIP_Alias" and "InternalNetMask_Alias" in the "basesys.ini" file.
Specific subsystems
The name "DHCPSvr" is a special case. This does not switch a normal subsystem on or off,
but specifies whether or not a DHCP server should be started on a network interface. The
interface is entered in the standard form.
The synchronization of the DHCP server is switched on and off with "DHCPSync". The
synchronization is only possible in the system network.
The commands "sc enable" and "sc disable" function by changing certain variables in the file
/user/system/etc/basesys.ini. In subsystems, this variable is "DisableSubsystems", in
DHCPSvr "DisableDHCPD<INTERFACE>".
2.5.7 Disconnect
Description
2.5.8 Distribute
Description
distribute tcudata
This command informs the active DHCP server that TCU data in /user/common/tcu has been
manually changed. The server can then distribute this data to the standby servers.
It is recommended that the version file in /user/common/tcu be changed manually as this is
only read in once by the DHCP server at the start. An incrementing of the version would then
only take effect at a restart.
Note
This command can be performed on any machine in the system network, not only on the
active server. A message is always sent to the active server.
2.5.9 Enable
Description
The "sc enable" command switches on the specified subsystems such that these are also
activated when a subsystem is started. You can also switch several subsystems on with a
single "enable" command.
"hmi", "nck" or any other subsystem names can be used for the subsystems.
"sc enable IPAlias" defines a second alias IP address for a network interface. This is only
supported for X120. The IP address itself has the usual notation with four numbers
separated by decimal points. If not specified, the subnet screen form can be determined from
the class (A/B/C) of the IP or determined explicitly. The CIDR notation (number of bits of the
network section) is also possible.
See also:
Parameters "InternalIP_Alias" and "InternalNetMask_Alias" in the "basesys.ini" file.
Specific subsystems
The name "DHCPSvr" is a special case. This does not switch a normal subsystem on or off,
but specifies whether or not a DHCP server should be started on a network interface. The
interface is entered in the standard form.
The commands "sc enable" and "sc disable" function by changing certain variables in the file
/user/system/etc/basesys.ini. In subsystems, this variable is "DisableSubsystems", in
DHCPSvr "DisableDHCPD<INTERFACE>".
DHCP synchronization
The synchronization of the DHCP server is switched on and off with "DHCPSync". The
synchronization is only possible in the system network (X120). A priority can also be
specified. -LOW, -HIGH or -MASTER.
The priorities have the following effect for the synchronization of the DHCP server:
● MASTER:The computer node will become an active DHCP server. If several servers
have been configured in the system network, this computer has the highest priority.
● HIGH:The computer node belongs to the server candidates with high priority, i.e. if no
server with "MASTER" priority becomes active, then a computer with "HIGH" priority can
be the active server.
● LOW:The computer node belongs to the server candidates with low priority, i.e. if no
server with "MASTER" priority or "HIGH" priority becomes active, then a computer with
"LOW" priority can be the active server.
Note
Recommended settings are:
DHCP operation and DHCP synchronization are switched on in the system network.
Exactly one NCU is set as DHCP server.
Maximum of two computers are candidates with "HIGH" priority.
All other components are set as DHCP clients or candidates with "LOW" priority.
See also:
Parameter "SyncModeDHCPD_SysNet" in the "basesys.ini" file.
2.5.10 Openport
Description
Mode of operation
This command opens a port in the firewall to the company network (X130) for a certain time.
The default time is 15 minutes, but this can be changed with the -MINUTES option. The
maximum possible time is 60 minutes.
The port to be opened is specified in the form "PROTO/PORTNR". The protocol can be
either "tcp" or "udp". This is followed by the specification of the hosts from which the port
should be accessible. Several forms are possible here:
● A single IP address: "128.128.12.12"
● A host name (if this can be resolved via DNS), e.g. "server"
● An IP area with network screen form specification, e.g. "128.128.12.0/255.255.255.0"
● An IP area with specification of the valid bits, e.g. "128.128.12.0/24"
If the specification of the source host is completely missing, this is normally acknowledged
with an error message. However, an exception is when the "sc openport" command is
entered in a shell opened via SSH. The permitted host is taken from the environment
variable $SSH_CLIENT that contains the IP of the SSH client.
If the opening was successful, an ID number is output in a status message:
sc: Port tcp/25 is open, rule ID is 6620
This ID can be used with "sc closeport" to manually close the port earlier.
See also:
Parameter "FirewallOpenPorts" in the "basesys.ini" file.
2.5.11 Restart
Description
Syntax: sc restart
Alternative names: reboot
Privilege level: service
The action "sc restart" triggers a controlled shut down of the machine (stops all subsystems
and the basic system), and then initiates a restart. The effect is the same as the "reboot"
command in the basic system, which can only be executed by "root".
2.5.12 Restore
Description
Mode of operation
As for "sc save", a restore is only possible from the service system or if subsystems are
stopped. If “sc restore" reports an error, for example that the restore will cause running
subsystems to crash, you can use the option "-force" to force the operation – just as for “sc
save”.
Normally, "sc restore" deletes the whole destination area before the backup is restored
(complete CF card for full backup, /user in user data backups). This means that no files are
subsequently available that were not included in the backup.
Options
If no further options are specified, the archive should represent a full backup and this should
be restored in full. The status of all files is therefore the same after the "restore" as it was at
the time of the backup.
● The -full option additionally forces the partition and the file system to be recreated on the
CF card. This is only possible from a service system however. -full is necessary if the
partition table and/or file system is missing or damaged.
● However, if you want to restore the backup files without losing any files that have been
created in the meantime, you can use the option "-nodelete" to prevent these from being
deleted. "-nodelete" is not executed together with "-full", as when the file system is
recreated, all files are essentially deleted.
● The options -addon, -oem, -user, -addon+ and -oem+ also allow you to unpack only parts
of an archive.
● The -update option is used for loading software updates supplied by Siemens. The -
restart option can also be useful with -update. If user-defined system files are changed
when loading an archive, a restart or reinitialization is necessary. In such cases, "sc
restore" outputs a message to that effect at the end of the operation. The -restart option
causes the required action to be performed automatically.
2.5.13 Save
Description
Options
The following options are used for selecting which directories of the file system are to be
written to the archive:
-full: complete backup (default): all files of the controller, incl. Boot Loader
-addon: only /addon directory
-oem: only /oem directory
-user: only /user directory (user data)
-addon+: /addon, /oem and /user
-oem+: /oem and /user
If "sc save" is used directly on the controller and the subsystems are running, this may lead
to inconsistencies between saved files, because they can still change during the backup
process. Therefore, in this case “sc save" normally ends in an error message to inform you
that subsystems are still running.
● If you want to create a backup anyway, you can use the -force option. "sc save" still
issues a warning, but the process continues. If "sc save" is started from the service
system, no subsystems of the controller are running and "-force" is not necessary.
● The -update option writes an Img-D control file to the archive. This makes it possible to
use the archive at a later date via "sc restore -update".
Example:
sc save -user /tmp/drv01/backup.tgz
2.5.14 Show
Description
In the "sc show" command, various displays are grouped together showing the status of the
system.
show ip
This command displays the IP address data of network interfaces. You have the option to
enter a specific interface. If no particular interface is specified, the data for all existing
interfaces is displayed, as well as the Default Gateway.
Example:
sc show ip
X120 (system network, eth0):
configured: (default)
current : IP=192.168.214.1 Netmask=255.255.255.0
MAC=08:00:06:73:55:fd
DNS Name : ncu1.local
Nameserver: 127.0.0.1
DNS Suffix: local
DHCP : synced server, prio=high, active
Statistics: RX=0.0MB (0.00% errors), TX=0.2MB (0.00% errors)
X130 (company network, eth1):
configured: DHCP
current : IP=111.222.333.64 Netmask=255.255.248.0
MAC=08:00:06:73:55:fe
DNS Name : name.test.siemens.de
Nameserver: 111.222.333.12 111.222.333.13 111.222.333.14
DNS suffix: test.siemens.de
DHCP : client (server: 111.222.333.221)
Statistics: RX=1.2MB (0.00% errors), TX=0.0MB (0.00% errors)
X127 (engineering network, ibn0):
current : IP=192.168.215.1 Netmask=255.255.255.224
MAC=08:00:06:73:55:ff
DNS Name : ncu-ibn
DHCP : server
Statistics: RX=0.0MB (0.00% errors), TX=0.0MB (0.00% errors)
Default gateway: 111.222.333.1 (via eth1)
Used nameserver: 127.0.0.1
Used DNS suffix: test.siemens.de local
show drives
"sc show drives" shows the available remote file systems for a particular server. The server
name SERVER can be an NFS server, an SMB server or "TCU", which represents any USB
media that are connected to a TCU. For details of possible server names and entering a user
name (often required for SMB), see the description of the "sc connect" command.
Examples
Notation:
sc show drives someuser/somedomain@somepc # Windows-Server
Password: *******
//somepc/C$
//somepc/D$
//somepc/images
sc show drives someserver # NFS-Server
someserver:/export/home1
someserver:/export/home2
sc show drives TCU # TCU USB-Medien
TCU1:/dev0-0
TCU2:/dev0-0
All the available remote file systems of the relevant server are listed in the notation that is
expected by "sc connect".
● SMB shared drives on Windows servers always begin with "//", followed by the server
name and the name of the shared drive. In NFS file systems, the server name is always
first, followed by a colon and then the export path.
Connection to SMB servers usually requires the entry of a user name (with domain, if
applicable) and a password.
● A USB memory on a TCU is a special form of NFS, and therefore also has the same
notation as an NFS file system. The specified path exists - but not physically - on the
TCU, but is converted there to USB by the NFS server.
show net
The "sc show net" command displays the devices in the system network and gives additional
information on these devices.
As both these functions rely on SNMP (Simple Network Management Protocol), only those
devices able to use SNMP will be found. SNMP as from version 2.6 is available for Linux-
based devices, for all other devices (e.g. MCP) this depends on the respective software
version. If a simple call is made, without any additional options, a list of the devices found will
appear showing the relevant IP address, DNS name (if known), and a short description
(module name).
Options
The various switches, which can also be combined, allow additional information to be output
on the devices found:
● Unless additional options are involved, the output format for "sc show net" is designed to
be displayed on the screen. The alternative XML format is preferable, however, if further
machine-based processing is required. This can be selected via the -xml option (this
option must be the first one!).
● If the command line contains nothing after the switches, "sc show net" will search the
entire system network by broadcast for devices able to use SNMP. This search takes
time, however, and in the case of larger systems, the volume of information output may
be considerable. In view of this, a list of IP addresses or (DNS) names can be specified to
ensure a better overview. This will limit the search process and only the named devices
will be included.
-hw Information on hardware, such as the MLFB, serial number, hardware ID,
hardware version, SRM version, manufacturer, and the serial number of
the CF card. Some devices have two of these hardware blocks (the
second one being intended for an integrated device).
The PLC in the NCU and the TACO in the OP on an TCU are two such
examples.
-tco Operating state data: switching counter, operating hours counter, quantity
of data written to the CF card, number of times maximum temperature
exceeded
-loc Location data: location, function, and contact details for the device (if
configured there)
-sw Displays brief details of the software installed, just the version of the
overall status (or of the basic system, if this is all that is installed)
-swfull Displays all the installed software components. These are represented
hierarchically in the form of a tree. The following is provided for each
component: information on the version, internal version (if different), target
version (if different), version details, and the installation path.
-panel: Displays panel-specific data: size and color depth of the display,
MCP/TCU/DCK/EKS index, and the VNC server currently represented
-dhcp Data on a synchronizing DHCP server: operating state (off/standby/active),
priority, versions of the .leases file and TCU data, and the range for
dynamically assigned IP addresses
-switch Displays the settings of rotary switches on the device, e.g. the NC and
PLC switches of an NCU or the DIPFIX of an HT 8
-all Equivalent to all the switches above
Note
EUNA (End User Notification Administration)
The data and information read out here is written to the EUNA file and saved on the
respective device.
Description
These two actions start or stop individual or all subsystems. Since these actions have a
direct influence on the runtime behavior, they are only available directly on the PLC, but not
in the service system (with the exception of "sc stop system"). The subsystems of the
underlying PLC do not run here, and can therefore not be controlled.
Note
Only "all" and "system" function, but not arbitrary subsystems.
Both of these actions have only been implemented to a restricted extent.
Subsystem names
"hmi", "nck", or any other names, can be used for the subsystems. Multiple subsystems can
also be specified in a row, which are then started and stopped in this order.
"all" and "system" are special values for the subsystem:
● "all" starts or stops all available subsystems.
● "sc stop system" similarly stops all subsystems, but also the basic system with the PLC.
● "start system" is identical to "start all" and exists mainly for reasons of symmetry.
start snc
This command starts the "System Network Center". To operate it, you will need a mouse.
The "System Network Center" you can end with "Exit". If you do not wish to end the "System
Network Center", then switch to the HMI with the following key combination:
<Recall> + <MENU SELECT> (Area switchover key) or
<F9> + <F10> on an external keyboard
Reference
A description of the settings in the "System Network Center" is provided in the Operating
Components and Networking Manual.
Overview
To backup user data or the complete CompactFlash Card, proceed as follows:
● Creating a service system.
● Backing up the license
● Backup: Data backup on USB storage medium or on a network drive.
● System diagnostics
– Output network settings
– Changing the network settings
– Starting the VNC Viewer
To restore the user data or the complete CompactFlash Card, proceed as follows:
● Restore/Recover: Restore the data from USB storage medium or from network drive.
● Carry out software update.
● Carry out firmware update.
Capacity
Note
CompactFlash Card > 1 GB
A CompactFlash Card with a capacity of > 1 GB is not partitioned, but behaves just like a
1 GB CompactFlash Card.
Purpose
In case service is needed, create a portable "Emergency Boot System" (EBS) on a USB
memory. Thus you can start the booting of the NCU from the service system in order to carry
out various service tasks, such as data backup or updates, in a service shell.
Scope of delivery
To create a service system on a USB storage medium, the following files are included on
CD:
● an executable file installdisk.exe
● an image file linuxbase-512M.img for USB-FlashDrive with 512 MB
● an image file linuxbase-resize.img for USB-FlashDrive > 512 MB
● a file with the newest information siemensd.txt
Recommendation:
It is better to use SIMATIC PC USB-FlashDrive.
Note
To create the service system, you need administrator rights.
All data already on the USB storage medium will be deleted.
The transfer is optimized for USB 2.0; therefore, the transmission to the USB storage
medium takes longer when using USB 1.1 than USB 2.0
Proceed as follows
To create a service system on a 512 MB USB storage medium:
1. Copy the service system onto a local hard disk of your programming device (PG) or PC.
2. Connect the USB storage medium to the USB interface of the PG/PC.
3. Determine in Windows Explorer which drive letter the USB storage medium was
assigned, e.g. H:
4. Open a DOS shell and change to the directory in which the files for the service system
are stored.
5. In the DOS shell, enter the following command:
installdisk ––verbose ––blocksize 1m linuxbase-512M.img h:
Result:
The image is transferred to the USB storage medium; a partition for Linux and a FAT
partition for Windows systems are created.
NOTICE
USB storage medium > 512 MB:
If you use a USB storage medium with a storage capacity > 512 MB as service system,
there is a further variant, "linuxbase-resize.img", so that the storage capacity of the USB
storage medium is retained.
VSK8 → OK / Confirm
Ok
Application
For the following cases, backup the license key of the CompactFlash Card on a USB storage
medium or on a network drive:
● Software update without license key
● System software error without defective hardware
NOTICE
Replacement CompactFlash Card
The following data are required in order to obtain a valid license key after replacing the
system CompactFlash Card: The serial number of the defective and the new
CompactFlash Card.
2. Select the menu item "Backup license key to USB memory stick".
The following menu is displayed:
The license key is backed up in the specified directory together with the serial number of the
CompactFlash Card.
See also
The procedure is essentially the same as for "Backup license key to network drive". In
addition, you connect to a network drive:
This is how you connect to a network drive (Page 59)
4. Confirm with "Ok". The following message is output after the operation has been
successfully completed:
See also
The procedure for "Backup user data to network drive" is essentially the same. In addition,
you connect to a network drive:
This is how you connect to a network drive (Page 59)
2. Select "Restore user data from USB memory stick" and confirm with "Ok".
The list of the tgz files available on the USB storage medium are displayed.
3. Select the appropriate tgz file and confirm with "Ok".
A message is output after the operation has been successfully completed.
See also
The procedure for "Restore user data from network drive" is essentially the same. In
addition, you connect to a network drive:
This is how you connect to a network drive (Page 59)
3.3.3 This is how you create a complete backup of the CompactFlash Card
2. Select "Backup complete CF card to USB memory stick" and confirm with "OK".
See also
The procedure for "Backup complete CF card to network drive" is essentially the same. In
addition, you connect to a network drive:
This is how you connect to a network drive (Page 59)
NOTICE
Formatting
This procedure corresponds to formatting the CompactFlash Card and all of the existing
data are overwritten.
2. Select the menu item "Recover system from USB memory stick (reformat CF card)" and
confirm with "Ok".
The list of the tgz files available on the USB storage medium is displayed.
3. Select the appropriate tgz file and confirm with "Ok".
A message is output after the operation has been successfully completed.
Completion
The system must be restarted in order that the new data become effective.
See also
The procedure for "Recover system from network drive (reformat CF card)" is essentially the
same. In addition, you connect to a network drive:
This is how you connect to a network drive (Page 59)
(I)
Configuration of NCU with TCU: the service shell is called under Linux.
(II)
Configuring the NCU with PCU 50 or programming device (PG).
A service shell can be called under:
on the NCU under Linux
on the PCU/PG using the VNC Viewer (system network or company network)
on the PCU/PG using WinSCP (system network or company network)
Proceed as follows
To back up the complete system:
1. Connect the service system to a USB interface (X125 or X135) of the NCU and press the
reset button.
Alternatively, you can switch the NCU off, connect the service system, and switch the
NCU on again.
Result: The NCU boots from the service system.
2. In the main menu, select the menu item "Service Shell".
3. Log on as a service technician using the user name "manufact" and password
"SUNRISE".
4. Using the command "sc backup" you can create the backup file "backup01.tgz".
The directory /data on the service system is provided for backup files. The complete path
should be specified.
5. Choose –full, to backup all data on the CompactFlash Card, or –user, if you only want to
backup user data.
Example: sc backup –full /data/backup01.tgz
Result:
A backup file of the complete CompactFlash Card is created under /data on the service
system on the USB storage medium.
3.4.2 This is how you restore data from the service system
Proceed as follows
To restore the complete system:
1. Connect the service system to a USB interface (X125 or X135) of the NCU and press the
reset button.
Alternatively, you can switch the NCU off, connect the service system, and switch the
NCU on again.
Result: The NCU boots from the service system and the main menu is displayed.
2. In the main menu, select the menu item "Service Shell".
3. Log on as a service technician using the user name "manufact" and password
"SUNRISE".
4. With the command "sc restore" you can write the backup file "backup01" from the service
system back to the CompactFlash Card in the NCU. The complete path should be
specified.
Example: sc restore /data/backup01.tgz
Result:
The system state stored in the file "backup01" is restored on the NCU.
Note
If access to the system data on the CompactFlash Card is not possible because the
CompactFlash Card is defective or empty, you can only log in as user "admin" with the
password "SUNRISE" and no longer as the user "manufact".
Sequence
Proceed as follows:
● Connect the service system.
● "Service Shell" open.
● Establish a connection to a network drive.
● Create a backup file.
Result:
A backup file of the complete CompactFlash Card is created under the specified path on
the network drive.
Scenario II: Start the command shell with WinSCP on the programming device:
Procedure:
1. Start WinSCP and enter the following data in the log-on window:
– IP address of the NCU (or, if required, host name)
– User name "manufact" with password "SUNRISE".
2. Select in the menu "Commands" → "Open Terminal".
3. Execute the data backup using the commands described in steps 4 to 6 from scenario I.
Scenario II: Start the command shell using the VNC Viewer on the programming device
Procedure:
1. Start the VNC Viewer and connect to the NCU using the IP address (or where relevant,
using the host name)
2. Log on under the "manufact" user name with the password "SUNRISE".
3. To restore the data, enter the corresponding commands as described under steps 3 to 5
in scenario I.
3.4.4 This is how you restore data from the network drive
Sequence
Proceed as follows:
● Connect the service system.
● "Service Shell" open.
● Establish a connection to a network drive.
● Restore the data.
Result:
The system state stored in the file "backup01.tgz" is restored on the NCU.
Scenario II: Start the command shell with WinSCP on the programming device:
Procedure:
1. Start WinSCP and enter the following data in the log-on window:
– IP address of the NCU (or, if required, host name)
– User name "manufact" with password "SUNRISE".
2. Select in the menu "Commands" → "Open Terminal".
3. To restore the data, enter the corresponding commands as described under steps 3 to 5
in scenario I.
Scenario II: Start the command shell using the VNC Viewer on the programming device
Procedure:
1. Start the VNC Viewer and connect to the NCU using the IP address (or where relevant,
using the host name)
2. Log on under the "manufact" user name with the password "SUNRISE".
3. To restore the data, enter the corresponding commands as described under steps 3 to 5
in scenario I.
Firmware Update
When service is required, it may be necessary for a service technician to install a BIOS
update. Siemens provides the corresponding update file. Possible formats include: *.img or
*.rom or *.bin. Or, the update file is already supplied on the service system, then step 1 is
eliminated.
Procedure:
1. Copy the update file to the service system.
2. Connect the service system to interface X125 or X135 of the NCU.
3. Switch on the system.
4. In the main menu, select the menu item "Firmware Update".
The following menu is displayed:
Note
Fall back strategy
Before the BIOS update is installed, a backup of the installed BIOS version is saved on the
service system.
For safety reasons, only files can be selected that are suitable and are appropriate for this
NCU.
Update / Recover
The following options are available:
● Update the software from the service system or from the network drive.
● Completely restore the CompactFlash Card with the system software from the service
system or from the network drive (Recover system ...).
2. Select the menu item "Update system software from USB memory stick".
The list of the tgz files available on the USB storage medium are displayed.
3. In order to check which software version contains the tgz file, first select the tgz file, then
press "Show version".
The following information is output:
Completion
The system must be restarted in order that the new data become effective.
See also
The procedure for "Update system software from network drive" is essentially the same. In
addition, you connect to a network drive: This is how you connect to a network drive
(Page 59)
For a complete backup of the system: This is how you install a complete system backup
(Page 68)
See also
This is how you check the CompactFlash Card (Page 82)
NOTICE
Reset ... data to factory defaults
If this data is restored to the delivery condition, then all specific commissioning settings that
were performed up until now are overwritten.
Note
This procedure can take several minutes.
Purpose
The VNC Viewer is used to connect directly with a VNC Server and, for example, to operate
an HMI application.
Furthermore, it enables you to call up a list of all the network devices, thereby obtaining an
overview of the system network.
Number Meaning
Session 0 HMI-Applikation
Session 4 Command Shell
Session 5 System logfile
Session 6 System Network Center (SNC)
Use
The programs WinSCP and PuTTY are freely-available open source programs for Windows.
WinSCP is intended especially for transferring files from and to Linux systems, PuTTY for
the remote operation of a command shell.
● WinSCP can be downloaded via the following link: http://winscp.net/eng/download.php
(http://winscp.net/eng/download.php) (Installation Package).
WinSCP also offers a "command shell" that is limited so that commands can be issued,
but no callbacks can be answered.
● PuTTY, by contrast, offers a complete command shell.
PuTTY web page: http://www.chiark.greenend.org.uk/~sgtatham/putty
(http://www.chiark.greenend.org.uk/~sgtatham/putty)
With both programs, a service technician can log onto the NCU and carry out service tasks.
The username ‘manufact’ with the password ‘SUNRISE’ is available for the Siemens service
technician.
Starting WinSCP
WinSCP is started from Windows after the service technician has logged onto the NCU with
which he is connected using the corresponding authorization (e.g. as user "manufact" with
password "SUNRISE").
From the "Commands“ menu, select ”Open terminal” to open a command shell. There you
can carry out the service commands in the usual way.
Preamble
The licenses for most software are designed to take away your freedom to share and change
it. By contrast, the GNU General Public License is intended to guarantee your freedom to
share and change free software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software Foundation's software and to
any other program whose authors commit to using it. (Some other Free Software Foundation
software is covered by the GNU Lesser General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not price. Our General Public
Licenses are designed to make sure that you have the freedom to distribute copies of free
software (and charge for this service if you wish), that you receive source code or can get it if
you want it, that you can change the software or use pieces of it in new free programs; and
that you know you can do these things.
To protect your rights, we need to make restrictions that forbid anyone to deny you these
rights or to ask you to surrender the rights. These restrictions translate to certain
responsibilities for you if you distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether free of charge or for a fee,
you must give the recipients all the rights that you have. You must make sure that they, too,
receive or can get the source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and (2) offer you this
license which gives you legal permission to copy, distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain that everyone
understands that there is no warranty for this free software. If the software is modified by
someone else and passed on, we want its recipients to know that what they have is not the
original, so that any problems introduced by others will not reflect on the original authors'
reputations.
Finally, any free program is threatened constantly by software patents. We wish to avoid the
danger that redistributors of a free program will individually obtain patent licenses, in effect
making the program proprietary. To prevent this, we have made it clear that any patent must
be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and modification follow:
0. This License applies to any program or other work which contains a notice placed by the
copyright holder saying it may be distributed under the terms of this General Public License.
The "Program", below, refers to any such program or work, and a "work based on the
Program" means either the Program or any derivative work under copyright law: that is to
say, a work containing the Program or a portion of it, either verbatim or with modifications
and/or translated into another language. (Hereinafter, translation is included without
limitation in the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not covered by this License;
they are outside its scope. The act of running the Program is not restricted, and the output
from the Program is covered only if its contents constitute a work based on the Program
(independent of having been made by running the Program). Whether that is true depends
on what the Program does.
1. You may copy and distribute verbatim copies of the Program's source code as you receive
it, in any medium, provided that you conspicuously and appropriately publish on each copy
an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that
refer to this License and to the absence of any warranty; and give any other recipients of the
Program a copy of this License along with the Program. You may charge a fee for the
physical act of transferring a copy, and you may at your option offer warranty protection in
exchange for a fee.
2. You may modify your copy or copies of the program or any portion of it, thus forming a
work based on the program, and copy and distribute such modifications or work under the
terms of Section 1 above, provided that you also meet all of these conditions:
You must cause the modified files to carry prominent notices stating that you changed the
files and the date of any change.
You must cause any work that you distribute or publish, that in whole or in part contains or is
derived from the Program or any part thereof, to be licensed as a whole at no charge to all
third parties under the terms of this License.
If the modified program normally reads commands interactively when run, you must cause it,
when started running for such interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a notice that there is no
warranty (or else, saying that you provide a warranty) and that users may redistribute the
program under these conditions, and telling the user how to view a copy of this License.
(Exception: if the Program itself is interactive but does not normally print such an
announcement, your work based on the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If identifiable sections of that
work are not derived from the Program, and can be reasonably considered independent and
separate works in themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you distribute the same
sections as part of a whole which is a work based on the Program, the distribution of the
whole must be on the terms of this License, whose permissions for other licensees extend to
the entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest your rights to work written
entirely by you; rather, the intent is to exercise the right to control the distribution of
derivative or collective works based on the Program.
In addition, mere aggregation of another work not based on the Program with the Program
(or with a work based on the Program) on a volume of a storage or distribution medium does
not bring the other work under the scope of this License.
3. You may copy and distribute the Program (or a work based on it, under Section 2) in
object code or executable form under the terms of Sections 1 and 2 above provided that you
also do one of the following:
Accompany it with the complete corresponding machine-readable source code, which must
be distributed under the terms of Sections 1 and 2 above on a medium customarily used for
software interchange; or,
Accompany it with a written offer, valid for at least three years, to give any third party, for a
charge no more than your cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be distributed under the terms
of Sections 1 and 2 above on a medium customarily used for software interchange; or,
Accompany it with the information you received as to the offer to distribute corresponding
source code. (This alternative is allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such an offer, in accord with
Subsection b above.)
The source code for a work means the preferred form of the work for making modifications to
it. For an executable work, complete source code means all the source code for all modules
it contains, plus any associated interface definition files, plus the scripts used to control
compilation and installation of the executable. However, as a special exception, the source
code distributed need not include anything that is normally distributed (in either source or
binary form) with the major components (compiler, kernel, and so on) of the operating
system on which the executable runs, unless that component itself accompanies the
executable.
4. You may not copy, modify, sublicense, or distribute the Program except as expressly
provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute
the Program is void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under this License will not
have their licenses terminated so long as such parties remain in full compliance.
5. You are not required to accept this License, since you have not signed it. However,
nothing else grants you permission to modify or distribute the Program or its derivative
works. These actions are prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the Program), you indicate your
acceptance of this License to do so, and all its terms and conditions for copying, distributing
or modifying the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the Program), the recipient
automatically receives a license from the original licensor to copy, distribute or modify the
Program subject to these terms and conditions. You may not impose any further restrictions
on the recipients' exercise of the rights granted herein. You are not responsible for enforcing
compliance by third parties to this License.
8. If the distribution and/or use of the Program is restricted in certain countries either by
patents or by copyrighted interfaces, the original copyright holder who places the Program
under this License may add an explicit geographical distribution limitation excluding those
countries, so that distribution is permitted only in or among countries not thus excluded. In
such case, this License incorporates the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions of the General
Public License from time to time. Such new versions will be similar in spirit to the present
version, but may differ in detail to address new problems or concerns. Each version is given
a distinguishing version number. If the Program specifies a version number of this License
which applies to it and "any later version", you have the option of following the terms and
conditions either of that version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of this License, you may
choose any version ever published by the Free Software Foundation.
10. If you wish to incorporate parts of the Program into other free programs whose
distribution conditions are different, write to the author to ask for permission. For software
which is copyrighted by the Free Software Foundation, write to the Free Software
Foundation; we sometimes make exceptions for this. Our decision will be guided by the two
goals of preserving the free status of all derivatives of our free software and of promoting the
sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS
AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
This program is free software; you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this
program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
Also add information on how to contact you by electronic and paper mail. If the program is
interactive, make it output a short notice like this when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with
ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are
welcome to redistribute it under certain conditions; type 'show c' for details.
The hypothetical commands `show w' and 'show c' should show the appropriate parts of the
General Public License. Of course, the commands you use may be called something other
than 'show w' and 'show c'; they could even be mouse-clicks or menu items -- whatever suits
your program.
You should also get your employer (if you work as a programmer) or your school, if any, to
sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the
names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program 'Gnomovision'(which
makes passes at compilers) written by James Hacker.
This General Public License does not permit incorporating your program into proprietary
programs. If your program is a subroutine library, you may consider it more useful to permit
linking proprietary applications with the library. If this is what you want to do, use the GNU
Lesser General Public License instead of this License.
Updated: $Date: 2005/06/07 16:30:55 $ $Author: novalis $
PuTTY Licence
The PuTTY executables and source code are distributed under the MIT licence, which is
similar in effect to the BSD licence. (This licence is Open Source certified and complies with
the Debian Free Software Guidelines.)
The precise licence text, as given in the file LICENCE in the source distribution, is as follows:
PuTTY is copyright 1997-2005 Simon Tatham.
Portions copyright Robert de Bath, Joris van Rantwijk, Delian Delchev, Andreas Schultz,
Jeroen Massar, Wez Furlong, Nicolas Barry, Justin Bradford, Ben Harris, Malcolm Smith,
Ahmad Khalifa, Markus Kuhn, and CORE SDI S.A.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software
and associated documentation files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or
substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL SIMON TATHAM BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
In particular, anybody (even companies) can use PuTTY without restriction (even for
commercial purposes) and owe nothing to me or anybody else. Also, apart from having to
maintain the copyright notice and the licence text in derivative products, anybody (even
companies) can adapt the PuTTY source code into their own programs and products (even
commercial products) and owe nothing to me or anybody else. And, of course, there is no
warranty and if PuTTY causes you damage you're on your own, so don't use it if you're
unhappy with that.
In particular, note that the MIT licence is compatible with the GNU GPL. So if you want to
incorporate PuTTY or pieces of PuTTY into a GPL program, there's no problem with that.
Network interface
The network interface is an interface that enables network communication. These are the
Ethernet interfaces on the NCU.
Subsystem
A subsystem is a CFS that not only contains a collection of files, but also executes a
program, for example, at runtime. To do this, the CFS contains a script that is used to control
the starting and stopping of this program.
For this reason, only administrators are permitted to set up NFS file systems, and NFS is
usually only implemented in uniformly administrated environments. Exported file systems on
the server are addressed directly on the server via their path.
Timezone, 25
7
C
7-segment display, 9
CFS (Compressed File System), 33
Coding switches, 7
A Command
Backup, (See Save)
Applications, 53
Check-cf, 36
Closeport, 37
Connect, 37
B
Disable, 39
basesys.ini, 15 Disconnect, 40
DHCPClientID, 17 Enable, 41
DHCPDNoMasterWait, 20 Help, 35
DisableIBNForwarding, 21 Openport, 42
DisablePLCTimeSync, 26 Reboot, (Siehe Restart)
DisableSubsystems, 26 Restart, 43
Domain, 17 Restore, 44
EnableCoreDumps, 26 Save, 45
EnableDHCP_IBNNet, 20 Show, 46
EnableSysNetToIBNForwarding, 20 Start, 50
ExternalDcpEnabled, 23 Stop, 50
ExternalIP, 15 CompactFlash Card, 5, 71
ExternalLldpEnabled, 23
ExternalLldpTLVsTxEnabled, 24
ExternalNetMask, 16 D
FirewallOpenPort, 25
data
Gateway, 16
Restoring, 73
Host name, 16
DHCP synchronization, 42
InternalDcpEnabled, 22
Directory structure, 5
InternalDNSDomain, 20
InternalDynRangeEnd, 19
InternalDynRangeStart, 19
E
InternalIP, 18
InternalIP_Alias, 18 Emergency Boot System, 53
InternalLldpEnabled, 23 Ethernet interfaces, 13
InternalLldpTLVsTxEnabled, 23
InternalNetMask, 18
InternalNetMask_Alias, 18 I
LogFileLimit, 25
Interfaces
Nameservers, 16
Ethernet, 33
SNMPAutLocation, 22
NCU, 13
SNMPContact, 21
IP address
SNMPFunction, 22
Setting, 14
SNMPLocation, 21
SyncModeDHCPD_SysNet, 19
Timeservers, 16
L System
Diagnostics, 9
Load operating system, 9
Log file, 5, 26
System error, 11
N
NCK start-up switch, 7 T
NCU booting, 8
Time zone, 25
Network drive, 59
Network interface, 13
NFS (Network File System), 34
U
Update
P BIOS, 75
Firmware, 75
PLC mode selector switch, 7
User group, 31
Privilege, 31
Users (default setting), 6
R V
Remote File System, 34
VNC (Virtual Network Computing), 13
Replacement part, 60
Reset
Button, 8
W
Execute, 8
WinSCP, 86
S
Section
[DCP], 22
[ExternalInterface], 15
[IBNInterface], 20
[InternalInterface], 18
[LinuxBase], 24
[LLDP], 23
[SNMP], 21
Service command
Application, 31
Rights, 31
Syntax, 32
Service menu, 57
Service system
Backing up data, 70
Creating for the NCU, 54
Restoring data, 71
Service Tool WinSCP, 86
SMB (Server Message Block), 34
Subnet mask, 14
Subsystem, 33
Designation, 33
Synchronization
DHCP, 42