Administering System Platform
Administering System Platform
Platform
Release 6.0
June 2010
© 2010 Avaya Inc. accessed by multiple users. “Software” means the computer programs
in object code, originally licensed by Avaya and ultimately utilized by
All Rights Reserved. End User, whether as stand-alone products or pre-installed on
Hardware. “Hardware” means the standard hardware originally sold by
Notices Avaya and ultimately utilized by End User.
While reasonable efforts have been made to ensure that the License types
information in this document is complete and accurate at the time of
printing, Avaya assumes no liability for any errors. Avaya reserves the Designated System(s) License (DS). End User may install and use
right to make changes and corrections to the information in this each copy of the Software on only one Designated Processor, unless
document without the obligation to notify any person or organization of a different number of Designated Processors is indicated in the
such changes. Documentation or other materials available to End User. Avaya may
require the Designated Processor(s) to be identified by type, serial
Documentation disclaimer number, feature key, location or other specific designation, or to be
provided by End User to Avaya through electronic means established
Avaya shall not be responsible for any modifications, additions, or
by Avaya specifically for this purpose.
deletions to the original published version of this documentation unless
such modifications, additions, or deletions were performed by Avaya. Concurrent User License (CU). End User may install and use the
End User agree to indemnify and hold harmless Avaya, Avaya's agents, Software on multiple Designated Processors or one or more Servers,
servants and employees against all claims, lawsuits, demands and so long as only the licensed number of Units are accessing and using
judgments arising out of, or in connection with, subsequent the Software at any given time. A “Unit” means the unit on which Avaya,
modifications, additions or deletions to this documentation, to the at its sole discretion, bases the pricing of its licenses and can be,
extent made by End User. without limitation, an agent, port or user, an e-mail or voice mail account
in the name of a person or corporate function (e.g., webmaster or
Link disclaimer
helpdesk), or a directory entry in the administrative database utilized
Avaya is not responsible for the contents or reliability of any linked Web by the Software that permits one user to interface with the Software.
sites referenced within this site or documentation(s) provided by Avaya. Units may be linked to a specific, identified Server.
Avaya is not responsible for the accuracy of any information, statement
or content provided on these sites and does not necessarily endorse Database License (DL). End User may install and use each copy of the
the products, services, or information described or offered within them. Software on one Server or on multiple Servers provided that each of
Avaya does not guarantee that these links will work all the time and has the Servers on which the Software is installed communicate with no
no control over the availability of the linked pages. more than a single instance of the same database.
Warranty CPU License (CP). End User may install and use each copy of the
Software on a number of Servers up to the number indicated by Avaya
Avaya provides a limited warranty on this product. Refer to your sales provided that the performance capacity of the Server(s) does not
agreement to establish the terms of the limited warranty. In addition, exceed the performance capacity specified for the Software. End User
Avaya’s standard warranty language, as well as information regarding may not re-install or operate the Software on Server(s) with a larger
support for this product, while under warranty, is available to Avaya performance capacity without Avaya's prior consent and payment of an
customers and other parties through the Avaya Support Web site: upgrade fee
http://www.avaya.com/support. Please note that if you acquired the
product from an authorized Avaya reseller outside of the United States Named User License (NU). End User may: (i) install and use the
and Canada, the warranty is provided to you by said Avaya reseller and Software on a single Designated Processor or Server per authorized
not by Avaya. Named User (defined below); or (ii) install and use the Software on a
Server so long as only authorized Named Users access and use the
Licenses Software. “Named User,” means a user or device that has been
expressly authorized by Avaya to access and use the Software. At
THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA Avaya's sole discretion, a “Named User” may be, without limitation,
WEBSITE, HTTP://SUPPORT.AVAYA.COM/LICENSEINFO/ ARE designated by name, corporate function (e.g., webmaster or helpdesk),
APPLICABLE TO ANYONE WHO DOWNLOADS, USES AND/OR an e-mail or voice mail account in the name of a person or corporate
INSTALLS AVAYA SOFTWARE, PURCHASED FROM AVAYA INC., function, or a directory entry in the administrative database utilized by
ANY AVAYA AFFILIATE, OR AN AUTHORIZED AVAYA RESELLER the Software that permits one user to interface with the Software.
(AS APPLICABLE) UNDER A COMMERCIAL AGREEMENT WITH
AVAYA OR AN AUTHORIZED AVAYA RESELLER. UNLESS Shrinkwrap License (SR). With respect to Software that contains
OTHERWISE AGREED TO BY AVAYA IN WRITING, AVAYA DOES elements provided by third party suppliers, End User may install and
NOT EXTEND THIS LICENSE IF THE SOFTWARE WAS OBTAINED use the Software in accordance with the terms and conditions of the
FROM ANYONE OTHER THAN AVAYA, AN AVAYA AFFILIATE OR AN applicable license agreements, such as “shrinkwrap” or “clickwrap”
AVAYA AUTHORIZED RESELLER, AND AVAYA RESERVES THE license accompanying or applicable to the Software (“Shrinkwrap
RIGHT TO TAKE LEGAL ACTION AGAINST YOU AND ANYONE License”). The text of the Shrinkwrap License will be available from
ELSE USING OR SELLING THE SOFTWARE WITHOUT A LICENSE. Avaya upon End User’s request (see “Third-party Components” for
BY INSTALLING, DOWNLOADING OR USING THE SOFTWARE, OR more information).
AUTHORIZING OTHERS TO DO SO, YOU, ON BEHALF OF
YOURSELF AND THE ENTITY FOR WHOM YOU ARE INSTALLING, Copyright
DOWNLOADING OR USING THE SOFTWARE (HEREINAFTER
REFERRED TO INTERCHANGEABLY AS “YOU” AND “END USER”), Except where expressly stated otherwise, no use should be made of
AGREE TO THESE TERMS AND CONDITIONS AND CREATE A materials on this site, the Documentation(s) and Product(s) provided
BINDING CONTRACT BETWEEN YOU AND AVAYA INC. OR THE by Avaya. All content on this site, the documentation(s) and the
APPLICABLE AVAYA AFFILIATE (“AVAYA”). product(s) provided by Avaya including the selection, arrangement and
design of the content is owned either by Avaya or its licensors and is
Avaya grants End User a license within the scope of the license types protected by copyright and other intellectual property laws including the
described below. The applicable number of licenses and units of sui generis rights relating to the protection of databases. You may not
capacity for which the license is granted will be one (1), unless a modify, copy, reproduce, republish, upload, post, transmit or distribute
different number of licenses or units of capacity is specified in the in any way any content, in whole or in part, including any code and
Documentation or other materials available to End User. “Designated software. Unauthorized reproduction, transmission, dissemination,
Processor” means a single stand-alone computing device. “Server” storage, and or use without the express written consent of Avaya can
means a Designated Processor that hosts a software application to be be a criminal, as well as a civil, offense under the applicable law.
Trademarks
Avaya Aura is a registered trademark of Avaya.
Downloading documents
For the most current versions of documentation, see the Avaya Support
Web site: http://www.avaya.com/support
Chapter 8: Troubleshooting..................................................................................................115
Template DVD does not mount......................................................................................................................115
Troubleshooting steps...........................................................................................................................115
Checking RAID status...................................................................................................................................115
raid_status command...........................................................................................................................115
Virtual machine has no connectivity outside after assigning dedicated NIC support....................................116
Troubleshooting steps through System Domain (Dom-0).....................................................................116
Troubleshooting steps through System Platform Web Console...........................................................117
General issues with the system and contacting support...............................................................................117
Troubleshooting steps...........................................................................................................................117
Issues when configuring High Availability Failover........................................................................................118
Cannot establish communication through crossover network interface................................................118
Local IP address provided....................................................................................................................118
Standby first-boot sequence is not yet finished....................................................................................118
Cluster nodes are not equal..................................................................................................................119
A template is installed on remote node.................................................................................................119
NICs are not active on both sides.........................................................................................................120
Cannot establish High Availability network interface............................................................................120
Issues when starting High Availability Failover.............................................................................................120
Different platform versions on cluster nodes........................................................................................120
A template is installed on remote node................................................................................................121
Resources are not started on any node and cannot access the Web Console....................................121
Cannot access the Web Console after starting High Availability Failover............................................122
Active server fails.................................................................................................................................122
Data switch fails....................................................................................................................................122
Heartbeat link fails................................................................................................................................123
Index.......................................................................................................................................147
Administration overview
After installing Avaya Aura™ System Platform and solution templates, you can perform
administrative activities for System Platform and solution templates by accessing the System
Platform Web Console. Some of the activities that you can perform include:
• Viewing the log information
• Monitoring the health of the system
• Updating and managing patches
• Managing users and passwords
• Rebooting or shutting down the server
Your administrative operations for System Platform can affect the performance of the solution
templates running on System Platform. For example, if you reboot or shut down the System
Platform server, the system also reboots or shuts down the solution templates running on
System Platform. However, some solution templates have their independent administrative
procedures that you can perform by accessing the respective solution template.
Important:
System Platform does not tag Quality of Service (QOS) bits for any packets (known as Layer
2 802.1p tagging). However, System Platform supports tagging of packets for QOS at the
Layer 2 switch.
System Platform allows configuring VLAN (from 1 to 4092) only on the S8300D server, which
is housed in a routing media gateway. To fulfill the VLAN requirements, the S8300D will pass
traffic to the media gateway based on the configured VLAN. Other server such as S8510 or
S8800 will exist as a host on the enterprise network and the VLAN configuration will not
have an impact.
Platform virtual machines (namely, System Domain (Dom-0) and Console Domain), install the
required solution template, and perform various administrative activities by accessing options
from the navigation pane.
In the navigation pane, the system lists the administrative options under three categories:
Virtual Machine Management, Server Management, and User Administration.
Virtual Machine Management
Use the options under Virtual Machine Management to view details and manage the virtual
machines on System Platform. Some of the management activities that you can perform
include rebooting or shutting down a virtual machine.
The System Domain (Dom-0), Console Domain, and components of the solution templates
running on the System Platform are known as virtual machines. The System Domain (Dom-0 )
runs the virtualization engine and has no direct management access. Console Domain (cdom
or udom) provides management access to the system through the System Platform Web
Console.
Server Management
Use the options under Server Management to perform various administrative activities for the
System Platform server. Some of the administrative activities that you can perform include:
• Configuring various settings for the server
• Viewing log files
• Upgrading to a latest release of the software
• Backing up and restoring current version of the software
User Administration
Use the options under User Administration to manage user accounts for System Platform.
Some of the management activities that you can perform include:
• Viewing existing user accounts for System Platform
• Creating new user accounts
• Modifying existing user accounts
• Changing passwords for existing user accounts
1. To enable IP forwarding:
a. Start an SSH session.
b. Log in to System Domain (Domain-0) as admin.
c. In the command line, type service_port_access enable and press Enter.
2. For security reasons, always disable IP forwarding after finishing your task. Perform
the following tasks to disable IP forwarding:
a. Start an SSH session.
b. Log in to System Domain (Domain-0) as admin.
c. In the command line, type ip_forwarding disable and press Enter.
You can access the System Platform Web Console from a Web browser on your laptop or
another computer connected to the same network as the System Platform server.
Note:
This is a secure site. If you get a certificate error, then follow the instructions in
your browser to install a valid certificate on your computer.
3. Enter a valid User ID.
Note:
If you use an Avaya services login that is Access Security Gateway (ASG)-
protected, you must have an ASG tool to generate a response for the challenge
that is generated by the login page. Many ASG tools are available such as Avaya
Token Mobile, Avaya Web Mobile, and Site Manager. The first two ASG tools
must be able to reach the ASG manager servers behind the Avaya firewall. An
Avaya Services representative will use Site Manager to pull the keys specific to
a site before visiting that site. At the site, the Avaya Services representative will
use those keys to generate the response for the challenge generated by the login
page.
4. Click Continue.
5. Enter a valid Password.
6. Click Log On.
The system displays the License Terms page when you log in for the first time.
7. Click I Accept to accept the end user license agreement.
The system displays the Virtual Machine List page in the System Platform Web
Console.
Solution template
After installing System Platform, you can install various solutions templates to run on System
Platform. After installing the templates, you can manage the templates from the System
Platform Web Console.
Related topics:
Virtual Machine List field descriptions on page 17
Virtual Machine Configuration Parameters field descriptions on page 18
Related topics:
Virtual Machine List field descriptions on page 17
Virtual Machine Configuration Parameters field descriptions on page 18
Note:
The Console Domain can only be restarted and not stopped. If the Console
Domain is stopped, administration of the system will no longer be possible.
3. If you want to shutdown the entire server including all of the virtual machines,
perform one of the following steps:
• On the Virtual Machine List page, click Domain-0 in the Name column.
On the Virtual Machine Configuration Parameters page, click Shutdown
Server.
• Click Server Management > Server Reboot / Shutdown.
On the Server Reboot/Shutdown page, click Shutdown Server.
Related topics:
Virtual Machine List field descriptions on page 17
Virtual Machine Configuration Parameters field descriptions on page 18
Name Description
Name Name of the virtual machines running on System Platform.
Version Version number of the respective virtual machine.
IP Address IP address of the virtual machine.
Maximum This is a display only field. The value is set by Avaya, and cannot be
Memory configured by the users.
The amount of physical memory from the total server memory the virtual
machine has allocated in the template file.
Maximum This is a display only field.
Virtual CPUs CPU allocation for the virtual machine from the template file.
CPU Time The amount of CPU time the virtual machine has had since boot. This is
not the same as uptime.
State Current status of the virtual machine.
Possible values are as follows:
• Running: Virtual machine is running normally.
• Starting: Virtual machine is currently booting and should enter a
running state when complete.
• Stopping: Virtual machine is in the process of being shutdown and
should enter stopped state when complete.
• Stopped: Virtual machine has been shutdown.
• Rebooting: Virtual machine is in the process of a reboot and should
return to running when complete.
Name Description
Button descriptions
Name Description
Refresh Refreshes the list of virtual machines.
Related topics:
Viewing virtual machines on page 15
Rebooting a virtual machine on page 16
Shutting down a virtual machine on page 16
Name Description
Name Name of the virtual machines running on System Platform.
MAC Address Machine address of the virtual machine.
IP Address IP address of the virtual machine.
OS Type Operating system of the virtual machine, for example, Linux or Windows.
State Current status of the virtual machine.
Possible values are as follows:
• Running: Virtual machine is running normally.
• Starting: Virtual machine is currently booting and should enter a
running state when complete.
• Stopping: Virtual machine is in the process of being shutdown and
should enter stopped state when complete.
• Stopped: Virtual machine has been shutdown.
• Rebooting: Virtual machine is in the process of a reboot and should
return to running when complete.
• No State: The virtual machine is not running or the application
watchdog is not being used.
Used Memory The amount of memory currently used by the virtual machine.
Maximum The amount of physical memory from the total server memory the virtual
Memory machine has allocated in the template file.
Name Description
This is a display only field.
CPU Time The amount of CPU time the virtual machine has had since boot. This is
not the same as uptime.
Virtual CPUs The maximum number of virtual CPUs used by the respective virtual
machine.
Domain UUID Unique ID of the virtual machine.
Auto Start Status of auto start of a virtual machine: if the virtual machine starts
automatically after a shut down operation.
Available status are True (if auto start is set), and False (if auto start is
not set).
Note:
This value should be changed only for troubleshooting purposes.
Button descriptions
Button Description
Reboot Reboots the respective virtual machine.
In the case of System Domain (Domain-0), this reboot operation is the same
as the reboot operation available in the left navigation pane. When you
reboot the System Platform server using the reboot option in the left
navigation pane, the system shuts down the System Platform server and
all the virtual machines running on it.
Important:
When you reboot System Domain (Domain-0), the system reboots the
System Platform server and all the virtual machines running on it, causing
potential service disruption. When you reboot Console Domain, the
system loses connection with the System Platform Web Console. You
can log in again after Console Domain finishes the reboot operation.
Shutdown Appears only if Domain-0 is selected and shuts down the server and all
Server virtual machines running on it.
Stop Appears if a virtual machine other than System Domain (Domain-0) or
Console Domain is selected and stops the selected virtual machine.
Start Appears if a virtual machine other than System Domain (Domain-0) or
Console Domain is selected and starts the selected virtual machine.
Related topics:
Viewing virtual machines on page 15
Rebooting a virtual machine on page 16
Shutting down a virtual machine on page 16
Managing patches
Patch management
You can install, download, and manage the regular updates and patches for System Platform
and the various templates provided by Avaya. Go to http://support.avaya.com and see the
latest Release Notes for information about the latest patches.
You can install or download the patches from the Avaya Product Licensing and Delivery System
(PLDS) Web site at http://plds.avaya.com.
Downloading patches
3. On the Search Local and Remote Patch page, choose a location to search for a
patch. Options are:
• Avaya Downloads (PLDS)
• HTTP
• SP Server
• SP CD/DVD
• SP USB Disk
• Local File System
4. If you selected HTTP or SP Server, specify the Patch URL.
5. If you selected HTTP, click Configure Proxy to specify a proxy server if required.
6. If you selected Local File System, click Add to locate the service pack file on your
computer and then upload.
7. Click Search to search for the required patch.
8. Choose the patch and click Select.
Related topics:
Configuring a proxy on page 24
Search Local and Remote Patch field descriptions on page 26
Errors encountered while downloading files from PLDS on page 145
Configuring a proxy
If the patches are located in a different server (for example, Avaya PLDS or HTTP), you may
be required to configure a proxy depending on your network.
Related topics:
Search Local and Remote Patch field descriptions on page 26
System configuration field descriptions on page 38
Installing patches
Use this task to install all patches (that is, System Platform and solution template patches)
through System Platform Web Console. Make sure that you do not use the patch installers
provided by your solution templates.
Related topics:
Patch List field descriptions on page 27
Patch Detail field descriptions on page 28
Removing patches
Tip:
You can clean up the hard disk of your system by removing a patch installation
file that is not installed. To do so, in the last step, click Remove Patch File.
Related topics:
Patch List field descriptions on page 27
Patch Detail field descriptions on page 28
Name Description
Supported The patch that you are installing should match the extensions in this list. For
Patch File example, *.tar.gz,*.tar.bz,*.gz,*.bz,*.zip,*.tar,*.jar,*.rpm,*.patch.
Extensions
Choose Displays the available location options for searching a patch. Options are:
Media
• Avaya Downloads (PLDS): The template files are located in the Avaya
Product Licensing and Delivery System (PLDS) Web site. You must enter
an Avaya SSO login and password. The list will contain all the templates
to which your company is entitled. Each line in the list begins with the
“sold-to” number to allow you to select the appropriate template for the
site where you are installing. You may hold the mouse pointer over the
selection to view more information about the “sold-to” number.
• HTTP: Files are located in a different server. You must specify the Patch
URL for the server.
• SP Server: Files are located in the vsp-template file system in the System
Platform server. You must specify the Patch URL for the server.
Tip:
When you want to move files from your laptop to the System Platform
Server, you may encounter some errors, as System Domain (Dom–0)
and Console Domain support only SCP, but most laptops do not come
with SCP support. You can download the following two programs to
enable SCP (Search on the Internet for detailed procedures to
download them):
- Pscp.exe
- WinSCP
• SP CD/DVD: Files are located in a System Platform CD or DVD.
Name Description
Patch URL Active only when you select HTTP or SP Server as the media location.
URL of the server where the patch files are located.
Button descriptions
Button Description
Search Searches for the available patches in the media location you specify.
Configure Active only when you select HTTP as the media location option.
Proxy Opens the System Configuration page and lets you configure a proxy
based on your specifications.
If the patches are located in a different server, you may be required to
configure a proxy depending on your network.
Add Appears when Local File System is selected and adds a patch file to
the local file system.
Upload Appears when Local File System is selected and uploads a patch file
from the local file system.
Download Downloads a patch file.
Related topics:
Downloading patches on page 23
Configuring a proxy on page 24
Errors encountered while downloading files from PLDS on page 145
Name Description
System Platform Lists the patches available for System Platform under this heading.
Solution Template Lists the patches available for the respective solution templates under
respective solution template headings.
Patch ID File name of a patch.
Description Information of a patch, for example, if the patch is available for System
Platform the description is shown as SP patch.
Status Shows the status of a patch.
Name Description
Possible values of Status are Installed, Not Installed, Active, and
Not Activated.
Service Effecting Shows if installing the patch causes the respective virtual machine to
reboot.
Button descriptions
Button Description
Refresh Refreshes the patch list.
Related topics:
Installing patches on page 25
Removing patches on page 25
Name Description
ID File name of the patch file.
Version Version of the patch file.
Product ID Name of the virtual machine.
Description Virtual machine name for which the patch is applicable.
Detail Virtual machine name for which the patch is applicable. For
example, Console Domain (cdom patch).
Dependency Shows if the patch file has any dependency on any other file.
Applicable for Shows the software load for which the patch is applicable.
Service effecting when Shows the action (if any) that causes the selected patch to restart
the System Platform Web Console.
Disable sanity when Shows at what stage the sanity is set to disable.
Status Shows if the patch is available for installing or already installed.
Patch File Shows the URL for the patch file.
Button descriptions
Button Description
Refresh Refreshes the Patch Details page.
Patch List Opens the Patch List page, that displays the list of patches.
Install Installs the respective patch.
Activate Activates the installed patch of a solution template.
Deactivate Deactivates the installed patch of a solution template.
Remove Removes the respective patch.
Remove Patch File Removes the respective patch file.
The button appears only if the patch file is still present in the system.
On removing the patch file, the button does not appear.
Related topics:
Installing patches on page 25
Removing patches on page 25
Log viewer
You can use the Log Viewer page to view the following log files that System Platform generates:
• System logs: These logs contain the messages that the System Platform operating
system generates.
• Event logs: These logs contain the messages that the System Platform generates.
• Audit logs: These logs contain the messages that the System Platform generates as a
record of user interaction such as the action performed, the time when the action was
performed, the user who performed the action, and so on.
To view a log, you should provide the following specifications:
• Select one of the following logs to view:
- System logs
- Event logs
- Audit logs
• Select one of the log levels relevant to the selected logs. The log level denotes the type
of incident that might have occurred such as an alert, an error condition, a warning, or a
notice.
• Specify a time duration within which an incident of the selected log level might have
occurred.
• Enter some text that you want to search in the selected logs. This is optional.
3. Click Search.
Related topics:
Log Viewer field descriptions on page 30
Name Description
Messages Select the type of log messages that you want to view. Options are:
• System Logs are log messages generated by the System Platform
operating system (syslog).
• Event Logs are log messages generated by the System Platform
software. These logs are related to processes and commands that have
run on System Platform.
• Audit Logs are a history of commands that users have run on the
platform.
Name Description
Log Levels Select the severity of log messages that you want to view: Options are:
• Alert
• Critical/Fatal
• Error
• Warning
• Notice
• Informational
• Debug/Fine
If you select Audit Logs for Messages, you have only Informational as
an option.
Timestamp The timestamp of the last message in the type of log messages selected.
From This timestamp is greater than or equal to the value entered for
Timestamp From.
To The timestamp of the first message in the type of log messages selected.
This timestamp is less than or equal to the value entered for To.
Find Lets you search for particular log messages or log levels.
Button descriptions
Button Description
Search Searches for the log messages based on your selection of message category and
log levels.
Related topics:
Viewing log files on page 30
Log severity levels on page 35
2. Specify a time server and click Add to add the time server to the configuration file.
3. Click Ping to check whether the specified time server, that is, the specified host, is
reachable across the network.
4. Click Start ntpd to synchronize the System Platform time with the Network Time
Protocol (NTP) server.
If you want to stop the synchronization, click the same button, which the system
now displays as Stop ntpd.
5. Select a time zone and click Set Time Zone to set the time zone in System Platform.
The system sets the selected time zone on the System Platform virtual machines
(System Domain (Dom-0) and Console Domain). The system also updates the time
zone on the other virtual machines.
6. Click Query State to check the NTP (Network Time Protocol) status.
The system displays the status of the NTP daemon on the System Platform.
Related topics:
NTP daemon on page 33
Date Time Configuration field descriptions on page 34
2. Click the calendar icon located next to the Save Date and Time button.
The system displays the Set Date and Time page.
Note:
If the Save Date and Time button is not enabled, you must stop the NTP server
that is currently being used.
3. Select a date in the calendar to change the default date and set the required date.
4. Do the following to set the time:
a. Click the time field at the bottom of the calendar.
The system displays a box showing time information.
b. Use the up and down arrow keys beside the hour to change the hour, and up
and down arrows beside the minutes field to set the minutes.
c. Click OK to accept your time changes.
5. Click Apply to save your changes.
6. Click Save Date and Time.
The system displays a warning message stating that this action will cause a full
system reboot.
7. Click OK to accept the message and set the updated date and time in the system.
Related topics:
Date Time Configuration field descriptions on page 34
NTP daemon
The NTP daemon reads its configuration from a file named ntp.conf. The ntp.conf file contains
at least one or more lines starting with the keyword server. Each of those lines specify one
reference time source, that is, time server, which can be either another computer on the
network, or a clock connected to the local computer.
Reference time sources are specified using IP addresses, or host names which can be
resolved by a name server. NTP uses the pseudo IP address 127.127.1.0 to access its own
system clock, also known as the local clock. You must not mix this IP address with 127.0.0.1,
which is the IP address of the local host, that is the computer's loopback interface. The local
clock will be used as a fallback resource if no other time source is available. That is why the
system does not allow you to remove the local clock.
Related topics:
Configuring System Platform to synchronize with an NTP server on page 31
Date Time Configuration field descriptions on page 34
2. Select a time server from the list of added servers and click Remove Time Server to
remove the selected time server.
Note:
The changes will be effective after you restart NTP.
Related topics:
Date Time Configuration field descriptions on page 34
Name Description
Date/Time Configuration Shows the local time and the UTC time.
Also shows the status of the NTP daemon, if it is started or
stopped.
Save Date and Time Lets you edit the date and time set during System Platform
installation.
Manage Time Servers Lets you ping a time server and see its status and manage the
existing time servers.
Button descriptions
Button Description
Start ntpd Starts the Network Time Protocol (NTP) daemon on System Platform to
synchronize the server time with an NTP server.
If the NTP daemon (ntpd) is started, this button changes to Stop ntpd.
Click this button to stop the NTP daemon.
Set Date and Edits the date and time that are configured for System Platform.
Time The button is disabled if ntpd is running.
Button Description
Set Time Zone Edits the time zone that is configured for System Platform . System
Platform updates the time zone on System Domain (Domain-0), Console
Domain, and the virtual machines running on System Platform.
Ping Checks whether the specified time server, that is, the specified host, is
reachable across the network.
Add Adds the time server that you specify to the list of time servers with which
System Platform can synchronize.
Remove Time Removes the selected time server.
Server
Query State Checks the status of the NTP daemon on System Platform.
Related topics:
Configuring System Platform to synchronize with an NTP server on page 31
Configuring date and time on page 32
NTP daemon on page 33
Removing a time server on page 34
Configuring Logging
Log retention
To control the size and number of historical log files that System Platform retains, you configure
a maximum size for log files and a maximum number of log files.
When a log file reaches the maximum size, it rolls over. When rollover occurs, .1 is appended to
the file name of the current log file and a new, empty log file is created with the original name.
For example, vsp-all.log is renamed vsp-all.log.1, and a new, empty vsp-
all.log file is created. The number that is appended to older log files is increased by one.
For example, the previous vsp-all.log.1 is renamed vsp-all.log.2, vsp-all.log.
2 is renamed vsp-all.log.3, and so on. When the maximum number of backup (old) log
files is reached, the oldest log file is deleted.
Related topics:
Log severity levels on page 35
Log retention on page 36
Logging Configuration field descriptions on page 36
Caution:
Change the default values only for troubleshooting purposes. If you change the logger level
to FINE, the system writes many log files. There are chances of potential performance issues
when using this logging level. So, Avaya recommends you to switch to FINE only to debug a
serious issue.
Name Description
SP Logger SP Logger is used for the System Platform Web Console logs, which
are generated by the System Platform code base (for example,
com.avaya.vsp).
3rd Party Logger Third Party Logger is the root logger, which can include logs from other
third party components included in the System Platform Web Console
(for example, com.* or com.apache.*).
vsp-all.log Contains all logs generated bySystem Platform Web Console,
regardless of whether they include event codes.
vsp-event.log Contains all event logs generated by System Platform Web Console.
The logs in vsp-event are available in Avaya common logging format.
vsp-rsyslog.log Contains syslog messages.
Max Backups Maximum number of historical files to keep for the specified log file.
Max FileSize Maximum file size (for example, for a file vsp-all.log. Once the maximum
file size is reached it, the log file will roll over (be renamed) to vsp-all.log.
1.
Related topics:
Log severity levels on page 35
Log retention on page 36
Configuring log levels and retention parameters on page 36
Related topics:
System configuration field descriptions on page 38
Name Description
Proxy Status Specifies whether an http proxy should be used to access the
Internet, for example, when installing templates, upgrading patches,
or upgrading platform.
Proxy Address The address for the proxy server.
Proxy Port The port address for the proxy server.
Keyboard Layout Determines the specified keyboard layout for the keyboard attached
to the System Platform server.
Statistics If you disable this option, the system stops collecting the statistics
Collection data.
Note:
If you stop collecting statistics, the system-generated alarms will
be disabled automatically.
Related topics:
Configuring system settings for System Platform on page 37
Important:
The System Platform network settings are independent of the network settings of the virtual
machines running on it. This means that the System Platform network settings will not affect
the network settings of the virtual machines.
Make sure that the IP address for the avprivate bridge do not conflict with any other IP
addresses in your network.
The Network Configuration page displays the addresses that are allocated to avprivate. The
range of IP addresses starts with System Domain's (Dom-0) interface on avprivate. If any
conflicts exist, resolve them. Keep in mind that the template you install may take additional
addresses on the private bridge.
The avprivate bridge is an internal, private bridge that allows virtual machines to
communicate with each other. This private bridge does not have any connection to your
LAN. During installation, System Platform runs an algorithm to find a set of IP addresses
that do not conflict with the addresses configured on the System Domain Network
Configuration page. However, it is still possible that the addresses selected conflict with
other addresses in your network. Since this private bridge is not connected to your LAN, this
address conflict could result in the failure of System Platform or an installed template to route
packets correctly.
Important:
Avaya recommends that you change all the IP addresses (wherever required) in a single
instance to minimize the service disruption.
3. Click Save.
Related topics:
Network Configuration field descriptions on page 39
Name Description
Turn On IPv6 Enables IPv6.
Name Description
Default Gateway The default gateway.
Name Description
Primary DNS The primary DNS server address.
Secondary DNS (Optional) The secondary DNS server address.
Domain Search The search list, which is normally determined from the local domain
List name. By default, it contains only the local domain name. This may be
changed by listing the desired domain search path following the search
keyword with spaces or tabs separating the names.
Udom hostname The host name for the Console Domain. This must be a fully qualified
domain name (FQDN), for example, SPCdom.mydomainname.com.
Dom0 hostname The host name for System Domain (Dom-0). This must be a fully
qualified domain name (FQDN), for example,
SPDom0.mydomainname.com.
Physical Network The physical network interface details for eth0 and eth1 (and eth2 in
Interface case of High Availability Failover is enabled).
Domain Applications with high network traffic or time-sensitive traffic may be
Dedicated NIC allocated a dedicated NIC. This means the virtual machine connects
directly to a physical Ethernet port and may require a separate cable
connection to the customer network.
See respective template installation topics for more information.
Bridge The bridge details for the following:
• avprivate: This is called a private bridge because it does not use any
Ethernet interface, so it is strictly internal to the server. The System
Platform installer attempts to assign IP addresses that are not in use.
• avpublic: This bridge uses the Ethernet interface associated with
the default route, which is usually eth0, but can vary based on the
type of the server. This bridge generally provides access to the LAN
for System Platform elements (System Domain (Dom-0) and
Console Domain) and for any guest domains that are created when
installing a template. The IP addresses specified during System
Platform installation are assigned to the interfaces that System
Domain (Dom-0) and Console Domain have on this bridge.
• template bridge: These bridges are created during the template
installation and are specific to the virtual machines installed.
Domain Network The domain network interface details for System Domain (Dom-0) or
Interface Console Domain that are grouped by domain based on your selection.
Global Template The set of IP addresses and host names of the applications hosted on
Network System Platform. Also includes the gateway address and network
Configuration mask.
Name Description
Name Is a valid bond name.
It should match regular expression in the form of “bond[0-9]+”.
Mode Is a list of available bonding modes that are supported by Linux.
The available modes are:
• Round Robin
• Active/Backup
• XOR Policy
• Broadcast
• IEEE 802.3ad
• Adaptive Transmit Load Balancing
• Adaptive Load Balance
For more information about bonding modes, refer to http://
www.linuxhorizon.ro/bonding.html.
Note:
The default mode of new bonding interface is Active/Backup.
Important:
System Platform doesn't allow to configure any advance parameters
not listed in this page. If you want to configure an advanced feature, log
in to System Platform Web Console and make the required changes.
Slave 1/ Is the first NIC to be enslaved by the bonding interface.
Primary If the mode is Active/Backup, this will be the primary NIC.
Slave 2/ Is the second NIC to be enslaved by the bonding interface.
Secondary If the mode is Active/Backup, this will be the secondary NIC.
Name Description
Add Bond Adds new bonding interface.
Delete Deletes a bonding interface.
Related topics:
Configuring System Platform network settings on page 38
Related topics:
Static route configuration field descriptions on page 44
Related topics:
Static route configuration field descriptions on page 44
Related topics:
Static route configuration field descriptions on page 44
Related topics:
Adding a static route on page 42
Deleting a static route on page 43
Modifying a static route on page 43
Related topics:
Ethernet configuration field descriptions on page 45
Name Description
Speed Sets the speed in MB per second for the interface. Options are:
• 10 Mb/s half duplex
• 10 Mb/s full duplex
• 100 Mb/s half duplex
• 100 Mb/s full duplex
• 1000 Mb/s full duplex
Auto-Negotiation must be disabled to configure this field.
Port Lists the available Ethernet ports.
Auto-Negotiation must be disabled to configure this field.
Auto- Enables or disables auto-negotiation. By default it is enabled, but might
Negotiation cause some problems with some network devices. In such cases you
can disable this option.
Button descriptions
Button Description
Apply Saves and applies the settings for the Ethernet device.
Refresh Refreshes the Ethernet Configuration page.
Related topics:
Configuring Ethernet interface settings on page 44
Configuring alarms
Alarm descriptions
System Platform generates the following alarms:
Alarm Description
High CPU Average CPU Usage of VM
Disk Usage (Logical Volume) Percentage of logical volume used (/, /
template-env, /dev/shm, /vspdata, vsp-
template)
Disk (Volume Group) Percentage of volume group used
(VolGroup00)
Disk reads Disk read rate (sda)
Disk Writes Disk write rate (sda)
Load Average Load average on each virtual machine
Network I/O received Network receive rate for all guests (excluding
dedicated NICs)
Network I/O Transmit Network transmit rate for all guests
(excluding dedicated NICs)
Webconsole heap Percentage of webconsole (tomcat) heap
memory in use
Webconsole open files Number of file descriptors that webconsole
has open
Webconsole permgen Percentage of webconsole (tomcat)
permgen heap used
SAL Agent heap SAL Agent permgen Percentage of SAL heap memory in use
SAL Agent permgen Percentage of SAL permgen heap used
Domain-0 Memory (Committed_AS) Memory for System Domain (Dom-0)
udom Memory (Committed_AS) Memory for Console Domain
Note:
A virtual machine other than System Domain and Console Domain may support configuring
alarms relevant to its operations. Please check the administration document of the virtual
machine to know whether any alarms are present for the virtual machine and how to
configure them.
Related topics:
Alarm descriptions on page 45
Alarm configuration field descriptions on page 47
Related topics:
Alarm descriptions on page 45
Configuring alarm settings on page 46
Managing Certificates
Certificate management
The certificate management feature allows a user with the right administrative privileges to
replace the default System Platform Web Console certificate and private key. It also allows the
user to upload and replace the enterprise LDAP certificate, if the option of transport layer
security (TLS) was enabled in the Enterprise LDAP page.
The user can replace the default System Platform Web Console certificate and private key by
selecting a new certificate file and a new private key on the local machine and uploading them.
The default System Platform Web Console certificate is generated during System Platform
installation with the CN value same as the Console Domain hostname. During platform
upgrade, the certificate is first backed up and then restored after the upgrade completes.
Similarly, the user can upload and replace the enterprise LDAP certificate by selecting new
certificate file on the local machine, and uploading it. The Certificate Management page shows
the following data for the current System Platform Web Console and Enterprise LDAP
certificate:
• Type
• Version
• Expiry date
• Issuer
Here are the things to note relating to a certificate:
• The only acceptable extension of a new certificate file is .crt.
• The only acceptable extension of a new private key file is .key.
• The option to upload the key is only for the System Platform Web Console certificate.
• An uploaded certificate is valid if its start date is not after the current date and its end date
is not before the current date. An uploaded private key is valid if it matches the uploaded
certificate.
Related topics:
Enterprise LDAP field descriptions on page 78
Related topics:
Configuring authentication against an enterprise LDAP on page 78
Name Description
Type Is the type of the certificate issued.
Version Is the version number of the certificate.
Expiry Date Is the expiry date of the certificate.
Issuer Is the issuing agency of the certificate.
Button descriptions
Name Description
Select New Selects new System Platform Web Console certificate and private
Certificate key or Enterprise LDAP certificate depending on the area where the
button is located.
License management
System Platform includes Avaya's Web License Manager (WebLM) to manage its licenses.
WebLM is a Web-based software application that facilitates easy tracking of licenses. You can
launch the WebLM application from within System Platform.
Launching WebLM
System Platform uses Web License Manager (WebLM) to manage its licenses. Use this
procedure to launch WebLM from System Platform.
Related topics:
License management on page 50
License Management field descriptions on page 50
Button descriptions
Name Description
Launch WebLM License Manager Launches the WebLM application.
Related topics:
License management on page 50
Launching WebLM on page 50
SAL
System Platform includes Avaya's Secure Access Link (SAL) Gateway to manage service
delivery (alarming and remote access). SAL Gateway is a software application that:
• Facilitates remote access to support personnel and tools that are needed to access
supported devices
• Collects and sends alarm information to a Secure Access Concentrator Core Server, on
behalf of the managed devices
• Provides a user interface to configure its interfaces to managed devices, Concentrator
Remote and Core Servers, and other settings
SAL requires an upload bandwidth (customer to Avaya) of at least 90 kB/s (720 kb/s) with
latency no greater than 150 ms (round trip.)
During the installation of System Platform, you must register the system (System Platform,
solution templates, and SAL Gateway) and configure SAL for the customer's network.
Important:
For Avaya to provide support, Avaya Partners or their customers must ensure that SAL is
registered and configured properly. Avaya support will be delayed or not possible if SAL is
not properly implemented.
Avaya Partners must provide their own B2B VPN connection (or other IP-based connectivity) to
deliver remote services. SAL does not support modem connections.
You can launch the SAL Gateway management portal from within System Platform.
Related topics:
SAL on page 51
Configuring the SAL Gateway on page 52
SAL Gateway Management field descriptions on page 53
To configure the SAL Gateway for the customer's network and System Platform, follow
the instructions that are provided in Administering SAL on Avaya AuraTM System
Platform. This document is available on http://support.avaya.com/css/P8/documents/
100069101.
Note:
For an understanding of how to administer the customer's network to support SAL,
follow the instructions provided in Secure Access Link 1.8 SAL Gateway
Implementation Guide. This document is available on http://www.avaya.com/
support.
Button Description
Launch SAL Gateway Launches the SAL Gateway management portal in a new
Management Portal Web browser window.
You must provide valid certificate details to access the portal.
Related topics:
SAL on page 51
Launching the SAL Gateway management portal on page 52
Configuring the SAL Gateway on page 52
Performance statistics
System Platform collects data on operational parameters such as CPU usage, free and used
heap and permgen memory, number of open files on System Platform Web Console, and disk
input and output operations to name a few. System Platform collects this data at one minute
interval and stores it in an RDD database. System Platform presents this data as graphs using
an open source data logging and graphing tool called RRDtool. The following sections should
help you understand the System Platform performance statistics capability:
Data retention and consolidation
System Platform stores data for 24 hours and then consolidates it into one hour average and
maximum, which is kept for a week. After a week, System Platform consolidates the one hour
average and maximum data into 4 hour average and maximum, and stores it for six months.
Monitored parameters
System Platform collects data on the following parameters every minute:
Graphs
Click Server Management > Performance Statistics to generate graphs for all or selected
parameters and for a specified duration. You can also obtain the comma separated value (CSV)
file of the graphed data.
Alarms
System Platform can raise alarms for parameters whose values and frequencies exceed the
configured threshold limits.
Related topics:
Log severity levels on page 35
Exporting collected data on page 55
Performance statistics field descriptions on page 55
• Clear All Statistics, and select the type of graph from the Type drop down
menu. Then select the required domain from the list in the Domains box.
3. Specify the date and time for the period that you want the report to cover.
4. Click Generate to generate the performance graph for the system.
Related topics:
Exporting collected data on page 55
Performance statistics field descriptions on page 55
Related topics:
Log severity levels on page 35
Performance statistics on page 53
Performance statistics field descriptions on page 55
Related topics:
Viewing performance statistics on page 54
Exporting collected data on page 55
Configuring security
Security configuration
Most JITC features are built into the System Platform image and are available after installing
System Platform. However, there are some features which need more user input and can be
configured from the Security Configuration page. This page allows an advanced administrator
user to do the following tasks:
• Remove network debugging tools, namely wireshark from System Platform
• Enable JITC Audit
• Set certain security parameters on the system
Important:
Removing the network debugging tools is irreversible. The tools are removed from System
Platform Web Console and the Console Domain.
The Remove network debugging tools (wireshark) check box is not enabled once the
tools are removed from the system. However, a platform upgrade makes the tools available
again and the Remove network debugging tools (wireshark) check box is also enabled.
Important:
Enabling audit is also irreversible. The Enable Audit check box is not available again after
you save the changed security configuration.
Configuring security
Use this procedure to change one or more security features such as enabling audit, resetting
the Grub password, changing host access list, and so on.
Name Description
Remove network Indicates whether or not to remove the network debugging tools.
debugging tools
(wireshark) Important:
Removing the network debugging tools is irreversible. The tools
are removed from System Platform Web Console and the Console
Domain.
A platform upgrade makes the tools available again and the
Remove network debugging tools (wireshark) check box is
also enabled.
Enable Audit Indicates whether or not the audit is to be enabled.
Important:
Enabling audit is irreversible.
Reset Grub Is the new System Platform Web Console Grub password.
Password
Retype Grub Is the new System Platform Web Console Grub password being
Password retyped for verification.
Verify Dom0 Reset Is the System Platform Web Console root password to reset the
Password System Platform Web Console Grub password.
Cdom Hosts Allow Is the list of hosts that can access the Console Domain.
List
Note:
The list of hosts is maintained in the hosts.allow file at /etc
on the Console Domain.
Cdom Hosts Deny Is the list of hosts that cannot access the Console Domain.
List
Note:
The list of hosts is maintained in the hosts.deny file at /etc
on the Console Domain.
Name Description
Important:
When JITC is enabled, all that hosts.deny has is the entry
ALL:ALL.
Dom0 Hosts Allow Is the list of hosts that can access the System Platform Web Console.
List
Note:
The list of hosts is maintained in the hosts.allow file at /etc
on the System Platform Web Console.
Dom0 Hosts Deny Is the list of hosts that cannot access the System Platform Web
List Console.
Note:
The list of hosts is maintained in the hosts.deny file at /etc
on the System Platform Web Console.
Important:
When JITC is enabled, all that hosts.deny has is the entry
ALL:ALL.
Login Banner Is the header shown for the login banner.
Header
Login Banner Text Is the text shown for the login banner.
Button descriptions
Name Description
Save Saves the security configuration.
backup archive. If any of the backup sets fail, then the system removes the backup archive.
The amount of data backed up is dependent on the specific solution template.
The system stores the backup data in the /vspdata/backup directory in Console Domain.
This is a default location. During an upgrade, the system does not upgrade the /vspdata
folder, so that you can restore the data, if required. You can change this location and back up
the System Platform backup archives to a different directory in System Platform or in an
external server. You can also send the backup data to an external e-mail address if the file size
is not larger than 10 MB.
If a backup fails, the system automatically redirects you to the Backup page after login and
displays the following message: Last Backup Failed. The system continues to display the
message until a backup is successful.
Note:
It is not the aim of the backup feature to provide a mechanism to re-enable a failed High
Availability Failover node back to High Availability Failover configuration. Follow the
instructions in this document on how to re-enable failed High Availability Failover node back
to High Availability Failover configuration.
Related topics:
Re-enabling failed standby node to High Availability Failover on page 126
Re-enabling failed preferred node to High Availability Failover on page 127
Important:
The backup file size can reach 3 GB. Ensure that you have that much free space
at the location where you are storing the backup archive.
4. Select where to store or send the backup files:
• Local: Stores the backup archive file on System Platform in the /vspdata/
backup/archive directory.
• SFTP: Stores the backup archive file on the designated SFTP host server as
well as on the System Platform server.
• Email: Sends the backup archive file to the e-mail address that you specify as
well as stores the file on the System Platform server.
Note:
Avaya does not recommend that you use the Email option due to the large
size of backup files. The backup file size can reach 3 GB.
5. Enter other information as appropriate.
6. Click Backup Now.
Related topics:
Backup field descriptions on page 62
Scheduling a backup
Use this procedure to back up System Platform and the solution template on a regular basis.
Backups are not scheduled by default on System Platform.
Related topics:
Backup field descriptions on page 62
Field Descriptions
Names
Backup Select a location to send the backup file:
Method
• Local: Stores the backup archive file on System Platform in the /vspdata/
backup/archive directory.
• SFTP: Stores the backup archive file on the designated SFTP host server
as well as on the System Platform server.
Enter the hostname, directory, user name, and password for the SFTP
server.
• Email: Sends the backup archive file to the e-mail address that you specify
as well as stores the file on the System Platform server.
Enter the e-mail address and the server address of the recipient.
Related topics:
Backing up the system by using the System Platform Web Console on page 60
Scheduling a backup on page 61
Note:
The restore operation does not restore the High Availability Failover configuration from the
backup file. It is not the aim of the restore feature to re-enable the failed High Availability
Failover node back to High Availability Failover configuration. Follow the instructions given in
this document on how to re-enable the failed High Availability Failover node back to High
Availability Failover configuration. Avaya recommends that you restore the backup
configuration before configuring and starting High Availability Failover.
Related topics:
System Platform backup on page 59
Restore field descriptions on page 65
Archive Filenames of the backup archive files at the location you specify.
Filename
Archive Date Date that the file was created.
Selection Select this check box to restore from the archive file.
Restore Displays the restore history for the last ten restores. If an error occurred
History during the last restore, the system directs you to this page after login and
continues to display an error message until a restore is successful.
Button descriptions
Button Description
Search Displayed if you select SFTP. Searches for archive files in the specified
directory of the remote server.
Clear Search Clears the list of archive files found on a remote server after an SFTP
Result search.
Related topics:
Restoring backed up configuration information on page 64
Note:
You must have a user role of Advanced Administrator to perform this task.
Related topics:
Server Reboot Shutdown field descriptions on page 68
Note:
The Reboot HA System button is enabled only if the High Availability Failover
system is settled and stable to perform this operation.
Note:
You must have a user role of Advanced Administrator to perform this task.
Related topics:
Server Reboot Shutdown field descriptions on page 68
Note:
The Shutdown HA System button is enabled only if the High Availability Failover
system is settled and stable to perform this operation.
Name Description
Name Name of the application being shutdown. This is always System Domain
(Domain-0).
MAC Address Machine address of the virtual machine.
IP Address IP address of the System Platform server.
OS Type Operating system of the System Platform server, for example, Linux.
State Current status of the virtual machine.
Possible values are as follows:
• Running: Virtual machine is running normally.
• Starting: Virtual machine is currently booting and should enter a
running state when complete.
• Stopping: Virtual machine is in the process of being shutdown and
should enter stopped state when complete.
• Stopped: Virtual machine has been shutdown.
• Rebooting: Virtual machine is in the process of a reboot and should
return to running when complete.
• No State: The virtual machine is not running or the application
watchdog is not being used.
Name Description
Used Memory The amount of memory currently used by the virtual machine.
Maximum This is a display only field.
Memory The amount of physical memory from the total server memory the virtual
machine has allocated in the template file.
CPU Time The amount of CPU time the virtual machine has had since boot. This
is not the same as uptime.
Virtual CPUs The maximum number of virtual CPUs that can run on System Platform
server.
Domain UUID Unique ID of the virtual machine.
Auto Start Status of auto start - shows if the System Platform server starts
automatically after a shut down operation.
Available status are True (if auto start is set), and False (if auto start is
not set).
Button descriptions
Button Description
Reboot Reboots the System Platform server and all the virtual machines
running on it.
Reboot HA Reboots the whole High Availability Failover system that includes the
System primary and the secondary servers and all the virtual machines
running on the primary server.
Shutdown Server Shuts down the System Platform server and all the virtual machines
running on it.
Shutdown HA Shuts down the whole High Availability Failover system that includes
System the primary and the secondary servers and all the virtual machines
running on the primary server.
Related topics:
Rebooting the System Platform Server on page 66
Shutting down the System Platform Server on page 67
User roles
System Platform users must be assigned a user role. Two user roles are available:
Administrator and Advanced Administrator. The following table shows which administrative
activities each role can perform.
Related topics:
Creating users on page 74
Modifying users on page 75
You can create new System Platform users in the local LDAP server by using the Local
Management option in the User Administration menu.
You can access the Local Management option only with an Advanced Administrator role and
can perform the following functions:
• Viewing existing users
• Creating new users
• Modifying existing users
• Changing passwords for existing users
• Deleting existing users
• Changing LDAP Manager password
A user with Administrator role can only change own password.
Note:
A user created using the User Administration menu in System Platform Web Console is
stored in the local LDAP server and will not appear in the /etc/shadow file.
Creating users
You must have a user role of Advanced Administrator to perform this task.
Note:
Passwords must be at least six characters long. Avaya recommends using only
alphanumeric characters.
5. In the Confirm Password, enter the same password.
6. In the User Role field, click the user role you want to assign to the user.
7. Click Save User to the create the user with the details you have specified.
Related topics:
Local Management field descriptions on page 76
Modifying users
You must have a user role of Advanced Administrator to perform this task.
Note:
The cust and admin user IDs cannot be modified or deleted.
Note:
Passwords must be at least six characters long. Avaya recommends using only
alphanumeric characters.
5. In the Confirm Password, enter the same password.
6. In the User Role field, click the user role you want to assign to the user.
7. Click Save to save the edited user details.
Related topics:
Local Management field descriptions on page 76
Deleting users
You must have a user role of Advanced Administrator to perform this task.
Note:
You can delete the default cust and admin users using this task. You need to create a user
with the user role of Advanced Administrator and log in to System Platform Web Console
using the login credentials of the new user.
Related topics:
Local Management field descriptions on page 76
Name Description
User Id User name for the user.
User Role Role of the user. Options are:
• Advanced Administrator
• Administrator
Name Description
User Id User name for the user.
User Password Password for the respective user.
Name Description
Note:
Passwords must be at least six characters long. Avaya
recommends using only alphanumeric characters.
Confirm Password Reenter the password for the user.
User Role Role of the user. Options are:
• Advanced Administrator
• Administrator
Related topics:
Creating users on page 74
Modifying users on page 75
Deleting users on page 76
Note:
You must have a user role of Advanced Administrator to enable or configure user
authentication against an enterprise LDAP.
Related topics:
Configuring authentication against an enterprise LDAP on page 78
Note:
If you selected the TLS check box and could successfully connect to the
enterprise LDAP server, it means that you could successfully upload the
enterprise LDAP certificate.
Related topics:
Selecting enterprise LDAP certificate on page 49
Authentication against an enterprise LDAP on page 77
Enterprise LDAP field descriptions on page 78
Name Description
Enable This check box enables external LDAP authentication. If you save the
Enterprise LDAP page without selecting this check box, the system saves the
configuration without activating the enterprise LDAP authentication.
TLS This check box enables to use Transport Layer Security (TLS).
LDAP Server Is the Host name or IP address of the LDAP server.
User Attribute Is the LDAP attribute for the user.
This is usually cn or uid.
Name Description
Port Is the port number for the LDAP connection.
For TLS-based LDAP connection, the default port number is 636.
For non-TLS-based LDAP connection, the default port number is 389.
Base DN Is the distinguished name of the path where the user search will be
executed. This is used for connection authentication to the LDAP
server.
For example, cn=admin,ou=sv,dc=avaya,dc=com.
This parameter is used to login to the LDAP server.
User DN Is the distinguished name of the LDAP user.
User Password Is the password of the LDAPuser.
Attribute Map Specifies LDAP filters for the advanced administrator and administrator
roles.
A simple filter can be memberOf=admin_Group. A complex filter can
contain multiple criteria such as: (&(memberOf=vsp-craft)
(userstatus=ACTIVE)).
Advanced Specifies the LDAP filter on a user to check if the user has System
Administrator Platform advanced administrator role.
Filter For example, the LDAP filter (&(memberOf=vsp-craft)
(userstatus=ACTIVE)) will filter the active users who are the members
of vsp-craft.
Administrator Specifies the LDAP filter on a user to check if the user has System
Filter Platform administrator role.
For example, the LDAP filter (&(memberOf=vsp-admin)
(userstatus=ACTIVE)) will filter the active users who are the members
of vsp-admin.
Related topics:
Configuring authentication against an enterprise LDAP on page 78
Note:
Passwords must be at least six characters long. Avaya recommends using only
alphanumeric characters.
3. Confirm the new password.
4. Click Save to save the new password.
Note:
Passwords must be at least six characters long. Avaya recommends using only
alphanumeric characters.
4. In the Confirm Password field, reenter the new password.
5. Click Change Password to change the current password.
An important component of this security mechanism is the customer-specific ASG keys that
ASG sets. These keys are stored in an authentication file. To enable Avaya Partners to access
their system, customers have to download and install the authentic files specially prepared for
their sites.
Note:
To override validation of the AFID and date and time, select Force load of new
file on the Authentication File page. Select this option if you:
• need to install an authentication file that has a different unique AFID than
the file that is currently installed, or
• have already installed a new authentication file but need to reinstall the
original file
You do not need to select this option if you are replacing the default authentication
file with a unique authentication file.
Caution:
Use caution when selecting the Force load of new file option. If you install
the wrong authentication file, certificate errors and login issues may occur.
4. Click Install.
The system uploads the selected authentication file and validates the file. The
system installs the authentication file if it is valid.
Note:
If System Platform is configured for High Availability Failover, the authentication
file propagates to the backup server.
Note:
System Platform High Availability Failover does not support IPv6 and cannot be configured
with IPv6 addresses.
The System Platform High Availability Failover feature offers the following capabilities:
Node scores
High Availability Failover uses node scores to compute the ability of each machine to run the
resources and determine which node runs the resources. If the system has no issues, and
resources could run on either node, both machines have the same score. Thus System
Platform uses the term “preferred node” for the machine that should run the resources when
the system has no issues. The preferred node has a small score benefit. So if both machines
are booted at the same time, the preferred node will run resources. The node from which you
configure High Availability Failover is designated the preferred node. If you stop High
Availability Failover, the currently active node becomes the preferred node.
No auto-failback
High Availability Failover does not use auto-failback to migrate resources back to the preferred
node when the resources are running on the standby node and the preferred node becomes
available again. Switching servers disrupts service, and if both servers are healthy, then
running on the preferred node offers no increased benefit. If you want to migrate resources
back to the preferred node after a failover or a switchover, you can do so by using the Manual
Switchover option in the Failover menu at the most suitable time.
Expected failover/switchover times
High Availability Failover uses 30 seconds as a timeout interval after which the standby node
will declare the active node dead and start resources (even though the active node may be
not accessible, not running or blocked). Note that System Platform does not provide any Web
interface to modify this interval.
For manual switchover or when the system initiates a preemptive failover, the total time
between the start of the command and activating the standby node includes a graceful
shutdown and restart of all resources:
• Stop of resources– Up to 5 minutes.
• Start of resources–Up to 5 minutes.
• Resulting longest switchover time–Up to 10 minutes.
For failover due to total failure of the active node, the total time between the start of the outage
and the time when all resources are running on the standby node includes a detection interval
timeout and the start of all resources:
• Detect active node failure–30 seconds.
• Start of resources–Up to 5 minutes.
• Resulting longest switchover time–Up to 5.5 minutes.
Note:
The switchover time is approximate and varies depending on the hardware running System
Platform with no templates. The switchover is further delayed by the following factors:
• The system runs complex templates.
• The system shutdown was not proper. Therefore, the system performs an FSCK (File
System Check) as it boots up and starts the virtual machines.
Ping targets
High Availability Failover uses node scoring to compute the ability of each machine to run the
resources and determine which node runs the resources. Each node uses the following three
ping targets:
• The default network gateway as a public ping target.
• The eth0 network interface of the peer.
• The crossover interface of the peer (eth2 by default).
Each successful ping result adds points to the node's score. The node that has the higher
score becomes the active node. Therefore, if both machines can reach all three ping targets,
they both have the same score, and resources run on the preferred node. The following image
shows the two System Platform servers with their three ping targets.
Ping requests to these targets fail in three scenarios. These scenarios and their results are as
follows:
• If the crossover link is interrupted on any node, no action occurs because both machines
have the same score.
• If the public link is interrupted on the standby node, no action occurs because the active
node still has the full score while the standby node has lost two ping sources.
• If the public link is interrupted on the active node, failover occurs because the active node
has lost two ping sources while the standby has the full score.
Important:
The default gateway is the ping target and cannot be configured. Ensure that your gateway
replies to ICMP pings that come from the System Platform nodes.
the DRBD resources is complete, the standby node does not have sufficient data to start the
virtual machines. The following image shows the initial data synchronization from the active
node to the standby node:
Note:
During the initial synchronization, the online changes are also propagated. It is essential to
provide enough network throughput for the successful completion of the online changes.
Thus the System Platform sets the DRBD initial synchronization rate to 30 MB/s. You can
modify this value from the Failover page in case the system is not overloaded.
For more information on the DRBD component, see http://www.drbd.org.
If a failover or switchover occurs and the node roles are changed (that is, the active node
becomes the standby node and vice versa), the propagation direction swaps to ensure that
the changes on the active node are propagated to the current standby node.
Automatic failover
When the System Platform server encounters missing heartbeat checks, the standby System
Platform server becomes the active System Platform server. The system shuts down all virtual
machines on the original active server, and reboots them on the new active server.
The system performs the following steps:
1. Detects problems on the active (primary) node by missing heartbeat checks during a
specified period of time.
2. Designates the secondary node as the new primary node.
3. Sets the Distributed Replicated Block Device (DRBD) devices as primary on the
new active node.
4. Boots the virtual machines on the new active node.
Important:
Do not install a template on the standby node. If you do so, you will not be able to start High
Availability Failover. If you are using a bundled System Platform installation (with a solution
template), disable the template installation on the standby server. The solution template is
propagated from the active node to the standby node when you start High Availability
Failover.
Related topics:
Starting High Availability Failover on page 93
Stopping High Availability Failover on page 93
• Two servers with exactly the same hardware configuration. The standby server cannot
have less memory, number of processors, total disk space or free disk space than the
primary server.
• The hardware must be supported by System Platform.
• The servers must have a spare Gigabit network interface to be dedicated exclusively to
High Availability Failover services. The servers must be connected on the same ports on
both machines.
• Both the servers must be in the same subnet.
• Both servers must be in close proximity so that they can be connected with the crossover
cable. The Ethernet specification limit for this distance is 100 meters.
• The same version of System Platform must be installed on the active and standby nodes.
• Do not install a template on the standby node. If you do so, you will not be able to start
High Availability Failover. If you are using a bundled System Platform installation (with a
solution template), disable the template installation on the standby server. The solution
template is propagated from the active node to the standby node when you start High
Availability Failover.
1. Log in to the Web Console of the server that you want to be the preferred node.
2. Click Server Management > Failover to display the Failover page.
The Failover page displays the current status of High Availability Failover.
3. Click Configure Failover.
4. On the Configure failover page, enter the appropriate information to configure High
Availability Failover.
5. Click Create.
6. After the system completes creation of the High Availability Failover configuration,
click Start Failover Mode and confirm the warning that is displayed.
System Platform Web Console redirects to the Reboot page and after a few minutes
redirects to the Login page.
7. Log in to the System Platform Web Console.
8. Click Server Management > Failover.
You can check the status of the failover components on the Failover page and
ensure that Distributed Replicated Block Device (DRBD) is synchronizing the hard
disks of the two servers.
Tip:
During the disk synchronization process, you can increase or decrease the speed
of the synchronization with a slider bar on the console. The default value of this
rate is 30 MB/s. If you set the value too high, it may affect the performance of the
virtual machines running on the active server.
Related topics:
Configure Failover field descriptions on page 91
Related topics:
Configuring High Availability Failover on page 90
Troubleshooting steps on page 125
Important:
Do not install a template on the standby node. If you do so, you will not be able to start High
Availability Failover. If you are using a bundled System Platform installation (with a solution
template), disable the template installation on the standby server. The solution template is
propagated from the active node to the standby node when you start High Availability
Failover.
When you start High Availability Failover, the console domain and all template virtual machines
are restarted. When this happens, System Platform Web Console redirects to the Reboot page
and after a few minutes redirects to the Login page.
Stopping High Availability Failover
If you want to stop High Availability Failover, you should do so as soon as no disk
synchronization is in progress or the disc synchronization is not paused. If you stop High
Availability Failover during disk synchronization, the file system of the standby console domain
could be corrupted.
When you stop High Availability Failover, the console domain and all template virtual machines
are restarted. When this happens, System Platform Web Console redirects to the Reboot page
and after a few minutes redirects to the Login page.
When High Availability Failover is stopped, the system does not propagate changes from the
preferred node to the standby node.
When High Availability Failover is stopped, you can access the Web Console on the standby
server by using its IP address (provided during configuration of High Availability Failover).
Removing the High Availability Failover configuration
If you want to permanently remove the High Availability Failover configuration, you can do so.
Related topics:
Starting High Availability Failover on page 93
Stopping High Availability Failover on page 93
This procedure synchronizes all required configuration settings from the preferred node to the
standby node so that the standby node can assume the role of active node if required.
This procedure restarts the console domain and all template virtual machines.
Related topics:
Start and stop of High Availability Failover on page 92
Related topics:
Start and stop of High Availability Failover on page 92
Note:
When you perform a manual switchover, the system shuts down all template
virtual machines and the Console Domain on the active node. System Platform
Web Console redirects to the Reboot page until the Console Domain is up on the
new active server (previously standby server). After that it redirects to the Login
page.
Note:
It is not possible to directly access the system using the root and sroot user IDs. If it is
required to log in using one of these user IDs, log in as an unprivileged user and run the su
command to switch to either the root or sroot user ID. If you use the root user ID, you
will enter the root password. In the case of the sroot user ID, you will use the correct
response to the ASG challenge.
1. Log in to System Domain or Console Domain where you want to stop the firewall
rules.
2. Type service firewall stop
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to start the firewall
rules.
2. Type service firewall start
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to display the firewall
rules.
2. Type service firewall status
3. Log out of the system.
Note:
All blocked IP packets are logged in the file /var/log/vsp/vsp-rsyslog on Console
Domain. You can view these IP packets by using the command dmesg on Console Domain
command line.
All IP packets blocked on System Domain are logged in the file /var/log/messages on
the System Domain. You can view these IP packets by using the command dmesg on the
System Domain command line.
Avaya advises logging of blocked IP packets only on rare occasions and for short time
periods to prevent flooding of log files.
1. Log in to System Domain or Console Domain where you want to start the logging
of IP packets blocked by the firewall.
2. Type service firewall logging
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to stop the logging
of IP packets blocked by the firewall.
2. Type service firewall restart
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to stop the firewall
rules.
2. Type service firewallIPv6 stop
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to start the firewall
rules.
2. Type service firewallIPv6 start
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to display the firewall
rules.
2. Type service firewallIPv6 status
3. Log out of the system.
Note:
All blocked IP packets are logged in the file /var/log/vsp/vsp-rsyslog on Console
Domain. You can view these IP packets by using the command dmesg on Console Domain
command line.
All IP packets blocked on System Domain are logged in the file /var/log/messages on
the System Domain. You can view these IP packets by using the command dmesg on the
System Domain command line.
Avaya advises logging of blocked IP packets only on rare occasions and for short time
periods to prevent flooding of log files.
1. Log in to System Domain or Console Domain where you want to start the logging
of IP packets blocked by the firewall.
2. Type service firewall logging
3. Log out of the system.
1. Log in to System Domain or Console Domain where you want to stop the logging
of IP packets blocked by the firewall.
2. Type service firewallIPv6 restart
3. Log out of the system.
Note:
System Platform runs a hardened Linux-based operating system and it is unlikely that any
viruses or other types of malicious code will be able to penetrate the system. LinuxShield
provides an additional layer of protection to an already secure system for the enterprises
that have very high security requirements. Most systems will not need to install LinuxShield.
Avaya recommends that LinuxShield is installed and configured only by people who have
knowledge of working on Linux servers. Further, LinuxShield virus scan may affect the
system performance.
Note:
During installation, set the YOUR_IP_ADDRESS field to the IP address of
System Domain. Avaya recommends setting the scanning schedule to daily
during the configuration of McAfee Linuxshield™.
Note:
During installation, set the YOUR_IP_ADDRESS field to the IP address of
Console Domain. Avaya recommends setting the scanning schedule to daily
during the configuration of McAfee Linuxshield™.
BIOS changes are required for each of the following server types to disable booting from
removable media:
• S8510 (also known as Dell Powerledge 1950)
• S8800 (also known as IBM x3550 M2)
• S8300D
1. Upon booting, press the F2 key to start the BIOS setup utility.
You may need to enter the setup password.
2. From the menu, click Boot Sequence.
A list of bootable devices will be displayed..
3. Select Hard Drive from the boot sequence list and press the + key to move it to the
first position in the list.
4. Press the Spacebar to clear selection of all other devices such as CD-ROM and
embedded NIC in the boot sequence list.
5. If a BIOS password has not been enabled, click System Security from the main
menu and enter a password.
6. Press Escape to exit from the boot sequence list.
7. Click Save changes.
Port summary
• Ingress: This indicates data flowing into the product defined in the matrix.
• Egress: This indicates data flowing away from the product defined in the matrix.
• Port(s): This is the layer-4 port number. Valid values are in the range of 0 – 65535. All
ports listed are the destination ports.
• Network/Application Protocol: This is the name associated with the layer-4 protocol and
layers-5-7 application.
• Optionally Enabled / Disabled: This field indicates whether customers can enable or
disable a layer-4 port changing its default port setting. Valid values are 'Yes' and 'No'.
- No means the default port state cannot be changed (that is, enabled or disabled).
- Yes means the default port state can be changed and that the port can either be
enabled or disabled.
• Default Port State: A port is either open, closed, filtered, or N/A.
- Open ports will respond to queries.
- Closed ports may or may not respond to queries and are only listed when they can
be optionally enabled.
- Filtered ports can be open or closed. Filtered UDP ports will not respond to queries.
Filtered TCP will respond to queries, but will not allow connectivity.
- N/A is used for the egress default port state since these are not listening ports on
the product.
Note:
The port numbers are assigned by IANA (Internet Assigned Numbers Authority) and can be
found at http://www.iana.org/assignments/port-numbers.
Note:
The port numbers are assigned by IANA (Internet Assigned Numbers Authority) and can be
found at http://www.iana.org/assignments/port-numbers.
Avaya provides the log harvest utility that collects logs and command line outputs and prepares
a compressed file. You can send this compressed file to an Avaya Partner to investigate the
System Platform performance in your enterprise.
Note:
The log harvest utility is installed on System Domain and Console Domain at /opt/avaya/
vsp/bin during the System Platform installation.
Using the log harvest utility
To use the log harvest utility, you need to log in to either System Domain or Console Domain
using SSH. The log harvest utility collects logs and command line outputs and prepares a
compressed file with the filename as vsp_logs_hostname_YYMMDDHHMM.zip. In the
filename, hostname is the short hostname of either System Domain or Console Domain from
where the log harvest utility was run and YYMMDDHHMM is the timestamp when the compressed
file created.
Note:
Avaya recommends using the log harvest utility from Console Domain. When run from
Console Domain, the log harvest utility collects logs and command line outputs from both
System Domain and Console Domain. When run from System Domain, the log harvest utility
collects logs and command line outputs only from System Domain.
Compressed file structure
The compressed file has files and cmds categories in which respectively the logs and the
command line outputs are collected. The structure of the compressed file is as follows:
vsp_logs_hostname_YYMMDDHHMM
/files
/cmds
/dom0.vsp
/files
/cmds
/dom0-standby.vsp
/files
/cmds
In the above structure, if the log harvest utility is run from Console Domain, the logs and
command line outputs will be collected under the /files and /cmds directories immediately
following the filename. The logs and command line outputs for System Domain will be collected
under the subdirectories under the /dom0.vsp directory. The dom0–standby.vsp directory
will be present if High Availability Failover is configured and will have the logs and command
line outputs for System Domain of the secondary server.
If the log harvest utility is run from System Domain, the logs and command line outputs will be
collected under the /files and /cmds directories immediately following the filename and
the /dom0–standby.vsp directory will be present only if High Availability Failover is
configured. There will not be log and command line outputs collected for Console Domain.
The log harvest utility retains the location information of the log files under the files
directories. For example, the /var/log directory from Console Domain will show up as …/
files/var/log and that from System Domain will show up as …/dom0.vsp/files/var/
log.
The cmds directories contain files that are named after the commands used to produce the
output. Each output file has the command at its beginning.
Related topics:
Using the log harvest utility on page 114
1. Log in to System Domain or Console Domain from where you want to run the log
harvest utility.
Note:
Avaya recommends using the log harvest utility from Console Domain. When run
from Console Domain, the log harvest utility collects logs and command line
outputs from both System Domain and Console Domain. When run from System
Domain, the log harvest utility collects logs and command line outputs only from
System Domain.
2. Type su - root
3. Type the password of the root user ID.
4. Type getlogs
5. Log out of the system.
Troubleshooting steps
raid_status command
-s: Shows short RAID status information; is the default output form
-p: Displays physical disk drive data; can be used with -v and -s
-r: Returns 0 if server supports RAID
Example
raid_status -h
raid_status [-s|-v]
raid_status [-s|-v] -p
raid_status -r
Note:
In case of physical disk information, -s -p is the default form of output.
Specifying -v -s options together will result in an invalid command.
1. Check the Ethernet cable is connected on the correct Ethernet port, for example,
eth3.
2. Shutdown virtual machine and restart it from System Platform Web Console.
Troubleshooting steps
System Platform provides scripts that gather all the required configuration files, log files, and
system status commands, and collect them into a zip file. If this script is executed from console
domain SSH session, it also gathers this information from Domain-0 (if High Availability
Failover is not configured) or from both Domain-0s (if High Availability Failover is configured).
1. To create such zip file execute getlogs command from console domain.
It will create vsp_logs_<hostname>_<date_time>.zip compressed file in the
current directory.
2. If console domain is not accessible, execute getlogs command on Domain-0 (if
High Availability Failover is not configured) or on both Domain-0s (if High Availability
Failover is configured).
Result
This file can be then used to your support technician.
Troubleshooting steps
Ensure that the crossover cable is properly connected to the same interface on both
machines and that you selected correct interface when configuring the High Availability
Failover.
Troubleshooting steps
Ensure that you specify remote console domain IP address when configuring High
Availability Failover.
Troubleshooting steps
You have provided IP address of remote console domain when initial start-up procedure was
not yet completed.
Provide enough time to complete this start-up process and try configuring High
Availability Failover again later.
Note:
The machine can take up to 5 minutes until this process is finished from the moment
you can log in into System Domain (Dom-0).
Troubleshooting steps
When you attempted to set up High Availability Failover, you added the weaker server and
then the preferred server to the system.
Either use another server that has the same or better configuration parameters or swap
the servers so that the weaker server becomes preferred node.
Note:
The standby server cannot have less memory, number of processors, total or free
disk space then active server.
Troubleshooting steps
A solution template is installed on the standby node.
Note:
System Platform forbids setup of High Availability Failover when a template is installed on
the standby node.
Either delete the solution template from the standby node or reinstall System Platform
on the standby node and retry configuration of High Availability Failover.
Troubleshooting steps
Either public and crossover network interface is not available on one of the nodes. Both public
and crossover network interfaces must be available and properly working on both nodes.
Troubleshooting steps
Crossover network interface cannot be setup on one of the nodes. Crossover network interface
must be available properly working on both nodes.
Ensure that this network interface is not enslaved to the network bridge on the system.
Troubleshooting steps
Versions of System Platform are not the same on both cluster nodes. System Platform forbids
the start of High Availability Failover if the versions are not the same on both cluster nodes.
Both machines must be installed with the same version of System Platform. If you
install a patch, ensure that it is installed on both machines.
Troubleshooting steps
A solution template is installed on the standby node.
Note:
System Platform forbids the start of High Availability Failover when a template is installed
on the standby node.
Resources are not started on any node and cannot access the Web
Console
Troubleshooting steps
High Availability Failover uses the default network gateway as a ping target to:
• check each machine’s ability to communicate with the network
• compute each machine's score to run resources
If the gateway is not replying to those ping requests, System Platform cannot designate either
node as active node, because the score of both nodes is equal. As a result, no resources are
activated on either node.
Check that your default network gateway is able to receive and reply to ICMP echo
requests from both System Platform nodes.
Related topics:
High Availability Failover overview on page 83
Ping targets on page 84
Prerequisites for configuring High Availability Failover on page 90
Troubleshooting steps
Troubleshooting steps
Disconnect the main network cable only from the active server.
Result
The standby server become active.
Note:
Ensure that the crossover connection is working fine before the test.
Troubleshooting steps
1. Disconnect the main network cable from both active and standby server.
2. Reconnect the cables after few minutes.
Result
Previous active server remains as active.
Note:
Ensure that the crossover connection is working fine before the test.
Troubleshooting steps
Result
Active server remains as active. Active server will resync the data to standby server.
Note:
The crossover connection interruption should not initiate any failover action.
Troubleshooting steps
1. Remove the SAMP board from the S8510 server before installing System Platform.
2. Ensure that the Dual NIC card is connected to the correct port for High Availability
Failover.
Troubleshooting steps
If from any reason (for example, in case of power outage) system rebooted without initiating
shutdown procedure, the LDAP can prevent to start on next boot up sequence. In that case all
users that are stored in LDAP database will not be able to log in.
Log in to the system console as user that is not using LDAP credentials and execute
following commands:
# su –
# cd /var/lib/ldap
# slapd_db_recover –v
# service ldap restart
Troubleshooting steps
Troubleshooting steps
Note:
This procedure is service-disruptive and you must plan your activities accordingly.
In this case all services are still running on the preferred node. Use this procedure to restart
High Availability Failover after the standby node is reinstalled with System Platform of the same
version as the currently active node.
You must have a user role of Advanced Administrator to perform this task.
You can check the status of the failover components on the Failover page and
ensure that Distributed Replicated Block Device (DRBD) is synchronizing the hard
disks of the two servers.
Tip:
During the disk synchronization process, you can increase or decrease the speed
of the synchronization with a slider bar on the console. The default value of this
rate is 30 MB/s. If you set the value too high, it may affect the performance of the
virtual machines running on the active server.
Related topics:
Configure Failover field descriptions on page 91
Troubleshooting steps
Note:
This procedure is service-disruptive and you must plan your activities accordingly.
In this case all the services are still running on the preferred node. To re-enable standby node
after it was reinstalled withSystem Platform of the same version as currently active node,
perform the following steps:
5. Execute the “Configure Failover” operation with newly reinstalled standby node.
6. Execute the “Start Failover Mode” from the active node webconsole.
Troubleshooting steps
In this case all the services are running on the standby node. However, the resolution could
differ in the following cases:
• completely new machine is to be re-enabled into the HA system, or
• previous preferred machine with new primary network card (the card with eth0 and eth1
NICs) is to be re-enabled
If you plan to re-enable into HA system the machine that fits to any of the above conditions,
the process is exactly the same as re-enabling the failed standby node. Please refer to the
Re-enabling failed standby node to High Availability Failover section for more information.
To re-enable previously used preferred node with the same primary network card, some
additional steps that are not available on the webconsole are required. Please contact Avaya
support to assist you with resolving of this state.
Important:
Do not try to reinstall this failed node with System Platform on the same network as currently
active node. Such installation would fail. If you already reinstalled the machine, it will have
to be reinstalled again with assistance of Avaya support.
Troubleshooting steps
Perform the troubleshooting steps given here to ensure that a PermGen error does not occur.
For a sensor alarm type, the information provided in the alarm string is essentially the same
information provided by IPMI. Using the example above, ipmitool can display full detail as
shown below:
[root@mesaverde1 log]# ipmitool sensor get "Planar 3.3V"
Locating sensor record...
Sensor ID : Planar 3.3V (0x16)
Entity ID : 7.1
Sensor Type (Analog) : Voltage
Sensor Reading : 3.294 (+/- 0) Volts
Status : Lower Critical
Lower Non-Recoverable : na
Lower Critical : 3.294
Lower Non-Critical : na
Upper Non-Critical : na
Upper Critical : 3.564
Upper Non-Recoverable : na
The sensor ID in this example ipmitool command (“Planar 3.3V” from the example in the
table above) is the component in the alarm string.
RAID tools constantly monitor RAID health and alarm when a problem is detected. The RAID
monitoring tools differ by server type. Therefore, server-specific alarms are described
separately.
Fault types
IPMI can detect two generalized fault types, namely, sensor-related and chassis status-
related faults for various server types. This section presents information on the fault types for
S8510 and S8800 servers. Please note that the information provided here should not be
considered exhaustive as the server hardware and sensors may vary over time. Further, a
firmware update may also change the list of monitored sensor-related faults.
Please check your vendor's documentation to understand the implementation of monitored
sensor-related faults.
For S8510
The monitored sensor-related faults for S8510 server are as follows:
• Temp (processor 1, processor 2, power supply 1, power supply 2)
• Ambient Temp
• FAN MOD xx RPM (where xx is 1A, 1B, 2A, 2B, etc.)
• Current 1, 2 (sensor for each power supply)
• Voltage 1, 2 (sensor for each power supply)
• System Level
The monitored chassis-related faults for S8510 server are as follows:
• Power Overload
• Main Power Fault
• Power Control Fault
• Drive Fault
• Cooling/Fan Fault
The RAID alarms for S8510 server are as summarized below:
Message Note
Storage Service EventID: Device failed
2048
Storage Service EventID: Physical disk removed
2049
Storage Service EventID: Virtual disk failed / Virtual disk consistency check failed
2056
Storage Service EventID: Virtual disk degraded
2057
Storage Service EventID: Virtual disk failed / Virtual disk consistency check failed
2076
Storage Service EventID: Physical disk Initialization or rebuild fail
2080
Storage Service EventID: Physical disk Initialization or rebuild fail
2083
Storage Service EventID: Temperature exceeded the maximum failure threshold
2102
Storage Service EventID: Temperature dropped below the minimum failure threshold
2103
Storage Service EventID: HDD rebuild completed with error(s)
2163
Storage Service EventID: Controller battery needs to be replaced
2169
Storage Service EventID: Storage Management has lost communication with the
2268 controller
Storage Service EventID: Physical disk Initialization or rebuild fail
2270
Storage Service EventID: Patrol Read found an uncorrectable media error
2272
Storage Service EventID: A block on the physical disk has been punctured by the controller
2273
Storage Service EventID: Hot spare SMART polling failed
2282
Storage Service EventID: Multi-bit ECC error on controller DIMM
2289
Storage Service EventID: Bad PHY or physical connection
2299
Storage Service EventID: Bad block table is full. Unable to log block
2307
Message Note
Storage Service EventID: Single bit ECC error. The DIMM is critically degraded
2320
Storage Service EventID: Controller DIMM is critically degraded
2321
Storage Service EventID: The background initialization (BGI) completed with
2340 uncorrectable errors
Storage Service EventID: Rebuild failed due to errors on the source or target physical disk
2347
Storage Service EventID: Rebuild failed due to errors on the source or target physical disk
2348
Storage Service EventID: A bad disk block could not be reassigned during a write
2349 operation
Storage Service EventID: Unrecoverable disk media error during the rebuild or recovery
2350
For HP DL360 G6
The monitored sensor-related faults for HP DL360 G6 server are as follows:
• VRM 1
• VRM 2
• UID Light
• Int. Health LED
• Ext. Health LED
• Power Supply x (where x is 1 or 2, depending on the number of power supplies)
• Fan Block y (where y is 1, 2, 3, 4)
• Fans
• Temp n (where n is 1 – 28)
• Power Meter
• Memory
Message Note
Physical drive failed: <location>
<location> of <controller>
• Port [Number]
• Port [Type][Number] Box [Number], where Type = I for internal,
E for external
<controller>
• Embedded Array Controller
• Array Controller in slot [Number]
• Array Controller in slot [unknown]
For example:
Physical drive failed: Port 1I Box 1 Bay 3 of Embedded Array
Controller
Physical Drive Status <location>
Change: <location> of
• Port [Number]
<controller>. Status is
now <status> • Slot [Number] Port [Type][Number] Box [Number], where Type
= I for internal, E for external
<controller>
• Embedded Array Controller
• Array Controller in slot [Number]
• Array Controller in slot [unknown]
<status>
• OK
• Failed
• Unconfigured
• Interim Recovery
• Ready For Rebuild
• Rebuilding
• Wrong Physical Drive Replaced
Message Note
Message Note
Logical drive [Number] of <controller>
<controller>, is in a
• Embedded Array Controller
FAILED state but has one
or more drive • Array Controller in slot [Number]
replacements and is
• Array Controller in slot [unknown]
ready to go to OK.
However, this will not For example:
happen until an Accepted Logical drive 1 of Embedded Array Controller, is in a FAILED
Media Exchange state but has one or more drive replacements and is ready to go
command is issued to the to OK. However, this will not happen until an Accepted Media
logical drive. Exchange command is issued to the logical drive.
Logical drive [Number] of <controller>
<controller>:I/O request
• Embedded Array Controller
fatal error.
• Array Controller in slot [Number]
• Array Controller in slot [unknown]
For example:
Logical drive 1 of Embedded Array Controller: I/O request fatal
error.
Logical Drive Status <status>
Change: Slot [Number],
• OK
Drive [Number]. Status is
now <status> • Failed
• Unconfigured
• Interim Recovery
• Ready For Rebuild
• Rebuilding
• Wrong Physical Drive Replaced
• Physical Drive Not Properly Connected
• Hardware Overheating
• Hardware Overheated
• Expanding
• Not Available
• Queued For Expansion
• Unknown
For example:
Logical Drive Status Change: Slot 0, Drive: 1. Status is now
Interim Recovery.
For S8800
The monitored sensor-related faults for S8800 server are as follows:
• Ambient Temp
• Altitude
• Avg Power
• Planar 3.3V
• Planar 5V
• Planar 12V
• Planar VBAT
• Fan xx Tach (where xx is 1A, 1B, 2A, 2B, and so on)
The monitored chassis-related faults for S8800 server are as follows:
• Power Overload
• Main Power Fault
• Power Control Fault
• Drive Fault
• Cooling/Fan Fault
The RAID alarms for S8800 server are as summarized below:
Message Note
Drive Slot sensor Drive This message indicates that a drive has been removed. No
[0–9]+[^\-]*- Drive alarm message is generated when the drive is inserted.
Presented Deasserted
Drive Slot sensor Drive A predictive failure was detected. The drive will likely need to be
[0–9]+[^\-]*- Drive replaced.
Predictive Failure
Asserted
Drive Slot sensor Drive A critical failure was detected. The drive will likely need to be
[0–9]+[^\-]*- In Critical replaced.
Array Asserted
Drive Slot sensor Drive The device has failed. The drive will likely need to be replaced.
[0–9]+[^\-]*- In Failed
Array Asserted
Message Note
Drive Slot sensor Drive The rebuild has failed.
[0–9]+[^\-]*- In Rebuild
Abort Asserted
For S8300D
System Platform does not monitor hardware on the S8300D server.
In the “Alarm text” column, <vm> is the virtual machine's name as it appears in the System
Platform Management Console under the Virtual Machine Management page.
Performance faults
Alarm text Problem/Action
VSP High CPU Usage Check <vm>
detected for <vm> This may require troubleshooting within the virtual
machine.
VSP High Webconsole heap Check Webconsole is OK.
usage
VSP High Network I/O (Tx) Check <vm>
from for <vm> This may require troubleshooting within the virtual
machine.
VSP High Network I/O (Rx) Check <vm>
from for <vm> This may require troubleshooting within the virtual
machine.
VSP High Load Average <vm> Check <vm>
This may require troubleshooting within the virtual
machine.
VSP Low logical volume free Free some space on logical volume <lv>
space <lv> This may require troubleshooting within the virtual
machine.
VSP Low volume group free Free some space on volume group VolGroup00 in dom0.
space (VolGroup00) This may require troubleshooting within the virtual
machine.
VSP High disk read rate on From dom0, check the device sda.
disk (sda)
VSP High disk write rate on From dom0, check the device sda.
disk (sda)
VSP High Webconsole Log in to the System Platform Management Console.
permgen usage Click Virtual Machine Management > Manage.
Click the cdom link.
Click Reboot.
Note:
If unable to log in to System Platform Management
Console, use the xm reboot command while logged
in to dom0.
VSP High Webconsole open Log in to the System Platform Management Console.
files Click Virtual Machine Management > Manage.
Click the cdom link.
Click Reboot.
Note:
If unable to log in to System Platform Management
Console, use the xm reboot command while logged
in to dom0.
VSP High SAL Agent heap Log in to the System Platform Management Console.
usage Click Virtual Machine Management > Manage.
Click the cdom link.
Click Reboot.
Note:
If unable to log in to System Platform Management
Console, use the xm reboot command while logged
in to dom0.
VSP High SAL Agent permgen Log in to the System Platform Management Console.
usage Click Virtual Machine Management > Manage.
Click the cdom link.
Click Reboot.
Note:
If unable to log in to System Platform Management
Console, use the xm reboot command while logged
in to dom0.
High Memory Usage in Check Memory Usage in Domain-0.
Domain-0
High Memory Usage in cdom Check Memory Usage in cdom.
Example
change vlan -? shows the available options as explained below:
• -n Don't restart network
• -y Restart network without prompting
• -l List existing VLANs
• -f num Specify which VLAN ID to change
You can view the currently configured VLAN IDs by typing the command:
change vlan -l
You can change the current VLAN ID to new VLAN ID by typing the commands:
change vlan new_vlan_id
In the above command, the script prompts you to know whether the network should be restarted
immediately or not. You can suppress those prompts by appending -n or -y to the command.
While downloading files from PLDS, one can encounter one of the following errors:
Error message
The SSO user id and/or password are not valid.
Error establishing SSO session. Please check the log for additional information.
The provided SSO credentials are not authorized to access PLDS Web Services.
PLDS Web Services error. Please check the log for additional information.
Error accessing SSO URL.
Error accessing PLDS Web Service URL.
Error accessing SSO URL. Please verify that the proxy settings are correct.
Error accessing SSO URL due to an SSL problem.
Error accessing PLDS Web Service URL. Please verify that the proxy settings are correct.
Error accessing PLDS Web Service URL due to an SSL problem.
Error downloading from Akamai. Please verify that the proxy settings are correct.
Error accessing Akamai URL.
Error accessing Akamai URL. Please verify that the proxy settings are correct.
Error accessing Akamai URL due to an SSL problem.
No File Found in Avaya Downloads (PLDS) for this credential.
To resolve these errors, check or initialize the proxy settings, if the errors suggest to do so. You may also
contact Avaya Partners for support.
I P
installing Linuxshield on Console Domain ................102 password
installing Linuxshield on System Domain .................102 changing ..............................................................80
IP forwarding Patch Detail page
disabling ...............................................................12 field descriptions ..................................................28
enabling ...............................................................12 Patch List page