Search <book_title>...

Veritas Velocity™ User's Guide

Last Published: 2017-11-28

Product(s): Velocity (2.8)

Getting to know Velocity
1. Introducing Velocity
2. How to access the Velocity Cloud Console
3. About the Velocity Appliance
4. About the Velocity Storage Server administration interfaces
5. Using the Velocity shell menu
Setting up Velocity
1. Velocity administrator's checklist for setting up Veritas Velocity
2. Database administrator's checklist for setting up Veritas Velocity
3. Sandbox user's checklist for setting up Veritas Velocity
4. How to set up the Velocity Storage Server
5. How to set up the Velocity Client
6. Deleting a Velocity Client
7. Configuring a proxy server for Velocity
8. Required and optional ports for Velocity
9. Installing the NetBackup Client on the Velocity Storage Server
Setting up the Velocity on-premises management server
1. How to set up the Velocity on-premises management server
2. Deploying the Velocity on-premises management server image on a virtual machine
3. Configuring the network settings for the Velocity on-premises management server
4. Configuring Active Directory/LDAP settings on the Velocity on-premises management server
5. Adding users to the Velocity on-premises management server
Upgrading Velocity
1. How to upgrade to Velocity version 2.8
2. Finding the Velocity Storage Server and Velocity Client version numbers
3. Downloading and transferring software updates to the Velocity Storage Server
4. Removing previous upgrade files
5. Upgrading the Velocity Storage Server
6. Upgrading the Velocity Client for Linux
7. Upgrading the Velocity Client for Windows
8. Upgrading the Velocity Client for Solaris
Velocity Storage Server
1. About the Velocity Storage Server
2. Viewing physical storage usage on the Velocity Storage Server
3. About reclaiming storage space on the Veritas Velocity Storage Server
4. Increasing meta and data storage capacity on the Velocity Storage Server
5. Deregistering a Velocity Storage Server
6. How to reset the Velocity Storage Server
Users and roles
1. How to configure users and roles in Velocity
2. Adding users
3. Role-based access control
4. Adding roles
5. Deleting roles
6. Viewing details about all users and roles
7. Assigning users to an existing role
8. Removing users from a role
9. Changing the database sources that are assigned to a role
Oracle database ingestion using Velocity
1. How to provide copies of Oracle databases for sandboxes in Velocity
2. Adding an Oracle database to ingest into Velocity
3. Ingesting an Oracle database into Velocity for the first time
4. Ingesting an Oracle database again after the first ingest
5. Canceling an Oracle database ingestion
6. How to use copy preparation to mask or sanitize sensitive data
7. Ingesting an Oracle database into Velocity from the command line
8. About setting custom initialization parameters for a sandbox for an Oracle database copy
9. Editing default options for the ingest method for Oracle databases
Oracle database ingestion using NetBackup CoPilot
1. How to set up NetBackup CoPilot to ingest Oracle databases into Velocity
2. Ingesting an Oracle database with NetBackup CoPilot
Microsoft SQL Server database ingestion using Velocity
1. How to provide copies of SQL Server databases for sandboxes in Velocity
2. Adding a SQL Server database to ingest into Velocity
3. Ingesting a SQL Server database into Velocity
4. Editing default options for SQL Server database ingestion
5. Canceling a SQL Server database ingestion
Database sources and copies
1. About database sources and copies
2. Viewing details of an Oracle database source
3. Viewing details of a SQL Server database source
4. Changing the nickname or description of a database source
5. Deleting a database source from Velocity
6. About scheduling ingestions for a database source
7. Retention periods for database sources and copies
8. Viewing database copies
9. Viewing the number of sandboxes that were created from a database copy
10. Viewing the status of database copies
11. Deleting database copies
Sandboxes
1. About sandboxes
2. Creating a sandbox from an Oracle database copy
3. Starting an Oracle database instance manually
4. Creating a sandbox from a SQL Server database copy
5. Starting a SQL database manually
6. Finding your sandbox
7. Viewing details about your sandboxes
8. Deleting a sandbox
9. Managing sandboxes when you restart the host Oracle Database server
10. Unmounting a sandbox from an Oracle host server
Database recovery
1. Recovering an Oracle database
Alerts and logs
1. Viewing alerts
2. Creating audit log reports
3. Redirecting the syslog messages
4. Viewing the syslog messages on a Red Hat Enterprise Linux computer
5. Viewing the syslog messages on a Windows computer
Managing the Velocity physical appliance
1. Configuring network address settings on the Velocity physical appliance
2. About the Veritas Remote Management Console on the Velocity physical appliance
3. About Velocity physical appliance storage
  1. Configuring the storage on the Velocity physical appliance
  2. Viewing the storage on the Velocity physical appliance
4. About users on the Velocity physical appliance
5. About Velocity physical appliance checkpoints
  1. Creating a custom checkpoint on the Velocity physical appliance
  2. Restoring the Velocity physical appliance from a checkpoint
6. About factory reset on the Velocity physical appliance
  1. Restoring the Velocity physical appliance to a factory state
Monitoring the Velocity physical appliance
1. About Veritas AutoSupport on the Velocity physical appliance
  1. Setting up AutoSupport on the Velocity physical appliance
2. Setting up email notifications on the Velocity physical appliance
3. Setting up SNMP notifications on the Velocity physical appliance
4. Auditing the SDCS logs on the Velocity physical appliance
  1. About SDCS event type codes and severity codes on the Velocity physical appliance
  2. Changing the SDCS log retention settings on the Velocity physical appliance
5. Testing the Velocity physical appliance hardware
Velocity physical appliance security
1. About Velocity physical appliance user account privileges
  1. Velocity physical appliance user name and password specifications
    1. Password encryption and handling on the Velocity physical appliance
2. About the Velocity physical appliance intrusion detection system
  1. Reviewing SDCS events on the Velocity physical appliance
3. About Velocity physical appliance operating system security
  1. Vulnerability scanning of the Velocity physical appliance
  2. Disabled service accounts on the Velocity physical appliance
4. About data security on the Velocity physical appliance
5. About data integrity on the Velocity physical appliance
6. About the Velocity physical appliance ports
7. Recommended IPMI settings on the Velocity physical appliance
  1. Replacing the default IPMI SSL certificate on the physical appliance
Best practices
1. Improving the performance of Veritas Velocity for Oracle Database
2. Stopping and starting all mounts
3. Protecting the Velocity on-premises management server
Troubleshooting
1. NFS export paths where ingested Oracle Database sources are stored are inaccessible
2. NFS export path is not created during a database ingestion
3. Database ingestion fails with the Oracle error 'diskgroup {xx} space exhausted'
4. After restart of the vpfsd service, links to the applications are broken
5. Sandbox creation fails on an Oracle Database server
6. Sandbox creation fails for a SQL Server database copy
7. Sandbox creation fails after you use the --adGroups argument when you configure the Velocity Client for Windows
8. Sandbox creation may take longer than usual on Oracle Database 12c
9. A sandbox cannot be deleted from an Oracle Database server because the mount point is busy
10. Error occurs when registering the Velocity Client; provide the Oracle DBA with access to the Velocity registration files
11. Error occurs when a new sandbox name has the same name as a deleted sandbox
12. Ingestions and sandboxes are stuck 'In Progress' after the Velocity Storage Server is restarted
Glossary
1. Glossary terms for Velocity
Context-sensitive topics
1. Create Sandbox - Choose Database
2. Create Sandbox - Configure Host
3. Create Sandbox - Review Settings
4. Create Sandbox - Choose Database
5. Create Sandbox - Configure Host
6. Create Sandbox - Review Settings
7. Sandboxes window
8. Sandbox details
9. Sandbox details for an Oracle database copy
10. Sandbox details for a SQL Server database copy
11. Role Wizard - Select User Type
12. Role Wizard - Select Users
13. Role Wizard - Select Sources
14. Role Wizard - Review
15. Copies dialog
16. Database source details
17. Database Sources dialog
18. How to set up the Velocity Client
19. Schedule dialog
Section I. Velocity shell menu commands
1. Introduction
  1. About Velocity commands
2. Appendix A. Main > Manage > Storage
  1. Manage > Storage > Configure
  2. Manage > Storage > Show
3. Appendix B. Main > Manage > Cloud
  1. Main > Manage > Cloud
4. Appendix C. Main > Manage > Software
5. Appendix D. Main > Monitor
6. Appendix E. Main > Network
7. Appendix F. Main > Settings
8. Appendix G. Main > Support

NFS export paths where ingested Oracle Database sources are stored are inaccessible

Issue

Vpfsd is the service that manages all the data of the NFS export path where the backups of the source Oracle Database are stored. Each NFS export path has a corresponding vpfsd service. The NFS export path becomes inaccessible if its vpfsd service fails.

Solution

To troubleshoot NFS export paths where ingested Oracle Database sources are stored

On the Velocity Storage Server, to verify if the vpfsd for an NFS export path is running, type the following command:
ps aux|grep <NFS export path>
For example: # ps aux|grep asm4
root 8079 1 1 Mar30 ? 00:50:37 /opt/veritas/velocity/vpfs/bin/vpfsd
--mount_point /mnt/vpfs_shares/asm4/asm4 --meta_dir /vs_meta/meta_dir
--source_id asm4 --share_name asm4 --log_level information
--config_path /vs_data/vol0/etc/velocity/vpfsd_config.json --allow_other
If vpfsd is not in the output, the vpfsd service of that NFS export path may have failed.
From the Velocity shell menu, select Support > Support > Maintenance.
When prompted, enter the Velocity Storage Server password, and then type the following command:
elevate
Root access is enabled.
On the source database server, as a root user type the following command to unmount the NFS mount path:
umount <NFS_mount_path>
For example:# umount /nfs/backup
Do not shut down the Oracle instance.
On the Velocity Storage Server, as a root user, type the following commands to stop the network share and unmount the NFS mount point:
- exportfs -u <oracle_host>:<NFS_mount_point>
- umount -If <NFS_mount_point>
  Where
  <oracle_host> is the source database server that mounts the NFS mount point.
For example:
# exportfs -u 1.2.3.4:/mnt/vpfs_shares/asm4/asm4
# umount -If /mnt/vpfs_shares/asm4/asm4
Note:
You may receive a message that the mount point is not mounted. This message is expected.
On the Velocity Storage Server, as a root user type the following command to restart vpfsd:
/opt/veritas/velocity/etc/vpfs.mnt/<NFS mount point_name>.sh
For example:# /opt/veritas/velocity/etc/vpfs.mnt/asm4.sh
To verify that vpfsd has started correctly, as a root user type the following command:
ps aux|grep <NFS_export_path>
For example:# ps aux|grep asm4
root 8079 1 1 Mar30 ? 00:50:37 /opt/veritas/velocity/vpfs/bin/vpfsd
--mount_point /mnt/vpfs_shares/asm4/asm4 --meta_dir /vs_meta/meta_dir
--source_id asm4 --share_name asm4 --log_level information
--config_path /vs_data/vol0/etc/velocity/vpfsd_config.json --allow_other
On the Velocity Storage Server, as a root user type the following command to start the network share of the NFS export path:
exportfs <oracle_host>:<NFS_mount_point>
For example:
# exportfs 1.2.3.4:/mnt/vpfs_shares/asm4/asm4
On the source database server, type the following command to mount the NFS export path (as a root user):
mount -o rw,bg,hard,nointr,rsize=1048576,wsize=1048576,tcp,actimeo=0,vers=4,timeo=600 <velocity_server>:<mount_point> <NFS mount_path>
For example:
# mount -o rw,bg,hard,nointr,rsize=1048576,wsize=1048576,tcp,actimeo=0,vers=4,timeo=600 1.2.3.4:/mnt/vpfs_shares/asm4/asm4 /nfs/backup
To start the ingest again (as an Oracle user) type the following command:
$ /nfs/backup/tools/bin/ingest_dba
Note:
When you ingest an Oracle database on ASM, the ingest_dba application attaches the disk group to ASM automatically.

After the vpfsd service is restored, the NFS export path becomes available again and you can proceed with ingesting an Oracle database.