VERITAS Access 3340 Operating manual

Veritas Access Appliance
Commands Reference
Guide
7.3.2 Revision 2

Veritas Access Appliance Commands Reference
Guide
Last updated: 2018-06-14
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. 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:
[email protected]Worldwide (except Japan)
[email protected]Japan
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:
[email protected]
You can also see documentation information or ask a question on the Veritas community site:
http://www.veritas.com/community/
Veritas Services and Operations Readiness Tools (SORT)
Veritas Services and Operations Readiness Tools (SORT) is a website that provides information
and tools to automate and simplify certain time-consuming administrative tasks. Depending
on the product, SORT helps you prepare for installations and upgrades, identify risks in your
datacenters, and improve operational efficiency. To see what services and tools SORT provides
for your product, see the data sheet:
https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf

Chapter 1 Overview ................................................................................ 7
Scope of the Veritas Access Commands Reference Guide ..................... 7
Where to find the documentation ....................................................... 7
Changes in the Access Appliance document revision ...................... 9
Using the Access Appliance shell menu .............................................. 9
Appendix A Main > Appliance ............................................................... 11
Main > Appliance > Status .............................................................. 12
Appendix B Main > Manage > Cluster ................................................ 13
Main > Manage > Cluster > Configure .............................................. 14
Appendix C Main > Manage > Software ............................................ 15
Main > Manage > Software > Cancel ................................................ 16
Main > Manage > Software > Delete ................................................ 17
Main > Manage > Software > Download ............................................ 18
Main > Manage > Software > DownloadProgress ................................ 19
Main > Manage > Software > Install ................................................. 20
Main > Manage > Software > List .................................................... 21
Main > Manage > Software > Readme .............................................. 22
Main > Manage > Software > Rollback .............................................. 24
Main > Manage > Software > Share ................................................. 25
Main > Manage > Software > UpgradeStatus ..................................... 26
Appendix D Main > Manage > Storage .............................................. 27
Main > Manage > Storage > Show ................................................... 28
Main > Manage > Storage > Scan .................................................... 29
Main > Manage > Storage > Erase ................................................... 30
Appendix E Main > Network .................................................................. 32
Main > Network > Configure ........................................................... 33
Main > Network > Date .................................................................. 34
Main > Network > DNS .................................................................. 35
Contents

Main > Network > Gateway ............................................................ 37
Main > Network > Hosts ................................................................. 39
Main > Network > IPv4 .................................................................. 40
Main > Network > IPv6 .................................................................. 41
Main > Network > SetProperty ........................................................ 42
Main > Network > Show ................................................................. 43
Main > Network > TimeZone ........................................................... 44
Main > Network > NetStat .............................................................. 45
Main > Network > NTPServer ......................................................... 46
Main > Network > Unconfigure ........................................................ 47
Main > Network > VLAN ................................................................ 48
Main > Network > TraceRoute ......................................................... 51
Main > Network > Ping .................................................................. 52
Main > Network > Hostname Show .................................................. 53
Main > Network > Proxy ................................................................. 54
Appendix F Main > Monitor ................................................................... 57
Main > Monitor > MemoryStatus ...................................................... 58
Main > Monitor > NetworkStatus ...................................................... 61
Main > Monitor > SDCS ................................................................. 62
Main > Monitor > Top .................................................................... 64
Main > Monitor > Uptime ................................................................ 65
Main > Monitor > Who ................................................................... 66
Main > Monitor > Hardware ............................................................ 67
Appendix G Main > Settings .................................................................. 70
Main > Settings > Password ........................................................... 71
Main > Settings > Alerts > CallHome ................................................ 72
Main > Settings > Alerts > Email ...................................................... 74
Main > Settings > Alerts > Hardware ................................................ 77
Main > Settings > Alerts > SNMP ..................................................... 78
Main > Security > DeviceCertificate > Export ...................................... 86
Main > Security > DeviceCertificate > Import ...................................... 87
Appendix H Main > Support ................................................................... 88
Main > Support > DataCollect ......................................................... 89
Main > Support > Logs .................................................................. 91
Main > Support > RAID .................................................................. 93
Main > Support > Shutdown ........................................................... 94
Main > Support > Storage Reset ...................................................... 95
Main > Support > Test ................................................................... 96
5Contents

Main > Support > FactoryReset ....................................................... 98
Main > Support > InfraServices ...................................................... 103
Main > Support > IPMI ................................................................. 105
Main > Support > Maintenance ...................................................... 108
Main > Support > Reboot ............................................................. 109
Main > Support > Services ............................................................ 110
6Contents

Overview
This chapter includes the following topics:
■Scope of the Veritas Access Commands Reference Guide
■Where to find the documentation
■Using the Access Appliance shell menu
Scope of the Veritas Access Commands
Reference Guide
This document describes the commands that are used in the Access Appliance
shell menu. These commands are used in the following scenarios:
■Access Appliance initial configuration. For example, the Network > Configure
command for configuring eth1, the Cluster > Configure command for setting
up the Access cluster on the appliance.
■Access Appliance node-level management. For example, the Network > Date
command for setting the date and time, and the Monitor > Hardware command
for monitoring the node hardware.
For cluster-level management commands that are used in the Access CLI, refer to
the Access Command Reference Guide.
See “Where to find the documentation” on page 7.
Where to find the documentation
The latest version of the Veritas Access Appliance documentation is available on
the Veritas Support website and the Veritas Services and Operations Readiness
Tools (SORT) website.
1
Chapter

https://www.veritas.com/content/support/en_US/Appliances.html
https://sort.veritas.com/documents
You need to specify the product and the platform and apply other filters for finding
the appropriate document.
The following guides are available for the Access Appliance:
■Veritas Access Appliance Initial Configuration and Administration Guide
Note: This guide replaces the Veritas Access Appliance Getting Started Guide
■Veritas Access Appliance Commands Reference Guide
■Veritas Access Appliance Release Notes
Note: For the 7.3.2 release, this guide has been removed. The content has
been moved into the Veritas Access Release Notes.
■Veritas Access 3340 Appliance Product Description
■Veritas Access 3340 Appliance Hardware Installation Guide
■Veritas Appliance AutoSupport 2.0 Reference Guide
■Veritas Access Safety and Maintenance Guide
■Veritas Access documentation set
Veritas Access documentation set
The corresponding version of the Access application documentation is available
on the same page of the Veritas Services and Operations Readiness Tools (SORT)
website.
The following guides are available for the Access application:
■Veritas Access Administrator's Guide
■Veritas Access Command Reference Guide
■Veritas Access NetBackup Solutions Guide
■Veritas Access Online Help
■Veritas Access RESTful API Guide
■Veritas Access Release Notes
■Veritas Access Troubleshooting Guide
8Overview
Where to find the documentation

Changes in the Access Appliance document revision
In the 7.3.2 release, the Access Appliance documentation set has been revised.
The following changes are made:
■The Veritas Access Appliance Getting Started Guide has been renamed as
Veritas Access Appliance Initial Configuration and Administration Guide
■The Veritas Access Appliance Release Notes has been removed for the 7.3.2
release. The content has been merged into the Veritas Access Release Notes.
Using the Access Appliance shell menu
The Access Appliance shell menu provides a menu-based interactive shell interface
through which an administrator can manage the Veritas Access Appliance. The
interface is made up of hierarchical views that contain the administrative commands
and options. When you log onto the Access Appliance shell menu, the Main_Menu
view is displayed.
access-cluster_01.Main_Menu>
Appliance Access Appliance node configuration.
Exit Logout and exit from the current shell.
Manage Manage Access Appliance node.
Monitor Monitor appliance activities.
Network Network Administration.
Settings Change appliance settings.
Shell Shell operations.
Support Appliance Support.
To navigate to sub-views or execute available commands, type the name of the
option you want from the list of available options. For example, from the Main_Menu
view, type Manage and press Enter to go to the Manage view.
Helpful tips
The following list contains some helpful tips for using the Access Appliance shell
menu:
■Press Tab or Enter to auto-complete a command.
■Press the spacebar key to display the next parameter that needs to be entered.
■Type a question mark (?) to show more information about the commands or
sub-views that are available in the current view. If you type ?after you enter a
command or option, more information about that command is shown, such as
the format and usage of the command parameters.
9Overview
Using the Access Appliance shell menu

■When you press the Enter key, the next mandatory parameter that needs to be
entered is displayed. A mandatory parameter is one that does not have
predefined values.
Command parameters that are in angular brackets (< >) are mandatory; whereas
the command parameters that are in square brackets ([ ]) are optional.
For example, from the Main_Menu > Settings > Alerts view, the following
command has one mandatory parameter and two optional parameters:
Email SMTP Add <Server> [Account] [Password]
Where <Server> is the mandatory SMTP server address, and [Account] and
[Password] are the optional account credentials if the SMTP server requires
them.
10Overview
Using the Access Appliance shell menu

Main > Appliance
This appendix includes the following topics:
■Appliance > Status
A
Appendix

Appliance > Status
Appliance > Status – Show status information about the appliance node.
SYNOPSIS
Status
DESCRIPTION
Use this command to show status information about the appliance and the current
node.
■Appliance model
■Access software version
■Appliance software version
■Appliance node status
■Access cluster name
■Access management console virtual IP address
OPTIONS
Status
Show the status information about the node, such as appliance model, software
release version, and the node status.
12Main > Appliance
Appliance > Status

Main > Manage > Cluster
This appendix includes the following topics:
■Cluster > Configure
B
Appendix

Cluster > Configure
Cluster > Configure – Configure the Access cluster on the appliance.
SYNOPSIS
Configure
DESCRIPTION
Use this command to configure the Access cluster on the appliance from the current
node.
Note the following before you run the command:
■The Access cluster configuration is only allowed to run from one node. Make
sure that the Access cluster configuration process is not already ongoing on the
current node or other nodes.
■Make sure that you have the node management IP addresses of the appliance
nodes for clustering.
■Make sure that you have reserved enough IP addresses for use as the physical
and the virtual IP addresses of the Access cluster. At least four continuous IP
addresses must be reserved for each type.
Do not run the Configure on the current node in the following scenarios:
■When the cluster configuration process is already running on another node of
the Access appliance.
■When the node has been factory reset without resetting the storage, and the
Access cluster remains on the other node.
■When the node is an unconfigured node that is used to replace a faulty node in
an Access cluster.
OPTIONS
Configure
Use the command to configure the Access cluster on the appliance.
14Main > Manage > Cluster
Cluster > Configure

Main > Manage >
Software
This appendix includes the following topics:
■Manage > Software > Cancel
■Manage > Software > Delete
■Manage > Software > Download
■Manage > Software > DownloadProgress
■Manage > Software > Install
■Manage > Software > List
■Manage > Software > Readme
■Manage > Software > Rollback
■Manage > Software > Share
■Manage > Software > UpgradeStatus
C
Appendix

Manage > Software > Cancel
Manage > Software > Cancel – Cancel the download process of a software update
or the software patch, which can be in any of these installation stages - downloading
or stopped or finished, or postcheck.
SYNOPSIS
Cancel update_name
DESCRIPTION
Use this command to cancel a patch download in one of the following stages:
■Downloading - The software update is in the process of being downloaded.
■Stopped - The downloading process has stopped abruptly; therefore the
download cannot be completed.
■Finished - The software update is downloaded completely. However, you must
run the Software > List Downloaded command to view the software updates
that are available for installation.
■Postcheck - During downloading, the software update splits into several files.
Once the split files are downloaded, they need to be merged into the software
update. The merging is termed as Postcheck.
OPTIONS
Cancel update_name
This command cancels downloading of patch. Here, update_name is the name
of the software patch update.
16Main > Manage > Software
Manage > Software > Cancel

Manage > Software > Delete
Manage > Software > Delete – Delete a software update.
SYNOPSIS
Delete update_name
DESCRIPTION
You can use this command to delete a specific software release update, sometimes
referred to as a patch. Use the Main_Menu > Manage > Software > List
Downloaded command to obtain the list of software release updates that are
downloaded.
OPTIONS
Delete update_name
Delete a specific release update. Here update_name is the specific name of
the update that you want to delete.
17Main > Manage > Software
Manage > Software > Delete

Manage > Software > Download
Manage > Software > Download – Download a software update.
SYNOPSIS
Download update_name
DESCRIPTION
You can use this command to download a specific release update.
OPTIONS
Download update_name
Download a specific update, where update_name is the name of the update
that you want to download.
18Main > Manage > Software
Manage > Software > Download

Manage > Software > DownloadProgress
Manage > Software > DownloadProgress – Show the progress of an online patch
download.
SYNOPSIS
DownloadProgress
DESCRIPTION
Use this command to display the download progress of a software patch.
OPTIONS
DownloadProgress
Display the download progress of a software patch.
19Main > Manage > Software
Manage > Software > DownloadProgress

Manage > Software > Install
Manage > Software > Install – Use to install an EEB or a software release
update.
SYNOPSIS
Install update_name
DESCRIPTION
Use this command to install a new or an existing software update or an engineering
binary (EEB) to an appliance node that you designate.
To use this command you must know the name of the software update or EEB that
you want to install. To see a list of the software updates and EEB that are available
for you to install, run Software > List AvailablePatch command. This command
checks the Veritas site for the latest software update. Once you find the software
update or EEB that you want to install, you must run the Software > Download
update_name command, where update_name is the name of the software update.
After you have downloaded the software update, you can now run the Software
> Install update_name command.
OPTIONS
Install update_name
Install a software release update.
update_name is the name of the update that you want to install.
20Main > Manage > Software
Manage > Software > Install