Veritas NetBackup™ for

MySQL Administrator's
Guide

Windows and Linux

Release 8.1.1
Documentation version: 8.1.1

Legal Notice
Copyright © 2018 Veritas Technologies LLC. All rights reserved.

Veritas and the Veritas Logo are trademarks or registered trademarks of Veritas Technologies
LLC or its affiliates in the U.S. and other countries. Other names may be trademarks of their
respective owners.

This product may contain third-party software for which Veritas is required to provide attribution
to the third party (“Third-party Programs”). Some of the Third-party Programs are available
under open source or free software licenses. The License Agreement accompanying the
Software does not alter any rights or obligations you may have under those open source or
free software licenses. Refer to the Third-party Legal Notices document accompanying this
Veritas product or available at:

https://www.veritas.com/about/legal/license-agreements

The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Veritas Technologies
LLC and its licensors, if any.

THE DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED

CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. VERITAS TECHNOLOGIES LLC
SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN
CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS
DOCUMENTATION. THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS
SUBJECT TO CHANGE WITHOUT NOTICE.

The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, et seq.
"Commercial Computer Software and Commercial Computer Software Documentation," as
applicable, and any successor regulations, whether delivered by Veritas as on premises or
hosted services. Any use, modification, reproduction release, performance, display or disclosure
of the Licensed Software and Documentation by the U.S. Government shall be solely in
accordance with the terms of this Agreement.
Veritas Technologies LLC
500 E Middlefield Road
Mountain View, CA 94043

http://www.veritas.com

.
Technical Support
Technical Support maintains support centers globally. Technical Support’s primary
role is to respond to specific queries about product features and functionality. The
Technical Support group also creates content for our online Knowledge Base. The
Technical Support group works collaboratively with the other functional areas within
the company to answer your questions in a timely fashion.
Our support offerings include the following:
■ A range of support options that give you the flexibility to select the right amount
of service for any size organization
■ Telephone and/or Web-based support that provides rapid response and
up-to-the-minute information
■ Upgrade assurance that delivers software upgrades
■ Global support purchased on a regional business hours or 24 hours a day, 7
days a week basis
■ Premium service offerings that include Account Management Services
For information about our support offerings, you can visit our website at the following
URL:
www.veritas.com/support
All support services will be delivered in accordance with your support agreement
and the then-current enterprise technical support policy.

Contacting Technical Support

Customers with a current support agreement may access Technical Support
information at the following URL:
www.veritas.com/support
Before contacting Technical Support, make sure you have satisfied the system
requirements that are listed in your product documentation. Also, you should be at
the computer on which the problem occurred, in case it is necessary to replicate
the problem.
When you contact Technical Support, please have the following information
available:
■ Product release level
■ Hardware information
■ Available memory, disk space, and NIC information
 ■ Operating system
■ Version and patch level
■ Network topology
■ Router, gateway, and IP address information
■ Problem description:
■ Error messages and log files
■ Troubleshooting that was performed before contacting Technical Support
■ Recent software configuration changes and network changes

Licensing and registration

If your product requires registration or a license key, access our technical support
Web page at the following URL:
www.veritas.com/support

Customer service
Customer service information is available at the following URL:
www.veritas.com/support
Customer Service is available to assist with non-technical questions, such as the
following types of issues:
■ Questions regarding product licensing or serialization
■ Product registration updates, such as address or name changes
■ General product information (features, language availability, local dealers)
■ Latest information about product updates and upgrades
■ Information about upgrade assurance and support contracts
■ Advice about technical support options
■ Nontechnical presales questions
■ Issues that are related to CD-ROMs, DVDs, or manuals
Support agreement resources
If you want to contact us regarding an existing support agreement, please contact
the support agreement administration team for your region as follows:

Worldwide (except Japan) CustomerCare@veritas.com

 Contents

Technical Support ............................................................................................. 4

Chapter 1 Introduction to NetBackup for MySQL Agent .............. 9

About NetBackup for MySQL Agent ................................................... 9
Features of NetBackup for MySQL Agent .......................................... 10
The NetBackup for MySQL Agent package ........................................ 10
About the NetBackup for MySQL Agent License ................................. 11
NetBackup for MySQL Documentation .............................................. 11

Chapter 2 Installing NetBackup for MySQL Agent ...................... 12

Planning the installation of NetBackup for MySQL Agent ...................... 12

Verifying the operating systems and the platforms ............................... 13
Installing prerequisites of NetBackup for MySQL Agent ........................ 13
Post-installation requirements for NetBackup for MySQL Agent ............. 14
Describing the NetBackup for MySQL Agent package .......................... 15
Installing the NetBackup for MySQL Agent ........................................ 16
Authenticating the password ........................................................... 16
Uninstalling the NetBackup for MySQL Agent ..................................... 17

Chapter 3 Configuring NetBackup for MySQL Agent ................. 18

The nbmysql configuration file ......................................................... 18

Configuring NetBackup for MySQL backups with DataStore policies
........................................................................................... 20

Chapter 4 The NetBackup for MySQL backups and restores

........................................................................................... 22

About MySQL database backups .................................................... 22

Performing the MySQL backups ..................................................... 23
Validating the backup information .................................................... 24
Querying the backups ................................................................... 25
Deleting backup information from the NetBackup catalog ...................... 25
About NetBackup for MySQL restores .............................................. 26
Performing the restores for MySQL databases ................................... 26
Redirected restores ...................................................................... 27
 Contents 8

Disaster recovery ......................................................................... 28

Chapter 5 Troubleshooting for NetBackup for MySQL ............... 29

Troubleshooting errors for the NetBackup for MySQL Agent .................. 29

Appendix A The NetBackup for MySQL commands and

conventions ................................................................... 34
About NetBackup for MySQL commands ........................................... 34
About NetBackup for MySQL conventions ......................................... 35

Appendix B The NetBackup for MySQL commands ...................... 37

nbmysql -o backup ....................................................................... 38
nbmysql -o restore ........................................................................ 39
nbmysql -o query .......................................................................... 40
nbmysql -o delete ......................................................................... 41

Index .................................................................................................................... 42
 Chapter 1
Introduction to NetBackup
for MySQL Agent
This chapter includes the following topics:

■ About NetBackup for MySQL Agent

■ Features of NetBackup for MySQL Agent

■ The NetBackup for MySQL Agent package

■ About the NetBackup for MySQL Agent License

■ NetBackup for MySQL Documentation

About NetBackup for MySQL Agent

NetBackup for MySQL Agent extends the capabilities of NetBackup to include
backup and restore operations of MySQL databases. The agent is located on the
NetBackup client and supports the operations on standalone setups. The agent
supports MySQL version 5.5.5 and later.
The agent also supports to:
■ Validate the backup information.
■ Query backups.
■ Delete the backup information from the catalog files.
■ Redirect restore to a client different from that originally performed the backup.
 Introduction to NetBackup for MySQL Agent 10
Features of NetBackup for MySQL Agent

NetBackup for MySQL workflow

The agent reads the parameters from the nbmysql.conf file and then initiates the
operations. The nbmysql.conf file includes the parameters that you must set to
run the respective operations.
The agent communicates with the MySQL database to create a snapshot. The
Volume Shadow Copy Services (VSS) for Windows or Logical Volume Manager
(LVM) for Linux, takes a snapshot of the database.
The agent then interacts with the NetBackup XBSA interface to update the server
name, policy, and schedule type information. The NetBackupmaster server connects
to the NetBackup client to backup or retrieve the data that you want to protect. The
agent mounts the snapshot, copies the file, and sends it to the NetBackup XBSA
interface.
The NetBackup XBSA interface writes this data to the mounted media or disk storage
managed by the NetBackupmedia server.

Features of NetBackup for MySQL Agent

The Table 1-1 displays the features supported by the NetBackup for MySQL Agent.

Table 1-1 Features supported by NetBackup for MySQL Agent

Features Description

Backup The agent supports full instance backup of the MySQLdatabases.

Restore The agent supports full instance restores of MySQL backups.

Redirected restore The agent supports to restore MySQL backups to alternate NetBackup
clients.

The NetBackup for MySQL Agent package

The agent is packaged in NBMySQLAgent_8.1.zip file and is available on
my.veritas.com site.
package file includes the following platform files:
■ (Windows) NBMySQLAgent_8.1_AMD64/
■ (Linux RHEL) NBMySQLAgent_8.1_linuxR_x86/
■ (Linux SLES) NBMySQLAgent_8.1_linuxS_x86/
 Introduction to NetBackup for MySQL Agent 11
About the NetBackup for MySQL Agent License

About the NetBackup for MySQL Agent License

The NetBackup for MySQL Agent is installed on the NetBackup client software and
is not a separately licensed option of NetBackup. The NetBackup for MySQL Agent
is available to customers who are entitled with a valid license of the Application and
Database License Pack. In general, licensing of the NetBackup for MySQL Agent
follows the existing capacity licensing models for supported database agents.

NetBackup for MySQL Documentation

The NetBackup for MySQL Agent documentation is available at the following URL:
www.veritas.com/support/en_US/article.000127661
 Chapter 2
Installing NetBackup for
MySQL Agent
This chapter includes the following topics:

■ Planning the installation of NetBackup for MySQL Agent

■ Verifying the operating systems and the platforms

■ Installing prerequisites of NetBackup for MySQL Agent

■ Post-installation requirements for NetBackup for MySQL Agent

■ Describing the NetBackup for MySQL Agent package

■ Installing the NetBackup for MySQL Agent

■ Authenticating the password

■ Uninstalling the NetBackup for MySQL Agent

Planning the installation of NetBackup for MySQL

Agent
Table 2-1 lists the planning steps that are mandatory for installing the NetBackup
for MySQL Agent.
 Installing NetBackup for MySQL Agent 13
Verifying the operating systems and the platforms

Table 2-1 Installation steps for NetBackup for MySQL Agent

Step Action

Step 1 Verify the operating systems.

For more information, See “Verifying the operating systems and the platforms”
on page 13.

Step 2 Verify the prerequisites before you install the NetBackup for MySQL Agent.

For more information, See “Installing prerequisites of NetBackup for MySQL

Agent” on page 13.

Step 3 Install the NetBackup for MySQL Agent on your operating system.

For more information, See “Installing the NetBackup for MySQL Agent ”
on page 16.

Step 4 Authenticate the password for MySQL backups.

For more information, See “Authenticating the password” on page 16.

Verifying the operating systems and the platforms

Verify that the NetBackup for MySQL Agent is supported on your operating systems
and platforms.
The agent supports the operations on
■ Red Hat Enterprise Linux (RHEL) 6.8 and later
■ SUSE Enterprise Linux Server 11 SP3 and later
■ Microsoft Windows Server 2008 R2 and later
■ Microsoft Windows 8.1 and later

Installing prerequisites of NetBackup for MySQL

Agent
Verify the following prerequisites before you install the NetBackup for MySQL Agent:
■ NetBackup 8.1 is installed and operational on the master server, media server,
and the client.
■ The MySQL database is installed and operational on the client.
■ The MySQL instance is on the InnoDB storage engine.
 Installing NetBackup for MySQL Agent 14
Post-installation requirements for NetBackup for MySQL Agent

Post-installation requirements for NetBackup for

MySQL Agent
After you install the agent
■ (Windows) Configure the NetBackup for MySQL Agent to run with administrative
privileges.
■ (Windows) Add the NetBackup bin directory to the PATH user environment
variable.
■ (Linux) The user of the agent is a superuser or have superuser privileges.
■ (Linux) Symbolic link: If a symbolic link does not exists, create a symbolic link
libmysqlclient.so and ensure that it points to libmysqlclient.so.<n>,
where n is the MySQL client library version . You can create the symbolic link
at your chosen directory.
For example, if the MySQL client library version is 18, then the symbolic link
libmysqlclient.so points to libmysqlclient.so.18.

Note: Ensure that you update the MYSQL_LIB_INSTALL_PATH parameter in the

nbmysql.conf file with the absolute path of the symbolic link.

■ Set the following user privileges:

Table 2-2 User privileges

User Privileges

Backup LOCK TABLES, SELECT, FILE, RELOAD, SUPER, UPDATE, TRIGGER,

SHOW, VIEW, EXECUTE, and EVENT.

Restore CREATE, DROP, INDEX, SHUTDOWN, INSERT, ALTER, DELETE,

UPDATE, TRIGGER, SUPER, and CREATE VIEW.

To set the user privileges, run the following commands:

GRANT SELECT, INSERT, UPDATE, CREATE, DROP, RELOAD, SHUTDOWN, FILE,
INDEX, ALTER, SUPER, LOCK TABLES, CREATE VIEW, SHOW VIEW, TRIGGER,
CREATE ROUTINE, DELETE, EVENT, ALTER ROUTINE ON *.* TO
'USER'@'localhost' IDENTIFIED BY 'PASSWORD'

For more information, see MySQL Administration Guide

 Installing NetBackup for MySQL Agent 15
Describing the NetBackup for MySQL Agent package

Describing the NetBackup for MySQL Agent

package
The agent is packaged in the NBMySQLAgent_8.1.zip file and is available on
my.veritas.com site.
The package file includes the following platform files:
■ (Windows) NBMySQLAgent_8.1_AMD64/
■ (Linux RHEL) NBMySQLAgent_8.1_linuxR_x86/
■ (Linux SUSE NBMySQLAgent_8.1_linuxS_x86/
The platform files have the following directory structure:
(Windows) NBMySQLAgent_8.1_AMD64/ includes the following files:
■ NBMySQLAgent_8.1_AMD64/README.txt

■ NBMySQLAgent_8.1_AMD64/NBMySQLAgent.msi

■ NBMySQLAgent_8.1_AMD64/Setup.exe

■ NBMySQLAgent_8.1_AMD64/CAB1.CAB

(Linux RHEL) NBMySQLAgent_8.1_linuxR_x86/ includes the following files:

■ NBMySQLAgent_8.1_linuxR_x86/README

■ NBMySQLAgent_8.1_linuxR_x86/install

■ NBMySQLAgent_8.1_linuxR_x86/LICENSE

■ NBMySQLAgent_8.1_linuxR_x86/pkg.tar

(Linux SUSE) NBMySQLAgent_8.1_linuxS_x86/ includes the following files:

■ NBMySQLAgent_8.1_linuxS_x86/README

■ NBMySQLAgent_8.1_linuxS_x86/install

■ NBMySQLAgent_8.1_linuxS_x86/LICENSE

■ NBMySQLAgent_8.1_linuxS_x86/pkg.tar

When you install the agent, you have to accept the VERITAS LICENSE
AGREEMENT, to proceed installing the agent successfully.
The agent by default gets installed at the following locations:
■ (Windows) C:\Program Files\Veritas\NBMySQLAgent
■ (Linux RHEL and SUSE) /usr/NBMySQLAgent/
 Installing NetBackup for MySQL Agent 16
Installing the NetBackup for MySQL Agent

Installing the NetBackup for MySQL Agent

To install the agent on Windows
1 Extract the NBMySQLAgent_8.1_AMD64/ file contents to your chosen location.
2 Run the NBMySQLAgent_8.1_AMD64/Setup.exe.
3 Accept the VERITAS LICENSE AGREEMENT and then click Finish.
The agent gets installed at C:\Program Files\Veritas\NBMySQLAgent
location.
To install the agent on Linux (RHEL)
1 Extract the NBMySQLAgent_8.1_linuxR_x86/ file contents to your chosen
location.
2 Run the NBMySQLAgent_8.1_linuxR_x86/install file.
3 Type y to accept the VERITAS LICENSE AGREEMENT.
The agent gets installed at /usr/NBMySQLAgent/ location.
To install the agent on Linux (SUSE)
1 Extract the NBMySQLAgent_8.1_linuxS_x86/ file contents to your chosen
location.
2 Run the NBMySQLAgent_8.1_linuxS_x86/install file.
3 Type y to accept the VERITAS LICENSE AGREEMENT.
The agent gets installed at /usr/NBMySQLAgent/ location.

Authenticating the password

Authenticating the password keeps you from specifying the password every time
you run a backup. The my.cnf or the my.ini file stores the authentication
credentials that the agent reads when it connects to the MySQL Server. Ensure
that you store the password in the MySQL environment variable.
The MySQL utility to encrypt the password lets you set, reset, and validate the
password. The utility for password encryption uses the port number to create a
section name that corresponds to the instance to which the password belongs.
In MySQL v5.5.x, it reads the plain text authentication credentials from MySQL
configuration file my.cnf. To authenticate, under the client section, edit the my.cnf,
or my.ini file to add the password. For example:
[client]
 Installing NetBackup for MySQL Agent 17
Uninstalling the NetBackup for MySQL Agent

port=3306
password= type the password
In MySQL v5.6 and later, it reads the encrypted authentication credentials from the
MySQL options .mylogin.cnf file.
To authenticate the password
1 (Windows) Run the following command:
mysql_config_editor.exe set --login-path=<portnumber> --password

For example, if the portnumber is 3306:

mysql_config_editor.exe set --login-path=3306 --password

2 (Linux) Run the following command:

mysql_config_editor set --login-path=<portnumber> --password

For example, if the portnumber is 3306:

mysql_config_editor set --login-path=3306 --password

3 To reset the password, run the command that applies to your operating system:
■ (Windows) mysql_config_editor.exe reset
■ (Linux) mysql_config_editor reset

4 To validate the password, run the command that applies to your operating
system:
■ (Windows) mysql_config_editor.exe print --all
■ (Linux) mysql_config_editor print --all

Uninstalling the NetBackup for MySQL Agent

To uninstall the agent
1 (Windows) From the Control Panel, right-click the
NBMySQLAgent_8.1_AMD64/file and Uninstall the agent.

2 (Linux RHEL) To uninstall, delete the NBMySQLAgent_8.1_linuxR_x86/ directory

from the installed location.
3 (Linux SUSE) To uninstall, delete the NBMySQLAgent_8.1_linuxS_x86/
directory from the installed location.
 Chapter 3
Configuring NetBackup for
MySQL Agent
This chapter includes the following topics:

■ The nbmysql configuration file

■ Configuring NetBackup for MySQL backups with DataStore policies

The nbmysql configuration file

The NetBackup for MySQL configuration file (nbmysql.conf) contains the
parameters for the respective operations. It contains predefined settings and is
located on the client. You can configure the parameters in the nbmysql.conf file
or provide them on the command line, where the command line parameters take
precedence. The nbmysql.conf file keeps you from providing the parameters
every time you run operations. When parameters are not configured in the
nbmysql.conf file, then the default parameter value takes precedence.

The nbmysql.conf file is located in the following locations:

■ (Windows) install_path\NBMySQLAgent_8.1_AMD64\nbmysql.conf .
■ (Linux (RHEL) install_path/NBMySQLAgent_8.1_linuxR_x86/nbmysql.conf.
■ (Linux SUSE) install_path/NBMySQLAgent_8.1_linuxS_x86/nbmysql.conf.
Table 3-1 lists the nbmysql.conf parameters.
 Configuring NetBackup for MySQL Agent 19
The nbmysql configuration file

Table 3-1 The nbmysql.conf parameters

Parameters Description Required Default value

parameter for

DB_USER Configures the MySQL database Backup and restore When you do not set the
user name. and when not specified, operations. database user name, it
then the default value is "root". defaults to root.

DB_PORT Configures the MySQL database Restore operations When you do not set this
server port number on which the database server port, it
backup or the restore should be defaults to 3306.
performed.

MYSQL_LIB_INSTALL_PATH Configures the Backup operations No default value for this

libmysql.dll//libmysqlclient.so parameter.
binary path. On Windows, the
library directory is at MySQL server
installed path. On Linux, run the
libmysqlclient command to
locate the library path.

NETBACKUP_MASTER_SERVER Specifies the NetBackup master Backup operations No default value for this
server to run backups and restores. parameter.

NETBACKUP_POLICY_NAME Specifies the NetBackup DataStore Backup operations No default value for this
policy name. parameter.

NETBACKUP_SCHEDULE_NAME Identifies the backup schedule that Backup operations No default value for this
you configured while creating the parameter.
DataStore policy.

NETBACKUP_CLIENT_NAME Defines the NetBackup MySQL Redirected When you do not set the
client name. restores and query NetBackup client, it
backups. defaults to the NetBackup
master server.

SNAPSHOT_SIZE (Linux) Specifies the snapshot size LVM backups When you do not set the
in kilobytes, megabytes, or snapshot size, it defaults
gigabytes as K, M, or G to MB.
respectively. If you do not specify
a measurement, the default
measurement is M (megabytes).

COPY_ID Represents the backup image To query, restore, No default value for this
name. You can use this value to or delete a backup parameter.
query, restore, or delete a specific using its backup
backup. image name.
 Configuring NetBackup for MySQL Agent 20
Configuring NetBackup for MySQL backups with DataStore policies

Table 3-1 The nbmysql.conf parameters (continued)

Parameters Description Required Default value

parameter for

MYSQL_TARGET_DIRECTORY Specifies the destination directory Restore backups. No default value for this
where you want to restore the parameter.
backups.

NBMYSQL_LOG_LEVEL The NBMYSQL_LOG_LEVEL lets The log levels help When you do not set
you set the logging level for the to control the nbmysql log level, it
NetBackup MySQL logs. The amount of defaults to level 1.
default value is 1. For a particular information that
logging level, all details at that level you want to
or lower are logged. access, when
troubleshooting
The MySQL debug logs includes
errors.
the following verbose levels:

■ 1 – ERROR: Conditions that

should be corrected, such as
configuration errors.
■ 2 – WARN: Conditions that are
not errors, but that might
require special handling.
■ 3 – INFO: Informational
messages
■ 4 – DEBUG: Debugging the
messages that is used for
troubleshooting.

NBMYSQL_LOG_SIZE Configures the nbmysql.conf You can specify When you do not specify
log size in MB. When the log the value according the nbmysql log size, it
reaches the specified size, it to the events that defaults to 10MB.
overwrites the log information. you want to write
into the logs.

Configuring NetBackup for MySQL backups with

DataStore policies
The agent uses the DataStore policies to define the attributes, schedules, clients
list, and backup selections.
 Configuring NetBackup for MySQL Agent 21
Configuring NetBackup for MySQL backups with DataStore policies

To configure MySQL database backups with DataStore policies, complete the

following steps:
1 Log on to the master server as an administrator (Windows) or root (Linux).
2 In the NetBackup Administration Console, expand NetBackup Management,
and then click Policies.
3 In All Policies pane, right-click Summary of All Policies, and then click New
Policy.
4 In Add a New Policy dialog box, enter a unique name for the policy.
5 In the Change Policy dialog box, select Data Store Policy from the Policy
Type drop-down list.
6 From the Policy Storage list, select the disk-based storage unit for storage.
7 To select the schedule type, under the Schedules tab, click Ok to select the
Default Application Backup schedule type.

Note: The XBSA framework supports the Default Application backup schedule
type only.

8 In the Clients tab, click New, and then add the NetBackup client that has the
NetBackup for MySQL Agent.
9 In the Add Client screen, click New, and then in the Client Name field, type
the name of the client.
10 In the NetBackup Administration Console, click NetBackup Management>
Policies to view the policy in the existing policies list.
11 Verify the parameters in nbmysql.conf before you run the backup operation
or specify them on the nbmysql command line.
For more information, See “The nbmysql configuration file” on page 18.
 Chapter 4
The NetBackup for MySQL
backups and restores
This chapter includes the following topics:

■ About MySQL database backups

■ Performing the MySQL backups

■ Validating the backup information

■ Querying the backups

■ Deleting backup information from the NetBackup catalog

■ About NetBackup for MySQL restores

■ Performing the restores for MySQL databases

■ Redirected restores

■ Disaster recovery

About MySQL database backups

The nbmysql command initiates the backup operation using the -S, -P, -s and -l
as required parameters. The parameter -z is the required parameter for LVM
configured systems.
The parameter -p and -u are the optional parameters.
Configure these parameters in the nbmysql.conf file or specify on the nbmysql
command line, where the parameters provided on the command line takes
precedence.
 The NetBackup for MySQL backups and restores 23
Performing the MySQL backups

Figure 4-1 NetBackup for MySQL backup workflow

Connect to the MySQL database

and prepare to take a snapshot.
1

MySQL
Database server Sends MySQL
data for back up
Requests snapshot, reads and NetBackup
mounts snapshot, reads the 3 NetBackup
MySQL agent
MySQL data master server
2 5
Snapshot Back up status is
creation returned

NetBackup
media server
NetBackup client

NetBackup XBSA
MySQL data
VSS/LVM Snapshot 4 is backed up

Storage unit

Performing the MySQL backups

This topic lists the prerequisites, describes the procedure to run MySQL backups,
and the information to schedule the backup from the NetBackup Administration
Console.

Prerequisites
Before you run the backup, ensure that you meet the following prerequisites.
■ (LVM users) Ensure that MySQL data and logs directory reside on the logical
volumes.
■ Configure the DataStore policy from the NetBackup Administration Console.
■ Add the database parameters and library path in the nbmysql.conf file.
 The NetBackup for MySQL backups and restores 24
Validating the backup information

■ Verify that there is enough space for the snapshot in the volume group, and
then set the snapshot size in nbmysql.conf file or by the command line.

Note: Ensure that the snapshot size is 50% more than the instance size that
you want to backup.

■ Verify that the prerequisites and the post-installation requirements are met.
For more information, See “Installing prerequisites of NetBackup for MySQL
Agent” on page 13.
For more information, See “Post-installation requirements for NetBackup for
MySQL Agent ” on page 14.
To run the backup
1 Run the following command:

nbmysql -o backup
-S master_server_name
-P policy_name
-s schedule_name
-l mysql_lib_path
-z snapshot_size
[-p database_server_port]
[-u database_username]

2 (Optional) Type the password, when the nbmysql command line prompts for
the password.

Scheduling MySQL backups from NetBackup

You can schedule MySQL backups from NetBackup Administration Console
using the DataStore policy to call a backup script.
For more information, https://www.veritas.com/support/en_US/article.100041374

Validating the backup information

After a successful MySQL backup, you can list the backups and verify the backup
information using the following command:
nbmysql -o query
 The NetBackup for MySQL backups and restores 25
Querying the backups

Querying the backups

The nbmysql query command lists the backup files according to the options that
you specify. The parameter -S is the required parameter. Alternatively, you can
use the -C client_name and -P policy_name options to define a different client
and policy.
You can configure the parameters from the nbmysql.conf file or set the parameters
using the nbmysql command. By default, NetBackup uses the values that you have
configured in the nbmysql.conf file.
For example, to query a backup from the client ClientA, run the following command:
nbmysql -o query -S master_server_name [-C ClientA]

For example, to list backup files with the policy name policy_name, run the following
command:
nbmysql -o query -S master_server_name [-P policy_name]

For example, to query a backup from the client Client A with policy name
policy_name, run the following command:

nbmysql -o query -S master_server_name [-C ClientA] [-P policy_name]

Deleting backup information from the NetBackup

catalog
The nbmysql delete command, removes the backup information from the catalog
files but retains the backup files on the NetBackup media server.
The parameter -S is the required parameter. Alternatively you can use the -i option
to delete a backup using its backup image name.
By default, NetBackup uses the values that you have defined in the nbmysql.conf
file.
To delete the MySQL backup information
1 Configure the parameters, in the nbmysql.conffile or set them on the command
line.
2 Run the following command:
nbmysql -o delete -S master_server_name [-i copy_id].
 The NetBackup for MySQL backups and restores 26
About NetBackup for MySQL restores

About NetBackup for MySQL restores

When you initiate a restore, the NetBackup XBSA interface reads the progress files
to receive the MySQL backup files to restore them to the target directory. Before
you run a restore, ensure that the target directory is empty.

Figure 4-2 NetBackup for MySQL restore workflow

Read progress
file
2

Progress file

Restore
NetBackup Initiate restore
MySQL data
NetBackup
MySQL agent 1
4 master server

MySQL
3
Database server Retrieve data
to restore

NetBackup
media server
NetBackup client
NetBackup XBSA

Storage unit

The parameter-S, t, and -p are required parameters. Alternatively, you can choose
to restore using the optional values -i as the backup image name and -C to restore
from a specified client name.

Note: The restore fails when the target directory is invalid or not empty. Ensure
that you delete all contents of the target directory before you initiate the restore.

Performing the restores for MySQL databases

This topic lists the prerequisites and describes the procedure to restore the backups.
 The NetBackup for MySQL backups and restores 27
Redirected restores

Prerequisites
Before you restore the backups, you must meet the following prerequisites:
■ Ensure that you restore the MySQL instance to an empty target directory.
■ Ensure that the target directory is a valid instance directory.
■ (Non-LVM) Ensure the MySQL services are running.
To restore the backups
1 Configure the parameters in the nbmysql.conf file, or specify them using the
nbmysql command.

For more information, See “The nbmysql configuration file” on page 18.
2 Verify that the MySQL services are running for Non-LVM restores.
3 Run the following command:
nbmysql -o restore -S master_server_name -t target_directory -p
db_port [-i copy_id] [-C client_name]

Redirected restores
A redirected restores lets you restore backup files to a client different from the client
that originally performed the backup. The new location can be a different host or a
different file path using a different name for the redirected restore. To redirect a
restore to a different host, include the destination client name in the
install_path\NetBackup\db\altnames directory.

Performing redirected restores

To redirect a restore to a different host
1 Update the nbmysql.conf file with the NetBackup client name as the host and
the MySQL target directory as the directory where you want to redirect the
restore.
2 On the NetBackup master server, create an altnames directory for the host
that you want to have permission to perform the redirected restore. For example,
to give Host B permissions to restore from another host, create the following
file:
■ (Windows) install_path\NetBackup\db\altnames\HostB
■ (Linux RHEL and SLES) /usr/openv/netbackup/db/altnames/HostB
 The NetBackup for MySQL backups and restores 28
Disaster recovery

3 In the altnames directory, add the names of the client(s) whose files the
requesting client wants to restore. For example, if you want Host B to have
permissions to redirect restores from Host A, add Host A to the Host B file.
4 Run the following command:
nbmysql -o restore -S master_server_name -t target_directory -p
db_port [-i copy_id] [-C client_name]

5 After a successful redirected restore, undo the changes that you made on the
master server and the client.
To redirect a restore to a different file path
1 Run the following command:
nbmysql -o restore -S master_server_name -t target_directory -p
db_port [-i copy_id] [-C client_name]

2 After a successful restore, make the following changes:

■ (Linux) To change the ownership of the files and directories to MySQL, run
the following command:
$chown -R mysql <data_dir>
$chgrp -R mysql <data_dir>

3 Copy the restore data to the data directory.

Disaster recovery
Disaster recovery is a plan to recover the data that can get lost in a disaster event.
The NetBackup for MySQL agent uses redirected restore as a disaster recovery
strategy.
For more information, See “ Redirected restores ” on page 27.
 Chapter 5
Troubleshooting for
NetBackup for MySQL
This chapter includes the following topics:

■ Troubleshooting errors for the NetBackup for MySQL Agent

Troubleshooting errors for the NetBackup for

MySQL Agent
To troubleshoot problems, you can refer to the logs that are specific to NetBackup
for MySQL Agent, NetBackup XBSA, or set the verbose logging levels in the
nbmysql.conf file. The logs are located at the following locations:

The NetBackup logs are located at:

■ install_path\NetBackup\logs\bprd

■ install_path\NetBackup\logs\bpcd

■ install_path\NetBackup\logs\user_ops\dbext\logs

The logs that are specific to NetBackup for MySQL Agent is located at:
install_path\nbmysql.log

The logs that are specific to NetBackup XBSA is located at:

<NetBackup_install_path>/netbackup/logs/extrn_client.

Preliminary steps
Verify the following, before you troubleshoot the problems:
■ All the prerequisites are completed.
■ All the computers have compatible operating system versions.
 Troubleshooting for NetBackup for MySQL 30
Troubleshooting errors for the NetBackup for MySQL Agent

■ The debug logs and reports are verified for errors.

Troubleshooting NetBackup problems

For troubleshooting NetBackup problems, refer to the Veritas NetBackup
Troubleshooting Guide and the Veritas NetBackup Commands Reference Guide.

Troubleshooting NetBackup for MySQL operations

Table 5-1 Troubleshooting NetBackup for MySQL backups and restores

Problems Description Solution

The nbmysql backup fails The nbmysql backup may fail for For a successful backup, complete any of the
with the following error: any of the following reasons: following:

An error has occurred during ■ The NetBackup media server ■ Upgrade the media server or client to use
backup or client runs on NetBackup 8.0 NetBackup 8.1 or later versions.
or earlier versions. ■ In NetBackup Administration Console, under
■ The check box for Enable in Security Management > Global Security
secure communication with Settings, select the Enable in secure
NetBackup8.0 and earlier communication with NetBackup 8.0 and
hosts is disabled earlier hosts check box.
■ The NetBackup host ID ■ Verify the NetBackup host ID certificate. You
certificate that exists on the can manually obtain the host ID certificate. For
MySQL client is invalid. more information, see
www.veritas.com/support/en_US/article.000127129

The nbmysql agent fails to The MySQL agent displays an error When the agent fails to initiate operations due to
initiate any operation. that is related to absence of the absence of the I18N file, copy the language file
I18N file. You may encounter this in the agent installer location and then run the
problem when you launch the operations.
NetBackup MySQL Agent.

The nbmysql backup fails You may encounter this problem Verify the following and then run the backup again:
with the following error: when the nbmysql.conf file is not
■ Add or update the MySQL library file location
updated with the following:
Unable to load MySQL library in the nbmysql.conf file.
■ MySQL library file location. For more information, See “The nbmysql
■ The configuration file” on page 18.
MYSQL_LIB_INSTALL_PATH ■ Ensure that the MYSQL_LIB_INSTALL_PATH
does not point to is set to the absolute path of the symbolic link.
libmysqlclient.so.<n> ■ Create a symbolic link libmysqlclient.so
that points to the libmysqlclient.so.<n>
version.
For more information, See “Post-installation
requirements for NetBackup for MySQL Agent
” on page 14.
 Troubleshooting for NetBackup for MySQL 31
Troubleshooting errors for the NetBackup for MySQL Agent

Table 5-1 Troubleshooting NetBackup for MySQL backups and restores

(continued)

Problems Description Solution

The nbysql backup fails with The nbmysql backup fails if the To add the appropriate database user name and
the following error message: nbmysql.conf includes an invalid port number
database user name and the port
Unable to connect to the ■ Configure the appropriate database user name
number.
database and port number in the nbmysql.conf file or
provide the appropriate options with the
nbmysqlcommand.
For more information, See “The nbmysql
configuration file” on page 18.
■ If the backup fails again, verify if the MySQL
services are running.

The nbmysql backup fails The nbmysql backup fails if the To run a MySQL backup successfully
with the following error: environment variable path is not
■ Update the environment variable path with
updated with NetBackup bin
Unable to load xbsa.dll NetBackup_install_path/bin.
directory.

The nbmysql backup fails The nbmysql backup fails if the To run the MySQL backup successfully
with the following error: nbmysql.conf file is not updated
■ Configure the valid master server name, policy
with the required parameters.
XBSA initiation failed name, schedule type in the nbmysql.conf
file or from the command line.
For more information, See “The nbmysql
configuration file” on page 18.
■ Verify if there are communication errors
between the MySQL agent and the NetBackup
master server. For more information see the
NetBackup Administration guide.
 Troubleshooting for NetBackup for MySQL 32
Troubleshooting errors for the NetBackup for MySQL Agent

Table 5-1 Troubleshooting NetBackup for MySQL backups and restores

(continued)

Problems Description Solution

The nbmysql backup on The nbmysql backup fails during To unmount the snapshot
Linux (LVM), fails with the an attempt to unmount the
1 List all mounted file systems using the
following error: snapshot, the device, or when you
following command:
remove the existing snapshots.
Error unmounting the
$ mount-l
snapshot-Device or resource
busy 2 If the snapshot still exists, create a mount
directory using the following command:
OR
$mount<mount_directory>
Error removing the
snapshot-mysqlsnap_<timestamp> Note: This directory is created in
/mnt/<snapshot_name>. The prefix names
Note: <timestamp> is the
for snapshot are mysqlsnap.
LVM snapshot time
3 To remove the mount directory run the
following command:

$rm -rf <mount_directory>

4 To remove the snapshot manually run the

following command:

1vremove -f
<volume_group>/<snapshot_name>

Error messages after a The nbmysql backup gives these To remove the snapshots
successful backup: errors when the volume group
1 Run the following command to list the existing
contains the snapshots. You can
<volume_group>/<snapshot_name> snapshots::
list the snapshots and then remove
Read failure after 0 of 4096
them before you run the backup $lvs
at 29393616896: input or
again.
output error. The command displays the snapshot details.

OR 2 Run the following command to delete the

snapshots:
<volume_group>/<snapshot_name>:
read failure after 0 of 4096 at $ lvremove -f
4096: input or output error. <volume_group>/<snapshot_name>
 Troubleshooting for NetBackup for MySQL 33
Troubleshooting errors for the NetBackup for MySQL Agent

Table 5-1 Troubleshooting NetBackup for MySQL backups and restores

(continued)

Problems Description Solution

The nbmysql backup fails The nbmysql backup may fail To verify the space in the volume group
with the following error: when the volume group does not
1 Run the following command to view the
have sufficient space for the
(Linux)Error creating LVM volume group details:
snapshot.
snapshot
$vgs

2 Update the nbmysql.conf file with the

appropriate snapshot size.

Verify that the snapshot is equivalent to or

more than the instance size.

(Windows)VSS snapshot The nbmysql backup may fail Run cmd.exe in Administrator mode.
creation failed when the user does not have the
privileges to run the nbmysql
operations.

The nbmysql restore The nbmysql restore fails if the Add or update the NetBackup client name in the
operation does not restore nbmysql.conf file is not updated nbmysql.conf file.
any data from the target with the NetBackup client name.
For more information, See “The nbmysql
NetBackup client.
configuration file” on page 18.

The nbmysql restore is The nbmysql restore fails if the For a successful restore
unsuccessful when you target directory is invalid or not
■ Verify that the target directory is a valid and
trigger from the target client. empty for restores.
empty.
The restore may also fail, when you ■ Initiate the restore from the NetBackup source
initiate a redirected restore from the client.
NetBackup target client instead of
the NetBackup source client.

Exception error during The nbmysql restores and Verify that the disk space is larger than the MySQL
backups and restores. backups fail, if the disk space is not database and then initiate backups or restores.
sufficient for the restore and Note: Approximately 50% of space more than the
backups.
MySQL database is required for restores and
backups.
 Appendix A
The NetBackup for MySQL
commands and
conventions
This appendix includes the following topics:

■ About NetBackup for MySQL commands

■ About NetBackup for MySQL conventions

About NetBackup for MySQL commands

This section describes the commands, options, and parameters that are available
to run the nbmysql operations. Each command contains a brief description, required
parameters, and the optional parameters for the respective operations. The agent
supports only those commands, options, and parameters that are mentioned in this
document.
Note for the following:
■ You must provide the parameters for the respective operations in the
nbmysql.conf file or provide them on the nbmysql command line.

■ The parameter values that you provide on the command line takes precedence
over the nbmysql.conf file.
■ Set the operation type -o on the nbmysql command line.
■ Set the other parameters and options for the respective operation on the nbmysql
command line or the nbmysql.conf file.
The parameters on the command line take precedence over the nbmysql.conf
file.
 The NetBackup for MySQL commands and conventions 35
About NetBackup for MySQL conventions

The NetBackup for MySQL command options

Table A-1 lists the options for nbmysql command.

Table A-1 The nbmysql command options

Options Descriptions

-C Configures the NetBackup client name for redirected restores.

-h Displays the Help usage, when it is the only option on the nbmysql
command line.

-id Configures the specified backup using the backup image name.

-l Configures the MySQL library directory.

-o Configures the operation type (backup, restore, query, and delete).

-P Configures the DataStore policy.

-p Configures the database server port number that identifies the MySQL
instance on which the backup or restore is performed.

-s Configures the NetBackup schedule.

-S Configures the NetBackup master server name.

-t Configures the target directory to restore the data.

-u Configures the database user name.

-z Configures the LVM snapshot size for Linux configured systems.

About NetBackup for MySQL conventions

This document uses the following conventions when describing commands that are
specific to NetBackup for MySQL Agent.
Run the following commands in the command line interface to see the results:
■ The -help command (-h) option prints a command-line usage message when
it is the only option on the command line. For example,
nbmysql -h

■ Brackets [ ] indicate that the enclosed component of the command line is optional.
Other parameters are required.
■ Italics indicate that the information is user supplied. For example, you may
provide the policy name and the schedule name for a backup operation.
 The NetBackup for MySQL commands and conventions 36
About NetBackup for MySQL conventions

nbmysql -o backup -S master_server_name -P policy_name -s schedule_name

 Appendix B
The NetBackup for MySQL
commands
This appendix includes the following topics:

■ nbmysql -o backup

■ nbmysql -o restore

■ nbmysql -o query

■ nbmysql -o delete
 The NetBackup for MySQL commands 38
nbmysql -o backup

nbmysql -o backup
nbmysql -o backup – runs the backup from the NetBackup client.

SYNOPSIS
nbmysql -o backup

-S master_server_name

-P policy_name

-s schedule_name

(Linux) -l mysql_library_path

(LVM) -z snapshot_size

[-p database_server_port]

[-u database_server_user]

Description
This command invokes the backup operation from the NetBackup client using the
NetBackup DataStore policy name and the schedule type. The parameter -S, -s
and -P are required parameters for Windows. The parameters -l and (LVM) -z
are required parameters for Linux. The -p and -u are the optional parameters.
On Linux systems, the directory path is /usr/NBMySQLAgent/
On Windows, the directory path is install_path\NBMySQLAgent\

Options
-l (Linux) Configures the MySQL library directory.
-p Configures the database port number that identifies the MySQL instance on
which the backup is performed.
-P Configures the NetBackup DataStore policy name.
-S Configures the NetBackup server name.
-s Specifies the schedule name that you have configured for the DataStore
policy.
-u Configures the database user name.
-z (LVM backups) Specifies the LVM snapshot size.
 The NetBackup for MySQL commands 39
nbmysql -o restore

nbmysql -o restore
nbmysql -o restore – restores the backup files from the NetBackup server.

SYNOPSIS
nbmysql -o restore

-S master_server_name

-t target_directory

-p database_server_port

[-i copy_id]

[-C client_name]

Description
The nbmysql command restores the backup file using -t, -S, and -p as the required
parameters. The -i and -C are optional parameters.
On Windows systems, the directory path to this command is
install_path\NBMySQLAgent\

On Linux systems, the directory path to this command is /usr/NBMySQLAgent/

Options
-C Specifies the client name.
-i Specifies the backup image name.
-p Specifies the database server port.
-S Configures the NetBackup master server.
-t Configures the target directory to restore the backup.
 The NetBackup for MySQL commands 40
nbmysql -o query

nbmysql -o query
nbmysql -o query – query the backups.

SYNOPSIS
nbmysql -o query

-S master_server_name

[-P policy_name]

[-C client_name]

Description
The nbmysql -o query command gets the backup using -S as the required
parameter and -C and -P as optional parameters
On Windows systems, the directory path to this command is
install_path\NBMySQLAgent\

On Linux systems, the directory path to this command is /usr/NBMySQLAgent/

Options
-C Retrieves and lists all backups on the specified client name.
-P Retrieves and lists all backups with the specified policy name.
-S Configures the NetBackup master server.
 The NetBackup for MySQL commands 41
nbmysql -o delete

nbmysql -o delete
nbmysql -o delete – deletes the backup information from the NetBackup catalog
files.

SYNOPSIS
nbmysql -o delete

-S master_server_name

-i copy_id

Description
The nbmysql-o delete command deletes the backup images from the NetBackup
catalog files, but retains the backups in the storage media.
The parameter -S and -i are the required parameters.

Options
-i Specifies the backup using the backup image name.
-S Configures the NetBackup master server.
 Index

A L
authenticating 16 LVM snapshot 33

B M
backup MySQL library 30
backup information 22
deleting 22 N
prerequisites 22
NetBackup bin directory 31
querying 22

C O
ownership 28
configuration file
parameters 18
R
redirected restore
D different file path 27
DataStore policy 20
different host 27
destination client 27
reset password 17
different file path 28
Restores
disaster recovery 28
Redirected restore 26

E S
encrypt password 17
symbolic link 14

F T
Features of NetBackup MySQL Agent 10
troubleshooting
nbmysql logs 29
H NetBackup logs 29
host ID certificate 30 NetBackup XBSA logs 29

I U
I18N file 30 uninstall 17
InnoDB 13
installing V
directory structure 12
validate password 17
installing prerequisites 12
VSS snapshot 33
user privileges 12
verifying operating systems 12