Veritas NetBackup™ Appliance Decommissioning and Reconfiguration Guide
- Decommissioning a NetBackup appliance
- Reconfiguring a NetBackup appliance
- About reconfiguring a NetBackup appliance
- About reconfiguring a NetBackup appliance
- Appendix A. LUN reconfiguration
Reconfiguring a 52xx or 53xx media server appliance using the NetBackup Appliance Shell Menu
Starting with release 4.0, the initial configuration process requires that you change the default passwords for the admin, maintenance, and sysadmin (IPMI) user accounts. The default admin password is valid only for the initial appliance login. The prompt to change the default passwords appears when you enter the > command to set the appliance role.
The following procedure describes how to reconfigure a 52xx or 53xx 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.
To reconfigure a 52xx or 53xx 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 addresses 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
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.
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.
- 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 Domain Name Suffix is appended to the host name and cannot be changed after the initial configuration is completed. If you need to change the suffix or move the appliance to a different domain at a later time, you must perform a factory reset first, and then perform the initial configuration again.
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 primary server that must work with this appliance.
From the Main_Menu > Appliance view, run the following command:
Media PrimaryServer
The following prompt appears to change the default passwords:
- [Info] Default password change is required for the following user(s): admin, maintenance, sysadmin
Change each user account password as prompted.
Review the following password policy before setting a new password:
Passwords must contain at least eight characters.
Passwords must contain at least one lowercase letter (a-z) and one number (0-9).
Dictionary words are considered weak passwords and are not accepted.
Passwords for the sysadmin (IPMI) user must contain no more than 20 characters.
The last seven passwords cannot be reused and the new password cannot be similar to previous passwords.
Note:
If you enter five consecutive invalid passwords for any user account, the appliance aborts the initial configuration process automatically. You must start the initial configuration process again.
Note:
If you enable the STIG feature after completing the initial configuration, you may be prompted to change the new passwords you entered here to meet the requirements of the STIG password policy.
Where PrimaryServer is either a standalone primary server, a multihomed primary server, or a clustered primary server. The following defines each of these scenarios:
Standalone primary server
This scenario shows one primary server host name. This name does not need to be a fully qualified name as long as your appliance recognizes the primary server on your network. The following is an example of how the command would appear.
Media PrimaryServerName
Multihomed primary server
In this scenario, the primary 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 PrimaryNet1Name,PrimaryNet2Name
Clustered primary server
In this scenario, the primary 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 PrimaryClusterName,ActiveNodeName,PassiveNodeName
Multihomed clustered primary server
In this scenario, the primary 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 PrimaryClusterName,ActiveNodeName,
PassiveNodeName,PrimaryNet1Name,PrimaryNet2Name
To prevent any future issues, when you perform the appliance role configuration, Veritas recommends that you provide all of the associated primary server names.
For more information about security certificates, refer to the chapter Security certificates in NetBackup in the NetBackup Security and Encryption Guide.
Note:
If the host name of the primary server is an FQDN, Veritas recommends that you use the FQDN to specify the primary 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 primary 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 primary 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_5240)
AdvancedDisk storage unit name: (stu_adv_5240)
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_5240)
MSDP storage unit name: (stu_disk_5240)
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 vary depending on the system load. It may also take 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