appsync installation and configuration guide · modernhomedataprotection is the authoritative...

EMC® AppSync®Version 3.0.2

Installation and Configuration Guide302-003-364

01

Copyright © -2016 EMC Corporation. All rights reserved. Published in the USA.

Published September 2016

EMC believes the information in this publication is accurate as of its publication date. The information is subject to changewithout notice.

The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind withrespect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for aparticular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicablesoftware license.

EMC², EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and othercountries. All other trademarks used herein are the property of their respective owners.

For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).

EMC CorporationHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.EMC.com

2 EMC AppSync 3.0.2 Installation and Configuration Guide

Prerequisites 5

AppSync server prerequisites.......................................................................... 6Application host plug-in prerequisites.............................................................6AppSync console prerequisites .......................................................................8

Display requirements ........................................................................ 8Checklist for AppSync deployment.................................................................. 9

Installation 11

Installing AppSync........................................................................................ 12Installing the server..........................................................................12Installing the host plug-in manually - Windows servers only............. 13UNIX host plugin push install with SUDO user.................................. 13Adding servers................................................................................. 16

Upgrading AppSync.......................................................................................17Upgrading the AppSync server......................................................... 17Upgrading the AppSync agent plug-in ..............................................18

Uninstalling AppSync.................................................................................... 19Removing a server from AppSync .....................................................19Uninstalling the AppSync agent plug-in............................................20Uninstall the AppSync server ...........................................................20

Licensing in AppSync 23

Licensing in AppSync.................................................................................... 24Obtaining a license online................................................................25Uploading and installing a license file..............................................25

Configuration and resource management 27

Backup and restore AppSync using the Backup Assistant tool....................... 28AppSync Backup Assistant arguments and actions...........................28Restore an automated backup..........................................................28

Migrating the AppSync server........................................................................ 29Resource management ................................................................................. 29

Adding a RecoverPoint site ..............................................................30Adding VMAX and VMAX 3 storage................................................... 31Add a VNX, VNXe, or a Unity array to AppSync.................................. 33Adding and registering ViPR Controller storage to AppSync ..............35Add an XtremIO array to AppSync .................................................... 37Adding a VPLEX cluster to AppSync.................................................. 38Viewing EMC storage........................................................................39Removing an EMC storage system ................................................... 39Rediscovering an EMC storage system .............................................40Adding a VMware vCenter Server ..................................................... 40

Chapter 1

Chapter 2

Chapter 3

Chapter 4

CONTENTS

EMC AppSync 3.0.2 Installation and Configuration Guide 3

CONTENTS


CHAPTER 1

Prerequisites

This chapter includes the following topics:

l AppSync server prerequisites.................................................................................. 6l Application host plug-in prerequisites.....................................................................6l AppSync console prerequisites ...............................................................................8l Checklist for AppSync deployment.......................................................................... 9

Prerequisites 5

AppSync server prerequisitesThe AppSyncserver 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.

Table 1 AppSync server prerequisites

Item Value

Operating system Windows Server 2008 SP2 (x64), Windows Server 2008 R2(x64), Windows Server 2008 R2 SP1 (x64), Windows Server2012, Windows Server 2012 R2.

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 VMware virtual machine. Memory and disk spacerequirements are the same as on physical host.

Additional informationThe AppSync server can now co-exist on the same server with any other EMC product thatuses the RSA Common Security Toolkit, for example NetWorker Server, Unisphere CLI, andNavisphere CLI.

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

Table 2 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 2 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 8085, 10004, pushing the host plugin to a Windows hostrequires CIFS access (TCP port 139 and TCP port 445).

UNIX ports: Source IP is AppSync server:

l Destination IP = Production or mount host running UNIXAppSync Host plug-in

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

Source IP = Production or mount host running UNIX AppSynchost plug-in

l Destination IP = AppSync server

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

Supported device configurations

Table 3 Supported device configurations

AIX LINUX

Multipath: Multipathing packageis required for platforms runningVNX, VNXe, Unity, XtremIO,VPLEX, VMAX, or RecoverPoint onVNX in non-virtualizedenvironments.

l Native MPIO

l PowerPath

Multipath: Multipathing package is required for platformsrunning VNX, VNXe, Unity, XtremIO, VPLEX, VMAX, orRecoverPoint on VNX in non-virtualized environments.

l Native MPIO

l PowerPath

l Veritas DMP

n Supported where both production and mount hosthave DMP installed and DMP devices do not have apartition.

n Supported with non-ASM database on VXDMP deviceswith or without VXVM Volume manager

Device mapping using:

l Symbolic links

l mknod devices

l Block devices

Device mapping using:

l Linux-ASMLib (ASM only)

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

Prerequisites

Application host plug-in prerequisites 7

Table 3 Supported device configurations (continued)

AIX LINUX

l XFS (necessary rpms needed on production as well asmount 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 Volume Group

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 authoritative source ofinformation 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.

Display requirementsAppSync requires a display resolution of 1280x1024.

Prerequisites




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

Table 4 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 list ofserver prerequisites in this guide for other details.

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 EMC AppSync User and Administration Guide and thelatest EMC AppSync Support Matrix .

Install the AppSync server executableon the designated server system.

Obtain server installation executable from support.EMC.com.

From a web browser, open the AppSyncconsole.

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

n XtremIO

n RecoverPoint site

n VPLEX

n ViPR Controller

l If mounting copies to a virtual machine, browse to CopyProtection > VMware Datacenters and click DiscoverDatacenters > Add vCenter Servers.

l IPv6 address is not supported for any array managementserver or storage processor.

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

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

This is only applicable for Windows.

You cannot register hosts with IPv6 IP address.

From the AppSync console, discoverapplication objects on the respectiveservers.

Copy Management > Microsoft Exchange / SQL Server /Oracle / VMware Datacenters / FileSystem.

Prerequisites

Checklist for AppSync deployment 9

Table 4 Deployment checklist (continued)

Basic step Details Notes Done?

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

Copy Management > Microsoft Exchange / SQL Server /Oracle / VMware Datacenters / FileSystem.

l Protect immediately with Subscribe to Plan and Run,which subscribes the application object to a service planand runs the protection immediately for the selectedobject 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 canrepurpose application database copiesfor SQL Server and Oracle for use in test-dev, break-fix, data mining, andreporting. Use the Repurpose wizard toschedule or immediately create first orsecond generation copies as needed.

Copy Management > Oracle or SQL Server to display thelist of available applications.

l Select the database instance that you want to Repurpose,

and then select Repurposeto launch the wizard.

l Follow wizard steps.

l Select Run now ,Run Recurrently As Per Schedule, or

Run Only Once At later time. Complete details appearin the online help and user guide.

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................................................................................................ 12l Upgrading AppSync...............................................................................................17l Uninstalling AppSync............................................................................................ 19

Installation 11

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

l Install the AppSync server.

l Install the AppSync agent plugin.

l Add your servers to AppSync.

If you want to upgrade an existing AppSync installation to the current full version refer to Upgrade your AppSync installation on page 17.

Installing the 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 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 to installAppSync.

The default location is C:\EMC\AppSync.

Note

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

4. On the AppSync Administrator screen, enter a user name and password for thedefault 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 and onespecial character from the following list: ! , @ # $ % ^ * ? _ ~

5. On the AppSync Ports screen, modify the default http, https, CAS, and tomcat portdetails, 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 installation log forthe AppSync server, appsync_setup.log, is located in the folder defined by theinstalling user's TEMP environment variable.

Installation


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

Before you begin

Obtain the AppSync host plug-in installation executable from the AppSync distribution orfrom 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 must specify itwhen 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.

Note

A reboot of Exchange may be required after installation of the host plug-in.

UNIX host plugin push install with SUDO userThis section describes how to perform a push install of the AppSync host plugin on aUNIX host from the AppSync server.

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 and OpenSSL.Zlib is a pre-requisite for enabling the SUDO feature.

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

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.

Installation

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

http://support.emc.com/

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 AppSync hostplug-in. .

6. Grant the {user} read, write, and execute permissions to the install location directory(and to all its subdirectories recursively) that you select in Add Unix Servers of theAppSync GUI.

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

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.

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 like thefollowing:

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 the lastline to the following:

appsync lrmp333.org.com = (root) NOPASSWD: /opt/emc/appsync/acp9. Ensure that the secure_path variable is set to default. This is required for AppSync

to execute some basic commands which reside in these directories.Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin

10. Start SFTP server service for the created SUDO user. For example, SSH as SUDO userand execute the sftp-server& command.

11. 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 EMC AppSync Support Matrix.

Linux deployment requirements include:

l Red Hat Linux.

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 SUDO featureenabled.

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

Installation


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 the AppSyncserver:

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 location directory(and to all its subdirectories recursively) that you select in Add Unix Servers of theAppSync GUI.

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

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 like thefollowing:

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 the lastline to the following:

appsync lrmp333.org.com = (root) NOPASSWD: /opt/emc/appsync/acp5. Ensure that the secure_path variable is set to default. This is required for AppSync

to execute some basic commands which reside in these directories.Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin

6. 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.

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 host, you canuse Rediscover to refresh the server with the new associated application information.

Before you begin

This operation requires the Resource Administrator role in AppSync.Procedure

1. Select Settings > Servers.

2. Select the server you want to refresh.

3. Select Rediscover.

4. Select Yes to confirm.

Installation

UNIX host plugin push install with SUDO user 15

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

Before you begin

Review this information before you begin. When you add a server, AppSync registers theserver in its database and discovers the protectable objects on that server. If the hostplug-in software is not already present, AppSync attempts to install it. If the host plug-insoftware is present, AppSync attempts to register it. An error occurs if the host plug-insoftware is already registered to another AppSync server.

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

l You need to supply credentials for an account that has local administrator privilegeson the server.

l For Windows servers: if the server is not part of a domain, disable the following useraccess control: User Access Control: Run all administrators inAdmin 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.



2. Click Add. You can select to add Windows or UNIX/Linux servers.

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

Optionally, you can automatically repeat the credentials from the first entry for thesubsequent entries. For a local account, use the server name as the domain. If you areprotecting databases in an Exchange DAG, add the DAG member servers that host thedatabase copies that you want to protect.

If you want to protect the virtual disk in the host, register the Virtual Center beforehost registration.

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 protecting SQLServer databases in a clustered instance of SQL Server, add the SQL Server virtualserver. Before you add the SQL Server virtual server, you must first install the AppSyncagent host plug-in software on all of the nodes in the cluster using the Add Serverswizard or by manually installing the software.

Note

If SQL Server virtual server is added before the latest version of the AppSync agenthost plug-in is installed on all physical nodes of the cluster, Add virtual server canfail.

4. Expand Push Install Settings to install the agent host plug-in software as part of theAdd Servers operation.

Use Push Install Settings when AppSync installs the agent host plug-in software aspart of the Add Servers operation. You can specify the agent host plug-in version toinstall, the port (on Windows servers only), and the location in which to install theagent host plug-in. The default location is /opt/emc/. By default, AppSync extractsthe host plug-in to a folder named appsync under this location. The same rule is

Installation


applicable even if you change the install location. For example, if the locationis /opt/emc/user1/agent, the AppSync agent host plug-in will beunder /opt/emc/user1/agent/appsync. These values apply to each server thatyou are adding.

Available plug-in versions depend on what is available on the AppSync server. OnWindows servers, the default port is 10004; valid range is from 1024 to 49151. Thedefault install location is system drive\Program Files\EMC\AppSync HostPlug-in.

Note

For Windows servers: verify that agent host plug-in is no more than one versionbehind the version of the server. Make sure that the server components are at thesame version as the AppSync server.

5. Click Start.

Temporary location for UNIX hostsYou can configure a temporary location for each UNIX host from AppSync console, Serverspage.

This location will be used by AppSync during Oracle mount operations to storeinformation that was 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 each operatingsystem command that is executed by AppSync on a UNIX platform. The default value is 60minutes. For example, if fsck during file system copy mount takes more than 60 minuteson a host, you can increase the command execution timeout value.

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 > AppSync and note your completeAppSync 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 AppSync serverback 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 the server

Installation

Upgrading AppSync 17

that requires 40% of the size of this directory, so plan a backup save location withthe required amount of free space.

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 EMC Support website.

2. Run the executable installation file.

The upgrade process requires free space equal to the size of the directory in Step 4.

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

After you finish upgrading the server, ensure that you upgrade the AppSync host-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 is notpart 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 credentials forrunning the AppSync Exchange Interface service. This service is reconfigured duringupdate.

For AppSync 3.0.2, verify that agent host plug-in is no more than one version behind theversion of the AppSync server. For AppSync 2.2 and earlier, upgrade the agent host plug-in to 2.2 from any earlier version, then upgrade to 3.0.2, if desired. (Refer toESA-2014-179).

Procedure


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

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 the serversand click OK.

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

Installation


5. 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 AppSync Userand 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 host, you canuse Rediscover to refresh the server with the new associated application information.

Before you begin



2. Select the server you want to refresh.


4. Select Yes to confirm.

Uninstalling AppSyncTo uninstall AppSync:

l Remove the server from 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 AppSync database.

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 or servers (multiselection is allowed) and click the Remove > RemoveServers 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 errormessage displays indicating why the removal failed.

After you finish

If the server you removed is one of the members of a DAG, you must rediscover databasesin AppSync.

Installation

Uninstalling AppSync 19

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 is notpart 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 and passwordwill be applied to all selections.

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

5. Specify credentials of an account with local administrator privileges on the serversand 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. If thereare failures, they display with a red icon.

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

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

EMC Engineering strongly suggests that you contact EMC Customer Support to resolve theissues with the newer, enhanced version of AppSync you are currently running beforetrying to roll back to an older version.

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

Installation


Procedure

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

2. Disable all Service Plans and make sure there is no current activity on the AppSyncserver.

3. Uninstall the AppSync server application from the host.

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

4. Re-install the version of AppSync server that was on the host prior to upgrade that younoted during the server upgrade procedure (Upgrading the server on page 17).

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

5. Re-apply any hand-edit procedures to configuration files that a readme or EMCCustomer Support Representative requested that you implement for your previousAppSync server installation.

6. Restore the automated backup refer to: Automated backup restore on page 28.

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

Installation

Uninstall the AppSync server 21

Installation


CHAPTER 3

Licensing in AppSync

l Licensing in AppSync............................................................................................ 24

Licensing in AppSync 23

Licensing in AppSyncEMC AppSync 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 a specificarray with some restrictions on the features supported by AppSync. This is onlyavailable for Unity, VMAX V3, VMAX AFA, 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 snapshot or bookmarks of Oracle,Microsoft SQL, Microsoft Exchange, File systems, or VMware datastores. Forexample, 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 on thenumber of volumes.

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 EMC 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 the starterpack license is upgraded to a permanent license, you must reapply thepermanent license for the second array, or wait for the license validationthread to run to clear the non compliance status for the second array.

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 to installanother APPSYNC_VSL file, the new file overrides the content of the earlier file.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 any enforcement oncapacity or utilization. Allows you to use storage from any type of array configured inAppSync with no limitation on the amount of storage from each 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 ensure thatthe 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 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 EMC License management web page, you are prompted to enter a Machinename as part of the process. 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 the AppSyncserver.

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 25

CHAPTER 4

Configuration and resource management

This chapter includes the following topics:

l Backup and restore AppSync using the Backup Assistant tool............................... 28l Migrating the AppSync server................................................................................ 29l Resource management ......................................................................................... 29

Configuration and resource management 27

Backup and restore AppSync using the Backup Assistant toolInstalled 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 5 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 not used abackup will be taken.)

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

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 the latestversion of AppSync before attempting to use the automated restore.

Automated restore is supported for backups taken with the Backup Assistant tool fromAppSync 2.0 and above.

Note

Automated restore is supported for backups taken with the Backup Assistant tool fromAppSync 2.0 and above. However, restoring an earlier version of the backed-up AppSyncdatabase on a new version of AppSync server is not supported. Make sure the version ofthe AppSync server installed on the host is same version as the backup that was created.



Backups taken from AppSync 1.6 are still supported but you must follow the manualrestore process.

Procedure

1. Run the backup assistant tool with the -i, -import argument, for example: C:\AppSyncBackup\2100_BACKUP\2015_06_17_06_34_32\base.tar.gz

When 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 a folder onServer B.

3. On the AppSync console on Server A, go to Help About > AppSync and note thecomplete AppSync version including CFxx (xx = the cumulative hotfix number). Also,note any hand-edit procedures to configuration files that Customer Support requestedyou to perform for the AppSync server installation.

4. Install the AppSync server on Server B. Ensure you apply the exact version of AppSyncthat includes the exact cumulative hotfix number, if a hotfix was previously installed.Re-apply any hand-edit procedures to configuration files that 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

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.

Resource managementUse Settings > Servers to manage hosts.

Use Settings > Storage Infrastructure to manage storage systems and RecoverPoint sites.

Use Settings > VMware vCenter Servers to manage vCenter Servers.


Migrating the AppSync server 29

Adding a RecoverPoint siteLearn how to add a RecoverPoint site to offer Local protection, Remote replication, andLocal and Remote replication protection that is provided by Bronze, Silver, and Goldservice 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, or RPAcluster 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 a RecoverPointAdmin role to access the site.

Note

If you upgrade a SOAP enabled RecoverPoint version earlier than 4.1.1 to the same ora later REST enabled version, you must add RecoverPoint to AppSync again.

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 IP addressfor 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 if sitesare in use.Procedure



3. Select Remove.

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

Before you begin

Ensure you obtain the credentials for the RecoverPoint appliance. The account that youspecify must have the RecoverPoint Admin role.

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

Procedure

1. Select Reset Login Credentials from a RecoverPoint site that is listed in Settings >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 VMAX and VMAX 3 storageFollow this procedure to add VMAX and VMAX 3 arrays to AppSync.

Before you begin


AppSync requires a minimum version of 8.0.2 for the SE provider to support VMAX 3arrays, and a minimum SE provider version 4.6.2.27 to support VMAX V2 arrays.

Note

After upgrading to AppSync 3.0.2, or after upgrading the SE provider, rediscover all VMAXarrays in AppSync. This action updates the provider configuration information.


Adding VMAX and VMAX 3 storage 31

AppSync can manage both VMAX V2 and VMAX V3 arrays on the same host with SEprovider version 8.0.3.26 and later. The AppSync Support Matrix is the authoritativesource of information on supported software and platforms.

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 then selectVMAX Storage to launch the Add VMAX storage wizard.

3. On the first page of the wizard, type SMI-S provider credentials including Name orIP 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 VMAX arrays for storagegroups and/or storage pools. For VMAX 3 arrays, only storage group options appear,for example:Figure 1 Configure VMAX storage group

6. Select a Storage Group and/or Storage Pool from the drop-down list. If you selectStorage Pool, add the threshold for storage pool usage.

For a VMAX 3, if the storage group option is not configured, the storage Resource Poolis used to create target devices.

Note

Only storage groups which are not part of any masking view are listed and availablefor selection. If a storage group is configured to pick target devices, you must createand add target copy LUNs that you want AppSync to use in the storage groups.AppSync removes the devices from the storage group at the time of mount and addsthem to the storage group for the mount host. The devices are added back to thestorage group when the copy is expired.

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 > Storage Infrastructure

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

Procedure

1. On the Storage Infrastructure array list in the console, select the VMAX array that youwant to configure, and then click Manage Copy Storage located in the lower menu barof the Storage Infrastructure screen.

The Manage Copy Storage dialog box appears with the currently configured storagegroup and pool information for the selected array (if previously configured).

Note

Only storage groups which are not part of any masking view are listed and availablefor selection. If a storage group is configured to pick target devices, you must createand add target copy LUNs that you want AppSync to use in the storage groups.AppSync removes the devices from the storage group at the time of mount and addsthem to the storage group for the mount host. The devices are added back to thestorage group when the copy is expired.

2. Select the desired storage group for the array from the Storage Group menu in thedialog box.

3. Select the desired storage pool from the Storage Pool menu. You can also assign thepercentage of the array you want to allocate to the pool.

For VMAX V3, Storage Pool displays as Storage Resource Pool, which is pre-selectedand not user selectable.

4. Click OK.

Results

AppSync configures the new data for the VMAX array.

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.


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

3. Select one of the following:

l VNX

l VNXe

l Unity

4. Add a name or IP address:

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

Note

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

b. For VNX, type the IP address of the Control Station.

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

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), and Password(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 to addfunctionality (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, and ControlStation IP, or for VNXe and Unity, edit the Management Interface credentials, thenclick 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. Follow stepsin the Add Storage wizards. You can also update the credentials in AppSync later usingthese steps.



Procedure

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

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

Adding and registering ViPR Controller storage to AppSyncReview pre-requisites and learn the procedure for adding and registering ViPR Controllerstorage to AppSync.

Before you begin

This procedure requires the Storage Administrator role in AppSync and ViPR ControllerProvider Tenant Administrator credentials.ViPR Controller must be registered and discovered into AppSync. AppSync is not multi-tenant aware and allows only one credential to be associated per storage system,therefore configure ViPR Controller with AppSync using ViPR Controller TenantAdministrator credentials. These credentials provide ViPR Controller system rights.

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 ViPR System.EMC recommends that you use the ViPR Controller public virtual IP address(VIP) toregister the array.

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.


Adding and registering ViPR Controller storage to AppSync 35

Figure 2 Add ViPR to AppSync

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) launches where youcan view the added ViPR Controller instance with configuration information.

Results

ViPR Controller details page launches (Settings > Storage Infrastructure) where you canview the added ViPR Controller instance with configuration information.If ViPR Controller credentials are modified in the future, the AppSync StorageAdministrator can reset the ViPR credentials on this settings page.



Figure 3 ViPR Controller Settings and Details

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 manage multipleXtremIO 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. EnsureXtremIO 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 then selectXtremIO.

The Add XtremIO wizard opens.

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

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

Results

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


Add an XtremIO array to AppSync 37

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 both managementservers. For management server redundancy, it is recommended that you add bothmanagement servers.

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

Procedure


The Storage Infrastructure window appears.

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 by AppSync withVPLEX. A green icon next to an array indicates that the array is supported; a red iconindicates that the array is not supported.

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 1 through 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 VPLEX Metro,AppSync automatically discovers both clusters and displays them in the list. If you clickon either cluster in the list, the Details pane will show the same IP address (the addressof the management server you added). However, when you add the second managementserver, if you click on either cluster, the Details pane will show both IP addresses in theVPLEX Management Servers section.

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

Before you begin


Procedure

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

The Storage Infrastructure window displays a list of storage added to AppSync.

2. Select the VPLEX cluster. For VPLEX Metro systems, ensure that you are selecting thecorrect cluster. Pay attention to the cluster name in the Details pane below when youselect a cluster.



3. In the VPLEX Management Servers list, select the management server to edit, andthen 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 preferred managementserver.To modify the preference:

Procedure


The Storage Infrastructure window appears.

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 then click SetPreferred.

The preferred management server is modified.

Viewing EMC storageGet steps to view EMC storage on AppSync.

Before you begin

View EMC 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 an EMC storage systemGet the steps you need to remove an EMC storage system from AppSync.

Before you begin

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

Note

You cannot remove storage until all copies have been expired.


Viewing EMC storage 39

Procedure


2. Select the storage system you want to remove. For VMAX and VMAX 3 arrays, you mustalso deselect the configured storage pool if applicable.

3. Select Remove.

Note

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

Rediscovering an EMC storage systemUse the Rediscover operation to query and update storage system information, such as,name, model, serial number, storage group, storage pool, and operating environmentversion in AppSync.

Before you begin


Procedure


2. Select a storage system.


Note

If you change the VPLEX cluster name, ensure that you rediscover the VPLEX clusterbefore 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 privileges onthe vCenter Server.

Procedure

1. Select Settings > VMware vCenter Servers.

2. Click Add.

3. Type the vCenter Server name.

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



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 Linux environment to aVMware virtual environment as a RDM device. Ensure that you add the vCentermanaging that virtual machine to AppSync before performing a mount.

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 VMware vCenterServer.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



2. Select one or more vCenter servers to remove.

3. Click Remove.


Adding a VMware vCenter Server 41

appsync installation and configuration guide · modernhomedataprotection is the authoritative...

Documents