Escolar Documentos
Profissional Documentos
Cultura Documentos
Teradata Viewpoint
Installation, Configuration, and Upgrade Guide
for Customers
Release 15.10
B035-2207-035K
May 2015
The product or products described in this book are licensed products of Teradata Corporation or its affiliates.
Teradata, Active Data Warehousing, Active Enterprise Intelligence, Applications-Within, Aprimo Marketing Studio, Aster, BYNET,
Claraview, DecisionCast, Gridscale, MyCommerce, QueryGrid, SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, Teradata
ServiceConnect, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its
affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
Apache, Apache Avro, Apache Hadoop, Apache Hive, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks
of the Apache Software Foundation in the United States and/or other countries.
Apple, Mac, and OS X all are registered trademarks of Apple Inc.
Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda
Access, Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and
Maximum Support are servicemarks of Axeda Corporation.
Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.
GoldenGate is a trademark of Oracle.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other
countries.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, and z/OS are registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI is a registered trademark of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United
States and other countries.
NetVault is a trademark or registered trademark of Dell Inc. in the United States and/or other countries.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
Quantum and the Quantum logo are trademarks of Quantum Corporation, registered in the U.S.A. and other countries.
Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license.
SAP is the trademark or registered trademark of SAP AG in Germany and in several other countries.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
SPARC is a registered trademark of SPARC International, Inc.
Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States
and other countries.
Unicode is a registered trademark of Unicode, Inc. in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
The information contained in this document is provided on an "as-is" basis, without warranty of any kind, either express
or implied, including the implied warranties of merchantability, fitness for a particular purpose, or non-infringement.
Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. In no
event will Teradata Corporation be liable for any indirect, direct, special, incidental, or consequential damages, including
lost profits or lost savings, even if expressly advised of the possibility of such damages.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are
not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features,
functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions,
products, or services available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or
updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this
information at any time without notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this
document. Please e-mail: teradata-books@lists.teradata.com
Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata
Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display,
transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis.
Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose
whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback.
Table of Contents
Preface.............................................................................................................................................................7
Purpose.................................................................................................................................................................. 7
Audience................................................................................................................................................................ 7
Revision History................................................................................................................................................... 7
Additional Information........................................................................................................................................7
Related Links..................................................................................................................................................7
Related Documentation................................................................................................................................8
Customer Education..................................................................................................................................... 8
Product Safety Information.................................................................................................................................8
Chapter 1:
Overview........................................................................................................................................................9
Dependencies........................................................................................................................................................ 9
Supported Web Browsers..............................................................................................................................9
Supported Teradata Viewpoint Appliances................................................................................................ 9
Supported Teradata Database Versions...................................................................................................... 9
Ports Used by Teradata Viewpoint............................................................................................................ 10
Teradata Manager Feature Equivalence...........................................................................................................10
Teradata Viewpoint Services............................................................................................................................. 10
Starting and Stopping Teradata Viewpoint Services...................................................................................... 11
Interaction between Teradata Alerts and Teradata Database.......................................................................12
Notification Server Requirements....................................................................................................................12
Linux Server Requirements........................................................................................................................12
Windows Server Requirements..................................................................................................................13
Starting and Stopping the Teradata Notification Service (Windows)..........................................................13
Starting and Stopping the Teradata Notification Service (Linux)................................................................14
Chapter 2:
Upgrading Viewpoint Software............................................................................................ 15
About Upgrading Viewpoint Software.............................................................................................................15
Upgrading from Teradata Viewpoint 13.11.xx.xx, 13.12.xx.xx, or 14.00.xx.xx................................... 15
Upgrading Teradata Viewpoint 14.01.00.00 or Later..............................................................................15
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Table of Contents
Creating an Incident............................................................................................................................................16
Finding the PUT Version Running on the System.......................................................................................... 16
Determining the Latest PUT Release................................................................................................................16
Downloading New PUT Packages.....................................................................................................................17
Installing and Upgrading PUT...........................................................................................................................18
Installing PUT...............................................................................................................................................18
Upgrading PUT............................................................................................................................................ 18
Checking for Space on the Node....................................................................................................................... 19
Creating a Target Directory................................................................................................................................19
Software Package Downloads.............................................................................................................................20
Downloading Software Packages................................................................................................................20
Verifying the Previous Database Backup..........................................................................................................21
Upgrading a Teradata Viewpoint Server...........................................................................................................21
Creating a Teradata User for Data Collection..................................................................................................22
Upgrading a Teradata Viewpoint Cluster......................................................................................................... 23
Troubleshooting a Failed Upgrade.................................................................................................................... 23
Chapter 3:
Installing Notification Services.............................................................................................25
Downloading the Teradata Alerts Notification Software...............................................................................25
Installing Teradata Notification Service for Windows....................................................................................25
Preparing for Installation of Notification Service.................................................................................... 25
Installing Notification Service Software on a Windows Server..............................................................26
Configuring the Teradata Viewpoint Server Location.............................................................................27
Setting Up the BTEQ Scripts and Run Program Executables.................................................................27
Installing Teradata Notification Service for Linux..........................................................................................28
Preparing for Installation of Notification Service for Linux...................................................................28
Installing Software on a Linux Server........................................................................................................ 28
Installing Teradata Notification Service Interactively............................................................................. 29
Service User............................................................................................................................................29
Configuring the Teradata Viewpoint Server Location.............................................................................30
Setting Up the BTEQ Scripts and Run Program Executables.................................................................30
Uninstalling the Teradata Notification Service................................................................................................31
Chapter 4:
Advanced Configuration Tasks...............................................................................................33
Configuring NTP Time Synchronization......................................................................................................... 33
Configuring LDAP for Teradata Viewpoint..................................................................................................... 33
Prerequisites.................................................................................................................................................. 34
4
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Table of Contents
Definitions....................................................................................................................................................34
Before You Begin LDAP Configuration................................................................................................... 35
Determining LDAP Configuration Mode................................................................................................35
Is the Username in DN?...................................................................................................................... 36
Determining the Number of Bind Patterns...................................................................................... 37
LDAP Servers...................................................................................................................................................... 37
About Auto-Provisioning and Role Mapping..........................................................................................38
Adding an LDAP Server............................................................................................................................. 38
LDAP Configuration Options....................................................................................................................39
Basic Configuration............................................................................................................................. 39
DN Pattern Bind...................................................................................................................................40
User Search............................................................................................................................................40
Key User Information.......................................................................................................................... 40
Auto-Provisioning................................................................................................................................41
Role Mapping Global Settings............................................................................................................ 41
Role Mapping Individual Settings......................................................................................................41
Changing a Teradata Viewpoint System Name...............................................................................................41
Resetting the Admin User Password................................................................................................................42
Portlets Enabled Under Special Circumstances............................................................................................. 42
Installing Teradata Data Lab............................................................................................................................. 42
Configuring Teradata Data Lab Email Notifications..............................................................................43
Configuring Teradata Viewpoint to Monitor a Managed Server..................................................................43
About Configuring Stats Manager....................................................................................................................44
Before You Begin......................................................................................................................................... 44
Configuring Stats Manager........................................................................................................................ 44
Configuring Teradata Database to Collect and Analyze Statistics...............................................................45
Collecting Statistics..................................................................................................................................... 45
Analyzing Statistics..................................................................................................................................... 45
Cleaning Up the TDStats Database...........................................................................................................45
Teradata Viewpoint Server Clustering Configurations..................................................................................46
High Availability Configuration: Two Teradata Viewpoint Servers..................................................... 46
High Usage Configuration: Three or More Teradata Viewpoint Servers............................................. 47
Advanced Configuration: Three or More Teradata Viewpoint Servers With Dedicated Cache
Database Server.................................................................................................................................... 47
Teradata Alerts Cluster Configurations................................................................................................... 48
Failure Scenarios..........................................................................................................................................49
Teradata Viewpoint Failure Scenarios............................................................................................... 49
Data Collection Server Failure.............................................................................................49
Cache Database Failure.........................................................................................................49
Active Teradata Viewpoint Server Failure.......................................................................... 50
Teradata Alerts Failure Scenarios.......................................................................................................51
Alert Service Failure (Scenario 1)........................................................................................51
Messaging Service Failure (Scenario 2).............................................................................. 51
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Table of Contents
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Preface
Purpose
This guide provides customer information and procedures for configuring and maintaining
the Teradata Viewpoint server, as well as upgrading from and backing down to a previous
Teradata Viewpoint software version.
Audience
This guide is intended for use by:
System administrators
Database administrators and relational database developers
Customers
Teradata Customer Support
Revision History
Date
Release
Description
May 2015
15.10
April 2015
15.10
March 2015
15.10
Initial release
Additional Information
Related Links
URL
Description
http://tays.teradata.com
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Preface
Product Safety Information
URL
Description
www.teradata.com
Related Documentation
Documents are located at www.info.teradata.com.
Title
Publication ID
B035-5713
B035-2206
BCD0-0718-0000
Customer Education
Teradata Customer Education designs, develops and delivers education that builds adept
skills and capabilities for our data warehousing technology customers, enabling them to
maximize their Teradata investment. Teradata offers a variety of delivery formats to suit your
needs. The combination of web technology through the Teradata Education Network, along
with hands-on classroom training, provides each user level with a wide range of
opportunities to gain knowledge about our data warehousing tools.
Our flexible education options build upon and complement one another to give you a cost
effective, robust education offering. On this website, you can view and enroll in any Teradata
Customer Education training offering.
As the premier on-line learning environment for Teradata users, Teradata Education
Network (TEN) is a membership-based learning community that allows you to harness the
power of the internet and expand your knowledge of Teradata data warehousing tools at your
own pace ... anytime, anywhere.
If you do not have a membership that includes web-based training courses, you can purchase
courses at www.teradata.com/TEN/ or Teradata University.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
CHAPTER 1
Overview
Dependencies
Supported Web Browsers
Browser
Version
Mozilla Firefox
35
Internet Explorer
10 or 11
Google Chrome
40
Safari
Recommended Hardware
At least 1.8 GHz Pentium M, 3 GHz Pentium 4, or equivalent CPU
At least 1 GB of RAM
Monitor or display supporting at least 1024x768 resolution
Storage Capacity
415
617
Dell R710
819
Dell R720
13.10
14.0
14.10
15.0
15.10
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Chapter 1 Overview
Teradata Manager Feature Equivalence
22 (SSH)
80 (HTTP)
443 (HTTPS)
5432 (Cache Database)
8888 (Optional for monitoring Teradata Viewpoint server - tmsmonitor)
61616 (Teradata Alerting)
Outgoing
Alerts
25 SMTP (default)*
465 SMPT over SSL (default)*
162 SNMP Trap
*You can change the outgoing Teradata Alerts SMTP ports by selecting Delivery Settings >
Email in the Alert Setup portlet.
Option
Scheduling
Priority Scheduler
Administrator
10
Service
Description
camalert
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Chapter 1 Overview
Starting and Stopping Teradata Viewpoint Services
Service
Description
dcs
Data Collection Service that monitors and collects data from Teradata
systems
postgresql
tdnotification
Teradata Notification Service used to run BTEQ and Run Program alert
actions.
tdactivemq
tmsmonitor
viewpoint
Description
start
Starts the service. If the service is already running, a new instance is not started.
stop
Stops the service. The script completes successfully even when the service is not
running.
restart
status
The Teradata Viewpoint services that can use these commands are:
camalert
dcs
postgresql
tdactivemq
tmsmonitor
viewpoint
The following are examples of using the commands.
Action
Example
/etc/init.d/camalert start
/etc/init.d/viewpoint stop
/etc/init.d/postgresql restart
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
11
Chapter 1 Overview
Interaction between Teradata Alerts and Teradata Database
Action
Example
The vp-control.sh script, located in the same directory, allows you to run the start, stop,
restart and status commands. When running start, stop, or restart, the script performs the
specified action on the tdactivemq, camalert, tmsmonitor, dcs, and viewpoint services. When
running status, you receive the status of all commands for all the services including
postgresql.
/opt/teradata/viewpoint/bin/vp-control.sh command
Where command is the command you want to perform using the script.
This script supports the same command arguments as the individual init.d scripts.
12
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Chapter 1 Overview
Starting and Stopping the Teradata Notification Service (Windows)
Software Dependencies
Other Requirements
Other Requirements
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
13
Chapter 1 Overview
Starting and Stopping the Teradata Notification Service (Linux)
You can start, stop, pause, resume, or restart a service using the Services Administration tool
in Windows, which can be opened from a command prompt window by typing
services.msc.
Example
start
stop
/etc/init.d/tdnotification start
restart
Stops and restarts the service. To restart the tdnotification service, type:
/etc/init.d/tdnotification restart
status
14
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
CHAPTER 2
Action
13.11.xx.xx 13.12.xx.xx, or
14.00.xx.xx
14.01.00.00 or later
15
Creating an Incident
You must obtain an Incident number from Teradata at Your Service prior to performing any
software upgrades.
1 On your Windows PC, open a web browser and go to Teradata At Your Service at http://
Note: Click the green arrows to move forward or back in the selection screens.
Option
Description
Site
Priority
Product Area The area of the system where the issue is located or where work will be
performed.
Problem Type A list of Problem Types.
Synopsis
Description
The incident is added to the list of Incidents. The Status shows Pending (a blue circle)
until Customer Services accepts the incident, at which time the Status becomes Active (a
green circle).
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Service at http://tays.teradata.com.
4 In the Specify the type for PUT Packages section, select the following:
Field
Selection
Platform
Current
Current
5 Click Submit.
6 On the Teradata PUT screen, select PUTSRC, PUTTools, and TDput for download and
Selection/Entry
Download Type
Windows
No
User Name
Site ID
8 Click Submit.
9 Click Download.
10 Save the downloaded files and transfer them to the PUT Master Node:
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
17
click Save.
The package files are compressed into a single Windows .zip file.
Notice: The unzipped files are Linux files in the .gz or .rpm format. Never uncompress a
Linux .gz file on a Windows computer. Windows might corrupt the file.
e Use the Secure File Transfer Protocol (SFTP) utility to transfer the .gz or .rpm files to
the Master Node download directory and then uncompress the .rpm files (the .gz files
do not need to be uncompressed).
Note: Make sure you transfer the files using the binary mode, not the ASCII mode.
The .zip files are not needed on the Master Node and can be deleted from the
Windows system after the upgrade.
Installing PUT
1 To install PUT, follow the instructions in the Parallel Upgrade Tool (PUT) Reference.
Note: Make sure the version of PUT is the same on all nodes, including TMS servers.
Always use the latest version of PUT.
Upgrading PUT
This procedure copies PUT from the Master Node to all other nodes that need a new version
of PUT installed.
Notice: Do not choose any PUT operation other than the operation specified. Choosing any of the
PUT operations that are not specified in your task could result in severe damage to user data.
1 Start PUT on the Master Node (if it is not already started).
2 In the main screen, select Install/Upgrade PUT and click Next.
3 In the Network Subnet Selection screen, select byn1 and click Next.
4 In the Select Nodes screen:
18
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
If any nodes are missing, you will not be able to continue with this upgrade and
should open an incident.
b Select and move the desired nodes from the Available column to the Selected
c Click Next.
5 In the Choose Software Location screen, enter the source directory for the downloaded
PUT proceeds through the Gather PUT Package Info, Spool & Distribute PUT
Package, and Upgrade PUT Package screens which may take several minutes. No user
interaction is required here. When PUT reaches the Overall Package Install Results
screen, the package name and installation results are displayed.
6 Check the results of the installation and report any failures.
7 Click Next.
8 In the Finished! screen, click Finish.
PUT will complete the operation and return you to the main screen.
df -k
Example output:
Filesystem
/dev/sda2
udev
/dev/sda5
/dev/sda7
1K-blocks
9076396
4123416
2016016
37293996
Used
8580828
2528
312628
4112908
Available
34504
4020888
1600976
1286628
Use%
100%
1%
17%
12%
Mounted on
/
/dev
/var
/var/opt/teradata
In this example, the / drive has no available space. Contact your system administrator to
remove old files and free up space for the new packages. Teradata recommends that you
double the total the space required by the packages you are downloading.
following command:
mkdir -p /var/opt/teradata/ccnumber/pkgs
where the ccnumber is the Teradata Change Control Number, as shown in the following
example:
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
19
Description
a. Click Teradata.
b. Click Combined Certification List.
2 In the Certification List section of the left pane, click Current List.
3 In the Certification List area, make the appropriate selections as follows:
Field
Selection/Entry
Node Type
Target OSs
Application Version
Teradata Releases
N/A
BusType
SM3G
Select Yes or No
Selection/Entry
TESA Type
4 Click Submit.
5 Select all packages.
6 Complete the download request with the following choices:
20
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Selection/Entry
Download Type
Windows
No
User Name
Site ID
7 Click Submit.
8 When the .zip package is ready to download, click the Download button.
Optionally, you can save the patch for future use by selecting the Save the Patch for
future use box.
9 In the File Download dialog, click Save, navigate to the target directory, and click Save
again.
21
need attention (or correct any issues that need correcting), and click Ignore.
5 Accept the default selection in the Select Spool Area for Linux Nodes screen and click
Next.
6 In the Enter Source for New Packages screen, enter or select the path /var/opt/
teradata/packages/Viewpoint/Linux and click Next.
7 In the Media Source Confirmation screen, accept the default selections and click Next.
8 In the Group Nodes screen verify that the node displayed in the right panel has the
These values vary based on several factors, including the size of the Teradata Database
system, the level of activity on the Teradata Database system, and the amount of data
retained in the data dictionary tables queried by Teradata Viewpoint. For Teradata
systems of 50 nodes or fewer, the suggested allocations are 2 GB of perm space and 500
GB of spool space. For Teradata Database systems larger than 50 nodes, additional perm
and spool space might be required.
22
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
3 If the console user does not exist on the target Teradata Database system, run the
The IP address or server name of the primary cache database is listed after the
active.database.host key.
2 Stop the Teradata Viewpoint services on all of the servers except the primary server:
/opt/teradata/viewpoint/bin/vp-control.sh stop
If there are more than two Teradata Viewpoint servers in the cluster, the order in which
you stop the servers does not matter.
3 Upgrade the primary server.
4 Upgrade the remaining servers in the cluster.
5 If you upgraded from a version earlier than 14.01.00.00, use the cluster setup tool from
the primary server to re-establish the cluster by following the instructions in Creating a
Teradata Viewpoint Cluster.
This ensures that the software and PostgreSQL database are successfully upgraded.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
23
24
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
CHAPTER 3
http://tays.teradata.com
2 Select Certified Configs.
3 On the menu on the left, select Software Patches > Teradata Applications.
4 At Sub Category, select Common Alerting Mechanism.
5 At Release, select 15.10.
6 Click Submit.
7 Select the Notification Service package for Windows or Linux as needed.
8 At please enter the following information to download, enter your user name, email
9 Click Submit.
10 Click Download.
11 Extract the files from the downloaded archive.
12 Copy the files to the servers where the installation or upgrade is to be performed.
25
Description
Windows 7 operating
system
variable.
26
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Click Finish.
The software is installed at drive:\Program Files (x86)\Teradata\Client
\15.10\Teradata Notification Service
5 Remove the comment sign and assign cam.activemq.host to the Viewpoint server
27
location:
2 Launch TDPut on the Linux server and install the tdnotification1500 package onto
the server.
3 After the installation, manually configure the software with the location of the Viewpoint
server.
28
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
installation is interactive:
export CAM_INTERACTIVE_INSTALL=1
The service runs with the user id of the service user account. See Service User for more
information.
The software is installed in the following location:
/opt/teradata/client/15.10/cam/tdnotification
If you provided the name of the Viewpoint server, the software is now configured and
ready to start:
/etc/init.d/tdnotification start
Service User
The tdnotification installation process creates a new user which, as of release 14.10, can be
custom-defined during installation. If no user is defined, the system creates a default user
called camuser, with a default home account of /home/camuser. If the new user account
cannot be created with a home account, it is created without one. The camuser account is a
non-login account. The tdnotification service runs with the user ID--either custom-defined
or camuser-- instead of running as the root user.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
29
3 Change directory:
cd /opt/teradata/client/cam/tdnotification/config
6 Remove the comment sign and assign cam.activemq.host to the Viewpoint server
cam.activemq.host=serverName
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
permissions set for the service user (default is camuser) effective user ID for the
tdnotification service.
/opt/teradata/client/cam/sql
/opt/teradata/client/cam/usrcmd
account.
account.
Linux
If multiple versions of the Teradata Notification Service Package are installed in a Linux
environment, removing the primary version reverts all soft links to the next greatest
version installed. To uninstall all packages, use the command on each installed
tdnotification package.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
31
32
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
CHAPTER 4
server:
server host
cluster, excluding the current host, where address is the IP address of another
Teradata Viewpoint server:
peer address
33
When users are auto-provisioned, the administrator does not need to enter their account into
Teradata Viewpoint. LDAP validation works in conjunction with the Externally
Authenticated? flag on the Add User and Modify User dialog boxes in the User Manager
portlet. If the Externally Authenticated? check box is selected, the user is authenticated
through LDAP when logging in. The Externally Authenticated? check box is automatically
selected when a user is created using auto-provisioning. The first time these users log in to
Teradata Viewpoint, they are validated against the LDAP directory. If their credentials are
valid, a Teradata Viewpoint account is created for them.
Use the LDAP Servers portlet to:
Add and delete an LDAP configuration in Teradata Viewpoint
Enable and disable the LDAP after it has been added
Use the auto-provisioning feature to automatically add users to Teradata Viewpoint on
first login
Use the role mapping feature to position the new user in Teradata Viewpoint
Prerequisites
A basic understanding of LDAP
The URL of the LDAP server, for example, ldap://ldap.acme.com:389
The username and password of a user or availability of that user to test the configuration
Definitions
Lightweight Directory Access Protocol (LDAP)
Technically an application-protocol, LDAP is frequently used to refer to a directory
server such as Microsoft Active Directory or OpenLDAP.
LDAP Data Interchange Format (LDIF)
A standard, plain-text data interchange format for representing LDAP directory
content and update requests.
Distinguished Name (DN)
The full "path" to a user-entry in LDAP. Every user's DN is, by definition, unique. The
DN consists of its Relative Distinguished Name (RDN) constructed from some
attributes in the entry, followed by the parent entry's DN. Think of the DN as a full
file name and the RDN as a relative filename in a folder. In the following example,
the DN is the entire string.
cn=joec,OU=NorthAmerica,OU=User
Accounts,DC=td,DC=acme,DC=com
34
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
cn=joec,OU=NorthAmerica,OU=User
Accounts,DC=td,DC=acme,DC=com
Bind
Used for LDAP authentication, binding is an LDAP operation that authenticates a
username and a password.
Service Account
An LDAP service account is an account (username and password) not associated
with a user, but existing for the purposes of binding to LDAP to perform a search of
the directory. Typically, a service account is required when the DN of an
authenticating-user is unknown, and an LDAP search (based on some other attribute
of the user-entry such as sAMAccountName) must first be performed to determine
the user's DN. After the user's DN has been determined, a normal bind using the
user's DN and password is run.
Viewpoint Authenticator
Also referred to simply as the Authenticator, this component of Teradata Viewpoint
runs the authentication process against LDAP, among other actions.
The user-entry details for the user in LDAP Data Interchange Format (LDIF) form.
The following LDIF snippet is an example:
dn: cn=joec,dc=User Accounts,dc=acme,dc=com
cn: joec
givenName: Joe
sn: Customer
telephoneNumber: +1 888 555 6789
telephoneNumber: +1 888 555 1232
mail: [joe.customer@acme|mailto:joe.customer@acme].com
sAMAccountName: customerjoe
objectClass: inetOrgPerson
memberOf: cn=Sales,ou=Groups,dc=acme,dc=com
memberOf: cn=DBA,ou=Groups,dc=acme,dc=com
...
At least one other future Teradata Viewpoint user, preferably in a different region or
country.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
35
To bind to LDAP, Teradata Viewpoint authentication must know the DN of Joe Customer.
When logging in, Joe presents a corporate username, which is usually part of the DN. Using
the following DN as an example:
cn=<<USERNAME>>,dc=User Accounts,dc=acme,dc=com
1 If the corporate username for Joe is joec and the username is in the DN, perform a DN
pattern bind.
attribute from the LDIF snippet below, the username is not in the DN.
36
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
3 Search the LDAP tree for a user entry where the attribute matches the username value
After establishing Joe's DN and verifying that the username for Joe is part of the DN string,
bind to LDAP using the DN and password for Joe. As a reminder, following is the DN for
Joe:
cn=joec,dc=User Accounts,dc=acme,dc=com
1 Are all users in Joe's company located at the same Base DN in LDAP?
cn=joec,dc=User Accounts,dc=acme,dc=com
cn=janedoe,dc=Contractors,dc=User Accounts,dc=acme,dc=com
cn=kaizers,dc=Europe,dc=User Accounts,dc=acme,dc=com
If there are multiple DN patterns, the Teradata Viewpoint Authenticator iterates over
each of the patterns until it finds one that matches the username presented. If the
authenticator does not find a match, it fails to authenticate.
Note: if the number of patterns grows to seven or more, it might be faster to perform a
user search.
3 Select one of the following options in the LDAP Servers portlet:
If there are fewer than seven DN patterns, select the DN Pattern Bind option.
If there are seven or more DN patterns, select the User Search option.
LDAP Servers
The LDAP Servers portlet allows you to configure LDAP (Lightweight Directory Access
Protocol) servers to authenticate users and assign user roles in Teradata Viewpoint. The
LDAP Servers portlet displays the names of currently configured LDAP servers or is empty
if an LDAP server is not configured.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
37
next to Servers.
7 [Optional] Use
Select DN Pattern Bind and specify one or more patterns that represent a
distinguished name (DN) in the LDAP directory.
Example: cn={0},ou=Users,dc=teradata,dc=com, where {0} is replaced by the
username the user enters when logging in to Teradata Viewpoint.
Select User Search.
password.
If these fields are empty, the Viewpoint portal connects to the LDAP server
anonymously.
38
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Example: cn={0}, where {0} is replaced by the username the user enters when
logging in to Teradata Viewpoint.
c Enter a search base to specify a base directory for the search pattern.
Example: ou=Users,dc=teradata,dc=com
d [Optional] For Search Extent, select the Recursive scan check box to include
10 Under Key User Information, enter the LDAP attribute names for the user attributes:
Attribute
givenName
surname
11 [Optional] Under Settings Test you can test whether your settings are correct.
a Enter a username and password.
b Click Test.
appears.
If the test is successful, you receive the full DN and key user information for the user,
and if the test fails, you receive the error message returned from the LDAP server.
12 Click Apply.
The LDAP Servers view remains open for you to use the Advanced Options if you wish.
Description
Server Nickname
Enable server
URL
One or more URLs for this LDAP configuration. The URL must include
the appropriate protocol (ldap:// or ldaps://) as well as the port, for
example, ldap://ldap.acme.com:389. Enter more than one URL
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
39
Description
only if all of the URLs point to a similarly configured LDAP server. This
might be the case if you have replicated LDAP servers or a failover
LDAP server that should be used if the primary one is unreachable.
DN Pattern Bind
Attribute
Description
Pattern
DN patterns used to perform the LDAP user bind attempt. The patterns
are invoked in the order specified, so it is recommended that you put the
patterns that match the most users before those that match fewer users.
For example:
cn={0},OU=User Accounts,DC=acme,DC=com
User Search
Attribute
Description
Service Account DN
Service Account
Password
Search Pattern
LDAP attribute to match against the username when searching for a user
entry.
If the cn attribute is the username, set to (cn={0}).
If the sAMAccountName attribute is the username, set to
(sAMAccountName={0}).
Search Base
Entry that is the base of the subtree containing users. If not specified, the
search base is the top-level context. For example:
OU=User Accounts,DC=acme,DC=com
Search Extent
When the Recursive scan check box is selected, searches the entire
subtree rooted at the search base entry. Unselected, requests a singlelevel search including only the top level.
40
Attribute
Description
Name of the attribute on the LDAP user entry that specifies the first
name of the user (given name).
Name of the attribute on the LDAP user entry that specifies the last
name of the user (surname).
Name of the attribute on the user object that specifies the email address
of the user.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Description
Turn on autoprovisioning
Automatically assign
these roles
Description
Entry that is the base of the subtree containing groups. This field needs
to be specified only if role mappings of type Group are used.
Name of the attribute on the LDAP group entry that contains the DNs
of the users in the group.
When the Search subtree check box is selected, searches the entire
subtree rooted at the Group search base entry.
Unselected, requests a single-level search including only the top level.
This field needs to be specified only if role mappings of type Group are
used.
Description
Type
Attribute Name
LDAP Value
Value of the attribute specified in the Attribute name field that should
be mapped to the role specified in the Viewpoint role field.
Viewpoint Role
Related Topics
41
6 To exit the dcsadmin shell, type quit on the primary server and press Enter.
7 Restart the Teradata Viewpoint services for all nodes in the Viewpoint cluster:
/opt/teradata/viewpoint/bin/vp-control.sh start
click Next.
42
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Next.
6 In the Enter Source for New Packages screen, enter or select the path /var/opt/
teradata/ccnumber/pkgs and click Next.
7 In the Media Source Confirmation screen, enter or select the source for the new
8 In the Group Nodes screen, verify that the node displayed in the right panel has the
4 Open the Monitored Systems portlet from the Viewpoint server and add a new
managed server.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
43
The login name must be unique from the other logins already configured for the system
to allow overhead of statistics collection and analysis to be measured separately from
other Teradata Viewpoint monitoring overhead.
You also have the option to specify an account string and authentication mechanism.
7 [Optional] Click Test to verify that the login settings are correct.
If the operation is successful, appears. If the operation fails, appears. If you receive
an error, verify that the login credentials are valid and the host can be reached.
8 [Optional] Click Grant to provide Viewpoint data collectors with access to Teradata
9 Click Apply.
44
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
scope of a collect job, the statistics are not collected and an error is reported. Follow this step
to prevent these errors.
1 To grant TDStats permission to collect statistics on any databases you associate with a
Analyzing Statistics
Some analyze job options require that Teradata Database query logging (DBQL) features be
enabled. For the analyze job options that you plan to use, you must enable the associated
database feature prior to running the job.
1 Depending on which method you choose to evaluate statistics, select one of these
procedures:
Method
Procedure
and
Use DBQL
Evaluate stats to determine Enable query logging with the USECOUNT option for the objects
if they should be collected being analyzed.
or deactivated
Note: The query logging feature should be enabled, prior to
running the analyze job, for a period of time that is equal to the
period specified in the Recommend stats for deactivation when
inactive for option.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
45
Both Teradata Viewpoint instances point at the same a cache database on the active server.
The standby cache database is kept up-to-date with the last minute of data. The DCS service
runs on the active server, with a standby DCS service available on the standby server. Both
servers share a distributed cache to ensure that the state between the Teradata Viewpoint
portals remains consistent.
46
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
47
48
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Failure Scenarios
Teradata Viewpoint Failure Scenarios
The Teradata Viewpoint failure scenarios describe what can happen during a failure and any
actions you need to take.
Data Collection Server Failure
If the active data collection server (DCS) fails, the standby DCS automatically assumes data
collection, logs an error to TVI, and optionally sends out an email. When the standby DCS
detects that the active DCS is back online, it stops data collection and continues to operate in
standby mode.
If the DCS detects that the active cache database has failed, the DCS logs an error to TVI
and optionally sends out an email. The System Administrator can promote the standby cache
database, to become the active cache database and redirect all Teradata Viewpoint servers to
the new active cache database. After the standby server is promoted, the System
Administrator must set up a new standby cache database.
If the cluster is set up using the advanced configuration, stop the Teradata Viewpoint portal
on the new active cache database server so that it continues to run on a dedicated server.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
49
If the active Teradata Viewpoint server fails, the standby DCS detects that the active DCS and
cache database are both down and logs an error to TVI and optionally sends out an email
alert. The System Administrator can promote the standby cache database to the active cache
database and send a notification to all Teradata Viewpoint portals so that they are
automatically redirected to the new active cache database.
After the standby cache database is promoted, the System Administrator needs to set up a
new standby cache database.
If the cluster is set up using the advanced configuration, stop the Teradata Viewpoint portal
on the new active cache database server so that it continues to run on a dedicated machine.
50
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
The Teradata Alerts failure scenarios describe what can happen during a failure and any
actions you need to take.
Alert Service Failure (Scenario 1)
If an alert service fails, the secondary alert service does the following:
Automatically processes messages sent to the remote messaging service
Generates an alert exception indicating the alert service has failed
When the failed alert service is restored, the alert service does the following:
Relinquishes message processing when it detects the remote alert service is back online
Generates an alert exception indicating the alert service has been restored
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
51
If the active DCS fails, the standby DCS automatically takes control and establishes a
connection with the local messaging service. The alert service on the standby server
processes messages sent by the DCS to the local messaging service.
If the active cache database goes down, and a promotion of the standby cache database
occurs, the alert service is automatically redirected to the new active database cache.
52
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
This failover scenario is a combination of all the scenarios discussed previously. All
components are redirected to the secondary messaging service. The alert service
automatically continues to process alerts.
Note: The following diagram assumes the standby cache database has been promoted.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
53
Clustering Considerations
LAN or WAN
Although using a LAN is recommended, Teradata Viewpoint clusters can be set up over a
WAN. All the data collected by the active Teradata Viewpoint server is sent asynchronously
to the standby Teradata Viewpoint server. Depending on the number and activity of the
Teradata systems being monitored, the amount of data transferred has the potential of
approaching 1 GB an hour. Consider setting up a Teradata Viewpoint cluster spanning a
WAN only if there is adequate bandwidth available.
Load Balancing
To make all Teradata Viewpoint portals in a cluster appear as a single host and to protect
users from a single host failure, you can set up a third-party load balancer to split traffic
between the running Teradata Viewpoint portals.
Configuration of a third-party load balancer is outside the scope of this guide.
Setting Disk Capacity for the Standby Cache Database
The disk capacity available to different generations of Teradata Viewpoint servers might be
different. When clustering, if the active cache database has more disk capacity than the
standby cache database, set a disk quota so that the active cache database does not use up
more space than is available on the standby cache database.
1 To ensure that enough disk capacity is available to the cache database, run df -h /data.
2 If the capacity on the active cache database is greater than on the standby cache database,
run the following command on the active cache database server to limit the capacity used
(replace number of GBs with the limit, in Gigabytes, for the drive):
When Teradata Viewpoint detects a situation that requires the attention of a Teradata
Viewpoint Administrator, an email can be sent to a configured list of recipients. Emails are
sent for the following conditions:
Active DCS is down
Active DCS is restored
Active cache database is down
Active cache database is restored
Cache database replication is not working
Standby cache database is promoted
The list of email recipients can be configured at the time the cluster is created or modified at a
later time by selecting option 5 in the cluster setup tool. Email alerts are sent using the
configuration specified in the Alert Setup portlet.
You can test if the notifications are working by triggering an alert.
1 Stop the active DCS.
2 After 3 minutes, restart the DCS.
54
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
An email is sent for the active DCS that is failing and another one for the active DCS
that is recovering. The standby DCS must be up and running for the alerts to be sent.
Note: The cluster setup script used here clusters both Teradata Viewpoint and Teradata
Alerts servers.
1 Run the cluster setup script on the server that will host the active cache database:
/opt/teradata/viewpoint/bin/clustersetup.sh
2 Select option 1.
After the cluster setup script completes, the Notification Banner within the Teradata
Viewpoint portal appears, and the setup of the standby cache database is handled
automatically in the background. The server is added to the cluster, and all Teradata
Viewpoint services are restarted.
Related Topics
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
55
database:
/opt/teradata/viewpoint/bin/clustersetup.sh
5 When the setup script completes, you can tail the vpclustermonitor log file to ensure that
/opt/teradata/viewpoint/vpclustermonitor/logs/
vpclustermonitor.log
6 [Optional] Configure email alerts to provide notification when an automatic promotion
occurs.
Related Topics
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
database:
/opt/teradata/viewpoint/bin/clustersetup.sh
The cluster is disabled and each Viewpoint server points to its own local cache database
and performs its own data collection.
/opt/teradata/viewpoint/bin/clustersetup.sh
The clustersetup script ends with a statement that the status of the operation can be
viewed in the Viewpoint Portal notification area. Do not perform further activities until
you have seen the message that the operation has completed successfully.
3 [Optional] If you want to make the new cache database the active one:
a Log in to the Teradata Viewpoint server hosting the newly created cache database.
b Type the following command to promote the newly created cache database to active:
/opt/teradata/viewpoint/bin/promote.sh
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
57
All Viewpoint services in the cluster will be restarted automatically, resulting in a short
outage of the Teradata Viewpoint portal.
Cluster Enabling
The Teradata Notification Service may be running when a Viewpoint cluster is configured.
The service should initially be configured as the notification service for the server that is to
become the primary Viewpoint server.
After configuring the Viewpoint cluster, the Teradata Alerts components running on the
Viewpoint server are restarted in the new clustered configuration. The Teradata Notification
Service automatically detects the configuration change within five minutes and reconfigures
the service to operate in a clustered configuration.
Cluster Disabling
The Teradata Notification Service is aware of the two Viewpoint servers that are part of the
cluster configuration. The initial state of the primary and secondary Viewpoint servers is
maintained by the service.
After disabling the Viewpoint clustering, the Teradata Alerts components running on the
Viewpoint servers are restarted as two standalone Viewpoint servers. The Teradata
58
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
Notification Service automatically detects the configuration change within five minutes and
reconfigures the service as the Teradata Notification Service for the initial primary
Viewpoint server. If this is not the desired Teradata Alerts configuration, the service should
be manually configured with the location of the Viewpoint server.
59
Select the Enable backup check box to activate the backup process.
Clear the Enable backup check box to disable the automatic-backup process.
4 From the Daily Backup Time list, select the daily start time of the backup operation.
5 From the Keep Backups For list, select the number of days to retain the backup data.
6 Under Location, select one of the following options to set the location of the backup files:
Option
Description
Local
Network Backs up Teradata Viewpoint databases to a networked file server to prevent data loss
in the event of a catastrophic failure.
a.
The host is the IP address or DNS name of the networked file server.
b. Enter a Path to specify the absolute path name where the backups are stored on
the host system.
c.
For example, if you are running the command on Linux, it would look something
like this: mount <host>:<path>/path/to/local/mount/point
[Optional] Click Test to verify that the login settings are correct.
If the operation is successful, appears. If the operation fails,
the settings are correct and try again.
Note: You can click
appears. Verify
7 Click Apply.
The changes are saved and backup files are deleted when they are older than the
configured number of days.
b Install the backup application's client software in the following location, depending on
60
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
completed.
This ensures that you get the latest backed up data set and avoid resource contention.
For example, to uninstall the 14.01.00.00 version of the tddatalabsportlets package, run
the following command:
rpm -e tddatalabsportlets-14.01.00.00-1
Description
Configuration Data
only
Restores only the configuration data. Existing historical data is retained and
is not restored from backup.
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
61
Description
Configuration Data
only (into a clean
database)
Full Restore
a Copy the backup files to /data/backup on the Viewpoint server being restored.
b Ensure that the directory and file permissions within /data/restore are readable
If the restoration process failed, an error message is displayed instead of the success
message.
5 If the restoration process fails or is interrupted in any manner, fix the problem that
6 If you want the Teradata Notification Service to run on a Windows server, start this
service.
2 Validate that the script completed successfully by looking for the message: Restore or
migration performed successfully. If historical data is also
being restored or migrated, progress of this operation can be
viewed in the portal's notification bar.
If the restoration process failed, an error message is displayed instead of the success
message.
62
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
3 If the Teradata Notification Service is running on a Windows server, stop this service.
4 Restore the last successful backup of the Teradata Viewpoint databases.
The duration of this process varies depending on the size of the databases. If the
Teradata Viewpoint databases are in a clustered environment, perform the restore against
the primary database server.
service:
/etc/init.d/tdnotification stop
3 Stop all of the Teradata Alerts services on all Teradata Viewpoint servers. Also stop the
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
63
/etc/init.d/dcs stop
/etc/init.d/tmsmonitor stop
/etc/init.d/viewpoint stop
/etc/init.d/camalert stop
/etc/init.d/tdactivemq stop
4 Restore the last successful backup of the previous version of the Teradata Alerts database.
6 If the Teradata Notification Service for Linux is running on a Linux Server, uninstall the
tdnotification1500 package.
configure the previous version of the Teradata Notification Service for Windows.
a Move the programs from the usrcmd folder of the current version to the usrcmd
installation folder\Teradata\Client\version\Teradata
Notification Service\usrcmd
b Move the BTEQ scripts from the sql folder of the current version to the sql folder of
installation folder\Teradata\Client\version\Teradata
Notification Service\sql
c Start the previous version of the Teradata Notification Service on the Windows Server.
10 If the Teradata Notification Service for Linux was installed on a Linux Server, install the
b Start the previous version of the Teradata Notification Service on the Linux Server:
/etc/init.d/tdnotification start
11 Start the previous version of the Teradata Alerts services on all Teradata Viewpoint
64
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
/etc/init.d/camalert start
/etc/init.d/dcs start
/etc/init.d/tmsmonitor start
/etc/init.d/viewpoint start
For example, to uninstall the camportlets package, run the following command:
rpm -e camportlets
camportlets
camalert
tdactivemq
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10
65
66
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers, Release 15.10