NetBackup102 AdminGuide SQLite
NetBackup102 AdminGuide SQLite
NetBackup102 AdminGuide SQLite
Administrator's Guide
Release 10.2
NetBackup™ for SQLite Administrator's Guide
Last updated: 2023-03-17
Legal Notice
Copyright © 2023 Veritas Technologies LLC. All rights reserved.
Veritas, the Veritas Logo, Veritas Alta, and NetBackup 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 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.
http://www.veritas.com
Technical Support
Technical Support maintains support centers globally. All support services will be delivered
in accordance with your support agreement and the then-current enterprise technical support
policies. For information about our support offerings and how to contact Technical Support,
visit our website:
https://www.veritas.com/support
You can manage your Veritas account information at the following URL:
https://my.veritas.com
If you have questions regarding an existing support agreement, please email the support
agreement administration team for your region as follows:
Japan CustomerCare_Japan@veritas.com
Documentation
Make sure that you have the current version of the documentation. Each document displays
the date of the last update on page 2. The latest documentation is available on the Veritas
website:
https://sort.veritas.com/documents
Documentation feedback
Your feedback is important to us. Suggest improvements or report errors or omissions to the
documentation. Include the document title, document version, chapter title, and section title
of the text on which you are reporting. Send feedback to:
NB.docs@veritas.com
You can also see documentation information or ask a question on the Veritas community site:
http://www.veritas.com/community/
https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf
Contents
Index .................................................................................................................... 30
Chapter 1
Introduction to NetBackup
for SQLite
This chapter includes the following topics:
Note: Ensure that all NetBackup hosts are of the same NetBackup versions for
successful backup and restore operations.
Feature Description
Backup The agent supports single file-based backups of the SQLite database.
Redirected The agent supports to restore the SQLite backup files to alternate
Restores NetBackup clients.
Note: If the NetBackup is upgraded to version 10.1 or above from prior versions,
then NetBackup client must also be upgraded to the corresponding NetBackup
version.
7 To select the schedule type, under the Schedules tab, click OK to select the
Application Backup schedule type.
Note: The XBSA framework supports the Application Backup schedule type
only.
8 Under the Clients tab, click New and then add the NetBackup client that has
the NetBackup for SQLite Agent.
9 In the Add Client screen, click New, and type the name of the client that has
the SQLite server.
10 In the NetBackup Administration Console, click NetBackup Management
> Policies to view the policy in the existing policies list.
Chapter 3
NetBackup for SQLite
backup and restore
This chapter includes the following topics:
■ Redirected restores
■ Disaster recovery
SQLite Database
server Sends SQLite data for
back up
Requests snapshot, reads and
mounts snapshot, reads the 3 NetBackup
SQLite data primary server
2 5
Snapshot Back up status is
creation returned
NetBackup
media server
NetBackup XBSA
NetBackup client SQLite data is
VSS/LVM Snapshot 4 backed up
Storage unit
■ Ensure that the user has administrator (Windows) or root (Linux) access.
■ (Windows) Set the NetBackup\bin directory in the user variable path.
■ Configure the DataStore policy from the NetBackup Administration Console.
■ (LVM) Verify that there is enough space for the snapshot in the volume group,
and then set the snapshot size by the command line.
Note: Ensure that the snapshot size is 110% of the file size that you want to
backup.
To run backup
1 Configure the parameters on the nbsqlite command line.
2 Run the following command:
nbsqlite -o backup
-S primary_server_name
-P policy_name
-s schedule_name
(Linux) -z snapshot_size
-d sqlitedb_db_path
The parameter -S is the required parameter. Alternatively, you can query the
backups using the -C and -P options to define a different client and policy.
To query backup
1 Configure the parameters on the nbsqlite command line.
2 Run the following command:
nbsqlite -o query -S primary_server_name [-C ClientA] [-P
policy_name]
For example, to query a backup from the client ClientA, run the following command:
nbsqlite -o query -S primary_server_name [-C ClientA]
For example, to list backup files with the policy name policy_name, run the following
command:
nbsqlite -o query -S primary_server_name [-P policy_name]
For example, to query a backup from the client ClientA with policy name
policy_name, run the following command:
To delete backup
1 Configure the parameters or provide on the command line.
2 Run the following command:
nbsqlite -o delete -S primary_server_name -id db_backup_image_name
The parameter -id restores the backup using the specified backup image name.
The parameter -C lists all the backups that exist on the specified client. When you
do not specify the client, it defaults to the NetBackup primary server.
Read progress
file
2
Progress file
NetBackup
media server
NetBackup XBSA
NetBackup client
Storage unit
Redirected restores
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.
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.
Note: (Linux only) The NetBackup service user account must have ownership
of the altnames directory and host files.
Note: For redirected restore, provide the source client name (client from which
backup was taken) to the -C option.
5 After a successful redirected restore, undo the changes that you made on the
primary server and the client.
Disaster recovery
Disaster recovery is a plan to recover the data that can get lost in a disaster event.
The agent supports redirected restore as a disaster recovery strategy.
For more information, See “Redirected restores” on page 16.
Chapter 4
Troubleshooting for
NetBackup for SQLite
This chapter includes the following topics:
Step1 Remember the error message. Error messages are usually the vehicles for telling you
something went wrong. If you do not see an error on the
command line, but still suspect a problem, check the logs
and the reports. These can provide an error message that
directly points to the problem. The logs and reports are
essential troubleshooting tools.
Troubleshooting for NetBackup for SQLite 19
Troubleshooting errors when using NetBackup for SQLite Agent
Step2 Identify what you were doing Ask the following questions:
when the problem occurred.
■ What operation was tried?
■ What method did you use?
■ What type of server platform and operating system was
involved?
■ If your site uses both primary server and media server,
was it a primary server or a media server?
■ If a client was involved, what type of client was it?
■ Have you performed the operation successfully in the
past? If so, what is different now?
■ What is the service pack level?
■ Do you use operating system software with the latest
fixes supplied, especially those required for use with
NetBackup?
■ Is your device firmware at a level, or higher than the
level, at which it has been tested according to the posted
device compatibility lists?
Step4 Correct the problem. After you define the problem, use the information to correct
it.
Step5 Contact Technical Support. If you cannot solve the error, contact the Technical support.
■ install_path\NetBackup\logs\bpcd
■ install_path\NetBackup\logs\user_ops\dbext\logs
You must enable the bprd and the bpcd log files. For more information, see the
NetBackup Troubleshooting Guide.
The logs that are specific to the NetBackup client are located at:
Troubleshooting for NetBackup for SQLite 20
Troubleshooting errors when using NetBackup for SQLite Agent
■ install_path\netbackup\logs\nbsqlite
The logs that are specific to NetBackup XBSA are located at:
■ <NetBackup_install_path>/netbackup/logs/exten_client
The nbsqlite backup fails with The nbsqlite backup fails if the To run a nbsqlite backup successfully:
the following error: user environment variable path
■ Update the user environment variable path
is not updated with NetBackup
Unable to load xbsa.dll with NetBackup_install_path/bin.
bin directory.
The nbsqlite backup fails with The backup may fail when the Verify that you configure the valid primary server
status code: 7648. host validation fails for secure name and the host name.
connection.
The nbsqlite backup fails with The nbsqlite backup fails if the To run the backup successfully:
the following error: required parameters are not
■ Configure the valid primary server name,
specified on command line.
XBSA initiation failed policy name, schedule type from the
command line.
Or
■ Verify for communication errors between the
Failed to create XBSA object nbsqlite agent and the NetBackup primary
server. For more information see the
NetBackup Administrator's Guide, Volume
I.
(Windows)VSS snapshot creation The nbsqlite backup may fail Run cmd.exe in Administrator mode.
failed when the user does not have the
privileges to run the nbsqlite
operations.
Troubleshooting for NetBackup for SQLite 21
Troubleshooting errors when using NetBackup for SQLite Agent
The nbsqlite restore operation The nbsqlite restore fails if the For a successful restore:
does not restore any data from the NetBackup client name and the
■ Initiate the restore from the NetBackup
target NetBackup client. target directory are not updated.
source client.
■ Set the NetBackup client name and target
directory parameters.
The nbsqlite backup fails with The nbsqlite backup may fail To verify the space in the volume group,
the following error: when the volume group does not use the following command:
have sufficient space for the
(Linux) Error creating LVM 1 $vgs
snapshot.
snapshot
The command displays the volume group
details.
Error messages after a successful The nbsqlite backup gives To remove the snapshots:
backup: these errors when the volume
1 To list the existing snapshot, run the
group contains the snapshots.
<volume_group>/<snapshot_name> following command:
You can list the snapshots and
Read failure after 0 of 4096 at
then remove them before you run $lvs
29393616896: input or output
the backup again.
error. The command displays the snapshot
details.
OR
2 To remove the snapshots, run the following
<volume_group>/<snapshot_name>:
command:
read failure after 0 of 4096 at
4096: input or output error. $ lvremove -f
<volume_group>/<snapshot_name>
Troubleshooting for NetBackup for SQLite 22
Troubleshooting errors when using NetBackup for SQLite Agent
The nbsqlite backup on Linux The nbsqlite backup fails To unmount the snapshot
(LVM), fails with the following during an attempt to unmount the
1 List all mounted file systems using the
error: snapshot, the device, or when
following command:
you remove the existing
Error unmounting the
snapshots. $ mount-l
snapshot-Device or resource busy
2 If the snapshot still exists, run the following
OR
command:
Error removing the
$unmount<mount_directory>
snapshot-sqlitesnap_<timestamp>
Note: This directory is created in
/mnt/<snapshot_name>. The prefix
name for the snapshot is sqlitesnap.
1vremove -f
<volume_group>/<snapshot_name>
Appendix A
NetBackup for SQLite
commands and
conventions
This appendix includes the following topics:
■ 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.
nbsqlite -o backup -S primary_server_name -P policy_name -s
schedule_name
Option Description
-h Displays the Help usage, when it is the only option on the nbsqlite
command line.
-id Configures the specified backup using the backup image name.
■ nbsqlite -o backup
■ nbsqlite -o restore
■ nbsqlite -o query
■ nbsqlite -o delete
NetBackup for SQLite commands 26
nbsqlite -o backup
nbsqlite -o backup
nbsqlite -o backup – runs the backup operation from the NetBackup client.
SYNOPSIS
nbsqlite -o backup
-S primary_server_name
-P policy_name
-s schedule_name
(LVM) -z snapshot_size
[-d sqlite_db_path]
Description
This command invokes the backup operation from the NetBackup client using the
NetBackup DataStore policy name and the schedule type. The parameter -S, -d,
and -P are required parameters for Windows. The parameter -z is required
parameters for LVM users.
On Windows, the directory path is /usr/openv/netbackup/bin
On Linux systems, the directory path is install_path\NetBackup\bin
Options
-d Configures the path to connect to the SQLite database.
-P Configures the NetBackup DataStore policy name.
-S Configures the NetBackup server name.
-s Specifies the schedule name that you have configure for the DataStore policy.
-z (LVM backups) Specifies the LVM snapshot size.
NetBackup for SQLite commands 27
nbsqlite -o restore
nbsqlite -o restore
nbsqlite -o restore – restores the backup files from the NetBackup server.
SYNOPSIS
nbsqlite -o restore
-S primary_server_name
-t target_directory
[-id db_backup_id]
[-C NetBackup_client_name]
Description
The nbsqlite command restores the backup file using -t and -S as the required
parameters. The -id and -C are optional parameters.
On Windows systems, the directory path to this command is
install_path\NetBackup\bin
Options
-C Specifies the client name.
-id
nbsqlite -o query
nbsqlite -o query – queries the backups that are performed for SQLite database.
SYNOPSIS
nbsqlite - o query
-S primary_server_name
[-P policy_name]
[-C client_name]
Description
The nbsqlite -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\NetBackup\bin\
Options
-C Retrieves and lists all the backups of the specified client.
-P Retrieves and lists all backups with the specified policy name.
-S Configures the NetBackup primary server.
NetBackup for SQLite commands 29
nbsqlite -o delete
nbsqlite -o delete
nbsqlite -o delete – deletes the backup information from the NetBackup catalog
files.
SYNOPSIS
nbsqlite - o delete
-S primary_server_name
-id db_backup-id
Description
The nbsqlite -o delete command deletes the backup information from the
NetBackup catalog files, but retains the backups in the storage media.
The parameter -S and -id are the required parameters.
Options
-id
Specifies the backup using the backup image name.
-S Configures the NetBackup primary server.
Index
B
backup
backup image 12
backup information 12
delete 12
LVM configured systems 12
parameter 12
validate 12
D
DataStore policy 9
Default Application Backup 9
P
prerequisites 7
S
single file 7
snapshot 7