VPLEX - Replacement Procedures-VS2
VPLEX - Replacement Procedures-VS2
Topic
Replacement Procedures
Selections
Select a hardware platform: VS2
Select a hardware component to replace: Management Server
Select a GeoSynchrony release: 6.0
Is this replacement for a configured or unconfigured system?: Configured
REPORT PROBLEMS
If you find any errors in this procedure or have comments regarding this application, send email to
[email protected]
Dell, EMC, Dell EMC and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other
trademarks may be the property of their respective owners.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 1 of 16
Contents
Preliminary Activity Tasks .......................................................................................................3
Read, understand, and perform these tasks.................................................................................................3
Replacement procedure..........................................................................................................5
Task 1: Perform preliminary steps ................................................................................................5
Task 2: Prepare your laptop for connecting to the management server .......................................7
Task 3: Assess the management server’s operational state.........................................................9
Task 4: Log in to the VPlexcli........................................................................................................9
Task 5: VPLEX Metro or VPLEX Geo with Cluster Witness only: Disable Cluster Witness..........9
Task 6: Prepare the management server to be replaced............................................................10
Task 7: Shut down the management server ...............................................................................10
Task 8: Remove the bad management server ............................................................................11
Task 9: Install and configure the replacement server .................................................................11
Task 10: Re-establish any migration sessions..............................................................................15
Task 11: VPLEX Metro or VPLEX Geo with Cluster Witness only: Re-enable Cluster Witness ...15
Task 12: (Optional) Add RecoverPoint connection on new cluster ...............................................15
Task 13: Exit the SSH session......................................................................................................16
Task 14: Restore your laptop settings if necessary ......................................................................16
Task 15: Restore the default cabling arrangement .......................................................................16
Task 16: Complete the EMC field return tag .................................................................................16
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 2 of 16
Preliminary Activity Tasks
This section may contain tasks that you must complete before performing this procedure.
Table 1 List of cautions, warnings, notes, and/or KB solutions related to this activity
462476: Please read KBA 462476 prior to performing an FRU replacement procedure on VS1 and
VS2 Management servers in Releases 5.2 and 5.3
494674: Please read KBA 494674 prior to performing an FRU replacement procedure on VS2
Management servers in Releases 6.0.X
• If you find an error in any VPLEX product procedure, that was generated via SolVe Desktop or SolVe
Online,you should report the issue to the SolVe Team using the feedback address located in the KBA
000171121 as well surrounding the reporting of any issues,errors confusion in a VPLEX procedure
2. This is a link to the top trending service topics. These topics may or not be related to this activity.
This is merely a proactive attempt to make you aware of any KB articles that may be associated with
this product.
Note: There may not be any top trending service topics for this product at any given time.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 3 of 16
General information for handling hardware components
This section describes precautions you must take and general procedures you must follow when
removing, installing, or storing field-replaceable units (FRUs) or other hardware components. The
procedures in this section apply to handling components during hardware upgrades or FRU replacement.
You add or replace most hardware while the cabinet is powered up. To maintain proper airflow for cooling
and to ensure EMI compliance, ensure that all front bezels, filler panels, and filler modules are in place
after the replacement/upgrade is complete.
IMPORTANT: Follow these steps only in an emergency. They are not a substitute for using an ESD kit.
• Before you touch a hardware component, touch a bare (unpainted) metal surface of the enclosure.
• Before you remove a FRU from its antistatic bag, place one hand firmly on a bare metal surface of the
enclosure, and at the same time, pick up the FRU while it is still sealed in the antistatic bag.
• When you remove the FRU from the antistatic bag, do not touch any electronic components and
circuits on it, and do not move around the room or contact other surfaces or people until you have
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 4 of 16
installed the FRU. If you must move around the room or touch other surfaces, return the FRU to the
antistatic bag before doing so.
Xxxbefore_SLES11_6.0_later
Important Notes
Before you begin this replacement, copy the VPlex-5.5.1.02.00.01-management-server.iso file onto a
DVD in case issues occur during the re-imaging. Refer to the Release Notes for version name and the
location of the file.
xxxbefore1_vs2
Replacement procedure
Task 1: Perform preliminary steps
Note: You can perform the procedure described in this document only on a VPLEX cluster that has been
configured for operation (by running the EZ-Setup utility). The procedure does not work on a new cluster
that has not yet been configured.
Note: This task is from a source file that is common to several procedures. Some items are not applicable
to all procedures.
1. [ ] Review the VPLEX best practices white papers on EMC Support Online, and verify that the
VPLEX cluster is configured for high availability.
CAUTION: A lack of high availability can cause data unavailability when a component is removed.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 5 of 16
4. [ ] Confirm that you have all VPLEX login usernames and passwords. The EMC VPLEX Security
Configuration Guide shows the default passwords; however, a customer administrator might have
changed some of them. Verify any changes, and ensure either that you know any changed
passwords or that someone who does know them will be available when you need them.
5. [ ] Confirm that you have identifying information for the component you are replacing. This
information should be available from the EMC Support Center or a Call Home message.
Typical identifying information you should note includes the following, where applicable:
• Serial number
• VPLEX cabinet TLA (top-level assembly number)
• Cluster ID
• Cluster IP Seed
• Enclosure ID (engine number)
Engines are numbered up from the bottom, starting with 1.
• Director name:
director-<Cluster_IP_Seed>-<Enclosure_ID>-A
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 6 of 16
Note: The Call Home event that identifies the problem also identifies the software version.
10. [ ] If you are replacing a management server in a VPLEX Metro or VPLEX Geo implementation,
confirm that you have the following information from the remote management server (the one you are
not replacing):
• IP address
• Cluster IP Seed
• CA Certificate and password
Xxxbefore_mgt_server_vs2
a. At the front of the cabinet, remove the filler panel at the U23 position.
b. Slide the laptop tray out, and place your laptop on the tray.
c. Depress the tab that secures the red service cable to the tray, to loosen the cable tie.
d. Connect the service cable to the Ethernet port on your laptop. (The other end is already
connected to the service port on the VPLEX management server as shown in Figure 1.)
• Non Dell EMC cabinet:
a. Locate the red service cable that hangs near the right rear of the cabinet.
b. Connect the free end of the cable to the Ethernet port on your laptop. (The other end is already
connected to the service port on the VPLEX management server as shown in Figure 1.)
Customer-provided
Ethernet cable
VPLX-000407
2. [ ] On your laptop’s desktop, select Start > Settings > Control Panel > Network Connections >
specific NIC (double-click).
3. [ ] On the Local Area Connection Status window, click Properties.
4. [ ] On the Local Area Connection Properties window, double-click Internet Protocol (TCP/IP) under
This connection uses the following items.
5. [ ] On the Internet Protocol (TCP/IP) Properties window, select Use the following IP addresses, and
type the following values:
• IP address: 128.221.252.3
• Subnet mask: 255.255.255.224
• Default gateway 128.221.252.2
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 7 of 16
6. [ ] Click OK on the Internet Protocol (TCP/IP) Properties window, and again on the Local Area
Connection Properties window.
7. [ ] Close the Network Connections window.
8. [ ] Open a Command Prompt window on your laptop, and type the following command:
ipconfig
Type:
128.221.252.2
(default)
(default)
PuTTY
12. [ ] Select SSH in the Category list, and ensure that Preferred SSH protocol version is set to 2.
13. [ ] Select Window in the Category list, and set Lines of scrollback to 20000. (This allows you to read
output that is too long to read in a standard-size PuTTY session window.)
14. [ ] Optional step: If you want to save the PuTTY session output to a log file:
Note: The log file will contain data only from the current PuTTY session. Any time you open a new
session, you must repeat this step if you want to log the output for that session.
15. [ ] Click Save to save the settings for the session name you configured.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 8 of 16
Task 3: Assess the management server’s operational state
The generator creates each procedure from a set of source files, many of which are common to
multiple procedures. Therefore, some tasks in this procedure are applicable only under certain
circumstances:
If the management server is still operational, click Open to establish a session on the management
server, and log in with username service.
Note: If the connection fails to open, ping 128.221.252.3 (the LAN port on your service laptop) to
verify intercomponent communication. If the ping is successful, ping 128.221.252.2 (the service
port on the management server).
If the management server is not operational, go to the task titled “Remove the bad management
server.”
xxxVplexcli2
Task 5: VPLEX Metro or VPLEX Geo with Cluster Witness only: Disable Cluster Witness
1. [ ] VPlexcli From the VPlexcli prompt, type the following commands to display the Cluster Witness
status:
cd /cluster-witness
ls
Note: If the cd command fails because no cluster-witness context exists, go to the next task,
because Cluster Witness is not configured on the cluster.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 9 of 16
[ ] VPlexcli When prompted Continue?, type Yes and press Enter.
3. [ ] Repeat step 1. [ ], and confirm that the output shows cluster-witness as admin-state = disabled.
xxxmgt_server_RevE
CAUTION: If any command or step in this procedure does not give you the expected result and you
cannot resolve the issue, contact the EMC Support Center. Continuing with the replacement without
resolving the issue can result in data unavailability.
1. [ ] VPlexcli From the VPlexcli prompt, type the commands to launch the FRU replacement script.
See the command-line Help for the replace–fru command, by specifying the CLI –help option
(VPlexadmin replace-fru –help). The command-line arguments vary based on the system
configuration. For example:
VPlexcli:> script –i VPlexadmin
6. [ ] Type the default option no and press Enter for the following message,
Do you want to run "collect-diagnostics" to collect system information? No failure
conditions have been detected that mandate a run. (yes/no)
Note: Type no as the default option unless there is a failure condition hit during replacement procedure. If
there is a failure, the Collect Diagnostics is collected automatically by the script.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 10 of 16
Wait 30 seconds for the management server to shut down before proceeding to the next task.
4. [ ] Connect your laptop to the service port on the replacement management server.
5. [ ] Launch PuTTY.exe, and establish a connection to the server:
a. On the PuTTY Configuration window, load the VPlex_service session you saved earlier in the
procedure.
b. Click Open, and log in to the management server as user service.
6. [ ] If you are replacing the management server in a VPLEX Metro or VPLEX Geo configuration:
a. Launch PuTTY, and establish a connection to the remote management server (the one you are
not replacing).
Log in with username service.
b. Shell-remote From the Linux shell prompt on the remote management server, type the following
command, and copy the output string to the Windows clipboard on your laptop:
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 11 of 16
service@ManagementServer:~> date
Tue Jan 16 19:07:58 UTC 2011
c. Shell From the Linux shell prompt on the new management server, type the following
command, and adjust the time as necessary to match what you expect the time now is on the
remote management server:
service@ManagementServer:~> sudo /usr/sbin/service-maintenance-window
ManagementServer # date –s ”paste_saved_string_here”
ManagementServer # exit
d. Shell-remote Type the following command to exit the shell session on the remote management
server:
service@ManagementServer:~> exit
7. [ ] Shell From the shell prompt on the new management server, type the following command to
verify the base image:
service@ManagementServer:~> more /etc/mgmt-server-base-version.properties
mgmt.server.base.version=D4_MSB_7
If the version does not match the required version identified in the VPLEX release notes, contact the
EMC Support Center.
8. [ ] Shell Copy the package VPlex-5.5.1.02.00.01-management-server-package.tar from your
laptop to /tmp/VPlexInstallPackages on the management server.
9. [ ] Copy the VPlex-5.5.1.02.00.01-management-server.iso from the service laptop into the
/tmp/VPlexInstallPackages directory.
10. [ ] Shell Type the following command to verify that the package is present in
/tmp/VPlexInstallPackages:
service@ManagementServer:~> ls
base-mgmt-server-software-install.tar
manifest.xml
mgmt-server-packages.version
mgmt-server-md5-checksums.txt
. . .
. . .
. . .
mgmt-server-packages.index
VPlex-MS-install
VPlex-MS-backup
VPlex-MS-manifest.expect
VPlex-MS-password.expect
Where base is the base version of VPLEX for the specific release and version is the release version
number of the release.
Example:
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 12 of 16
service@ManagementServer:/tmp/VPlexInstallPackages>tar xvf VPlex-5.5.0.00.00.11-
management-server-package.tar
D35.30.0.15-mgmt-server-software-install.tar
vplex-cws-D35.30.0.12-upgrade.tar.gz
mgmt-server-packages.version
rpms/ipmitool-1.8.13.D30-1.x86_64.rpm
rpms/libopenssl0_9_8-hmac-0.9.8j-0.66.1.x86_64.rpm
rpms/libpixman-1-0-0.24.4-0.11.1.x86_64.rpm
.
.
.
rpms/module-init-tools-3.11.1-1.28.5.x86_64.rpm
rpms/util-linux-lang-2.19.1-6.48.12.x86_64.rpm
mgmt-server-packages.index
mgmt-server-md5-checksums.txt
manifest.xml
12. [ ] Shell Type the following command to install the VPlex-5.5.1.02.00.01 management software
package:
service@ManagementServer:~> sudo /tmp/VPlexInstallPackages/VPlex-MS-install -v -l
/var/log/install.log --fru-install VPlex-5.5.1.02.00.01-management-server.iso
13. [ ] If you are prompted for a password, type the service account login password (the system may
reboot).
Configuring imaging on /dev/sda4 using VPlex-version-management-
server.iso ok
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 13 of 16
The system is going DOWN for reboot in 1 minute!
14. [ ] Wait about 15 minutes for the management server to reboot and be imaged with the public IP
configuration it had before reimaging, and then reconnect to the management server as you did in
step 5. [ ].
15. [ ] Copy the package VPlex- required-6.x-version-management-server-package.tar from
your laptop to /tmp/VPlexInstallPackages on the management server. (the 6.x version the old
management server was running)
16. [ ] Upgrade the management server to the target version using the following command:
VPlex-MS-installer --omit-manifest-check VPlex- required-6.x-version-management-
server-package.tar
17. [ ] Wait about 15 minutes for the management server to reboot, and then reconnect to the
management server as you did in step 5. [ ].
Note: Ensure you provide the correct platform (VS1 or VS2) and engine count (1,2 or 4).
When you are asked to enter the management server’s serial number, be sure to enter the serial
number of the management server you replaced. Do not enter the serial number of the new
management server.
When you see the following prompt, type yes and press Enter:
Have you already replaced the management server with the new part? Select 'yes' to
restore the new management server's configuration, or 'no' to prepare to shutdown
the management server to be replaced. (yes/no)
23. [ ] Type the default option no and press Enter for the following message,
Do you want to run "collect-diagnostics" to collect system information? No failure
conditions have been detected that mandate a run. (yes/no)
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 14 of 16
Note: Type no as the default option unless there is a failure condition hit during replacement procedure. If
there is a failure, the Collect Diagnostics is collected automatically by the script.
24. [ ] VPlexcli When the script is complete, type the following command:
VPlexcli:> exit
25. [ ] Shell At the shell prompt, type the following command to reboot the management server:
service@ManagementServer:~> sudo /sbin/shutdown –r now
Xxxre-establish-migration
Xxxwitness_enable
Task 11: VPLEX Metro or VPLEX Geo with Cluster Witness only: Re-enable Cluster Witness
Follow these steps if you disabled Cluster Witness earlier in this procedure:
cluster-witness enable
[ ] VPlexcli When prompted Continue?, type Yes and press Enter.
2. [ ] VPlexcli Type the ls command, and confirm that the output shows cluster-witness as admin-
state = enabled.
Note: If RP connections are not restored, then follow Task 13 else follow Task 14.
XxxRP-add
This will restart the VPLEX CLI on the replacement management station, and require a new login to
the VPLEX CLI.
2. [ ] VPlexcli Type the following command to register the RecoverPoint cluster with the VPLEX CLI:
rp rpa-cluster add –o rpa-management-address –u admin-username –c cluster-id
Use the same rpa-management-address, admin-username, and cluster-id as was used on original
management station.
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 15 of 16
ls /recoverpoint/rpa-clusters/rpa-management-address
2. [ ] Linux shell From the shell prompt, type the following command to exit the shell session:
exit
a. Disconnect the cable from the Ethernet port on your laptop, and remove your laptop from the
laptop tray.
b. Slide the cable back through the cable tie until only one or two inches protrude through the tie, and
then tighten the cable tie.
c. Slide the laptop tray back into the cabinet.
d. Replace the filler panel at the U23 position.
e. If you used the cabinet’s spare Velcro straps to secure any cables out of the way temporarily,
return the straps to the cabinet.
• Non-EMC cabinet:
Dell Technologies Confidential Information- for internal use only version: 2.9.0.87
Page 16 of 16