Veritas Velocity™ User's Guide
- Getting to know Velocity
- Setting up Velocity
- Velocity administrator's checklist for setting up Veritas Velocity
- Database administrator's checklist for setting up Veritas Velocity
- Sandbox user's checklist for setting up Veritas Velocity
- How to set up the Velocity Storage Server
- Deploying the Velocity Storage Server image on a virtual machine
- Velocity Appliance initial configuration requirements
- Configuring network and storage settings for the Velocity Storage Server in a virtual environment
- Registering the Velocity Storage Server
- Joining the Velocity Storage Server to the Active Directory domain
- Adding a Certificate Authority signed certificate to the Velocity Storage Server
- How to set up the Velocity Client
- Deleting a Velocity Client
- Configuring a proxy server for Velocity
- Required and optional ports for Velocity
- Installing the NetBackup Client on the Velocity Storage Server
- Setting up the Velocity on-premises management server
- How to set up the Velocity on-premises management server
- Deploying the Velocity on-premises management server image on a virtual machine
- Configuring the network settings for the Velocity on-premises management server
- Configuring Active Directory/LDAP settings on the Velocity on-premises management server
- Adding users to the Velocity on-premises management server
- Upgrading the Velocity on-premises management server
- Upgrading Velocity
- How to upgrade to Velocity version 2.9
- Finding the Velocity component version numbers
- Downloading and transferring software updates to the Velocity Storage Server
- Removing previous upgrade files
- Upgrading the Velocity Storage Server
- Upgrading the Velocity Client for Linux
- Upgrading the Velocity Client for Windows
- Upgrading the Velocity Client for Solaris
- Velocity Storage Server
- About the Velocity Storage Server
- Viewing physical storage usage on the Velocity Storage Server
- About reclaiming storage space on the Veritas Velocity Storage Server
- Increasing meta and data storage capacity on the Velocity Storage Server
- Deregistering a Velocity Storage Server
- How to reset the Velocity Storage Server
- Users and roles
- Oracle database ingestion using Velocity
- How to provide copies of Oracle databases for sandboxes in Velocity
- Adding an Oracle database to ingest into Velocity
- Ingesting an Oracle database into Velocity for the first time
- Ingesting an Oracle database again after the first ingest
- Canceling an Oracle database ingestion
- How to use copy preparation to mask or sanitize sensitive data
- Masking sensitive data manually in database copies
- Masking sensitive data in database copies by using a script
- Masking sensitive data manually in database copies that are already ingested
- Masking sensitive data by using a script in database copies that are already ingested
- Disabling copy preparation for Oracle database copies
- Ingesting an Oracle database into Velocity from the command line
- About setting custom initialization parameters for a sandbox for an Oracle database copy
- Editing default options for the ingest method for Oracle databases
- Oracle database ingestion using NetBackup CoPilot
- Microsoft SQL Server database ingestion using Velocity
- Automatic ingestion of NetBackup deduplicated backups
- About using NetBackup deduplicated backups to create Velocity sandboxes
- How to set up automatic ingestion of NetBackup deduplicated backups
- Supported Oracle policy options for automatic ingestions of NetBackup deduplicated backups
- Supported SQL Server policy options for automatic ingestions of NetBackup deduplicated backups
- Adding an Oracle database source to automatically ingest NetBackup deduplicated backups
- Adding a SQL Server database source to automatically ingest NetBackup deduplicated backups
- Database sources and copies
- About database sources and copies
- Viewing details of an Oracle database source
- Viewing details of a SQL Server database source
- Changing the nickname or description of a database source
- Deleting a database source from Velocity
- About scheduling ingestions for a database source
- Viewing the ingestion schedule for a database source
- Adding an ingestion schedule to a database source
- Editing the ingestion schedule for a database source
- Deleting the ingestion schedule for a database source
- Restarting scheduled database ingestions after changing the system time or time zone on the Velocity Storage Server
- Retention periods for database sources and copies
- Viewing database copies
- Viewing the number of sandboxes that were created from a database copy
- Viewing the status of database copies
- Deleting database copies
- Sandboxes
- About sandboxes
- Creating a sandbox from an Oracle database copy
- Starting an Oracle database instance manually
- Creating a sandbox from a SQL Server database copy
- Starting a SQL database manually
- Finding your sandbox
- Viewing details about your sandboxes
- Deleting a sandbox
- Managing sandboxes when you restart the host Oracle Database server
- Unmounting a sandbox from an Oracle host server
- Database recovery
- Alerts and logs
- Managing the Velocity physical appliance
- Configuring network address settings on the Velocity physical appliance
- About IPv4-IPv6-based network support on the Velocity physical appliance
- About NIC1 (eth0) port usage on the Velocity physical appliance
- Creating a network interface bond (NIC bond) on the Velocity physical appliance
- VLAN tagging on the Velocity physical appliance
- Configuring static routes on the Velocity physical appliance
- Configuring DNS and host name mapping on the Velocity physical appliance
- Setting the host name for the Velocity physical appliance
- Using a proxy server with the Velocity physical appliance
- About WAN optimization on the Velocity physical appliance
- About the maximum transmission unit size on the Velocity physical appliance
- Setting the date and time on the Velocity physical appliance
- About the Veritas Remote Management Console on the Velocity physical appliance
- About Velocity physical appliance storage
- About users on the Velocity physical appliance
- About Velocity physical appliance checkpoints
- About factory reset on the Velocity physical appliance
- Configuring network address settings on the Velocity physical appliance
- Monitoring the Velocity physical appliance
- Velocity physical appliance security
- About Velocity physical appliance user account privileges
- About the Velocity physical appliance intrusion detection system
- About Velocity physical appliance operating system security
- About data security on the Velocity physical appliance
- About data integrity on the Velocity physical appliance
- About the Velocity physical appliance ports
- Recommended IPMI settings on the Velocity physical appliance
- Velocity REST APIs
- Getting started with Velocity REST APIs
- Authenticate a user for the Velocity REST APIs
- Get Velocity Storage Servers
- Create a share
- Find the share ID
- Find the share location
- Create a snapshot
- Find the snapshot ID
- Create a sandbox
- Find the sandbox ID
- Get a sandbox
- Delete a share
- Delete a snapshot
- Delete a sandbox
- Get templates (shares)
- Get snapshots
- List all sandboxes
- Best practices
- Troubleshooting
- NFS export paths where ingested Oracle Database sources are stored are inaccessible
- NFS export path is not created during a database ingestion
- Database ingestion fails with the Oracle error 'diskgroup {xx} space exhausted'
- After restart of the vpfsd service, links to the applications are broken
- Sandbox creation fails on an Oracle Database server
- Sandbox creation fails for a SQL Server database copy
- Sandbox creation fails after you use the --adGroups argument when you configure the Velocity Client for Windows
- Sandbox creation may take longer than usual on Oracle Database 12c
- A sandbox cannot be deleted from an Oracle Database server because the mount point is busy
- Error occurs when registering the Velocity Client; provide the Oracle DBA with access to the Velocity registration files
- Error occurs when a new sandbox name has the same name as a deleted sandbox
- Ingestions and sandboxes are stuck 'In Progress' after the Velocity Storage Server is restarted
- Glossary
- Section I. Velocity shell menu commands
- Introduction
- Appendix A. Main > Manage > Storage
- Appendix B. Main > Manage > Cloud
- Appendix C. Main > Manage > Software
- Appendix D. Main > Monitor
- Appendix E. Main > Network
- Network > Configure
- Network > Date
- Network > DNS
- Network > Gateway
- Network > Hostname
- Network > Hosts
- Network > IPv4
- Network > IPv6
- Network > NetStat
- Network > NTPServer
- Network > LinkAggregation
- Network > VLAN
- Network > WANOptimization
- Network > Ping
- Network > Proxy
- Network > SetProperty
- Network > Show
- Network > TimeZone
- Network > TraceRoute
- Network > Unconfigure
- Appendix F. Main > Settings
- Appendix G. Main > Support
Configuring the Velocity Client for Windows
The Velocity Client is a service that facilitates automated database ingestion and sandbox preparation. To configure the Velocity Client, you must copy an installation package from the Velocity Storage Server. Then, you must install it on any host servers that are intended to be used for either sandboxes or database ingestion. Finally, each host server must be registered with Velocity before you can ingest databases or create sandboxes.
You can install and register the Velocity Client manually using a Windows installation wizard. If you prefer, you can install the Client using the Velocity launch pad. The launch pad walks you through the configuration process.
Note:
By default, Velocity uses host-based security for access to CIFS shares. To restrict access of CIFS shares to authorized users, you can choose to integrate with Active Directory when you configure the Velocity Client for Windows. However, you must first join the Velocity Storage Server to the Active Directory domain.
See Joining the Velocity Storage Server to the Active Directory domain.
When the Velocity Client is successfully registered, it appears in the Velocity Console. To view any registered instances of the Velocity Client, click in the left pane.
Note:
When you uninstall an instance of the Velocity Client, it must be able to connect to the Velocity Storage Server because the process also deregisters the Velocity Client.
You can also delete a client if an error was made in the initial registration and you want set it up again with valid information.
Note:
If you configure the Velocity Storage Server so that it is multihomed, these commands may not provide the correct IP address. You may need to change the IP address to the same IP address that matches the network that the Velocity Client is on.
To configure the Velocity Client for Windows manually
- Log on to the Windows host server as an administrator.
- Run the velocity-client.msi and follow the prompts to install the Client on your host server.
\\<storage FQDN/IP address>\packages\velocity-client.msi
- Log on to the Velocity Console as an administrator.
- From the Velocity Console, in the left pane, click Velocity Storage Server.
- Click Generate Server Credentials.
Make a note of the generated User name and Password credentials that display.
- On the host server, use one of the following commands to register the host with Velocity:
If you use the computer's hostname to identify the host server on the network:
Type the following command:
%PROGRAMFILES%\Veritas\Velocity\bin\velocity_registration.exe initialize -s https://<Storage FQDN/IP address>:8443 -u <user> -p <password>
Note:
If you configure the Velocity Storage Server so that it is multihomed, these commands may not provide the correct IP address. You may need to change the IP address to the same IP address that matches the network that the Velocity Client is on.
Where <Storage FQDN/IP address> is the FQDN or IP address of the Velocity Storage Server. Replace <user> with the user name and <password> with the password from the Generate Server Credentials dialog in the previous step.
Note:
If you installed the Client in a directory other than the default directory, C:\Program Files, you must modify the command to use the appropriate directory.
If the primary FQDN or IP address of the host server is not on the same network path as the Velocity Storage Server:
Type the following command:
%PROGRAMFILES%\Veritas\Velocity\bin\velocity_registration.exe initialize -i <MS SQL FQDN/IP address> -s https://<Storage FQDN/IP address>:8443 -u <user> -p <password>
Note:
If you configure the Velocity Storage Server so that it is multihomed, these commands may not provide the correct IP address. You may need to change the IP address to the same IP address that matches the network that the Velocity Client is on.
Where <Storage FQDN/IP address> is the appropriate FQDN or IP address of the Velocity Storage Server.
Replace <user> with the user name and <password> with the password from the Generate Server Credentials dialog in the previous step.
The -i flag lets you specify the FQDN or IP address that is associated with the interface and represents the network path to the Velocity Storage Server. Using the -i flag ensures that Velocity uses the correct network path when it communicates with the Velocity Storage Server.
Note:
If you installed the Client in a directory other than the default directory, C:\Program Files, you must modify the command to use the appropriate directory.
(Optional) If you want to secure the CIFS shares with Active Directory
Note:
You must first join the Velocity Storage Server to the Active Directory domain.
See Joining the Velocity Storage Server to the Active Directory domain.
For Active Directory integration, include the following arguments:
--adGroups <group1, group2,...> --clientUser <user> [-- clientPassword <password>]
Where:
<group1, group2,...> is a group or a set of groups that are separated by commas with no spaces in between. Group names that include spaces are currently not supported. Members of the group or groups have access to the CIFS share.
<user> must be a member of at least one of the groups that are listed in the adGroups argument.
<password> is the password for the Active Directory user account. Velocity uses this password to configure the Velocity Client vexecd service. Velocity does not store this password.
You can provide the user name on the command line to assist with the script. Otherwise, Velocity prompts you to enter a password.
The SQL Server service account for the instance on the server that will host the sandbox database must be configured to run as an Active Directory account. The Active Directory account must be a member of at least one of the Active Directory groups that is specified when the Velocity Client is registered. Then, the SQL Server service account can access the CIFS share and start the database for the sandbox.
To configure the Velocity Client for Windows using the Velocity launch pad
- On the Velocity Console, click Launch Pad.
- On the Configure the Velocity Client tile, click Configure.
- Click Next.
- Select Windows for SQL Databases, and then click Next.
- Do one of the following:
To use host-based security for access to CIFS shares
Complete the directions that display on the launch pad.
To secure the CIFS shares with Active Directory
Note:
You must first join the Velocity Storage Server to the Active Directory domain.
See Joining the Velocity Storage Server to the Active Directory domain.
Complete the directions that display on the launch pad, and include the following arguments to the commands that are copied and pasted into the terminal:
--adGroups <group1, group 2,...> --clientUser <user> [--clientPassword <password>]
Where:
<group1, group 2,...> is a group or a set of groups that are separated by commas with no spaces in between. Group names that include spaces are not currently supported. Members of the group or groups have access to the CIFS share.
<user>must be a member of at least one of the groups that are listed in the adGroups argument.
<password> is the password for the Active Directory user account. Velocity uses this password to configure the Velocity Client vexecd service. Velocity does not store this password.
You can provide the user name on the command line to assist with the script. Otherwise, Velocity prompts you to enter a password.
The SQL Server service account for the instance on the server that will host the sandbox database must be configured to run as an Active Directory account. The Active Directory account must be a member of at least one of the Active Directory groups that is specified when the Velocity Client is registered. Then, the SQL Server service account can access the CIFS share and start the database for the sandbox.
- Click Done.