appsync installation and configuration guide · n vnx, vnxe, unity n vmax/ powermax n xtremio n...

Dell EMC AppSync®Version 3.9

Installation and Configuration Guide302-005-745

01

Copyright © -2019 Dell Inc. or its subsidiaries. All rights reserved.

Published April 2019

Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND

WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF

MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED

IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.

Published in the USA.

Dell EMCHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.DellEMC.com

2 Dell EMC AppSync 3.9 Installation and Configuration Guide

Preface 5

Prerequisites 7AppSync server prerequisites.......................................................................8Application host plug-in prerequisites...........................................................8AppSync console prerequisites .................................................................. 10

Display recommendations ..............................................................10Checklist for AppSync deployment.............................................................. 11

Installation 13Installing AppSync.......................................................................................14

Installing the AppSync server......................................................... 14Adding servers to AppSync ........................................................... 15Installing the host plug-in manually - Windows servers only........... 17UNIX host plugin push install with SUDO user................................18

Upgrading AppSync.................................................................................... 21Upgrading the AppSync server.......................................................21Upgrading the AppSync agent plug-in .......................................... 22

Uninstalling AppSync..................................................................................23Removing a server from AppSync .................................................23Removing a server forcefully from AppSync ................................. 23Uninstalling the AppSync agent plug-in......................................... 24Uninstall the AppSync server ........................................................25

Licensing in AppSync 27Licensing in AppSync..................................................................................28

Obtaining a license online.............................................................. 29Uploading and installing a license file............................................. 29

Configuration and resource management 31Resource management .............................................................................. 32

Adding a RecoverPoint site ...........................................................32Adding VMAX, VMAX3, VMAX All Flash, and PowerMax storage....34Add a VNX, VNXe, or a Unity array to AppSync.............................37Adding and registering ViPR Controller storage to AppSync .........39Add an XtremIO array to AppSync ................................................40Adding a VPLEX cluster to AppSync..............................................40Adding a Dell SC array to AppSync................................................ 42Viewing storage............................................................................. 42Removing a storage system .......................................................... 42Rediscovering a storage system ................................................... 43Adding a VMware vCenter Server .................................................43

Backup and restore AppSync using the Backup Assistant tool................... 45AppSync Backup Assistant arguments and actions........................45Schedule automated backup of the AppSync server database.......45Restore an automated backup....................................................... 46

Chapter 1

Chapter 2

Chapter 3

Chapter 4

CONTENTS

Dell EMC AppSync 3.9 Installation and Configuration Guide 3

Migrating the AppSync server.................................................................... 46

CONTENTS


Preface

As part of an effort to improve its product lines, Dell EMC periodically releasesrevisions of its software and hardware. Therefore, some functions described in thisdocument might not be supported by all versions of the software or hardwarecurrently in use. The product release notes provide the most up-to-date informationon product features.

Contact your Dell EMC technical support professional if a product does not functionproperly or does not function as described in this document.

Note

This document was accurate at publication time. Go to https://support.emc.com toensure that you are using the latest version of this document.

PurposeThis document is part of the AppSync documentation set, and includes information oninstalling and configuring AppSync.

AudienceThis guide is intended for use by customers and service providers to install andconfigure AppSync.

Related documentationThe following publications provide additional information:

l AppSync User and Administration Guide

l AppSync Release Notes

Special notice conventions used in this documentDell EMC uses the following conventions for special notices:

DANGER

Indicates a hazardous situation which, if not avoided, will result in death orserious injury.

WARNING

Indicates a hazardous situation which, if not avoided, could result in death orserious injury.

CAUTION

Indicates a hazardous situation which, if not avoided, could result in minor ormoderate injury.

NOTICE

Addresses practices not related to personal injury.

Preface 5

https://support.emc.com

Note

Presents information that is important, but not hazard-related.

Typographical conventionsDell EMC uses the following type style conventions in this document:

Table 1 Typographical conventions

Bold Used for names of interface elements, such as names of windows,dialog boxes, buttons, fields, tab names, key names, and menu paths(what the user specifically selects or clicks)

Italic Used for full titles of publications referenced in text

Monospace Used for:

l System code

l System output, such as an error message or script

l Pathnames, filenames, prompts, and syntax

l Commands and options

Monospace italic Used for variables

Monospace bold Used for user input

[ ] Square brackets enclose optional values

| Vertical bar indicates alternate selections - the bar means “or”

{ } Braces enclose content that the user must specify, such as x or y orz

... Ellipses indicate nonessential information omitted from the example

Where to get helpDell EMC support, product, and licensing information can be obtained as follows:

Product informationFor documentation, release notes, software updates, or information about Dell EMCproducts, go to https://support.emc.com.

Technical supportGo to https://support.emc.com and click Service Center. You will see several optionsfor contacting Dell EMCTechnical Support. Note that to open a service request, youmust have a valid support agreement. Contact your Dell EMCsales representative fordetails about obtaining a valid support agreement or with questions about youraccount.

Online communitiesVisit https://community.emc.com/ for peer contacts, conversations, and content onproduct support and solutions. Interactively engage online with customers, partners,and certified professionals for all Dell EMC products.

Your commentsYour suggestions will help us continue to improve the accuracy, organization, andoverall quality of the user publications. Send your opinions of this document to [email protected].

Preface




https://community.emc.com/

mailto:[email protected]

CHAPTER 1

Prerequisites

This chapter includes the following topics:

l AppSync server prerequisites...............................................................................8l Application host plug-in prerequisites.................................................................. 8l AppSync console prerequisites .......................................................................... 10l Checklist for AppSync deployment......................................................................11

Prerequisites 7

AppSync server prerequisitesThe AppSync server must meet specific prerequisites.

The AppSync Support Matrix on https://elabnavigator.emc.com/eln/modernHomeDataProtection is the authoritative source of information on supportedsoftware and platforms.

The AppSync Security Configuration Guide provides more information on portrequirements.

Table 2 AppSync server prerequisites

Item Value

Operating system Windows Server 2008 SP2 (x64), Windows Server 2008R2 (x64), Windows Server 2008 R2 SP1 (x64), WindowsServer 2012, Windows Server 2012 R2, Windows Server2016, Windows Server 2019.

Disk space 1249 MB minimum. Exact value appears in the installationwizard.

Memory 6 GB minimum, 8 GB recommended.

CPU 2 CPU minimum, 4 CPU recommended.

Virtual environments l VMware virtual machine. Memory and disk spacerequirements are the same as on physical host.

l HyperV.

Application host plug-in prerequisitesReview this information for specific requirements before you install the AppSyncagent (host plug-in). The AppSync Support Matrix on https://elabnavigator.emc.com/eln/modernHomeDataProtection is the authoritative sourceof information on supported software and platforms.

Table 3 Application host plug-in prerequisites

Item Value as of GA (refer to support matrix for latestversions)

Operating system l Windows Server

l Linux

l AIX

Disk space 150 MB minimum. Exact value is displayed in theinstallation wizard.

Memory 2 GB minimum

CPU 2 CPUs

Prerequisites


https://elabnavigator.emc.com/eln/modernHomeDataProtection




Table 3 Application host plug-in prerequisites (continued)

Item Value as of GA (refer to support matrix for latestversions)

Virtual environments l VMware virtual machine. Memory and disk spacerequirements are the same as on physical host.

l HyperV

Windows ports 10004, pushing the host plugin to a Windows host requiresCIFS access (TCP port 135 and TCP port 445).

UNIX ports: Source IP is AppSync server:

l Destination IP = Production or mount host runningUNIX AppSync Host plug-in

l Destination port = 22 (SSH port), Protocol: TCP

Source IP = Production or mount host running UNIXAppSync host plug-in

l Destination IP = AppSync server

l Destination Port = 22 (SSH Port). Protocol: TCP

Note

You can modify the SSH port value after the UNIX host isregistered.

The AppSync Security Configuration Guide provides more information on portrequirements.

Supported device configurations

Table 4 Supported device configurations

AIX LINUX

Multipath: Multipathing package is requiredfor platforms running VNX, VNXe, Unity,XtremIO, VPLEX, VMAX, or RecoverPoint onVNX in non-virtualized environments.

l Native MPIO

l PowerPath

Multipath: Multipathing package is requiredfor platforms running VNX, VNXe, Unity,XtremIO, VPLEX, VMAX, or RecoverPoint onVNX in non-virtualized environments.

l Native MPIO

l PowerPath

l Veritas DMP

n Supported where both production andmount host have DMP installed andDMP devices do not have a partition.

n Supported with non-ASM database onVXDMP devices with or withoutVXVM Volume manager

Device mapping using:

l Symbolic links

Device mapping using:

l Linux-ASMLib (ASM only)

Prerequisites

Application host plug-in prerequisites 9

Table 4 Supported device configurations (continued)

AIX LINUX

l mknod devices

l Block devices

l UDEV bindings

l Dev-mapper devices

l Block devices with O_DIRECT

l Symbolic links

File systems:

l jfs and jfs2

l ext2, 3, 4

l XFS (necessary rpms needed onproduction as well as mount host)

l VxFS (When using VxVM)

Volume Manager:

l Native LVM

Volume Manager:

l Native LVM

l VxVM Supported device configuration:

n Non ASM database on VXVM VolumeGroup

AppSync console prerequisitesThe AppSync console runs on a variety of web browsers.

Supported browsers follow, for version support : The AppSync Support Matrix on https://elabnavigator.emc.com/eln/modernHomeDataProtection is the authoritativesource of information on supported software and platforms.

l Internet Explorer

l Firefox

l Chrome

Flash is required regardless of the browser type, minimum version 10.2.

The console requires 1 GB of RAM when loaded and working at capacity. The followingports are required and their uses are listed here:

l 8085: This port is used as an HTTP port and works for REST.

l 8444: This port is as an HTTPS port for CAS authentication.

l 8445: This port is used as an HTTPS port for both GUI & REST.

The AppSync Security Configuration Guide provides more information on the portrequirements.

Display recommendationsAs a recommendation, use a display resolution of 1280x1024 forAppSync.

Prerequisites



Checklist for AppSync deploymentLearn about initial AppSync deployment steps and how to use the checklist as a mapfor installation and security concerns.

Table 5 Deployment checklist

Basic step Details Notes Done?

Identify a system running a supportedversion of Windows to act as theAppSync server.

Refer to a recent support matrix for AppSync for exactWindows versions for the AppSync server. Refer to the listof server prerequisites in this guide for other details.

Note

An IPv6 host is not supported.

Verify that you have a supported webbrowser to run the AppSync console.

Refer to the Console prerequisites topic for the list ofsupported browsers.

Verify that the application host (forexample, Microsoft Exchange mailboxserver) meets requirements.

Refer to AppSync User and Administration Guide and thelatest AppSync Support Matrix .

Install the AppSync server executableon the designated server system.

Obtain server installation executable fromsupport.EMC.com.

From a web browser, open theAppSync console.

http://<appsync_server>:8085/appsync

From the desktop shortcut ortheAppSync console, add the storagewhere application data resides.

l To add any of the following storage arrays, go to

Settings > Storage Infrastructure

n VNX, VNXe, Unity

n VMAX/ PowerMax

n XtremIO

n RecoverPoint

n VPLEX

n ViPR Controller

n Dell SC

l If mounting copies to a virtual machine, browse to

Copy Protection > VMware Datacenters and

click Discover Datacenters > Add vCenterServers.

Or, navigate to Settings > VMware vCenterServers > Add.

l IPv6 address is not supported for any arraymanagement server or storage processor.

From the AppSync console, install theAppSync host plug-in on theapplication host.

Settings > Servers and click Add. When securityprevents push-install, manually install by running AppSync-Host-Plug-in-3.9-win-x64.exe on the host.

Prerequisites

Checklist for AppSync deployment 11

Table 5 Deployment checklist (continued)

Basic step Details Notes Done?

Note

l This is only applicable for Windows.

l You cannot register hosts with IPv6 IP address.

From the AppSync console, discoverapplication objects on the respectiveservers.

Copy Management > Microsoft Exchange / SQLServer / Oracle / VMware Datacenters /FileSystem.

From the AppSync console, subscribeapplication objects to a service plan tobegin data protection.

Copy Management > Microsoft Exchange / SQLServer / Oracle / VMware Datacenters /FileSystem.

l Protect immediately with Subscribe to Plan andRun, which subscribes the application object to aservice plan and runs the protection immediately for theselected object only.

l Subscribe to Plan, which subscribes the applicationobject to a service plan, but does not run the plan.Protection occurs according to the service plan'sschedule.

From the AppSync console, you cancreate copies of your database and filesystems for application testing andvalidation, test and development,reporting, data masking, and dataanalytics. Use the Repurpose wizard toschedule or immediately create first orsecond generation copies, asrequired.AppSync supportsrepurposing on File systems, SQLServer and Oracle databases.

Copy Management > File system, Oracle, or SQLServer to display the list of available applications.

l Select the database instance that you want to

Repurpose, and then select Repurpose to launch thewizard.

l Follow the wizard steps.

l Select Run now ,Run Recurrently As PerSchedule, or Run Only Once At later time.Complete details appear in the online help and userguide.

From the AppSync console, you canconfigure AppSync to communicatewith ESRS and provide systemconfiguration information to Dell EMC.

Settings > Remote Support > Register to registerESRS.

Prerequisites


CHAPTER 2

Installation

This chapter includes information on how to install your AppSync software. Forinformation on how to install arrays, see the chapter Configuration and ResourceManagement.

Topics in this chapter include:

l Installing AppSync.............................................................................................. 14l Upgrading AppSync............................................................................................ 21l Uninstalling AppSync......................................................................................... 23

Installation 13

Installing AppSyncTo install AppSync, you must perform the following operations:

l Installing the AppSync server.

l Adding servers to AppSync.

l Installing the host plug-in manually.

If you want to upgrade an existing AppSync installation to the current full version referto Upgrade your AppSync installation.

Installing the AppSync serverThe first step in the AppSync installation process is to install the AppSync server.

Before you begin

Obtain the installation executable from the AppSync distribution or from the AppSyncdownload page on the Dell EMC Support website.

Procedure

1. Run the executable installation file.

2. Accept the license agreement, and click Next.

3. On the Choose Install folder screen, specify the location where you want toinstall AppSync.

The default location is C:\EMC\AppSync.

Note

The install location cannot contain space. If you change the default location,click Restore Default Folder to restore the default location.

4. On the AppSync Administrator screen, enter a user name and password forthe default administrator account.

Note

The password for the default administrator account must be a minimum of eightcharacters, must be mixed case, and it must contain at least one number andone special character from the following list: ! , @ # $ % ^ * ? _ ~

5. On the AppSync Ports screen, modify the default http, https, CAS, and tomcatport details, if required.

6. Click Next.

The Pre-installation Summary page appears.

7. Review the installation summary, and click Install.

After installation is complete, you can view the installation log. The installationlog for the AppSync server, appsync_setup.log, is located in the folderdefined by the installing user's TEMP environment variable.

8. Click Done.

The AppSync Login screen appears.

Installation


9. Log in to the AppSync Server.

The AppSync Dashboard appears.Figure 1 Dashboard screen

a. Clear Add Storage now and click OK to proceed to installing the host plug-in.

b. Click OK to configure storage.

Adding servers to AppSyncLearn how to add your servers to your AppSync configuration.

Before you begin

Review this information before you begin. When you add a server, AppSync registersthe server in its database and discovers the supported applications on that server. Ifthe host plug-in software is not already present, AppSync attempts to install it. If thehost plug-in software is present, AppSync attempts to register it. An error occurs ifthe host plug-in software is already registered to another AppSync server.

l The servers must be accessible over IP to the AppSync server.

l The AppSync server must be accessible to the application server by hostname.

l You need to supply credentials for an account that has local administratorprivileges on the server.

l For Windows servers: if the server is not part of a domain, disable the followinguser access control: User Access Control: Run all administratorsin Admin Approval Mode .

l On Windows, AIX/Linux, AppSync can push install the host plugin software. OnWindows, you have the option to manually install the software on the applicationservers.

l For Windows Servers: If the Windows Server is used for mounting a copy,automount must be disabled. To manually disable automount run diskpart at acommand prompt then enter automount disable at the DISKPART> prompt.

Installation

Adding servers to AppSync 15

l Register the Virtual Center managing the application server VM. Adding a VMwarevCenter Server provides more information on adding a VMware vCenter Server toAppSync.

This operation requires the Resource Administrator role in AppSync.Procedure

1. Select Settings > Servers.

2. Click Add. You can select to add Windows Servers or UNIX Servers.

Note

Dell EMC recommends that you add a UNIX host using the FQDN thatcorresponds to the physical IP of the host.

3. For each server, enter the host name or IP address, domain\username, andpassword.

Optionally, you can automatically repeat the credentials from the first entry forthe subsequent entries. For a local account, use the server name as the domain.If you are protecting databases in an Exchange DAG, add the DAG memberservers that host the database copies that you want to protect.

If you want to protect SQL Server databases in availability groups on a WindowsAlwaysOn failover cluster, add each node of the cluster. If you are protectingSQL Server databases in a clustered instance of SQL Server, add the SQLServer virtual server. Before you add the SQL Server virtual server, you mustfirst install the AppSync agent host plug-in software on all of the nodes in thecluster using the Add Servers wizard or by manually installing the software.

Note

If SQL Server virtual server is added before the AppSync agent host plug-in isinstalled on all physical nodes of the cluster, Add virtual server can fail.

In a PowerHA (HACMP) cluster environment, do the following:

l Add active node of the cluster

l Add passive node of the cluster

l Add the service label IP of the Oracle database or File system that you wantto protect

4. Expand Push Install Settings to customize agent host-plugin installation.

You can specify the agent host plug-in version to install, the port, and thelocation where to install the agent host plug-in. For a UNIX host, the defaultinstall location is /opt/emc/ and the default port is 22. By default, AppSyncextracts the host plug-in to a folder named appsync under this location. Thesame rule is applicable even if you change the install location. For example, ifthe location is /opt/emc/user1/agent, the AppSync agent host plug-in willbe under /opt/emc/user1/agent/appsync. These values apply to eachserver that you are adding.

Available plug-in versions depend on what is available on the AppSync server.On Windows servers, the default port is 10004; valid range is from 1024 to49151. The default install location is system drive\Program Files\EMC\AppSync Host Plug-in.

Installation


Note

The default install-plug-in versions are sorted based on the latest version.

5. Click Start.

Figure 2 Add Unix Servers

Installing the host plug-in manually - Windows servers onlyInstall the host plug-in manually when a firewall or other security measure preventspush installation from the server to the application host.

Before you begin

Obtain the AppSync host plug-in installation executable from the AppSync distributionor from the AppSync support page on https://support.emc.com

Procedure

1. Run the plug-in executable installation file.

2. Follow the instructions on the wizard to complete the host plug-in installation.

Note

If you have used a non-default port setting, keep a record of it. You mustspecify it when you add the host in AppSync.

After you finish

Manually installed hosts must also be added to AppSync. Use the AppSync console,under Settings > Servers.

Installation

Installing the host plug-in manually - Windows servers only 17

http://support.emc.com/

UNIX host plugin push install with SUDO userThis section describes the prerequisites for adding a UNIX agent host with SUDO userprivileges to the AppSync server. This is useful in secure environments where you donot want AppSync to use root user privileges.

AIX deployment requirements

l OpenSSH and OpenSSL packages. OpenSSL is a pre-requisite for OpenSSHinstallation.

l The following packages are mandatory for AppSync to work with AIX hosts.

n BZip2 package. Zlib package is a prerequisite for Bzip2 installation.

n SUDO package (only if you want the SUDO feature), or OpenSSH andOpenSSL. Zlib is a pre-requisite for enabling the SUDO feature.

n CentOS.

n Supported Oracle database software that is installed on mount hosts fordatabase recovery.

n Supported Oracle database that is created on production hosts with /etc/oratab entries.

n Valid Oracle database configurations as described previously in this section.

Package locations:

l OpenSSH and OpenSSL packages are on the OS CD.

l Bzip2, Zlib, and SUDO are on the IBM AIX Toolbox website.

To perform a push install of the AppSync host plugin on an AIX host from the AppSyncserver:

1. Install the SUDO RPM package.

2. Install zlib, if it is not already installed.

3. Install OpenSSH.

4. Run SFTP server as root.

5. Create a {user} using smit on the AIX host where you plan to run the AppSynchost plug-in. .

6. Grant the {user} read, write, and execute permissions to the install locationdirectory (and to all its subdirectories recursively) that you select in Add UnixServers of the AppSync GUI.

7. Edit the sudoers file using the visudo command. (You must edit this file asroot.)

8. Add the following three lines at the end of the file:

Defaults:{user} !requirettyDefaults:{user} !env_reset{user} ALL = (root) NOPASSWD: /{install location}/appsync/acp

Where {user} is the user name you created, {install path} is the locationwhere you want to install the AppSync host plug-in.

Installation


For example, if the {user} created is appsync and the {install location}is /opt/emc, and you want to apply it to ALL the agent hosts, the entry looks likethe following:

Defaults:appsync !requirettyDefaults:appsync !env_resetappsync ALL = (root) NOPASSWD: /opt/emc/appsync/acp

If you want to restrict to one agent host such as lrmp333.org.com, change thelast line to the following:

appsync lrmp333.org.com = (root) NOPASSWD: /opt/emc/appsync/acp

Ensure that the secure_path variable is set to default. This is required forAppSync to execute some basic commands which reside in these directories.

Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin9. Start SFTP server service for the created SUDO user. For example, SSH as SUDO

user and execute the sftp-server& command.

10. Provide the username and password of the created SUDO {user} in the Add UnixServers dialog of the AppSync console. Ensure that you specify the {installlocation} used above for Push Install Settings, and click Start to proceed.

Linux deployment requirementsFor the latest support versions, see the AppSync Support Matrix.

Linux deployment requirements include:

l Red Hat Linux

l BZip2 package.

l Oracle® Linux.

l CentOS.

l SuSE Linux.

l Compatible Linux sg3_utils package.

l Supported Linux host with root SSH enabled or another OS user with SUDOfeature enabled.

l Supported Oracle database software that is installed on mount hosts for databaserecovery.

l Supported Oracle database that is created on production hosts with /etc/oratabentries.

l A valid Oracle database configuration.

To perform a push install of the AppSync host plugin to a LINUX host from theAppSync server:

1. Create a user {user} on the Linux host where you plan to run the AppSync hostplug-in.

2. Grant the {user} read, write, and execute permissions to the install locationdirectory (and to all its subdirectories recursively) that you select in Add UnixServers of the AppSync GUI.

3. Edit the sudoers file using visudo. (You must edit this file as root.)

Installation

UNIX host plugin push install with SUDO user 19

4. Add the following three lines at the end of the file:

Defaults:{user} !requirettyDefaults:{user} !env_reset{user} ALL = (root) NOPASSWD: /{install location}/appsync/acp

where {user} is the user name you created, {install path} is the locationwhere you want to install AppSync host plug-in.

For example, if the {user} created is appsync and the {install location}is /opt/emc, and you want to apply it to ALL the agent hosts, the entry looks likethe following:

Defaults:appsync !requirettyDefaults:appsync !env_resetappsync ALL = (root) NOPASSWD: /opt/emc/appsync/acp

If you want to restrict to one agent host such as lrmp333.org.com, change thelast line to the following:

appsync lrmp333.org.com = (root) NOPASSWD: /opt/emc/appsync/acp

Ensure that the secure_path variable is set to default. This is required forAppSync to execute some basic commands which reside in these directories.

Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin5. Provide the username and password of the created SUDO {user} in the Add Unix

Servers dialog of the AppSync console. Ensure that you specify the {installlocation} used above for Push Install Settings, and click Start to proceed.

Configuring UNIX agent parametersYou can configure a temporary location and a command execution timeout value foreach UNIX host from the Servers page of the AppSync console.

Temporary location for UNIX hostsYou can configure a temporary location for each UNIX host from the Servers page.AppSync uses this location during Oracle mount operations to store information thatwas previously located in /tmp/<SID>/.

The default temporary location is /tmp/ unless otherwise specified.

Command execution timeoutYou can configure a command execution timeout value for each UNIX host from theServers page of the AppSync console. AppSync uses this value to wait for eachoperating system command that is executed by AppSync on a UNIX platform. Thedefault value is 60 minutes. For example, if fsck during file system copy mount takesmore than 60 minutes on a host, you can increase the command execution timeoutvalue.

Rediscovering the AppSync agent hostRediscovering an AppSync agent host updates the agent host information on theAppSync Server. For example, if you add a new supported application to the

Installation


application server, you can use Rediscover to refresh the AppSync server with thenew associated application information.

Before you begin



2. Select the server you want to refresh.

3. Select Rediscover.

4. Select Yes to confirm.

Upgrading AppSyncTo upgrade AppSync, you must perform the following operations:

l Upgrade the AppSync server

l Upgrade the AppSync agent plugin

Upgrading the AppSync serverBefore you begin

l Disable all service plans and make sure there is no current activity on the AppSyncserver.

l On the AppSync console, go to Help About > About Dell EMC AppSync and noteyour complete AppSync version.

l Additionally, note any hand-edit procedures to configuration files that CustomerSupport requested you to perform for your AppSync server installation. Forinformation on adding back these edits, refer to the section, Moving AppSyncserver back to the previous version after an upgrade.

l Go to your \EMC\Appsync\Jboss\datastore\data and click Properties toview the size of this directory. During upgrade, AppSync runs a backup of theserver that requires 40% of the size of this directory, so plan a backup savelocation with the required amount of free space.

l Verify if the version that you have installed supports an upgrade. The AppSyncRelease Notes provides more information on the upgrade paths.

You do not have to uninstall the previous version of AppSync before installing a newversion.

Note

Before you upgrade, refer to the prerequisites required for the server in the previouschapter.

AppSync runs a backup (and restore) of the existing server before you upgrade. Thisprocess is documented in the configuration section of this document.

To upgrade the AppSync server:

Procedure

1. Obtain the installation executable file from the AppSync distribution or from theAppSync page on the Dell EMC Support website.

Installation

Upgrading AppSync 21

2. Run the executable installation file.

3. Follow the instructions on the wizard to upgrade the server.

After you finish upgrading the server, ensure that you upgrade the AppSynchost-plug-ins.

Upgrading the AppSync agent plug-inThis section describes how to upgrade the AppSync agent (host plug-in).

Before you begin

This operation requires the Resource Administrator role in AppSync. If the server isnot part of a domain, the following user access control must be disabled: "User AccessControl: Run all administrators in Admin Approval Mode".When updating Exchange Mailbox or utility servers, you will also need the credentialsfor running the AppSync Exchange Interface service. This service is reconfiguredduring update.

For AppSync 3.9, verify that the agent host plug-in is on version 3.7 or later. If theagent host plug-in is on a version earlier than 3.7, upgrade the agent host plug-in to3.7 first, and then upgrade to 3.9.

Note

Ensure that the AppSync host plug-in and the AppSync server are at the sameversion.

Procedure


2. Select the server and select Update Plug-in from the action button below theServers table.

The Update Server Plug-in window appears

3. Select the server, and click Set Username and Password.

If you select multiple servers, they must all have the same credentials.

4. Specify credentials of an account with local administrator privileges on theservers and click OK.

If an Exchange Mailbox or utility server is in the list, you will be asked to enterthe credentials for running the AppSync Exchange Interface service. Specifythe credentials and click OK.

5. Select the latest plug-in version from the Install plug-in version list.

6. Click Start to update the host plug-in.

After you finish

If you are updating a host plug-in on Exchange servers, refer to the latest AppSyncUser and Administration Guide.

Rediscovering the AppSync agent hostRediscovering an AppSync agent host updates the agent host information on theAppSync Server. For example, if you add a new supported application to the

Installation


application server, you can use Rediscover to refresh the AppSync server with thenew associated application information.

Before you begin



2. Select the server you want to refresh.


4. Select Yes to confirm.

Uninstalling AppSyncTo uninstall AppSync:

l Uninstall the AppSync host plugin

l Uninstall the AppSync server

Removing a server from AppSyncThe Remove Servers Only operation deletes the server's entry in the AppSyncdatabase.

Before you begin

This operation requires the Resource Administrator role in AppSync.

You cannot remove a server if its databases are subscribed to service plans, if it hascopies or has copied mounted, or if it is used in any script phases.

Procedure


2. Select a server, and click the Remove > Remove Servers Only button.

3. Select Yes in the Remove Servers dialog.

If successful, the host is removed from the list under Settings > Servers. If not,an error message displays indicating why the removal failed.

After you finish

If the server you removed is one of the members of a DAG, you must rediscoverdatabases in AppSync.

Removing a server forcefully from AppSyncThe Remove server forcefully operation forcefully deletes the server's entry in theAppSync database.

Before you begin


You can forcefully remove a server even if its databases are subscribed to serviceplans, if it has copies mounted, or if it is used in any script phases.

Procedure


Installation

Uninstalling AppSync 23

2. Select a server, and click the Remove > Remove server forcefully button.

3. Click Yes in the Remove Servers dialog.

If successful, the host is removed from the list under Settings > Servers. If not,an error message displays indicating why the removal failed.

Note

l Forcefully removing a host from AppSync only removes copies fromAppSync. You must manually unmount the mounted copies from the mounthost, delete copies from the arrays, and uninstall the plug-in from the host.

l If you forcefully remove a mounted host from AppSync, ensure that youmanually clean up the mount host, related ESX (if any), and storage arraybefore reusing the copy again.

After you finish

If the server you removed is one of the members of a DAG, you must rediscoverdatabases in AppSync.

Uninstalling the AppSync agent plug-inThe Deinstall plug-in and remove operation uninstalls the plug-in software from theselected servers and then removes the server's entry in the AppSync database.

Before you begin

This operation requires the Resource Administrator role in AppSync. If the server isnot part of a domain, the following user access control must be disabled: "User AccessControl: Run all administrators in Admin Approval Mode".Procedure


2. Select one or more servers and select Deinstall plug-in and remove.

3. Select servers from the Deinstall Server Plug-in wizard.

The wizard allows multi-selection. In these cases, the same user name andpassword will be applied to all selections.

4. For each server you wish to deinstall the plug-in, select Set Username andPassword.

5. Specify credentials of an account with local administrator privileges on theservers and click OK.

6. Click Start to deinstall the server plug-in and remove the server from AppSync.

The deinstallation progress displays in the progress column for each server. Ifthere are failures, they display with a red icon.

7. If some of the servers fail deinstallation, you can retry. Select Clear Successfuland then select Start again.

Installation


Uninstall the AppSync serverUninstall the AppSync server by running the native Windows uninstall utility.

Before you begin

l Be sure you are logged in as a user with Windows Administrator privileges.

l Remove hosts in Settings > Servers before uninstalling the server.

l This operation requires the Resource Administrator role in AppSync.

Procedure

1. Run the native Windows uninstall utility.

2. Follow the wizard steps.

Files and folders added after installation are not removed.

Moving AppSync server back to the previous version after an upgradeThis procedure shows you how to roll back to a previously installed version of theAppSync server.

Before you begin

Dell EMC recommends that you contact Customer Support to resolve issues with thenewer, enhanced version of AppSync you are currently running before trying to rollback to an earlier version.

You need your previous and current AppSync versions that you collected when youinstalled the current version of AppSync. Refer to Upgrading the server.

Procedure

1. Copy your license files to a safe place from the /EMC/AppSync/licensefolder.

2. Disable all Service Plans and make sure there is no current activity on theAppSync server.

3. Uninstall the AppSync server application from the host.

After the uninstall completes, the /EMC/AppSync folder should not be presenton the machine.

4. Re-install the version of AppSync server that was on the host prior to upgradethat you noted during the server upgrade procedure (Upgrading the server).

Make sure you apply the exact version of AppSync that includes the exactcumulative hotfix number, if a hotfix was previously installed.

5. Re-apply any hand-edit procedures to configuration files that a readme or DellEMC Customer Support Representative requested that you implement for yourprevious AppSync server installation.

6. Restore the automated backup, refer to: Automated backup restore.

7. Re-apply your AppSync licenses from the AppSync application.

Installation

Uninstall the AppSync server 25

Installation


CHAPTER 3

Licensing in AppSync

This chapter discusses the following:

l Licensing in AppSync......................................................................................... 28

Licensing in AppSync 27

Licensing in AppSyncAppSync provides a 90 day trial license for all supported arrays.

AppSync has the following licence types:

l Full license - Is an array based license.

l Starter Bundle license - Allows you to use unlimited amount of storage on aspecific array with some restrictions on the features supported by AppSync. Thisis only available for Unity, VMAX All Flash/PowerMax, and XtremIO arrays.With Starter Bundle, you can:

n Add only one storage array per AppSync server.

n Mount only 20 application copies. It can be a snapshot of Oracle, MicrosoftSQL, Microsoft Exchange, File systems, or VMware datastores. For example:

– If you have 20 volumes in one database, and that database is part of aservice plan that mounts, it will constitute one of the 20. It is not based onthe number of volumes.

– If you have 20 file systems subscribed to a service plan and is mounted, itwill be considered as 20 mounts.

Note

– If you add additional arrays or mount additional copies, the license is markedas non-compliant, and alerts are sent to the configured recipient addressspecified in the AppSync > Settings > Appsync server settings page.

– If a permanent license for one array is added with starter pack license foranother array, both the licenses are marked as non-compliant. After thestarter pack license is upgraded to a permanent license, you must reapplythe permanent license for the second array, or wait for the license validationthread to run to clear the non compliance status for the second array.

– RecoverPoint, VPLEX, XtremIO native replication, Unity native replication,and remote SRDF copies are not supported.

l Volume Software License (VSL) - Allows you to use a specific amount of storageregardless of the array type.

Note

If you already have an APPSYNC_VSL license installed, and if you attempt toinstall another APPSYNC_VSL file, the new file overrides the content of the earlierfile. Therefore, before upgrading the license, take a backup of the earlier content.

l Unlimited license for DPS - This is similar to a VSL license without anyenforcement on capacity or utilization. Allows you to use storage from any type ofarray configured in AppSync with no limitation on the amount of storage fromeach array.



Note

l For RecoverPoint and VPLEX, no separate license is required. The back-end arraylicenses are checked in the case of VPLEX and RecoverPoint. You must ensurethat the appropriate license files are installed for replication to proceed.

l For ViPR arrays, no separate license is required.

Obtaining a license onlineYou can access the license management page through the AppSync console.

Before you begin


l You need the License Authorization Code (LAC) that was emailed from Dell EMC.

Procedure

1. Select Settings > Licenses.

2. Click Obtain License File Online.

This brings you to the license management page on the AppSync support site.

3. Enter the required information to acquire and save the license file.

In the License management web page, you are prompted to enter a Machinename as part of the process. Dell EMC recommends that you enter AppSync-arrayserialnumber where arrayserialnumber is the serial number of the array.

After you finish

Once you have obtained the license file, you need to upload and install it to theAppSync server.

Uploading and installing a license fileYou must upload the license file to AppSync.

Before you begin


l Obtain the license file —The license file must have a filename extension of .lic andmust reside in a browsable location.

Procedure

1. Select Settings > Licenses.

2. Select Upload and Install License File.

3. Browse to and select the license file.


Obtaining a license online 29

CHAPTER 4

Configuration and resource management

This chapter includes the following topics:

l Resource management ......................................................................................32l Backup and restore AppSync using the Backup Assistant tool........................... 45l Migrating the AppSync server............................................................................46

Configuration and resource management 31

Resource managementUse Settings > Servers to manage hosts.

Use Settings > Storage Infrastructure to manage storage systems and RecoverPointsites.

Use Settings > VMware vCenter Servers to manage vCenter Servers.

Adding a RecoverPoint siteLearn how to add a RecoverPoint site to offer Local protection, Remote replication,and Local and Remote replication protection that is provided by Bronze, Silver, andGold service plans.

Before you begin


Procedure

1. Select Settings > Storage Infrastructure.

2. Select Add > RecoverPoint Sites.

3. Type the site management IP address or hostname for the RecoverPoint site, orRPA cluster name.

In a Local and Remote replication configuration, you must add one site, then theothers are discovered automatically.

4. Type an existing username and password for an account that has aRecoverPoint Admin role to access the site.

Note

If you upgrade a SOAP enabled RecoverPoint version earlier than 4.1.1 to thesame or a later REST enabled version, you must add RecoverPoint to AppSyncagain.

Updating the RecoverPoint site management IP addressUpdate AppSync when a RecoverPoint site's management IP address changes.

Before you begin


1. Select Settings > Storage Infrastucture.

2. Select the RecoverPoint site.

3. In the Details pane, in the IP Address field, enter the new site management IPaddress for the RecoverPoint site and click Apply.



Rediscovering a RecoverPoint siteThe Rediscover operation initiates a discovery of site information. For example, theRediscover operation may find additional RPAs or changes in site name (if invalid logincredentials impede connectivity).

Before you begin



2. Select a RecoverPoint site or sites.


Removing a RecoverPoint site

Before you begin

This operation requires the Resource Administrator role in AppSync. Removal fails ifsites are in use.Procedure



3. Select Remove.

Setting the credentials for a RecoverPoint applianceSpecify RecoverPoint appliance credentials when adding the RPA to AppSync andwhen the credentials change on the RPA itself.

Before you begin

Ensure you obtain the credentials for the RecoverPoint appliance. The account thatyou specify must have the RecoverPoint Admin role.

Initially, specify the credentials when you add the RecoverPoint appliance to AppSync.To update the credentials in AppSync later, follow these steps:

Procedure

1. Select Reset Login Credentials from a RecoverPoint site that is listed inSettings > Storage Infrastructurepage of the console.

2. Add the current credentials for the appliance.

Viewing RecoverPoint sitesView RecoverPoint sites under the Settings tab.

Before you begin


Procedure



The Details pane displays information for the RecoverPoint sites you selected.


Adding a RecoverPoint site 33

Adding VMAX, VMAX3, VMAX All Flash, and PowerMax storageFollow this procedure to add VMAX, VMAX3 VMAX All Flash, and PowerMax arrays toAppSync.

Before you begin

Note

The AppSync Support Matrix is the authoritative source of information on supportedsoftware and platforms.


The SMI-S Provider host managing the VMAX arrays must be configured in theAppSync server.

Refer to the AppSync Support Matrix for the minimum version of Solution Enablerrequired to support VMAX3, PowerMax, and VMAX2 arrays.

Note

After upgrading to AppSync 3.9, or after upgrading the SE provider, rediscover allVMAX arrays in AppSync. This action updates the provider configuration information.

To manage both VMAX2 and VMAX3 arrays using a single SMI-S Provider, refer to theAppSync Support Matrix for the minimum version of Solution Enabler that the SMI-Shost must be running.

To use a single SMI-S Provider for configuring multiple (local and/or remote) VMAXarrays in AppSync, ensure that you assign a minimum of 8 Gatekeeper devices fromeach VMAX array locally to the SMI-S host.

In the case of remote SRDF copies (on R2 devices), to support Gold service plans,AppSync requires a single SMI-S provider that has access to both the local andremote array. For Silver and Bronze service plans, local and remote arrays can haveseparate SMI-S providers. Refer to the AppSync VMAX Array Support Guide on https://support.emc.com for additional information.

AppSync does not support SRDF between VMAX2 and VMAX3 arrays even if thearrays are managed by the same SMI-S Provider.

If you want to use one SMI-S provider for the local array and another SMI-S providerfor the remote array, ensure that you set the preferred SMI-S provider in AppSync.AppSync discovers both the local and remote array in each of the SMIS-provider (oneas locally connected and the other as remotely connected). By default, AppSync setsthe locally connected as the preferred SMI-S provider. You can change the preferredSMI-S provider in AppSync.

Procedure

1. On the AppSync console, select Settings > Storage Infrastructure.

2. In the lower left corner of the console, click Add in the drop-down list, and thenselect VMAX Storage to launch the Add VMAX storage wizard.

3. On the first page of the wizard, type SMI-S provider credentials including Nameor IP address, Port number, User Name, and Password.

4. Click Enter to display the Select VMAX page.

A list of VMAX arrays managed by the SMI-S provider appears.




5. Select the desired array (the array where you want to store the copy, not theproduction array), and then click Next.

The Groups and Pools page appears where you can configure VMAX2 arraysfor storage groups and/or storage pools. For VMAX3 arrays, storage groupand/or storage resource pools appear.

6. Select the target storage group, if you want to limit AppSync to only use anominated set of target devices. AppSync will use this storage group for targetstorage devices, rather than creating the necessary target devices from thedefault storage resource pool. If this is a VMAX2 array, then you can allowAppSync to create devices in a specific storage pool, if no target devices arefound in the storage group. You can also select a storage pool to provisiontarget devices.

You can configure a combination of storage groups and storage pools or storageresource pools. If the suitable target devices are not available in the configuredstorage group, AppSync provisions target devices from the configured storagepools or storage resource pool.

Note

l VMAX3 and VMAX All Flash arrays with single storage resource pool issupported in AppSync. Multiple storage resource pool is not supported.

l Only storage groups which are not part of any masking view are listed andavailable for selection. If a storage group is configured to pick targetdevices, you must create and add target copy LUNs that you want AppSyncto use in the storage groups. AppSync removes the devices from the storagegroup at the time of mount and adds them to the storage group for themount host. The devices are added back to the storage group when the copyis expired.

l The same storage groups must not be configured in two different AppSyncservers.

l You can configure storage resource pools on VMAX3, VMAX All Flash, andPowerMax arrays with a single storage resource pool.

l AppSync does not allow you to configure storage resource pool for aVMAX3, VMAX All Flash, and PowerMax array, if there are already multiplestorage resource pools configured.

7. After selecting these options, click Finish.

A pop-up appears with a Successfully Configured VMAX storage message.

Using VMAX Manage Copy Storage featureAfter adding VMAX arrays, you can change or assign arrays to a storage group or poolusing the Manage Copy Storage feature of AppSync.

Before you begin

From the AppSync console browse to the VMAX arrays: Settings > StorageInfrastructure

Use the Manage Copy Storage feature to assign, or edit a storage group or storagepool for a specific VMAX array.


Adding VMAX, VMAX3, VMAX All Flash, and PowerMax storage 35

Procedure

1. On the Storage Infrastructure array list in the console, select the VMAX arraythat you want to configure, and then click Manage Copy Storage located in thelower menu bar of the Storage Infrastructure screen.

The Manage Copy Storage dialog box appears with the currently configuredstorage group and pool information for the selected array (if previouslyconfigured).

Note

Only storage groups which are not part of any masking view are listed andavailable for selection. AppSync removes the devices from the storage group atthe time of mount and adds them to the storage group for the mount host. Thedevices are added back to the storage group when the copy is expired.

2. Select the desired storage group for the array from the Storage Group menu inthe dialog box.

3. Select the desired storage pool from the Storage Pool menu. You can alsoassign the percentage of the array you want to allocate to the pool.

For VMAX3, storage pool displays as storage resource pool. You can select orclear the storage resource pool. You cannot select multiple storage resourcepools.

4. Select Terminate clone session created by AppSync to terminate AppSynccreated clone sessions on any device in a VMAX storage group whenunconfiguring storage groups.

5. Select Delete device created by AppSync in pool to delete AppSync createddevices in a pool when unconfiguring storage pools (in the case of VMAX 2 )and storage resource pools (in the case of VMAX3).

Note

This option is enabled only if you select the Terminate clone session createdby AppSync option.

6. Click OK.

Results

AppSync configures the new data for the VMAX array.

View VMAX target devicesYou can provision the target devices in a storage group and/or configure storagepools/storage resource pools to create target devices for VMAX copies.

Before you begin


Procedure


The Storage Infrastructure window appears.

2. From the list of storage, select a VMAX array.

The array details appear in the Details pane below.



3. Click Number of Devices to view all the available VMAX target devices.

The VMAX In-Use Devices window appears with details of the user provisioned(created by the storage administrator) and AppSync provisioned target devices.

4. Select the User Provisioned tab.

5. Select a target device to perform one of the following:

a. Click Reset Device In-Use Flag to reset the in-use flag to false, if AppSyncdoes not have any valid copy associated with the device.

b. Click Remove Device in AppSync to remove the devices from the AppSyncinventory, and from the AppSync configured storage group.

6. Select the AppSync Provisioned tab.

7. Select a target device to perform one of the following:

a. Click Reset Device In-Use Flag to reset the in-use flag to false, if AppSyncdoes not have any valid copy associated with the device.

b. Click Remove Device in AppSync to remove the devices from the AppSyncinventory, and from the AppSync configured storage group.

c. Click Delete Device In Array to remove the device from the AppSyncinventory and to delete the device from the array.

8. Select Application Copy Info to fetch details of the copy associated with theselected device such as service plan name, copy time stamp, and so on.

9. Click Close.

Note

AppSync tracks and manages all the target devices. Dell EMC does notrecommend manipulating the target devices. It is only for troubleshooting andmust not be manipulated for normal use cases.

Add a VNX, VNXe, or a Unity array to AppSyncThis operation requires the Resource Administrator role in AppSync.

Before you begin

Supply the credentials for an account that has the role of Administrator or StorageAdministrator.

Note

If VNX contains VNX File as well as VNX Block, you must be a Global user.

Procedure


2. Click Add.

3. Select one of the following:

l VNX

l VNXe

l Unity

4. Add a name or IP address:


Add a VNX, VNXe, or a Unity array to AppSync 37

a. For a VNX block storage system, enter one or both of the following: the IPaddress of service processor SPA or SPB.

Note

If the IP does not resolve to a name, create an entry in the Windows host filewith a name. Refer to this file: C:\Windows\System32\drivers\etc\hosts

b. If you want to manage file storage as well, type the IP address of the VNXFile Control Station. This is not mandatory if you are only managing blockstorage.

c. For VNXe and Unity, type the Name or IP Address of the ManagementInterface.

d. For Unity, type the Name or IP Address of the Management Interface.

5. Type additional credentials:

a. For VNX, type the username and password to access the storage system.

b. For VNXe and Unity, type the Global Username (Admin username), andPassword (Admin password).

6. Click OK.

Updating the VNX ,VNXe, or Unity storage systemUpdate AppSync when VNX ,VNXe, or Unity is not configured or when you want toadd functionality (for example, add VNX block or VNX file).

Before you begin


Procedure


2. Select the VNX storage system that you want to configure.

3. In the Details pane, for VNX, edit the IP address fields for SPA, SPB, andControl Station IP, or for VNXe and Unity, edit the Management Interfacecredentials, then click Apply.

Resetting the credentials for a storage systemWhen adding or configuring a storage system on AppSync, you specify credentials.However, you can reset these credentials later.

Before you begin


You need to know the credentials for the storage system.

Initially you specify credentials when adding the storage system to AppSync. Followsteps in the Add Storage wizards. You can also update the credentials in AppSynclater using these steps.

Procedure

1. Select Reset Login Credentials from a storage system listed in Settings >Storage Infrastructure.



2. Enter the new credentials for the storage system and then select OK.

Adding and registering ViPR Controller storage to AppSyncThis topic describes how to add ViPR Controller to AppSync.

Before you begin

This procedure requires the Storage Administrator role in AppSync and ViPRController Provider Tenant Administrator credentials.ViPR Controller must be registered and discovered into AppSync. AppSync is notmulti-tenant aware and allows only one credential to be associated per storagesystem, therefore configure ViPR Controller with AppSync using ViPR ControllerTenant Administrator credentials. These credentials provide ViPR Controller systemrights.

Before adding the ViPR Controller storage, consider the following:

l AppSync uses ViPR Controller Client APIs to communicate with a ViPR Controllersoftware-defined storage system.

l Client APIs makes REST calls to ViPR Controller internally on port 4443 (default).

l As part of ViPR Controller software-defined storage system discovery, AppSyncdiscovers all the controller nodes that are managed by a particular virtual IP.

n By default AppSync uses the IP address that is used to register the ViPRSystem. Use the ViPR Controller public virtual IP address(VIP) to register thearray.

n You can change the IP preference and set AppSync to use a particular node IPaddress for all the REST communication.

Procedure

1. On the AppSync console, go to Settings.

2. From the Add drop-down list select ViPR Controller.

The Add ViPR wizard launches.

3. Type the ViPR Virtual Name or IP Address to register ViPR.

4. Type the Global user name.

This name is the username for the ViPR Controller.

5. Enter the ViPR Controller Password.

6. Protocol and Port are pre-configured.

They are set by default.

7. Click OK.

The ViPR Controller details page (Settings Storage Infrastructure) launcheswhere you can view the added ViPR Controller instance with configurationinformation.

Results

ViPR Controller details page launches (Settings > Storage Infrastructure) where youcan view the added ViPR Controller instance with configuration information.If ViPR Controller credentials are modified, the AppSync Storage Administrator canreset the ViPR credentials on the Settings page.


Adding and registering ViPR Controller storage to AppSync 39

Add an XtremIO array to AppSyncTo enable the XtremIO array to work with AppSync, add the array to the AppSyncconfiguration.

With XtremIO 4.0 and later, one XtremIO Management Server (XMS) can managemultiple XtremIO arrays.

To add and configure an XtremIO array to work with AppSync, you need an XtremIOManagement Server (XMS) configured on a SAN with at least one XtremIO array.Ensure XtremIO is zoned to Production and Mount hosts.

Procedure

1. On the AppSync console, go to Settings > Storage Infrastructure.

2. On the left side, center of the Storage Infrastructure page, click Add, and thenselect XtremIO.

The Add XtremIO wizard opens.

3. Type the credentials for the XtremIO Management Server, including Name/IPaddress, Username, and Password, and then click Next.

4. Select the XtremIO array that you want to add to AppSync, and then clickFinish.

Results

You can view the added the array on the AppSync Storage Infrastructure page of theAppSync console.

Adding a VPLEX cluster to AppSyncTo protect applications running on VPLEX storage, add the VPLEX cluster(s) to theAppSync storage infrastructure.

Before you begin


On a VPLEX Metro, you can add either cluster's management server or bothmanagement servers. For management server redundancy, it is recommended thatyou add both management servers.

You must also configure the backend array on which the VPLEX virtual volume residesin AppSync. Refer to instructions in online help for adding the specific array toAppSync.

Procedure



2. Click the Add drop down box and select VPLEX.

The Add VPLEX wizard appears.

3. Enter the VPLEX management server login credentials, and then click Next.

The VPLEX Managed Arrays screen displays all the arrays supported byAppSync with VPLEX. A green icon next to an array indicates that the array isconfigured in AppSync; a red icon indicates that the array is not configured inAppSync.



4. Click Finish.

A popup message confirms that you have successfully added VPLEX.

5. Click OK to acknowledge the message, and then click Close.

6. VPLEX Metro only: To add the second management server, repeat steps 1through 5.

Results

The VPLEX cluster is added to AppSync and displays in the storage list on the StorageInfrastructure page. Note that when you add one management server in a VPLEXMetro, AppSync automatically discovers both clusters and displays them in the list. Ifyou click on either cluster in the list, the Details pane will show the same IP address(the address of the management server you added). However, when you add thesecond management server, if you click on either cluster, the Details pane will showboth IP addresses in the VPLEX Management Servers section.

Resetting a VPLEX cluster credentialsIf the credentials for a VPLEX cluster change, you can edit the management server toreset the credentials.

Before you begin


Procedure


The Storage Infrastructure window displays a list of storage added toAppSync.

2. Select the VPLEX cluster. For VPLEX Metro systems, ensure that you areselecting the correct cluster. Pay attention to the cluster name in the Detailspane below when you select a cluster.

3. In the VPLEX Management Servers list, select the management server to edit,and then click Edit.

The Edit Management Server dialog box appears.

4. In the Edit Management Server dialog box, type the new credentials in theappropriate field, and then click OK.

The new credentials display in the VPLEX Management Servers section.

Setting a preferred VPLEX management serverAppSync uses the preferred management server to communicate with VPLEX.

Before you begin


In the case of a VPLEX Metro, if you add both management servers to AppSync, bydefault, the selected cluster's management server is shown as the preferredmanagement server.To modify the preference:

Procedure




Adding a VPLEX cluster to AppSync 41

2. From the list of storage, select the VPLEX cluster.

The cluster details appear in the Details pane below.

3. In the VPLEX Management Servers list, select a management server and thenclick Set Preferred.

The preferred management server is modified.

Adding a Dell SC array to AppSyncTo protect applications running on Dell SC storage, add the Dell SC arrays to theAppSync storage infrastructure.

Before you begin


Configure Dell Storage Manager Data Collector for the Dell SC array and confirm thatthe array is accessible through the Dell Storage Manager Data Collector tocommunicate with AppSync.

Procedure



2. Click the Add drop down box and select Dell SC.

The Add Dell SC storage wizard appears.

3. Enter the Dell Storage Manager Data Collector credentials (name or IP address,port number, user name, and the password).

4. Click Next.

5. Select the Dell SC array that you want to add to AppSync, and then clickFinish.

Results

The Dell SC array is added to AppSync and displays in the storage list on the StorageInfrastructure page.

Viewing storageBefore you begin

View storage systems under the Settings tab of the AppSync console. This operationrequires the Resource Administrator role in AppSync.

Procedure


2. Select the storage array you would like to view.

The Details pane displays information for the storage system you selected.

Removing a storage systemBefore you begin

No copies generated by AppSync can exist on the storage system. This operationrequires the Resource Administrator role in AppSync.



Note

You cannot remove storage until all copies have been expired.

Procedure


2. Select the storage system you want to remove. For VMAX and VMAX3 arrays,you must also deselect the configured storage pool, storage group, or storageresource pool, if applicable.

3. Select Remove.

Note

Before removing a VPLEX storage system, ensure that you deselect the arraysthat you selected when configuring VPLEX (Service plan > Create local copy>Configure storage options >Array preference).

Rediscovering a storage systemUse the Rediscover operation to query and update storage system information, suchas, name, model, serial number, storage group, storage pool, and operatingenvironment version in AppSync.

Before you begin


Procedure


2. Select a storage system.


Note

If you change the VPLEX cluster name, ensure that you rediscover the VPLEXcluster before performing any operation.

Adding a VMware vCenter ServerAdd a VMware vCenter Server to AppSync when a virtual machine is used as a mounthost.

Before you begin


l Ensure that you know the credentials of an account with Administrator privilegeson the vCenter Server.

Procedure

1. Select Settings > VMware vCenter Servers.

2. Click Add.

3. Type the vCenter Server name.


Rediscovering a storage system 43

4. Type the credentials for an account that has Administrator privileges on thevCenter Server.

Note

AppSync allows you to mount a file system or a database (that is, the underlyingstorage LUN on which they reside) from a physical Windows or Linuxenvironment to a VMware virtual environment as a RDM device. Ensure thatyou add the vCenter managing that virtual machine to AppSync beforeperforming a mount.

5. Click OK.

Figure 3 Add vCenter Server

Resetting the login for a VMware vCenter ServerUpdate AppSync when credentials change for a VMware vCenter Server.

Before you begin

This operation requires the Resource Administrator role in AppSync. You need to knowthe new credentials an account that has Administrator privileges on the VMwarevCenter Server.Procedure


2. Select the vCenter server.

3. Select Reset Login Credentials.

4. Enter the credentials of a user account that has Administrator privileges on thevCenter Server.

Removing a VMware vCenter ServerYou can remove a VMware vCenter Server from AppSync.

Before you begin




Procedure


2. Select one or more vCenter servers to remove.

3. Click Remove.

Backup and restore AppSync using the Backup Assistanttool

Installed with the AppSync server is a tool that can be leveraged to both backup andrestore the local AppSync database. The tool is called the Backup Assistant.

AppSync Backup Assistant arguments and actionsLearn how to back up and restore the AppSync database by selecting the appropriatearguments for the AppSync Backup Assistant, appsync-backup.bat, located in the\AppSync\backup-assistant directory.

Ensure you have a valid backup before attempting a database restore.To create a backup, run appsync-backup.bat from the administrator commandprompt using the following syntax:

appsync-backup.bat[-o, -out "<path>"] [-d, -debug] [-h, -help]

Table 6 AppSync Backup tool arguments and actions

Argument Action

-o, -out Allows you to specify the base directory in which to save the backup. The backup is placed in a sub-directory referencing the current Date and Time. (Default ='$SystemDrive\AppSyncBackup\<DateTimeStamp>')

-d, -debug Enables display of DEBUG messages.

-h, -help Prints the Help message.

-i, -import Allows you to specify a backup that you want to restore to the current host. (If this argument is notused a backup will be taken.)

An example of an export command.appsync-backup.bat -o C:\AppSyncBackupDir -d

Schedule automated backup of the AppSync server databaseYou can use the Windows Task Scheduler to schedule backups of the AppSync serverdatabase at normal intervals.

Before you begin


Procedure

1. Log in to the Windows host.

2. Click Computer Management > System Tools > Task Scheduler.

3. Right-click Task Scheduler Library, and select Create Basic Task.

The Create Basic Task wizard appears.


Backup and restore AppSync using the Backup Assistant tool 45

4. Specify a name for the schedule, and click Next.

5. Select a trigger option, and click Next.

6. Set the frequency and time for the selected trigger option, and click Next.

7. Select the action that you want the task to perform, and click Next.

8. Browse to the appsync-backup.bat file or specify the full path (C:\EMC\AppSync\backup-assistant\appsync-backup.bat), and click Next.

9. Review the task summary, and click Finish.

The task is created and added to the Windows schedule.

Restore an automated backupThe Backup Assistant tool allows you to restore a backup created previously with thistool. Learn about the process and caveats for automated backup. Be sure to restore abackup at a time of low activity on the server.

Before you begin

To restore a back up from an older version of AppSync be sure that you install thelatest version of AppSync before attempting to use the automated restore.

Note

Automated restore is supported for backups taken with the Backup Assistant toolfrom AppSync 2.0 and above. However, restoring an earlier version of the backed-upAppSync database on a new version of AppSync server is not supported. Make surethe version of the AppSync server installed on the host is same version as the backupthat was created.

Procedure

1. Run the backup assistant tool with the -i, -import argument, for example: C:\ AppSyncBackup\3500_BACKUP\2018_06_17_06_34_32\base.tar.gzWhen running this restore, the AppSync services will be stopped.

Migrating the AppSync serverYou can migrate the AppSync server from one server to another.

For example, to migrate a server from Server A to Server B:

Procedure

1. Disable all service plans on Server A.

2. Copy the license files from Server A from /EMC/AppSync/license to afolder on Server B.

3. On the AppSync console on Server A, go to Help About > AppSync and notethe complete AppSync version including CFxx (xx = the cumulative hotfixnumber). Also, note any hand-edit procedures to configuration files thatCustomer Support requested you to perform for the AppSync serverinstallation.



Note

For VMAX environments, set the server settingvmax.disable.internal.sg to true, and rediscover VMAX arrays.

4. Install the AppSync server on Server B. Ensure you apply the exact version ofAppSync that includes the exact cumulative hotfix number, if a hotfix waspreviously installed. Re-apply any hand-edit procedures to configuration filesthat you noted in step 3.

5. Take a backup of the AppSync server from server A using the AppSync BackupAssistant utility, for example type: appsync-backup.bat -o C:\AppSyncBackupDir

Note

For VMAX environments, set the server settingvmax.disable.internal.sg to false, and rediscover VMAX arrays. Formore information on configuring the server settings, contact Dell EMC Support.

6. Restore the backup on Server B using the Backup Assistant utility, type:appsync-backup.bat -i C:\AppSyncBackupDir\base.tar.gz

7. Re-apply the AppSync licenses on Server B within the AppSync application.

8. Enable service plans on server B.

9. Stop the AppSync server on Server A.

Results

You can now use the AppSync server on Server B.


Migrating the AppSync server 47

appsync installation and configuration guide · n vnx, vnxe, unity n vmax/ powermax n xtremio n...

Documents