Advant OCS

AdvaCommand
for UNIX
Master Software Version 1.8
Extensions

Use of DANGER, WARNING, CAUTION, and NOTE

This publication includes, DANGER, WARNING, CAUTION, and NOTE information where appropriate to point out safety
related or other important information.
DANGER

Hazards which could result in severe personal injury or death

WARNING

Hazards which could result in personal injury

CAUTION

Hazards which could result in equipment or property damage

NOTE

Alerts user to pertinent facts and conditions

Although DANGER and WARNING hazards are related to personal injury, and CAUTION hazards are associated with
equipment or property damage, it should be understood that operation of damaged equipment could, under certain operational
conditions, result in degraded process performance leading to personal injury or death. Therefore, comply fully with all
DANGER, WARNING, and CAUTION notices.

TRADEMARKS

NOTICE
The information in this document is subject to change without notice and should not be construed as a commitment by ABB
Automation Technologies AB. ABB Automation Technologies AB assumes no responsibility for any errors that may appear in
this document.
In no event shall ABB Automation Technologies AB be liable for direct, indirect, special, incidental or consequential damages
of any nature or kind arising from the use of this document, nor shall ABB Automation Technologies AB be liable for incidental
or consequential damages arising from use of any software or hardware described in this document.
This document and parts thereof must not be reproduced or copied without ABB Automation Technologies ABs written
permission, and the contents thereof must not be imparted to a third party nor be used for any unauthorized purpose.
The software described in this document is furnished under a license and may be used, copied, or disclosed only in accordance
with the terms of such license.

3BSE 045 187R0101

Copyright ABB Automation Technologies AB 2006

3BSE001264/B

3BSE 045 187R0101

Table of Contents

Chapter 1 - Introduction
1.1

General Information.....................................................................................................1
1.1.1

Software Version Designation ....................................................................1

1.1.2

Extensions History......................................................................................1

1.1.3

Hardware requirements...............................................................................1
1.1.3.1

1.2

Extension 1...........................................................................1

Related Documentation................................................................................................2

Chapter 2 - Installation
2.1

Preconditions ...............................................................................................................1

2.2

Installation steps ..........................................................................................................1

2.2.1

Installation of Extensions............................................................................1

Chapter 3 - License Handling

3.1

Introduction..................................................................................................................1

3.2

Options Licensing ........................................................................................................1

3.3

Extensions Licensing ...................................................................................................5

3.3.1

Menu Bar ....................................................................................................6

Chapter 4 - Extensions
4.1

Extension 1 ..................................................................................................................1
4.1.1

Introduction.................................................................................................1

4.1.2

Station Backup On File...............................................................................1

4.1.2.1

Overview ..............................................................................1

4.1.2.2

Backup and restore alternatives ...........................................2

4.1.2.3

Menu Bar..............................................................................3

4.1.2.4

Backup of Configurable Data ..............................................6

4.1.2.5

Restore of Configurable Data ..............................................7

4.1.2.6

Interactive Restore ...............................................................9

4.1.2.7

Restore of Independent Configurable Data........................12

4.1.2.8

Backup of History Data......................................................13

4.1.2.9

Restore of History Data......................................................14

4.1.2.10

File Information .................................................................15

4.1.2.11

Set Target Directory ...........................................................17

4.1.2.12

Exit .....................................................................................18

4.1.2.13

Configuration file ...............................................................18

4.1.2.14

Possibilities for backup and restore ...................................19

Chapter 5 - Maintenance
5.1

3BSE 045 187R0101

Configuration of hard disk...........................................................................................1

Advant OCS AdvaCommand for UNIX, Extensions Users Guide

Table of Contents

ii

5.2

Reinstallation............................................................................................................... 2

5.3

Uninstallation of Extensions ....................................................................................... 2

5.4

FAQ ............................................................................................................................. 3

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Chapter 1 Introduction

1.1 General Information

This document describes installation, license handling, operation and maintenance of
AdvaCommand 1.8 for UNIX Extensions.

1.1.1 Software Version Designation

The software for the AdvaCommand 1.8 for UNIX Extensions is distributed on CD
with the following description and designation:
Table 1-1. Extensions Record
Extensions

Part Number

Date

Extension 1

3BSE 045 526R1

2006-06-22

1.1.2 Extensions History

Extension 1

Station Backup On File

1.1.3 Hardware requirements

1.1.3.1 Extension 1
Station Backup On File requires a minimum of 650 Mbyte free space on the local hard
disk. Depending of the size of user data (e.g. number of displays), the size requirement
will increase. A typical system requires between 1.0 - 1.7 Gbyte space.
History Backup requires approx. 270 Mbyte free space on the local hard disk with the
default configuration of AdvaInform History log data base. Increasing the log data base
affects the History Backup with the same amount of size.
In a standard installation of Advant Station, not all disk size is allocated. How to
increase size of the defined logical volumes is described in Section 5.1 Configuration
of hard disk.

3BSE 045 187R0101

1-1

Advant OCS AdvaCommand for UNIX, Extensions

1.2 Related Documentation

Table 1-2. Related Documentation
Document

1-2

Identity

AdvaCommand Basic Functions, Users Guide

3BSE 001 976R0401

Advant Station 520/B2600 Hardware, Users Guide

3BSE 025 712R101

AdvaCommand Version 1.8/X, Release Notes

3BSE 016 043

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Chapter 2 Installation
This chapter describes the installation of Extensions. Extensions are delivered on a CD
named "AdvaCommand 1.8 for UNIX Extension X" (there X is the number of the
extension).
To install and use Extensions you must have purchased the corresponding license
from ABB.

2.1 Preconditions
A CD/DVD drive must be connected to the Operator Station to install Extensions.
AdvaCommand 1.8 for UNIX must be installed on your system before you can install
Extensions.

2.2 Installation steps

2.2.1 Installation of Extensions
Extensions are installed in the same way. Installation of Extension 1 below is used as
an example on how to install Extensions:
1.

Insert the CD "AdvaCommand 1.8 for UNIX Extension 1" in your CD/DVD
drive.

2.

Open a Terminal window (System Config - Station - Terminal Window)

3.

Login as root user by typing command:

$ su - <CR>
Password: vm-guld <CR>

4.

Mount the CD file system to UNIX directory /cdrom by typing the command:
# /usr/local/bin/cdon <CR>

5.

Install the software by typing the command:

# swinstall -s /cdrom -x autoreboot=true ABB-EXTENSION1 <CR>

6.

Unmount the CD file system, i.e. the CD will be released and can be removed
from the CD/DVD drive.
# /usr/local/bin/cdoff <CR>

7.

Complete the installation with a Function Restart (System Config - Station Function Restart)
NOTE

Replace the name of the Extension ABB-EXTENSION1 with the

Extension you want to install e.g. ABB-EXTENSION2

3BSE 045 187R0101

2-1

Advant OCS AdvaCommand for UNIX, Extensions

2-2

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Chapter 3 License Handling

3.1 Introduction
Installation of Extensions also includes License Handling. The License Handling
function Options Licensing gives you the possibility to view the installed Options and
confirm the legal use of these Options with a License Number. In the License Handling
function Extensions Licensing you can activate Extensions with a Key Identity for
specific extension. License Number and Key Identity are specified in the Software
License Certificate document received at delivery.
To open the License Handling registration dialogs you must have authority, i.e. max
dialog. Do as follows:
1.
D1

Press <System Config>. The following set of dynamic function keys is displayed:
AdvaCommand

D6

Settings

D2

D7

AdvaBuild
Station

D3

D8

AdvaInform
Maintenance

D4

D9

D5

License Handling...

D10

Figure 3-1. Dynamic function keys - Max dialog

2.

D1

Press <D9> (License Handling...). The following set of dynamic function keys is
presented:
Options Licensing

D6

D2

D7

Extensions Licensing

D3

D4

D5

D8

D9

D10

Figure 3-2. Dynamic function keys - Max dialog - D9 License Handling...

3.2 Options Licensing

Press <D1> (Options Licensing) in the License Handling dynamic function keys set. A
dialog box is displayed with all installed options and a button to open the License
Agreement dialog box, where you can enter the License Number to confirm the
Software License Agreement for your installed options.

3BSE 045 187R0101

3-1

Advant OCS AdvaCommand for UNIX, Extensions

Figure 3-3. Options Licensing dialog box

Following buttons are available:

OK
To close the dialog box, press the OK button.

Help
To bring up the help dialog box, press the Help button.
Below is the Options Licensing Help dialog box:

3-2

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Figure 3-4. Options Licensing Help dialog box

License Agreement
To bring up the License Agreement dialog box, press the License Agreement button.

3BSE 045 187R0101

3-3

Advant OCS AdvaCommand for UNIX, Extensions

Below is the License Agreement dialog box:

Figure 3-5. License Agreement dialog box

Enter the License Number. The License Number is listed in the Software License
Certificate document.
Following buttons are available:

I Agree
To confirm installed Options and accept the Software License Agreement press the I
Agree button. The License Number will be validated and an illegal License Number
entered gives an error dialog.

3-4

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Cancel
To cancel the dialog and close the dialog box, press the Cancel button.

Help
To bring up the help dialog box, press the Help button.

Figure 3-6. License Agreement Help dialog box

3.3 Extensions Licensing

Press <D2> (Extensions Licensing) in the License Handling dynamic function keys set.
A dialog box is displayed where you can add or remove a Key Identity for Extensions.
Licensed extensions show their included functions.

3BSE 045 187R0101

3-5

Advant OCS AdvaCommand for UNIX, Extensions

Figure 3-7. Extensions Licensing window

3.3.1 Menu Bar

The Extensions Licensing window has the following menu bar:
Help

File

Figure 3-8. Extensions Licensing window menu bar

3-6

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

File
The File menu has the items Add Key Identity, Remove Key Identity and Exit.

File
Add
Exit
Add License
Key Identity...
Remove Key Identity...
Exit
Add

Figure 3-9. File menu item list

Figure 3-10. Add Key Identity dialog box

Add Key Identity

3BSE 045 187R0101

Used to add the Key Identity for the selected extension.

The Key Identity is listed in the Software License
Certificate document.
Press the OK button and the Key Identity is validated.
Illegal Key Identity entered gives an error dialog.
If you do not want to add the Key Identity, press the Cancel
button.

3-7

Advant OCS AdvaCommand for UNIX, Extensions

Figure 3-11. Remove Key Identity dialog box

3-8

Remove Key
Identity

Used to remove the Key Identity for an extension.

Press the Yes button and the Key Identity is removed.
If you do not want to remove the Key Identity, press
the No button.

Exit

Used to exit the Extensions Licensing function.

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Help
The Help menu has the item On Window.

Help
On Window

Figure 3-12. Help menu item list

On Window

Gives you help information for the Extensions Licensing

function.

Figure 3-13. Extensions Licensing Help dialog box

3BSE 045 187R0101

3-9

Advant OCS AdvaCommand for UNIX, Extensions

3-10

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Chapter 4 Extensions

4.1 Extension 1
4.1.1 Introduction
This section describes the contents of Extension 1.

Station Backup On File

4.1.2 Station Backup On File

4.1.2.1 Overview
Station Backup On File provides functions to backup and restore data to/from files on
the local hard disk. After the installation of the Extension 1 the Station Backup On
File will automatically be included as a choice when the Station Backup window is
opened.

Station Backup
File Edit Action
Status Description

Help
Last Execution Next Execution Timer
04/01/06 05:00

Backup of OS 1.8 Configurable Data

Restore of OS 1.6 Configurable Data
Restore of OS 1.7 Configurable Data
Interactive Restore
Restore of OS 1.8 Independent Config Data
Restore of OS 1.8 Configurable Data

03/16/06 13:21

Tape Information

03/16/06 11:43

Backup of History Data

Restore of History Data
Station Backup On File

Figure 4-1. Station Backup window with Station Backup On File choice
An error dialog box will be presented when starting a none licensed Station Backup On
File, see Chapter 3 License Handling.

3BSE 045 187R0101

4-1

Advant OCS AdvaCommand for UNIX, Extensions

The Station Backup On File makes the Operator Station independent of tape devices.
Backups can be taken in on-line mode, i.e. you do not have to set the Operator Station
in configuration mode to perform a backup.
Some restore alternatives must be done in the Backup Restore mode. Choose
Backup Restore mode when the window Workstation mode appears on the screen
of the Operator Station at startup.
Backup can be initiated in a remote host from the local host, meanwhile restore is
always performed in the local host.

Figure 4-2. Station Backup On File window

4.1.2.2 Backup and restore alternatives

Following backup and restore alternatives are available in Station Backup On File:

Backup of Configurable Data

Restore of Configurable Data

Interactive Restore

Restore of Independent Configurable Data

Backup of History Data

Restore of History Data

Following miscellaneous functions are available:

4-2

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

File Information

Set Target directory for Interactive Restore

CD/DVD Connect

Stop function

Help

Exit

4.1.2.3 Menu Bar

The Station Backup On File window, has the following menu bar:
File

Help

Tools

Figure 4-3. Station Backup On File window menu bar

File
The File menu has the items presented below:

File Tools
Add
Exit License
Backup
...
Restore ...
Interactive Restore ...
Independent Restore ...
History Backup ...
History Restore ...
File Info ...
Target ...
Exit
Add

Figure 4-4. File menu item list

3BSE 045 187R0101

4-3

Advant OCS AdvaCommand for UNIX, Extensions

Backup...
Restore...
Interactive Restore...
Independent Restore...
History Backup...
History Restore...
File Info...
Target...
Exit

All File menu items are described in separate sections

below.
Section 4.1.2.4 Backup of Configurable Data
Section 4.1.2.5 Restore of Configurable Data
Section 4.1.2.6 Interactive Restore
Section 4.1.2.7 Restore of Independent Configurable Data
Section 4.1.2.8 Backup of History Data
Section 4.1.2.9 Restore of History Data
Section 4.1.2.10 File Information
Section 4.1.2.11 Set Target Directory
Section 4.1.2.12 Exit

Tools

The Tools menu has the items CD/DVD Connect and Stop Function.

File

Toolsdit
CD/DVD Connect...
Stop Function...

Figure 4-5. Tools menu item list

CD/DVD Connect

Used to connect (access) the internal CD/DVD drive. After

a successful connect the folder /cdrom is showing the
contents of the CD/DVD disk

If you want to access a CD/DVD disk, follow the steps below:

1.

4-4

Select the CD/DVD Connect... item in the Tools menu, and following dialog box
is presented:

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Figure 4-6. CD/DVD Connect dialog box

2.

The radio buttons show the status of the connection when the dialog box is
presented. Click the On button to connect to the inserted CD/DVD-disk. Click the
Off button to release the inserted CD/DVD-disk.

3.

Press the OK button in the dialog box to confirm the choice. If you do not want to
change the status press the Cancel button.

Stop Function

Used to stop an executing backup, restore or file information function.

If no function is executing the Stop Function has no meaning.

If you want to stop an executing function, follow the steps below:

1.

Select the Stop Function... item in the Tools menu, and you get the following
dialog box presented (the text is depending on the executing function):

Figure 4-7. Stop Function dialog box

3BSE 045 187R0101

4-5

Advant OCS AdvaCommand for UNIX, Extensions

2.

Press the OK button in the dialog box presented on screen. If you do not want to
stop the function press the Cancel button.

Help
The Help menu has the item On Window.

Help
On Window

Figure 4-8. Help menu item list

On Window

Gives you help information about Station Backup On File.

Figure 4-9. Station Backup On File Help dialog box

4.1.2.4 Backup of Configurable Data

Use Backup of Configurable Data to make a full backup of the configurable data. A
new backup will always remove the backup file with the same name and location.
If you want to backup the configurable data, follow the steps below:
1.

4-6

Select the Backup... item in the File menu, and you get the following dialog box
presented:

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Figure 4-10. Backup of Configurable Data dialog box

2.

The field for Host is used to specify the host in which the backup will be executed.
If a remote host name is given, the backup executes in that host. This means, the
backup file will be taken and saved in the remote host. Default value is the name
of the local host.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/station.bck. The location
/disk2/BackupOnFile is not included in the backup.

NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13
Configuration file.

3.

Press the Start button in the dialog box to start a Backup of Configurable Data. If
you do not want to start the Backup of Configurable Data, press the Cancel button
and the dialog box is closed.

4.

The backup is ready when a message is presented in the Station Backup On File
window.

4.1.2.5 Restore of Configurable Data

NOTE

Restore of Configurable Data must be done when the Operator Station is

in Backup Restore mode, that can be selected at startup. A restore is
always performed on local host.

3BSE 045 187R0101

4-7

Advant OCS AdvaCommand for UNIX, Extensions

It is only allowed to use the Restore of Configurable Data when restore

to the same Operator Station where the backup was taken.
If you want to restore configurable data from the backup file, follow the steps below:
1.

Select the Restore... item in the File menu, and you get the following dialog box
presented:

Figure 4-11. Restore of Configurable Data dialog box

2.

The field for Host is used to specify the host where the backup file resides. Default
value is the name of the local host. Restore with a backup file on remote host is a
very time consuming operation.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/station.bck.
NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13
Configuration file.

4-8

3.

Press the Start button in the dialog box to start a Restore of Configurable Data. If
you do not want to start the Restore of Configurable Data, press the Cancel button
and the dialog box is closed.

4.

The restore is ready when a message is presented in the Station Backup On File
window.

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

4.1.2.6 Interactive Restore

NOTE

A restore is always performed on local host.

Files and directories are read from the backup file and listed in the Station Backup On
File window.
Files and/or directories can be restored relative to the Target directory see Section
4.1.2.11 Set Target Directory.
If you want to select one or several files to restore from the backup file, follow the steps
below:
1.

Select the Interactive Restore... item in the File menu, and you get the following
dialog box presented:

Figure 4-12. Interactive Restore dialog box

2.

The field for Host is used to specify the host where the backup file resides. Default
value is the name of the local host. Restore with a backup file on remote host is a
very time consuming operation.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/station.bck.

NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13
Configuration file.

3BSE 045 187R0101

4-9

Advant OCS AdvaCommand for UNIX, Extensions

3.

Press the Load button in the dialog box to load the contents of the backup file. If
you do not want to load the contents of the backup file, press the Cancel button
and the dialog box is closed.

4.

After a successful load, you get the contents (directory structure) of the backup file
presented in the Station Backup On File window:

Figure 4-13. Example of Interactive Restore directory structure

5.

4-10

Double click on left mouse button to traverse a directory structure. Select one or
several files by clicking with the left mouse button, press the Restore button and
you get the following dialog box presented:

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Figure 4-14. Example of Interactive Restore

6.

Press the OK button in the dialog box to restore the file(s). If you do not want to
restore, press the Cancel button and the dialog box is closed.

7.

The restore is ready when following dialog box is presented:

Figure 4-15. Example of Interactive Restore finished

3BSE 045 187R0101

4-11

Advant OCS AdvaCommand for UNIX, Extensions

4.1.2.7 Restore of Independent Configurable Data

NOTE

Restore of Independent Configurable Data must be done when the

Operator Station is in Backup Restore mode, that can be selected at
startup. A restore is always performed on local host.
It is only allowed to use the Restore of Independent Configurable Data
within the same control network as the backup was taken. The node in
which the backup is restored must be connected to the same type of data
link (MasterBus 300 or MasterBus 300E) as the node where the backup
was taken.
If you want to do an independent restore of configurable data, follow the steps below:
1.

Select the Independent Restore... item in the File menu, and you get the
following dialog box presented:

Figure 4-16. Restore of Independent Configurable Data dialog box

2.

The field for Host is used to specify the host where the backup file resides. Default
value is the name of the local host. Restore with a backup file on remote host is a
very time consuming operation.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/station.bck.

NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13

4-12

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Configuration file.
3.

Press the Start button in the dialog box to start a Restore of Independent
Configurable Data. If you do not want to start the Restore of Independent
Configurable Data, press the Cancel button and the dialog box is closed.

4.

The restore is ready when a message is presented in the Station Backup On File
window.

4.1.2.8 Backup of History Data

Use Backup of History Data to create a backup of the complete History log data base.
A new backup will always remove the backup file with the same name and location.
If you want to backup the history log data base, follow the steps below:
1.

Select the History Backup... item in the File menu, and you get the following
dialog box presented:

Figure 4-17. Backup of History Data dialog box

2.

3BSE 045 187R0101

The field for Host is used to specify the host in which the backup will be executed.
If a remote host name is given, the backup executes in that host. This means, the
backup file will be taken and saved in the remote host. Default value is the name
of the local host.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/history.bck. The location
/disk2/BackupOnFile is not included in the backup.

4-13

Advant OCS AdvaCommand for UNIX, Extensions

NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13
Configuration file.
3.

Press the Start button in the dialog box to start a Backup of History Data. If you
do not want to start the Backup of History Data, press the Cancel button and the
dialog box is closed.

4.

The backup is ready when a message is presented in the Station Backup On File
window.

4.1.2.9 Restore of History Data

NOTE

Restore of History Data must be done when the Operator Station is in

Backup Restore mode, that can be selected at startup. A restore is always
performed on local host.
Restore of History Data is normally invoked after an upgrade of the Operator Station
software or when you want to restore the History log data base after a hard disk
exchange. The function restores the complete History log data base including logged
values. It should be invoked after Restore of Configurable Data has been performed.
If you want to restore the history backup file, follow the steps below:
1.

Select the History Restore... item in the File menu, and you get the following
dialog box presented:

Figure 4-18. Restore of History Data dialog box

4-14

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

2.

The field for Host is used to specify the host where the backup file resides. Default
value is the name of the local host. Restore with a backup file on remote host is a
very time consuming operation.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/history.bck
NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13
Configuration file.
If the backup file is stored on a remote host, the backup file will be
automatically copied to the local host and restored from this file. This
means necessary disk space must be available.
3.

Press the Start button in the dialog box to start a Restore of History Data. If you
do not want to start Restore of History Data, press the Cancel button and the
dialog box is closed.

4.

The restore is ready when a message is presented in the Station Backup On File
window.

4.1.2.10 File Information

File Information will give overall information about the backup file.
Following information is extracted from the backup file:

Host name of the Advant Station.

Date and time of the backup.

Network and node of the Advant Station.

Version of the AdvaCommand software.

Installed options in the Advant Station.

NOTE

File Information is not implemented for History backup files.

If you want to get information about the backup file, follow the steps below:
1.

3BSE 045 187R0101

Select the File Info... item in the File menu, and you get the following dialog box
presented:

4-15

Advant OCS AdvaCommand for UNIX, Extensions

Figure 4-19. File Information dialog box

2.

The field for Host is used to specify the host where the backup file resides. Default
value is the name of the local host. File Information with a backup file on remote
host is a very time consuming operation.
The field for File is used to specify a different location and name of the backup
file, default value is /disk2/BackupOnFile/station.bck
NOTE

Changed Host or/and File are only valid for current session of the Station
Backup On File. To make these settings permanent see Section 4.1.2.13
Configuration file.

4-16

3.

Press the Start button in the dialog box to start File Information. If you do not
want to start the File Information, press the Cancel button and the dialog box is
closed. The Previous button is active when a File Information has been executed
and stored information is available to present.

4.

After a new successful File Information or an invoked Previous, you get the
following dialog box presented:

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Figure 4-20. Example of a File Information dialog box

5.

Press OK to close the dialog box.

4.1.2.11 Set Target Directory

The Set Target Directory is used in conjunction with Interactive Restore. The Target
Directory path will be added before the restored files/directory path. This can be used
when restoring file/directory to another location than it was originally stored.

3BSE 045 187R0101

4-17

Advant OCS AdvaCommand for UNIX, Extensions

Figure 4-21. Interactive Restore Target Directory dialog box

Example: The file /disk2/data/customer/OS/display/BHP/ISOTHERMNEW.ds will be
restored to /tmp/disk2/data/customer/OS/display/BHP/ISOTHERMNEW.ds.

NOTE

Changed Target Directory is only valid for current session of the Station Backup On
File. To make these settings permanent see Section 4.1.2.13 Configuration file.

4.1.2.12 Exit
Used to exit the Station Backup On File window.

4.1.2.13 Configuration file

The program Station Backup On File has a configuration file, dcBackupOnFile.cfg. In
this file you can specify and permanently save arguments to the program. Changed
arguments are reflected in the corresponding dialog boxes for the different functions.
The changes take effect after a restart of the Station Backup On File program. The file
is located in the directory /products/data/customer/OS/config. Below are the default
values specified. The format is <keyword> = <value>, note the space characters around
the equal sign.
HOST = LOCAL_HOST

The LOCAL_HOST keyword or a host name found in the /etc/hosts file.

FILE = station.bck

The file used in backup and restore. The format of the file is max. eight characters for
the name and three characters for the extension (xxxxxxxx.yyy).
LOCATION = /disk2/BackupOnFile

The location of the file used in backup and restore.

4-18

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

CYCLIC = ON

Cyclic backup invoked without any interaction. Used together with the Station
Backup function Define Timer. Value can be ON or OFF.
HISTORY_HOST = LOCAL_HOST

The LOCAL_HOST keyword or a host name found in the /etc/hosts file.

HISTORY_FILE = history.bck

The file used in history backup and restore.The format of the file is max. eight
characters for the name and three characters for the extension (xxxxxxxx.yyy).
HISTORY_LOCATION = /disk2/BackupOnFile

The location of the file used in history backup and restore.

HISTORY_CYCLIC = OFF

Cyclic history backup invoked without any interaction. Used together with the Station
Backup function Define Timer. Value can be ON or OFF. If option AdvaInform
History is installed, the default value will be set to ON at installation of Extension 1.
TARGET = NONE

The path will be added before the restored files/directory path used in Interactive
Restore. Value can be NONE or a path.

NOTE

The location /disk2/BackupOnFile is not included in the backup.

Changing of LOCATION or HISTORY_LOCATION to another value
than default can affect the size of the backup and should not be changed to
a location which is included in the backup.

4.1.2.14 Possibilities for backup and restore

NOTE

All remote operations are very time consuming.

3BSE 045 187R0101

4-19

Advant OCS AdvaCommand for UNIX, Extensions

Operator Station

Operator Station
TCP/IP
communication

PC

CD/DVD

Figure 4-22. Backup/restore overview

Backup:

A backup file is always created in the host where the backup is executed. A backup can
be started manually or cyclically as:
1.

Backup of local host.

2.

Backup of remote host, initiated from local host.

Storage:

For further storage, a backup file can be treated as follows:

1.

Storage in local host.

2.

Storage in common host (transfer between Operator Stations).

3.

Storage in PC (transfer to PC, initiated from PC).

4.

Storage on CD/DVD in PC (transfer to PC, initiated from PC).

Restore:

Restore can only be done in the local host. The Operator Station must be started in
Configuration Mode to restore files except for Interactive Restore. The following
alternatives to access the backup file are possible:

4-20

1.

Restore own host from backup file located in own host.

2.

Restore own host from backup file located on a CD/DVD in own host.

3.

Restore own host from backup file located in the remote common host.

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

Chapter 5 Maintenance

5.1 Configuration of hard disk

NOTE

All actions to increase logical volumes should be done by an experienced

person.
To increase a logical volume you must close the AdvaCommand for UNIX application.
Do a Function Restart and stop the start-up procedure in Backup Restore mode.
Move the Workstation mode window to the right of the screen to avoid interference
in the presentation later on.
Open the appearing hpterm and login as root by typing the command
$ su - <CR>
Password: vm-guld <CR>
Go to the root directory
# cd / <CR>
Start the system in single user mode by typing the command:
# shutdown now <CR>
The prompt is now <hostname>:/home/root#.
Go to the root directory and unmount the logical volume by typing following
commands:
<hostname>:/home/root# exit <CR>
<hostname>:/home/root# cd / <CR>
Unmount the logical volume where logical volume name is the volume you want to
increase, e.g. /home or /disk2.
<hostname>:/home/root# umount <logical volume name> <CR>
Start the System Administration Manager, sam by typing the command:
<hostname>:/home/root# sam <CR>
Accept the default values for the following questions by pressing Enter:
- Do you want to proceed using the terminal version of sam? (yes or no) [yes]
- Do you want to proceed in setting your TERM value and running sam? (yes or no)
[yes]

3BSE 045 187R0101

5-1

Advant OCS AdvaCommand for UNIX, Extensions

- Input the correct value for your terminal or press return to set the default TERM
value=hp. TERM=(hp)
Press Return (Enter) to continue. Use following steps in sam to increase a logical
volume:
1.

Use Arrow keys to move cursor. Mark Disks and File Systems and press Enter.

2.

Move cursor to Logical Volumes and press Enter (Note, this action will take
some time).

3.

Move cursor to the logical volume (Mount Director) you want to increase (e.g.
/home or /disk2) and press Space to select it.

4.

Now press TAB, use arrow keys to move to Actions menu and press Enter.
Choose Increase Size... and press Enter.

5.

Enter the new value for the increased size, mark OK by moving the cursor (TAB
key) and press Enter.

6.

Exit Logical Volumes dialog by pressing TAB then Enter. In the File menu
choose Exit and press Enter.

7.

Exit sam by pressing TAB then Enter. In the File menu choose Exit SAM and
press Enter.

Restart your workstation by typing the command:

# init 3 <CR>

5.2 Reinstallation
In the case that a reinstallation of the Operator Station is required even Extensions must
be reinstalled.
A reinstallation of the Operator Station must be performed in following order:
1.

Installation of AdvaCommand 1.8.

2.

Installation of Extensions.

3.

Activation of Extensions, entering of License Number and Key Identity.

Note: Installation of Extensions overwrites the current configuration file.

4.

Restore of Configurable Data.

5.

Restore of History Data (if applicable)

5.3 Uninstallation of Extensions

Extensions are uninstalled in the same way. Uninstallation of Extension 1 below is used
as an example on how to uninstall Extensions:
1.

5-2

Open a Terminal window (System Config - Station - Terminal Window)

3BSE 045 187R0101

Advant OCS AdvaCommand for UNIX, Extensions

2.

Login as root user by typing command:

$ su - <CR>
Password: vm-guld <CR>

3.

Uninstall the software by typing the command:

# swremove -v -x enforce_dependencies=false ABB-EXTENSION1 <CR>

4.

Complete the uninstallation with a Function Restart (System Config - Station Function Restart)
NOTE

Replace the name of the Extension ABB-EXTENSION1 with the

Extension you want to uninstall e.g. ABB-EXTENSION2

5.4 FAQ
Some frequently asked questions about the Extensions follows:
1.

Where is the configuration file of the Station Backup On File located?

The file dcBackupOnFile.cfg is located in the directory

/products/data/customer/OS/config.
2.

How can I see how much free disk space I have in the Operator Station?

To see how much free disk available, do as in follow example:

Open a Terminal window (System Config - Station - Terminal Window)
Enter following command in the Terminal window:
$ bdf <CR>
Filesystem

kbytes

used

/dev/vg00/lvol4 628643 466606

avail

%used Mounted on

99172 82%

/dev/vg00/lvol5 797845 387661 330399 54%

/usr

/dev/vg00/lvol7 1001729 346628 554928 38%

/home

/dev/vg00/lvol1

9726 33320 23%

/stand

/dev/vg00/lvol6 3005449 1809821 895083 67%

/disk2

47829

The reported numbers are in kilobytes.

Note: Default location of the backup files is /disk2/BackupOnFile, i.e. in this example
there are approx. 895 Mbyte available.
3.

How can I start a cyclic backup?

Define a Timer in the Station Backup window to configure execution time and set
Cyclic Execution Enabled.
Note: The Station Backup window must be closed to allow start of a cyclic backup on
file.

3BSE 045 187R0101

5-3

Advant OCS AdvaCommand for UNIX, Extensions

4.

How can I get a backup file to my PC?

To get the backup file from the Operator Station to a PC, do as follows in a PC
command window (replace advantOS_ip with the TCP/IP address of your Operator
Station. Default location and file name are used in this example):
C:\> ftp advantOS_ip <CR>
User <advantOS_ip:<none>>: root <CR>
Password: vm-guld <CR>
ftp> cd /disk2/BackupOnFile <CR>
ftp> bin <CR>
ftp> get station.bck <CR>
ftp> bye <CR>
5.

Why is the format of the backup file name just eight characters and three for the
extension as default?

The limits of the backup file name are adapted to the format used of HP UX 10.20
when reading a CD/DVD burned on a PC. Typical CD recording options for the file
system are ISO and Joliet.

5-4

3BSE 045 187R0101

3BSE 045 187R0101

May 2006