TM810TRE.30-ENG APROL Setup Configuration Recovery
TM810TRE.30-ENG APROL Setup Configuration Recovery
TM810TRE.30-ENG APROL Setup Configuration Recovery
Software APROL
SuSE LINUX
Hardware 1 control computer, 1 controller
Table of contents
1 Introduction........................................................................................................................................... 4
1.1 Objective..................................................................................................................................4
2 Data backups....................................................................................................................................... 6
2.1 Save engineering data............................................................................................................7
2.2 Save runtime data...................................................................................................................8
2.3 Save AprolConfig data and additional data.......................................................................... 11
2.4 Save historical data.............................................................................................................. 13
3 System installation............................................................................................................................. 15
3.1 APROL software package.................................................................................................... 16
3.2 Configuration......................................................................................................................... 18
4 Installing Linux....................................................................................................................................20
4.1 Brief overview of SuSE Linux installation............................................................................. 20
4.2 Operating system installation................................................................................................20
5 Installing and configuring APROL......................................................................................................32
5.1 APROL Installation................................................................................................................32
5.2 Configuring APROL systems................................................................................................ 35
6 Graphics Configuration in Linux.........................................................................................................48
12 Appendix...........................................................................................................................................81
12.1 Objectives checklist (a few on-topic questions)..................................................................81
12.2 Solutions to the objectives checklist................................................................................... 81
12.3 Glossary.............................................................................................................................. 82
1 Introduction
This training module contains basic information for setting up an APROL system. A number of "screen-
shots" are provided in the documentation to make installation of this comprehensive system easier.
We will go through the installation "step by step" in order to show you the simple installation and
configuration. While learning about the process control system installation, you will automatically gain
information about the Linux operating system.
After completing the installation of the Release, you will have no problems setting up APROL systems
in the future.
Figure 1: Introduction
1.1 Objective
The objective of this training is to learn how to backup, set up, configure, and commission an APROL
system on your own.
Example projects and the documentation are contained in the APROL system software.
Figure 2: Overview
2 Data backups
It is necessary to backup all of the relevant plant information, so that it can be restored with all of the
functionalities at a later date. A differentiation is made between engineering, runtime, and historical data.
Normally, the engineering data is sufficient for a restore. Although, this means that the start-up would
have to be done from scratch. This is why this training document also covers all other relevant data (e.g.
remanence data in runtime).
Engineering data can be saved using the CaeManager in an existing system, by using the "File > CAE
Database > CaeBackup" menu item. The data backup is then stored in the engineering home directory
(e.g.: /home/engin) in the path "APROL_CAE_BACKUPS", with the current timestamp of this backup.
The following configuration window appears after a check has been made to see if a backup is possible.
One can define the scope of the data backup before it is carried out. All of the data (libraries created
by GenLib, project data created by devil (tasks, etc.)) can be saved in this way if desired. This means
that the data is available immediately after a restore (no additional build required). However, this type
of data backup requires more space.
The standard setting "Include base engineering data" suffices for a restoration of the project. In this
case, all of the data (GenLib, devil) must be recreated after the recovery procedure.
Customer-specific directories can also be saved with the "customerBackup.inc" configuration file.
The following screenshot offers an example of multiple data backups:
This data can be burned to CD or transferred to another computer via the network. The user has a great
degree of flexibility in this case. In our case, we find various data backups available for copying.
Task:
Perform a data backup of your project. Save the data to your USB data stick.
In a runtime system, there is data of varying types which are useful when restoring the project and
starting up again.
The following list shows the most important data, but is not complete.
Trend compositions A user may have composed many of their own trend curves in the course
of time. These should also be backed up, so that they can be copied back
to the same place and reused.
The data is generally in the directory "~RUNTIME/cnf/TrendViewer". The
trend compositions can be found here (ending with *.tvc). The layout back-
up (ending *.tvl) can be found in a subdirectory "layout".
ControllerManager data Additional data for the ControllerManager may be connection data (ending
*.eConn) and Watch compositions (endings *.Watch and *.DefaultWatch).
These can be found in the "~RUNTIME/cnf/ControllerManager/config"
directory.
ParameterCenter data All ParameterCenter parameter sets and recipes which do not originate
from engineering can be saved via "File > Export all Runtime Parameter
Sets". An XML file is created and should be saved.
At best, this data should be gathered in one directory and transferred to an external data storage device
(USB stick, network, FTP, etc.).
Task:
Save your remanence data to your USB data stick. Also save all other relevant runtime data
to your data storage device.
An APROL server must be installed and configured respectively, in order to act as an engineering,
runtime, or operator system. This configuration is made via the "AprolConfig" tool. Furthermore, there
are several configuration files (Linux) which might also have to be saved.
The following list shows the most important data, but is not complete.
The "Export all" button is under the different AprolConfig aspects in the
leftmost area. The entire configuration is saved in the intended path after a
name and optional description is entered.
Files in /etc There are many system- specific files in the /etc directory. A couple may
be of importance for the restoration of the system.
/etc/hosts
/etc/hosts.equiv
/etc/fstab
/etc/services
/etc/sudoers
/etc/BrLicense/ (if licensed with a dongle)
/etc/X11/xorg.conf
...
Files in /var/log The log files may have a significance for analysis at a later stage. The most
important are:
messages
boot.msg
ChronoPlex.err
xinetd.log
Xorg.0.log
......
There may also be backup files (suffix *.bz2) in addition to the correspond-
ing files.
Own data Customer-specific data
At best, this data should be gathered in one directory and transferred to an external data storage device
(USB stick, network, FTP, etc.).
Task:
Export your APROL configuration and save it to your USB data stick. Also save any data from
your Linux system.
An APROL system saves a lot of data, such as alarms, trends, actions, etc.. This data should also be
saved, so that it can be read at a later stage. A rough differentiation is made between ChronoLog and
trend data.
ATTENTION:
A direct copy is not permitted, because these containers are permanently accessed and written
too. The access must therefore be stopped (rcaprollogging stop, TrendServer stop, ...) or the
data must be renamed to another container with the mv command.
The data here can be handled in the same way as explained in ChronoLog.
The TRD must however be noted. If other TRD-* directories exist, they can
be copied at any time.
mv TRD TRDsave>timestamp>
The project directory must also be taken into account, as can be seen in
the screenshot. This is important if several runtime systems are running on
one server.
Apache configuration Der Apache web server can be modified using the apache2.conf configu-
ration file. This is necessary if an additional data directory should be added
to the web queries (alarms, trends, etc.). (keyword ARKPATH)
The "apache2.conf" configuration file is in /home/aprolsys/APROL/cnf/
apache2/.
At best, this data should be gathered in one directory and transferred to an external data storage device
(USB stick, network, FTP, etc.).
Task:
Save your alarm and trend data to your USB data stick.
3 System installation
A DVD drive should be present in order to perform the installation. An external USB DVD drive can be
used if the PC system does not have a DVD drive. Techniques such as NFS or restoring images (e.g.
ACRONIS) are normal procedures and are welcome.
The entire APROL system software package can be obtained from B&R, and is also available for down-
load from the B&R homepage.
An APROL system is installed and preconfigured before delivery. Documents in the 'root' en-
vironment describe which interventions are necessary to adjust the server to certain customer
needs.
All software components (DVDs) are also supplied, so that your system can be re-installed anytime.
The following media are available:
3.2 Configuration
It is very helpful to determine the mentioned point beforehand, in order to install the APROL system
exactly as required.
Customer:
Customer contact:
Responsible sales organization:
Responsible order processor:
Order number - Position number:
Project description:
Date:
Table 1: Customer / Project information
Keyboard layout:
Partition sizes:
Time zone:
System language:
"Super User" password:
Table 2: Operating system information
Note:
In systems which are to be restored, the above mentioned information already partly exists in
an AprolConfig export. (see AprolConfig aspect)
4 Installing Linux
The Linux package (SLES --> SuSE LINUX Enterprise Server) is tailored especially for the APROL
system. All of the required Linux packages are in the APROL installation DVD.
The operating installation takes place quickly and easily with the help of the Linux Installations DVD
included in delivery.
You should monitor the installation because you must confirm at certain points in the process. This is
normally done with the [Accept]button.
Note:
Since this installation scans and automatically configures all of the hardware inside the com-
puter or connected to the computer, the computer must be completely put together before Linux
is installed. The peripheral devices that will be used (mouse, keyboard, printer, etc.) should
also be connected for this very same reason. Manual changes can of course be carried out
at any time.
• Modem
• Network printer
• Controller
• Computer name (in the scope of the APROL installation)
• Second network card, if necessary
• Internet connection
• Etc.
After Linux has been installed successfully, the system demands the "APROL System Software DVD"
for the further installation.
A detailed description of the individual steps is given in the following pages. The following tables provide
an overview of the steps to be made.
Step Description
1 Boot sequence
Insert the Linux installation DVD into the respective DVD drive and boot the computer from
the DVD drive. (The DVD-ROM drive must be bootable!). The installation source can be
selected beforehand (press F11 on an APC910). Other installation sources may be a USB
stick or NFS.
2 Installing Linux.
In the menu that appears after the SuSE welcome screen, you can set the options for the
respective topics using the listed function keys. Then please select "AutoYaST..". (The
setup makes the selection of the 32 or 64 bit processor) Press [Return] to confirm the se-
lection. The installation will now start the initialization process.
Step Description
3 Installation settings:
Basic settings for the computer are made in this menu. Changes can be made to the key-
board layout, mouse, language or partitions here. The time zone and system start can also
be set.
4 Start Linux installation:
You are directed back to the menu with the overview. Confirm all entries with[Accept].
The basic installation can be continued with [Install] or the settings can be changed with
the[Back] button.
5 Network configuration:
The installation now runs automatically up to the following point: [computer name / host
name] login: This must correspond to the APROL naming convention. The network is then
configured.
6 Install 32 / 64 bit version system software:
The installation of SuSE Linux is finished. The computer then prompts you to insert the
APROL system software DVD. The installation and configuration of an APROL system is
described in the following chapter.
To install Linux, the computer must be booted from the Linux DVD. If an operating system is already
installed, then the proper boot sequence must be defined in the BIOS. (boot first from CD-ROM or USB
– CD-ROM if an external DVD device is present.)
The boot menu can be started (the F11 key on the APC910) to select the boot source.
Linux is installed using the SuSE Linux installation DVD provided by B&R. This DVD contains all of the
SuSE packages (Linux) that are relevant to APROL. The first step is to boot the computer from the SuSE
Linux installation DVD. The installation is then started with the following window:
In the menu that appears after the SuSE welcome screen, you can set the options for the respective
topics using the listed function keys.
In this window, select the option.
The basic choice of the desired functionality takes place with the arrow keys. In our case we must select
"Installation APROL AutoYaST DVD-<version number>".
Another possibility is to boot the "Rescue System" from DVD and then carry out changes to the installed
system. The "Memory Test" (RAM check) and "Repair Installed system" points are also available
(may be necessary by incorrect shutdown).
Additional expert entries can be made using"Boot Options" during the boot procedure.
After the first installation steps have been confirmed, the "Kernel" is loaded and the "Installation Set-
tings" configuration window is shown.
A default setup is loaded and can be adapted respectively.
• System
The connected hardware (processor, RAM, memory, etc.) is displayed by using this menu item.
• Keyboard format
Used to select the connected keyboard. Selection is usually not necessary because this is nor-
mally detected automatically.
• partitioning
The default partition can be changed here to meet the requirements specified in the configuration
sheet. Select the menu item Partitioning to do this.
The partitions can be modified accordingly using the menu items Create, Edit, Delete, Resize. If an
operating system (Windows XP, etc.) is already installed, the Expert menu can be used to load and
modify the original partitioning table.
Note:
An additional data partition for "/home/aprolsys/APROL_DATA" can be created here if desired.
A subsequent configuration is only possible later with more of an effort.
• Software
Additional installation packages can be selected at this point. These are all system-relevant Linux
packages.
• System start
The Grub boot manager is configured at system start. This is automatically configured, allowing
the system to boot correctly. However, the boot loader options can also be modified.
The following configuration option is presented by selecting the system start menu:
• Time zone
The time zone and system time are set in this menu. (UTC)
• Language
This menu item is used to define the system's language setting. A primary and secondary lan-
guage can be selected here. Additionally, the keyboard options can also be changed here.
The [Install] button must be pressed after this configuration. A window is then opened informing you
that the format process and installation is being started.
The previously defined partitions are now created and formatted. The installation procedure then starts.
Depending on the constellation (drive, network, etc.), this may take a considerable amount of time.
The system is "rebooted" automatically after the installation process. A Linux installation sequence
configuration now starts. The superuser password (for the "root" user, administrator password) is the
first point.
The computer name and domain are set up in the next window. The host name must correspond to the
APROL naming conventions. This means that it must be C-conform and be made up of small letters.
The other options should be disabled, because we do not want the IP address to be changed by a
DHCP server. The loopback IP would be 127.0.0.2 and would be entered in the /etc/hosts. This is not
desired, because double entries could arise in the hosts (the same computer name with two different
IP addresses).
All of the network cards in the system are now loaded. They are now offered for configuration.
By clicking the orange "Network Interfaces" entry, you reach the network interface configuration.
The configured network cards are shown in the upper area of the window which just opened.. Select[Edit]
to configure the selected network card. Configure the network according to the guidelines and conditions
of your plant.
In our case, we configure eth0 to a fixed IP address (e.g. 192.168.0.200) in a TCP/IP network with the
class C (IPv4 subnetting reference: 255.255.255.0). The second network card is configured for DHCP
in order to be able to work in the private network.
Other details can be entered in the hardware area and the correct interface can be detected with the
"Blink" button.
Note:
If the Bus ID is used instead of the MAC address and a created image is restored on an identical
hardware, the network settings will be preserved. The network would have to be re-configured
after the image is restored if the MAC address was used.
The system automatically reboots after successful installation. The APROL installation must now be
performed.
Task:
Create a complete working environment by installing the latest APROL release. Configure your
system in the same way as the previous constellation.
This section will cover both types of installation: new installation and update.
Installing the APROL packages
The DVD's package files are installed in the / Files in the "/opt/aprol/" directory are overwrit-
opt/aprol directory. ten with newer files from the DVD
Configuration of the APROL systems with The APROL system update takes place auto-
"AprolConfig". The following systems can be matically. The following systems are updated
configured: automatically.
- Engineering system - Engineering system
- Runtime system - Runtime system
- Operator system - Operator system
- Gateway system - Gateway system
After installing Linux and logging in as superuser (root) in a text shell, the APROL installation procedure
appears automatically after Linux has been installed.
Throughout the installation procedure, decisions must be made and entries and notifications confirmed.
This is generally achieved by pressing the [UP], [DOWN] and [RETURN] or [ENTER] keys on a standard
PC keyboard. For the most part, these instructions do not describe how to handle the respective entries
and notifications.
After a successful SuSE Linux installation, the APROL system DVD should be inserted. The "AprolIn-
stall" script starts automatically after the DVD has been inserted. The "AprolInstall" script must be
started manually for an update. This must be done in Linux runlevel 3.
The menus for this procedure are self-explanatory, which is why this chapter deals only with a few
essential items.
The start menu for the APROL installation appears after executing the "AprolInstall" script or after a
first-time installation; the installation source must be opened.
Then either the NFS or the ISO mount point must be entered, depending on the existing installation
source.
When installing from a directory, the respective installation directory must be specified.
No additional entry is necessary for the "DVD_external" installation source.
Note: Update
The runtime system is not automatically started after performing the update. The whole project
must first be recompiled in the Engineering System and distributed among the different systems.
It is automatically launched after the respective download.
Please perform the following steps after re-installation of SuSE Linux X.x and after the APROL instal-
lation:
a) When performing a first installation (still not having performed an update), The APROL instal-
lation starts automatically and the corresponding systems for this computer are installed and
configured.
b) The Engineering systems, Runtime systems and Operator systems which were saved with
the AprolConfig tool earlier must be installed and pre-configured with the old names, logins
and passwords when updating from APROL RX.X to APROL release Y.Y. (importing the saved
data)
c) Restoring the saved data into the engineering and runtime systems.
d) Restoring the saved historical data
At least one APROL system must be created after installing APROL. Several APROL systems can be
created on a computer. These systems can be created with the "AprolConfig" tool. AprolConfig started
automatically after an APROL installation and can be started in the engineering and runtime environ-
ments at any time and in order to make adjustments.
Possible systems:
• E - Engineering-System
This allows the project configuration for the entire plant. All components (controller, gateways
systems, operator systems, runtime systems) are configured here.
• R - Runtime system
Is configured by the engineering system. All of the data collected at runtime is stored here.
Runtime systems transfer signal states from the controllers to the operator systems and send
commands from the operator systems to the controllers.
• O - Operating system
Is configured by the engineering system. The operator systems contain the data for the visual-
ization of the runtime systems. The monitoring and operation of the plant is done from these
computers.
• G - Gateway system
Is configured by the engineering system. A gateway system is the connection between APROL
and a foreign system. It behaves similarly to a runtime system.
It helps to adhere to the points in the "Configuration" section in order to install the APROL system exactly
as required.
Configuration - Example
The image shows an APROL process control system made up of different components.
Operator stations based on APCs with installed operator systems. The operator stations are equipped
with Multiscreening. A separate operator station was coupled over a wireless LAN connection.
An engineering sever (APC) with an installed engineering system.
Two redundant runtime severs (APC) with an installed runtime systems.
To round off the system, this example includes several controllers on the field level.
After pre-configuration of all systems, you have a system configuration that meets two conditions:
1. A system for completely setting up a process control system.
2. The process control system is ready after it has been engineered and downloaded.
The above mentioned is only meant to depict a condensed structure that provides the foundation for
the later engineering as well as showing how a process control system works with APROL system con-
figurations.
As a rule, the pre-configuration of the APROL system is performed with the "AprolConfig" tool. Creating
a user for the corresponding system under LINUX is also part of the configuration of a system. The
data files, which are an integral part of the system, are copied during the configuration from the APROL
installation directory to the /home* directory with the same name as the system.
In accordance to the conventions set by Linux, a Linux user with a Linux login is assigned to an APROL
system. Since several people generally work on one APROL system, it makes more sense to refer to a
"system login", which needs to be familiar to all of these people.
Within an APROL system, the people mentioned above (users) can administer different tasks. In order
to carry out these tasks, they are assigned an additional login name that has the necessary user rights.
There is another separate login mechanism in every APROL system with login as well as user name
and password to check these rights. For this reason, each user must always be given two login names
with their respective passwords.
5.2.2 AprolConfig
"AprolConfig" creates a Linux user for the corresponding system during the course of configuration.
The script then copies all necessary data from the installation directory (some are also configured auto-
matically) into the home directory of the system.
The following illustration shows the possible launching options.
• System
• ChronoPlex
• VNC
• NTP
• Display
• Global Cluster
• UPS
• LDAP
• Remote compiling
• Job Dispatcher
The initial configuration or pre-configuration of the systems mentioned above after installation is de-
scribed in steps with the respective dialog boxes shown as images. With only a few exceptions, each
step is corresponded by a dialog box. Windows, which are only notifications from AprolConfig for con-
firmation, are not always shown visually.
Step 1: System
You can set the computer types for the APROL system in this selection window.
Depending on the type of system selected, one or more of the APROL systems described above can be
installed and configured on a control computer or an operator station according to license regulations.
The letters below indicate which systems (licenses) can be installed. In this example, all three computer
types are selected consecutively.
System Description
R License for a Runtime System
O License for an Operator System
E License for an Engineering System
Table 7: Licenses
Note:
When configuring an system, the engineering system should be configured first. The oth-
er systems need the information about the corresponding engineering system when they are
configured, because the download is made from the engineering system.
Step 3: Runtime
Enter the name and password of the runtime system in the same way as you did for the engineering
system. Enter the name of the engineering system (in this case engin) in [Name of engineering sys-
tem]. Select [Standard] in [KDE configuration]. Confirm the input with [Activate CC-Accounts con-
figuration].
Activate both items [AprolLoader start] and [APROL system start].
Summary of the possible combinations of both specifications:
• No selection: An existing Runtime system can only be started if the user has the possibility to
start the AprolLoader.
• Choice of only AprolLoader start: The Runtime system is started with the StartManager.
• Choice of only APROL system start: The AprolLoader is started before the runtime system
and then the runtime system is started.
• Select both: The runtime system is started automatically after the boot process.
Step 4: Operator
Enter the data for the operator system in the same way as with the engineering system and runtime
system. Your cluster data must be entered in the [Cluster IP] and [Cluster Name] fields.
The runtime server data must be entered if a single system is being configured.
Step 5: ChronoPlex
The is the ChronoLog control center and is responsible for logging all kinds of APROL data (Audit Trail,
Trend, Alarm, etc.).
The following types are differentiated between:
Depending on the constellation, a forwarding of historical data is should be set up. This protects us from
a download. Customer-specific containers can be created here if this is necessary.
each of these containers plays the role of a save function in APROL. Details can be found in the APROL
system documentation.
Note:
If a container has reached its defined size, the FIFO principle is applied automatically.
Step 6: VNC
VNC (Virtual Network Computing) is a comfortable possibility for remote access and working in an en-
gineering team.
You can enable or disable the VNC connection possibilities here. There are benefits in connection to an
APROL server with VNC and it should therefore be activated.
The listed selection possibilities show three different ports. The ports represent the different resolutions
of the VNC sessions to be started.
Step 7: NTP
The NTP mechanism (Network Time Protocol) is a protocol for synchronizing the system time via the
network.
First, a computer can retrieve the time from a server or client with a reliable time source. (XNTP time
server)
The computer can then become the time source for other computers in the network.
This makes it possible to define the absolute time and to synchronize the system time on all computers
in the network. In principle, you can enter as many time servers as necessary.
There are three types to choose from:
Step 8: Display
Under "Display" you can assign the auto start application to a specific display. In this way, for example,
it is possible to auto-start to monitor 2 in a Multiscreening environment.
Here you can select the type. [Single] for a stand-alone system or [Redundant] for a redundant cluster
system. Enter the corresponding configuration data. IP addresses normally have to be discussed with IT.
• No UPS configuration
• B&R-UPS (External)
• B&R-UPC (APC Add-On)
• SHUT Communication UPS
• UPS slave
As a result, computers running the runtime and engineering systems should be equipped with a UPS.
The UPS must be connected to the computer in order to activate the configuration.
The requested data must be detected and entered here. Details can be found in the APROL system
documentation.
After installing LINUX and APROL, the default setting for the graphics can be changed using "sax2".
This program can be started with "SuSE Menu > System > Configuration > Configure X11 System".
The superuser password must be entered to start sax2.
sax2 can also be started in Linux runlevel 3 in case a basic configuration is necessary. sax2 then starts
its own X server and detects a default configuration.
As you can see in the screenshot here, the menu structure is simple and intuitive. The following items
are available by selecting "Monitor / Display":
• Monitor
• Graphic card
• Color and resolution,
• to change 3D Acceleration
Monitor configuration:
Press the [Change] button next to the monitor.
The monitor can be selected in the monitor tab. This is normally done automatically. You normally then
get the optimal settings for the monitor. If the monitor which is being used is not in the list, the resolution
and frequency can be adjusted. When multi-screening is active, it is important to also configure the
second monitor.
The resolution configuration can be set as desired by selecting the item "Color - Resolution".
A logical selection of colors and resolution must be made so that the settings are adapted to the graphics
card.
All other menu items are not absolutely necessary for graphics that meet the demands of APROL. Mul-
ti-screening can also be installed in this menu. An extra document is available for this installation in the
APROL documentation or on the B&R homepage.
The configuration can then be tested. A window where the graphic can be tested opens after pressing
the [OK] button.
Click on [Test] to start the test mode. If the test result is satisfactory, the configuration can be saved
by selecting [Save].
The new settings are adopted after restarting the Linux system [reboot].
A system restart can be prevented by entering the text console command
"init 3" --> All graphic consoles will be closed
and then
"init 5" --> Graphic console will be restarted - User appears for graphic login
execute.
Task:
Configure the best possible graphic for your system.
YaST2 can be used to configure the Linux system. This is the equivalent to Windows' Control Panel.
Among other things, it is also possible to define the computer's network configuration.
YaST2 must be started as superuser (root) , which can be done graphically or textually. (textually > when
starting from a text shell (F1- F6), graphically > via KDE).
The following screenshots are from a graphically started YaST2:
The "Network Devices" menu and "Network Settings" item must be selected to start the network
configuration. A window with a list of available network cards is opened.
You should first know the necessary data before configuring the network. The configuration sheet could
be useful in this case as well (see chapter "Configuration").
The pre-configured network cards can be chosen for configuration by selecting the [Edit] button.
Network configuration:
Address tab:
• No IP address
• choose automatic address assignment (using the DHCP) or configuration of a static address.
• Static IP addresses are mostly used APROL systems because the DHCP service is often not
available in the plants. This has the additional advantage of an explicit network topology. The
settings are even more important because the computers in the APROL network must recog-
nize each other to guarantee data exchange and downloads.
Note:
Several interfaces must be differentiated in the "hosts" file. This can be configured before-
hand with YaST2. Double entries in the "hosts" file are dangerous and can lead to errors in
downloads and communication. A "pb" is normally added to the host name of an additional
process bus.
As a rule: An additional name per interface.
Task:
Configure the network according to the guidelines and conditions given by the trainer. Test the
connection to the controller with a ping.
Once Linux and APROL have been completely installed, the actual project setup can be started. It is
often the case that an existing data backup is available, which must be imported and used.
This section describes how a data backup is imported and what steps must be taken to implement this
data.
Engineering data can be restored using the CaeManager in an existing system, by using the menu items
"Extras / Database Restore". To do this, the backup data must be copied to the server's engineering
environment.
If the data backup directory was not changed it is in the engineering home directory (e.g. /home/engin)
in the path "APROL_CAE_BACKUPS", with the timestamp it was created.
The following information text appears when this isn't the case.
The backed-up data cannot be restored before this state has occurred. If there is an exclusive access, the
restoration mechanism starts automatically and the backup data will be restored. A successful restoration
is finished with the following message:
After the message is closed, the CaeManager is closed and restarted automatically. Now please follow
the instructions on the screen.
After the restore, the project can be commissioned. A few steps must be made to do this:
Control the control computer setting with respect to the host name, domain, redundancy server, net-
work, etc. (see illustration)
The computer name and domain must normally be adjusted here. All other settings must of course also
be checked.
Check the "APROL system" project part with respect to the Iosys port, target system, etc.
(runtime, operator, or gateway system)
All of the libraries must normally be re-created after a successful restore. This is recommended to ensure
code is created for all defined environments (AR versions, etc.).
This is done with "Build > Build all (all Libraries)" or the project explorer context menu.
The results should be checked to ensure that all libraries were created properly.
It makes sense to recompile the entire project ("Build > Build all (Project)").
The output window should be checked to ensure that everything was created properly.
The entire download can now be carried out with the DownloadManager.
- Runtime
- Operator
- Controller
(see the DownloadManager documentation)
Task:
Perform a restore from your project which you backed up.
Steps:
Copy data to the PC, in /home/engin/APROL_CAE_BACKUPS.
Start CaeManager and perform CaeRestore.
Re-create the libraries
Re-create project.
Start-up your training project again. (Download)
The plant is operated in the runtime and operator environments with many inputs and configurations
(controller settings, limits, etc.). This data is stored in remanence files. We can restore and activate the
configuration which we saved on a USB stick.
The following sequence is necessary to do this:
• Stop APROL runtime system. This is generally done with the StartManager.
• Copy data from USB stick to /home/runtime/RUNTIME.
• Rename the files if the computer name has changed.
• Start APROL runtime system. This is generally done with the StartManager.
• Now use the DisplayCenter to see if the saved data exists.
Note:
This must be done on both servers if it is a redundant system.
Task:
Install the saved remanence file in the new runtime environment. Check the result with the
DisplayCenter.
All of the desired and saved archives must now be copied to the server. These can be copied to the
intended path with another name as the original archive.
The data is linked immediately, because the paths are implemented in the so-called !ARKPATH" of the
apache2.conf.
Note:
This must be done on both servers if it is a redundant system.
Task:
Restore the saved historical data. Start trend and alarm queries to see if the data exists.
The language package is another possible necessity. If the restore data supports another language
which is not contained in the standard installation (German and English), this step must be carried out.
Contents graphic
This package includes the following add-on lan-
guages: Chinese, Russian, Spanish, French, Ital-
ian, Romanian, Japanese, ....
The list of supported languages is being extended
continuously.
This data package also contains a translator. A user aproltr (password: .aproltr) is automatically created
when the translator is installed. The APROL product documentation provides you with more detailed
information.
A detailed description of the individual steps is given in the following pages. The following tables should
only be a rough overview of the steps to be made.
Step Description
1 Insert language DVD
Insert the "Language DVD" in the corresponding drive. Then start the YaST control center.
2 Select installation type
Then the CD Icon with the label "Change Source of Installation".
3 Select installation source
Then press the [Add] button. This lets you select the medium from which to import the da-
ta.
4 Create link to data
There are several possibilities for reaching the data that must be imported.
Select CD (i.e. installation source) when clicking the [Add] button.
Now click the [Finish] button which will bring you back to the control center overview.
5 Start software installation
Now click on the "Software Management" icon. A window then opens.
6 Software filter
In this window, select the filter from the top left. There are several ways to configure the
data filter. Switch the view to the "Patterns" function. You will then see the packages that
are recommended for installation. Selecting the individual packages activates them, which
is indicated by the selection icon.
7 Adopt settings
Now the settings just need to be accepted. Start the installation by selecting the [Accept]
and [Install] buttons.
8 Installation finished
The installation is now complete and you can now remove the CD and close the control
center.
Start the YaST control center. There are several methods available for doing this:
A.) Open the control center in the menu (also with "System configuration>Administrator Settings /
YaST)"
• Open an input window (e.g. xterm) key combination Alt + F2, and execute the xterm com-
mand ).
• Log in as superuser ( su - root > command execute). Now enter the required password
(.root).
• Execute the command "yast2".
• The YaST2 control center is opened after executing this command
In this figure, it is already evident which categories can be configured in the control center. The software
section provides information about installing data.
For this, choose [Software Repositories].
The files loaded from a memory medium are listed in this popup. However, since we still don't have any
data loaded, we will select [Add]. We can then see the different links to the memory media. To reach
our data, select DVD as shown in the illustration.
An installation can also be done from the "Local directory, NFS, USB, etc.".
This brings us back to the control center overview. Now select the icon labeled [Software / Management]
.
In this window, select the filter from the top left with [View]. There are several ways to configure the data
filter. Set the filter to the [Patterns] function. You will now see the packages that are recommended for
installation. (quasi everything in the repository)
Selecting the individual packages activates them. Click [Accept] to start the installation.
The installation is now complete and you can now remove the CD and close the control center.
Software packages are replaced by new versions when a control system update is done. New software
packages may be added..
An update should always be carried out on all computers in the process control network. (engineering
system, runtime system, operator system, gateway system).
Caution:
A control system update may also contain updating the controller's operating system. This
means that a STOP will be triggered on the controller. (PLANT STANDSTILL!)
Start the YaST control center to update the Linux system. This can be done using the KDE menu or
a text window.
Choose [Software Repositories] to start the installation.
This brings us back to the control center overview. Now select the icon labeled [Software Management] .
Filter options:
In this menu, select the view from the top left. Switch the view to the [Patterns] function.
All of the schemes are displayed in the list shown. All of the installed schemes are marked in the first
column.
Package menu:
Now select:
'Update if newer version available' item from the 'Package / All packages' menu.
Choose menu Package > All Packages > Update if newer version available.
You can now see the packages in the window to the right. Check if all of the packages have been
selected. Click [Accept] if all of the packages have been selected. Installation is now started.
If a new kernel has been installed, then the computer must be rebooted. YaST2 makes you aware of this.
Specify if the installation medium check (MD5 check sum) should be carried out.
The execution of the integrity check is strongly recommended!
We select the third option in the next window, because we are performing an update.
Please note:
All of the packages belonging to this computer type are installed. That means that the choice of discarded
drivers made during the last installation is not taken into account (drivers that were discarded last time
are now installed)
In order to de-select individual drivers you must choose the 'Computer type dependent installation'
menu item.
The services must be stopped before starting installation (APROL logging, TbaseServer, AprolLoader).
The programs are restarted after a successful update.
You are then queried if the configuration should start after the update. This setup involves creating
APROL systems. The setup can be closed by choosing [Quit] because we have already configured the
APROL systems.
The update is now complete and you can switch to the graphic mode.
You may have to enter "sax2 -l" to do this.
Starting point for restoring the project:
11 Summary
We have now completed the entire procedure for a new installation and for updating the APROL software.
We have also taken a look at topic of data handling. The procedure for installing add-on packages was
also covered in detail.
The two most important Linux programs (sax2, YaST) are required for configuring the system software.
The procedures described here are identical in other releases.
The backup and restore mechanisms can be used at any time.
12 Appendix
12.3 Glossary
DHCP Stands for Dynamic Host Configuration Protocol, and enables automatic
assignment of the correct IP address when starting the system.
HTTP Hypertext Transfer Protocol:
is the protocol used to transfer information between server and clients on
the internet.
SSL SSL (Secure Socket Layer) and the https protocol (secure HTTP) enable
information transfer between web browser (client) and web server guaran-
teed to be secure from spying or imitation.
DPMS DPMS (Display Power Management System) contains a power-saving
function for monitors.
Warm Failover: Originally, the same services and programs were supposed to be installed
on two computers. However, these services and programs only run on the
master (i.e. the process controlling computer). If any heartbeats are missed
("heartbeat" = sign of life), the services on the slave are started and the
slave becomes the master (and vice versa).
MRS Multi Runtime System (for larger projects and variable conceptions)
ANSL Automation Net Service Link (protocol for communicating between B&R
controllers and control computers)
VNC Virtual Networking Computing
FQDN Fully qualified domain name (e.g. aproltraining01.br-automation.com)
LDAP Lightweight Directory Access Protocol (organized logins, passwords and
access)
NTP Network Time Protocol (for time synchronization)
UPS / USV Uninterruptible Power Supply / Unterbrechungsfreie Stromversorgung
YaST2 Yet another Setup Tool
sax2 Graphics Configuration tool in Linux
The Automation Academy provides targeted training courses for our customers as well as our own employees.
At the Automation Academy, you'll develop the skills you need in no time!
Our seminars make it possible for you to improve your knowledge in the field of automation engineering.
Once completed, you will be in a position to implement efficient automation solutions using B&R technology. This will make
it possible for you to secure a decisive competitive edge by allowing you and your company to react faster to constantly
changing market demands.
SEM410 – Integrated motion control* If you don't happen to find a seminar on our website that suits your
SEM441 – Motion control: Electronic gears and cams** needs, keep in mind that we also offer customized seminars that we
SEM480 – Hydraulics** can set up in coordination with your sales representatives:
SEM1110 – Axis groups and path-controlled movements** SEM099 – Individual training day
TM400 – Introduction to Motion Control TM280 – Condition Monitoring for Vibration Measurement
TM410 – Working with Integrated Motion Control TM480 – The Basics of Hydraulics
TM440 – Motion Control: Basic Functions TM481 – Valve-based Hydraulic Drives
TM441 – Motion control: Electronic gears and cams TM482 – Hydraulic Servo Pump Drives
TM1110 – Integrated Motion Control (Axis Groups) TM490 – Printing Machine Technology
TM1111 – Integrated Motion Control (Path Controlled Movements)
TM450 – Motion Control Concept and Configuration In addition to a printed version, our training modules are also available
TM460 – Initial Commissioning of Motors on our website for download as electronic documents (login required):
TM500 – Introduction to Integrated Safety Visit our website for more information:
TM510 – Working with SafeDESIGNER www.br-automation.com/academy
TM540 – Integrated Safe Motion Control