Search <book_title>...

Veritas NetBackup™ Appliance Troubleshooting Guide

Last Published: 2017-06-26

Product(s): Appliances (3.0)

Reconfiguring a 52xx or 5330 media server appliance using the NetBackup Appliance Shell Menu

The following procedure describes how to reconfigure a 52xx media server appliance from the NetBackup Appliance Shell Menu.

Warning:

NetBackup appliances do not support configuring two IP addresses that belong to the same subnet. The appliance runs on the Linux operating system and this type of networking is a current limitation. Each bond that you create must use an IP address that belongs to a different subnet.

Note:

You cannot remove an IP address if the appliance host name resolves to that IP address.

Caution:

The appliance comes configured with a known default password for the Maintenance user account. You should change this password either before or immediately after the initial configuration to prevent unauthorized access to the appliance maintenance mode. Note that you must provide the Maintenance user password to Veritas Technical Support in the event that the appliance requires troubleshooting services. Step 15 in the following procedure describes how to change the Maintenance user password.

To reconfigure a 52xx media server appliance using the NetBackup Appliance Shell Menu

Before performing the reconfiguration process, make sure you have followed the re-image procedure. See Reimaging a NetBackup appliance from the USB drive.

From the Main_Menu > Network view, enter the following command to configure the IP address of a single network that you want your appliance to connect to.

Configure IPAddress Netmask GatewayIPAddress [InterfaceNames]

Where IPAddress is the new IP address, Netmask is the netmask, and GatewayIPAddress is the default gateway for the interface. The [InterfaceNames] option is optional.

The IP Address or the Gateway IP Address can be an IPv4 or IPv6 address. Only global-scope and unique-local IPv6 addresses are allowed.

Remember that you should not use both IPv4 and IPv6 address in the same command. For example, you cannot use Configure 9ffe::9 255.255.255.0 1.1.1.1.. You should use Configure 9ffe::46 64 9ffe::49 eth1

See About IPv4-IPv6-based network support.

If you want to configure multiple networks you must first configure the IP address of each network that you want to add. Then you configure the Gateway address for each network you added. You must make sure that you add the default Gateway address first. Use the following two commands:

Configure the IP address of each network

Use either of the following commands depending on whether you want to configure an IPv4 or an IPv6 address for the network interface:

To configure the IPv4 address of a network interface:

IPv4 IPAddress Netmask [InterfaceName]

Where IPAddress is the new IP address, Netmask is the netmask, and [InterfaceName] is optional. Repeat this command for each IP address that you want to add.

To configure the IPv6 address of a network interface:

IPv6 <IP Address> <Prefix> [InterfaceNames]

Where IPAddress is the IPv6 address, Prefix is the prefix length, and [InterfaceName] is optional.

Configure the gateway address for each network that you added

Gateway Add GatewayIPAddress [TargetNetworkIPAddress] [Netmask] [InterfaceName]

Where GatewayIPAddress is the gateway for the interface and TargetNetworkIPAddress, Netmask, and InterfaceName are optional. Repeat this command to add the gateway to all of the destination networks.

The Gateway IP Address or the TargetNetworkIPAddress can be an IPv4 or an IPv6 address.

Remember that you should not use both IPv4 and IPv6 address in the same command. For example, you cannot use Gateway Add 9ffe::3 255.255.255.0 eth1. You should use Gateway Add 9ffe::3 6ffe:: 64 eth1.

From the Main_Menu > Network view, use the following command to set the appliance DNS domain name.
Note:
If you do not use DNS, then you can proceed to Step 6.
DNS Domain Name
Where Name is the new domain name for the appliance.
From the Main_Menu > Network view, use the following command to add the DNS name server to your appliance configuration.
DNS Add NameServer IPAddress
Where IPAddress is the IP address of the DNS server.
The address can be either IPv4 or IPv6. Only global-scope and unique-local IPv6 addresses are allowed.
See About IPv4-IPv6-based network support.
To add multiple IP addresses, use a comma to separate each address and no space.
From the Main_Menu > Network view, use the following command to add a DNS search domain to your appliance configuration so the appliance can resolve the host names that are in different domains:
DNS Add SearchDomain SearchDomain
Where SearchDomain is the target domain to add for searching.
This step is optional. It lets you add the IP addresses of other hosts in the appliance hosts file.
From the Main_Menu > Network view, use the following command to add host entries to the hosts file on your appliance.
Hosts Add IPAddress FQHN ShortName
Where IPAddress is the IPv4 or IPv6 address, FQHN is the fully qualified host name, and ShortName is the short host name.
See About IPv4-IPv6-based network support.
From the Main_Menu > Network view, use the following command to set the host name for your appliance.
Note:
If you plan to configure Active Directory (AD) authentication on this appliance, the host name must be 15 characters or less. Otherwise, AD configuration can fail.
Hostname Set Name
Where Name is the short host name or the fully qualified domain name (FQDN) of this appliance.
The host name is applied to the entire appliance configuration with a few exceptions. The short name always appears in the following places:
- NetBackup Appliance Shell Menu prompts
- Deduplication pool catalog backup policy
- Default storage unit and disk pool names
If this appliance has been factory reset and you want to import any of its previous backup images, the appliance host name must meet one of the following rules:
- The host name must be exactly the same as the one used before the factory reset.
- If you want to change the host name to an FQDN, it must include the short name that was used before the factory reset. For example, if "myhost" was used before the factory reset, use "myhost.domainname.com" as the new FQDN.
- If you want to change the host name to a short host name, it must be derived from the FQDN that was used before the factory reset. For example, if "myhost.domainname.com" was used before the factory reset, use "myhost" as the new short host name.
Note:
The host name can only be set during an initial configuration session. After the initial configuration has completed successfully, you can re-enter initial configuration by performing a factory reset on the appliance. See the NetBackup Appliance Administrator's Guide for more information.
With this step, NetBackup is re-configured to operate with the new host name. This process may take a while to complete.
For the command Hostname set to work, at least one IPv4 address is required. For example, you may want to set the host name of a specific host to v46. To do that, first ensure that the specific host has at least an IPv4 address and then run the following command.
Main_Menu > Network > Hostname Set v46
In addition to the above network configuration settings, you may also use the Main_Menu > Network view to create a bond and to tag a VLAN during the initial configuration of your appliance
- Use the Network > LinkAggregation Create command to create a bond between two or more network interfaces.
- Use the Network > VLAN Tag command to tag a VLAN to a physical interface or bond interface.
For detailed information about the LinkAggregation and the VLAN command options, refer to the NetBackup Appliance Command Reference Guide.
From the Main_Menu > Network view, use the following commands to set the time zone, the date, and the time for this appliance:
- Set the time zone by entering the following command:
  TimeZone Set
  Select the appropriate time zone from the displayed list.
- Set the date and the time by entering the following command:
  Date Set Month Day HHMMSS Year
  Where Month is the name of the month.
  Where Day is the day of the month from 0 to 31.
  Where HHMMSS is the hour, minute, and seconds in a 24-hour format. The fields are separated by semi-colons, for example, HH:MM:SS.
  Where Year is the calendar year from 1970 through 2037.

From the Main_Menu > Settings > Alerts > Email view, use the following commands to enter the SMTP server name and the email addresses for appliance failure alerts.

Enter the SMTP server name

Email SMTP Add Server [Account] [Password]

The Server variable is the host name of the target SMTP server that is used to send emails. The [Account] option identifies the name of the account that was used or the authentication to the SMTP server. The [Password] option is the password for authentication to the SMTP server.

Enter email addresses

Email Software Add Addresses

Where Addresses is the user's email address. To define multiple emails, separate them with a semi-colon.

Set the role for the appliance to a media server.

Note:

Before you configure this appliance as a media server, you must add the name of this appliance to the master server that must work with this appliance.

From the Main_Menu > Appliance view, run the following command:

Media MasterServer

Where MasterServer is either a standalone master server, a multihomed master server, or a clustered master server. The following defines each of these scenarios:

Standalone master server	This scenario shows one master server host name. This name does not need to be a fully qualified name as long as your appliance recognizes the master server on your network. The following is an example of how the command would appear. Media MasterServerName
Multihomed master server	In this scenario, the master server has more than one host name that is associated with it. You must use a comma as a delimiter between the host names. The following is an example of how the command would appear. Media MasterNet1Name,MasterNet2Name
Clustered master server	In this scenario, the master server is in a cluster. Veritas recommends that you list the cluster name first, followed by the active node, and then the passive nodes in the cluster. This list requires you to separate the node names with a comma. The following is an example of how the command would appear. Media MasterClusterName,ActiveNodeName,PassiveNodeName
Multihomed clustered master server	In this scenario, the master server is in a cluster and has more than one host name that is associated with it. Veritas recommends that you list the cluster name first, followed by the active node, and then the passive nodes in the cluster. This list requires you to separate the node names with a comma. The following is an example of how the command would appear. Media MasterClusterName,ActiveNodeName, *PassiveNodeName,MasterNet1Name,MasterNet2Name* To prevent any future issues, when you perform the appliance role configuration, Veritas recommends that you provide all of the associated master server names.

Note:

If the host name of the master server is an FQDN, Veritas recommends that you use the FQDN to specify the master server for the media server.

The configuration process determines whether NetBackup storage objects have been detected. You must decide if you want to preserve any preexisting storage objects and data.
If storage objects are detected, you receive the following message:
```
NetBackup storage objects have been detected that belong to this
media server node. You have an option to clean up (delete and
recreate) or preserve any preexisting NetBackup storage objects
that are solely owned by this appliance node.

If you choose 'yes' the following occurs:
1. The NetBackup catalog images owned by this node are expired,
if applicable.
2. The storage servers, disk pools, and storage units are cleaned
up on the master server.

Whether you chose 'yes' or 'no', the backup data on the disk is
preserved.

If you want to remove the backup data, run 'Support->Storage Reset'
before you proceed.

 >> Do you want to clean up existing storage objects? [yes,no]
```
If you enter Yes the following occurs:
- The NetBackup catalog images owned by this media server compute node are expired.
- The storage servers, disk pools, and storage units are cleaned up on the master server.
- The backup data on the disk is preserved.
If you choose No the following occurs:
- NetBackup catalog images are retained.
- The backup data on the disk is preserved.
Note:
If you want to remove the backup data, run the following command from the NetBackup Appliance Shell Menu before you proceed.
Main_Menu > Support > Storage Reset
Enter the storage configuration properties to configure storage pools for AdvancedDisk, for Deduplication (MSDP), or both.
When you configure storage pool sizes after a reimage process, the default storage sizes are displayed. If you adjusted the storage pool sizes before the reimage, those new storage pool sizes become the new default values that appear. However, the default disk pool name and the storage unit name that appear are the same default names as in the initial configuration process. If you changed the disk pool name and the storage unit name before the reimage, you must enter the names that you had chosen again during the reconfiguration process
Note:
To skip this step enter 0 when you are prompted for the size. This also deletes any existing data for that partition.
If you enter a 0 when you are prompted and a storage partition does not exist, then a partition is not created. If you enter 0 and a partition already exists then the partition is deleted and any existing data is also deleted.
To configure an AdvancedDisk storage pool provide the following information:
- ```
AdvancedDisk partition size in GB/TB [1GB..4.51TB]: (1 GB)
[1.6395 GB..51.8 TB]:
```
- ```
AdvancedDisk diskpool name: (dp_adv_5230)
```
- ```
AdvancedDisk storage unit name: (stu_adv_5230)
```
To configure an MSDP storage pool provide the following information:
- ```
MSDP partition size in GB/TB [118GB..4.49TB]: (4.23 TB)
```
- ```
MSDP diskpool name: (dp_disk_5230)
```
- ```
MSDP storage unit name: (stu_disk_5230)
```
- ```
MSDP Catalog partition size in GB/TB [19GB..294GB]: (19 GB)
```
Note:
You may need to reference the configuration notes that you recorded before starting this reimaging procedure so you can recreate the same storage pool configurations.
Choose whether or not you want to make changes to the storage configuration from above.
Note:
The estimated time to configure storage can range depending on the system load. There may also be several minutes to restart the NetBackup services. The greater the system load the longer it takes to complete the operation.
```
Do you want to make changes to the storage configuration shown 
above? [yes,no]: no
```
Change the default Maintenance user password as follows:
- Enter the Main_Menu > Support > Maintenance command.
- At the password prompt, enter the default Maintenance user password (P@ssw0rd).
- At the Maintenance shell prompt, enter the passwd command to change the password.
- Type Exit to return to the NetBackup Appliance Shell Menu.
For complete information about using the Support > Maintenance command, see the NetBackup Appliance Commands Reference Guide.