Hitachi Content Platform Anywhere

Deploying the HCP Anywhere Connector for Good

MK-HCPAW013-00
July 01, 2016
 2016 Hitachi Data Systems Corporation. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying and recording, or stored in a database or retrieval system for
commercial purposes without the express written permission of Hitachi, Ltd., or Hitachi Data Systems
Corporation (collectively, Hitachi). Licensee may make copies of the Materials provided that any such
copy is: (i) created as an essential step in utilization of the Software as licensed and is used in no other
manner; or (ii) used for archival purposes. Licensee may not make any other copies of the Materials.
"Materials" mean text, data, photographs, graphics, audio, video and documents.

Hitachi reserves the right to make changes to this Material at any time without notice and assumes no
responsibility for its use. The Materials contain the most current information available at the time of
publication.

Some of the features described in the Materials might not be currently available. Refer to the most recent
product announcement for information about feature and product availability, or contact Hitachi Data
Systems Corporation at https://support.hds.com/en_us/contact-us.html.

Notice: Hitachi products and services can be ordered only under the terms and conditions of the applicable
Hitachi agreements. The use of Hitachi products is governed by the terms of your agreements with Hitachi
Data Systems Corporation.

By using this software, you agree that you are responsible for:

1) Acquiring the relevant consents as may be required under local privacy laws or otherwise from
authorized employees and other individuals to access relevant data; and

2) Verifying that data continues to be held, retrieved, deleted, or otherwise processed in accordance with
relevant laws.

Notice on Export Controls. The technical data and technology inherent in this Document may be
subject to U.S. export control laws, including the U.S. Export Administration Act and its associated
regulations, and may be subject to export or import regulations in other countries. Reader agrees to
comply strictly with all such regulations and acknowledges that Reader has the responsibility to obtain
licenses to export, re-export, or import the Document and any Compliant Products.

Hitachi is a registered trademark of Hitachi, Ltd., in the United States and other countries.

AIX, AS/400e, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, eServer, FICON, FlashCopy,
IBM, Lotus, MVS, OS/390, PowerPC, RS6000, S/390, System z9, System z10, Tivoli, z/OS, z9, z10, z13,
z/VM, and z/VSE are registered trademarks or trademarks of International Business Machines Corporation.

Active Directory, ActiveX, Bing, Excel, Hyper-V, Internet Explorer, the Internet Explorer logo, Microsoft,
the Microsoft Corporate Logo, MS-DOS, Outlook, PowerPoint, SharePoint, Silverlight, SmartScreen, SQL
Server, Visual Basic, Visual C++, Visual Studio, Windows, the Windows logo, Windows Azure, Windows
PowerShell, Windows Server, the Windows start button, and Windows Vista are registered trademarks or
trademarks of Microsoft Corporation. Microsoft product screen shots are reprinted with permission from
Microsoft Corporation.

All other trademarks, service marks, and company names in this document or web site are properties of
their respective owners.
 Contents

About HCP Anywhere 1

About the Good Enterprise Mobility Server 2
About the HCP Anywhere Connector for Good 2
Supported versions 2
Deploying the HCP Anywhere Connector for Good 3
Step 1: Enable the HCP Anywhere File Sync and ShareAPI 3
Step 2: Add the HCP Anywhere Connector for Good JAR file to the Good
Technology folder 6
Step 3: Configure HCP Anywhere in theGEMS Dashboard 7
Step 3a: Configure HCP Anywhere as a storage type 8
Step 3b: Specify an HCPAnywhere server to integrate withGEMS 10
Step 4 (conditional): Configure GEMS to accept an HCP Anywhere self-
signed certificate 13
Step 4a: Download the HCP Anywhere SSL self-signed certificate 14
Step 4b: Add theHCP Anywhere SSL self-signed certificate to theJava
keystore 17
Step 4c: Restart the Good Technology Common Services 18

Contents 3
Deploying the HCP Anywhere Connector for Good
4 Contents
Deploying the HCP Anywhere Connector for Good
About HCP Anywhere
HCP Anywhere is an enterprise mobility storage and collaboration platform
from Hitachi Data Systems (HDS). HCP Anywhere provides these three
major features for your company and your employees:

File synchronization and sharing This feature enables HCP

Anywhere users to securely store, access, work with, share, and
collaborate on files from any location that the user has Internet access.

When a user adds files to HCPAnywhere, the files are stored in a

Hitachi Content Platform (HCP) system. The files are then made
available through a web browser application called the HCP Anywhere
User Portal and through each computer, phone, and tablet that the
user has registered with HCP Anywhere.

Backup This feature allows users to dynamically backup folders on

their computer using the HCP Anywhere desktop application.

When a user backs up a folder, the folder and all its contents are
protected on the HCP Anywhere server. Any changes a user makes to
their backup files and folders are uploaded to the server while the
desktop application is running. This keeps a user's backup data up-to-
date for whenever they may need it. Users can download their backup
files and folders in the User Portal and on their HCP Anywhere mobile
applications and use that backup data to restore files and folders from
their computer that have been lost or corrupted.

HDI device management This feature allows an administrator to

configure and monitor Hitachi Data Ingestor (HDI) systems that
have been deployed at multiple remote sites throughout an enterprise.

1
Deploying the HCP Anywhere Connector for Good
About the Good Enterprise Mobility Server

About the Good Enterprise Mobility Server

The Good Enterprise Mobility Server (GEMS) is the system that
communicates with your company's Good applications and allows them to
securely access your internal resources. In addition to communicating
withyour company's Good applications, GEMS also supports the integration
of third-party applications with the GEMSDocs service. The HCP Anywhere
Connector for Good uses theGEMS Docs service to enable your Good users
to access data on HCP Anywhere.

About the HCP Anywhere Connector for Good

The HCP AnywhereConnector for Good is a Java program that integrates
your Good Enterprise Mobility Server with HCP Anywhere. Once you deploy
the HCP Anywhere Connector for Good, your users can access and work with
files in HCP Anywhere using a Good application.

As an administrator, you have a lot of control over how the HCP Anywhere
Connector for Good is deployed. On the GEMS Dashboard, you can
configure:

The HCP Anywhere servers you want to integrate withGEMS

The users from those HCP Anywhere servers who can access HCP
Anywhere using a Good application

The operations each of those users can perform in HCP Anywhere using
a Good application

Supported versions
In order for the HCP Anywhere Connector for Good to function properly, you
must be using a supported version of:

HCP Anywhere

The Good Enterprise Mobility Server

The Good Work application

Supported versions of HCP Anywhere

The HCP Anywhere Connector for Good requires that you use version 2.1.1
or later of HCP Anywhere.

2
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

Supported versions of the Good Enterprise Mobility Server Dashboard

The HCP Anywhere Connector for Good requires that you use:

Version 2.2.12 or later of the Good Enterprise Mobility Server

Java 8 or later on the Good Enterprise Mobility Server

Supported versions of the Good Work application

The HCP Anywhere Connector for Good requires that you use:

For iOS, version 2.2.1 or later of the Good Work application

For Android, version 2.2.2.300 or later of the Good Work application

Deploying the HCP Anywhere Connector for Good

To deploy the HCP Anywhere Connector for Good, you need to:

1. Enable the HCP Anywhere File Sync and ShareAPI in the HCP Anywhere
Management Console

2. Add the HCP Anywhere Connector for Good to the GoodTechnology

folder on the server running GEMS

3. Configure HCP Anywhere in the GEMS Dashboard

4. (Conditional) Configure GEMSto accept an HCP Anywhere SSL self-

signed certificate

Step 1: Enable the HCP Anywhere File Sync and ShareAPI

The HCP Anywhere File Sync and Share API is an HTTP API for integrating
third-party applications with HCP Anywhere. In the case of the HCP
Anywhere Connector for Good, the connector uses the File Sync and Share
API to integrate the Good Enterprise Mobility Server withHCP Anywhere.

For a user to access HCP Anywhere with a Good application, the user must
belong to a profile in the HCP Anywhere Management Console with the HCP
Anywhere File Sync and Share API enabled. By default, the File Sync and
Share API is disabled for each profile.

Note: These instructions are for enabling the HCP Anywhere File Sync and
ShareAPI in an existing profile. You can also enable the File Sync and Share
API when creating a profile.

3
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

To enable the HCP Anywhere File Sync and ShareAPI:

1. In the top-level menu in the HCP Anywhere Management Console, click

on Access.

2. In the list of profiles, click on the profile you want.

3. In the profile, click on the File Sync and Share tab.

4. On the left side of the profile, click on Devices.

4
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

5. In the Device types allowed section, click on the box next to FSS API. If
the box next to FSSAPI has a check, the File Sync and ShareAPI is
enabled.

6. (Optionally) In the Authentication Token Expiration section, select the

amount of time an authentication token remains active for an
application connected to HCP Anywhere by the File Sync and Share API.

5
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

Note: When the authentication token expires for an application connected

to HCP Anywhere by the File Sync and Share API, the user needs to reenter
his or her password to continue using the application to access HCP
Anywhere. In the case of the HCP Anywhere Connector for Good,
GEMSreauthenticates the user when the authentication token expires.

Step 2: Add the HCP Anywhere Connector for Good JAR file to
the Good Technology folder
The actual program that integrates GEMS with HCP Anywhere is located in a
JAR file called anywhere-fss-good-connector.2.1.1.40.jar. You can acquire
this file from your authorized HCP Anywhere service provider.

Once you have the anywhere-fss-good-connector.2.1.1.40.jar file, you need

to place it in the Good Technology program folder on the server running
GEMS. The Good Technology program folder is the folder that was created
when GEMS was first installed on the server. Once the anywhere-fss-good-
connector.2.1.1.40.jar is in the Good Technology program folder, GEMS
automatically deploys the HCP Anywhere Connector for Good with the HCP
Anywhere servers you specify in the GEMSDashboard.

To add the HCP Anywhere Connector for Good JAR file to the Good
Technology folder:

1. On the server running GEMS, locate the Good Technology folder. Most
likely, the Good Technology folder is located in the Program Files folder.

6
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

2. Place the anywhere-fss-good-connector.2.1.1.40.jar file in theGood

Technology deploy folder. The path to theGood Technology deploy folder
is:

Good Technology\Good Enterprise Mobility Server\Good Server

Distribution\gems-quickstart-2.2.12\deploy

Step 3: Configure HCP Anywhere in theGEMS Dashboard

The GEMS Dashboard is the Good administrator portal for adding,
deploying, and managing storage. On theGEMS Dashboard, you need to:

1. Configure HCP Anywhere as a storage type that can be used by GEMS

2. Specify the HCP Anywhere servers to be integrated withGEMS

These operations are performed in the Docs section of the

GEMSDashboard.The GEMS Docs service allows third-party applications to
integrate withGEMS. In the case of the HCP Anywhere Connector for Good,
the connector uses theGEMS Docs service to enable your Good users to
access data on HCP Anywhere.

7
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

Step 3a: Configure HCP Anywhere as a storage type

Before you can specify the HCP Anywhere servers that you want to integrate
with GEMS, you need to configure HCP Anywhere to be a storage type that
GEMS can use. You only need to configure HCP Anywhere as a storage type
a single time.

Once you configure HCP Anywhere as a storage type, it can be used with as
many HCP Anywhere servers as you'd like in the next step.

To configure the storage type for HCP Anywhere on theGEMS Dashboard:

1. On the GOOD ENTERPRISE MOBILITY SERVER DASHBOARD page, click on

Docs.

2. Click on Storages.

8
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

3. Click on New Storage.

4. In the New Storage section, configure these settings:

Storage Name The name of the storage type. This can be any
name you'd like.

Storage Provider In the Storage Provider dropdown, select

HCPAnywhere.

Authentication Provider In the Authentication Provider dropdown,

select Windows - Explicit Credentials.

9
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

5. Click on Save.

The HCP Anywhere storage you configured appears in the list of storage
types on the Storage Type Configuration page.

Step 3b: Specify an HCPAnywhere server to integrate withGEMS

Once you configure HCP Anywhere as a storage type that GEMS can use,
you need to specify:

The HCP Anywhere servers that you want to integrate withGEMS

The users from those servers who can access HCP Anywhere with a Good
application

The operations each user can perform in HCP Anywhere with a Good
application

To specify an HCP Anywhere server to integrate withGEMS:

1. On the GOOD ENTERPRISE MOBILITY SERVER DASHBOARD page, click on

Docs.

10
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

2. Click on Repositories.

3. Click on New Repository.

11
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

4. On the REPOSITORIESCONFIGURATION page, configure these settings:

Display Name The name of the repository. This can be any name
you'd like.

Storage In the Storage dropdown, select the storage you

configured in step 3a.

Path The URLof the HCP Anywhere server. The URL will have this
format:

https://hcp-anywhere-system-name[.domain-name]

Add Users /Groups In the User / Group Lookup window, select the
users and groups you want to be able to acces HCP Anywhere using a
Good application. The users and groups available are those from the
Active Directory accounts configured in the HCP Anywhere server.

Access Permissions Select the operations that each user or group

can perform in HCPAnywhere when using a Good application.

12
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

5. Click on Save.

6. Repeat steps 3 - 5 for each HCP Anywhere server you want to integrate
withGEMS.

Step 4 (conditional): Configure GEMS to accept an HCP Anywhere

self-signed certificate
By default, GEMSdoes not trust SSL self-signed certificates. GEMSonly
trusts valid-signed certificates. If your HCP Anywhere server is using an
SSLself-signed certificate, you need to add the certificate to the Java
keystore on the server running GEMS.

Note: By default, HCP Anywhere uses SSL self-signed certificates.

To configure GEMS to accept an HCP Anywhere SSL self-signed certificate,

you need to:

1. Download your HCP Anywhere SSL self-signed certificate

13
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

2. Add the HCP Anywhere SSL self-signed certificate into the Java keystore
on the server running GEMS

3. Restart the Good Technology Common Services

Step 4a: Download the HCP Anywhere SSL self-signed certificate

The SSL self-signed certificate for your HCP Anywhere system can be
downloaded from any browser.

These instructions are for downloading the HCP Anywhere SSL self-signed
certificate from a Mozilla Firefox version 45 browser. However, the overall
process for downloading the HCP Anywhere SSL self-signed certificate is the
same regardless of the browser that you are using:

Log into the HCP Anywhere Management Console

Download the SSL self-signed certificate from the browser

Save the SSL self-signed certificate

To download the HCP Anywhere SSL self-signed certificate from a Firefox

browser:

1. Log into the HCP Anywhere Management Console.

2. Click on the lock icon ( ) to the left of the HCP Anywhere URL.

3. Click on the arrow to the right of HCP Anywhere server name.

4. Click on More Information .

14
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

5. In the Website Identity panel, click on View Certificate.

6. Click on Details.

15
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

7. Click on Export .

16
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

8. Save the certificate in a location of your choice.

Step 4b: Add theHCP Anywhere SSL self-signed certificate to theJava

keystore

On the server running GEMS, you need to add the HCP Anywhere SSL self-
signed certificate you downloaded in step 4a into the Java keystore. You add
the certificate to the Java keystore using a command prompt.

Important: In order to add the certificate to the Java keystore, you need
to be running the command prompt as an administrator.

To add the HCP Anywhere SSL self-signed certificate into the Java keystore:

1. On the computer running GEMS, open a command prompt as an

administrator.

17
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

2. Navigate to the Java keystore. In general, the path to the Java keystore
is:

Program Files\Java\jre<java-version-number>\bin

For example:

3. Import your HCP Anywhere SSL self-signed certificate using this

command:

For example:

4. In the Enter keystore password prompt, type "changeit" and then press
Enter.

5. In the Trust this certificate? prompt, type "yes" and then press Enter.

Step 4c: Restart the Good Technology Common Services

While theGood Technology Common Services is runnnig, GEMS does not

recognize any new certificates that are added to the Java keystore. In order
for GEMS to recognize the new certificate, you need to restart the Good
Technology Common Services.

Once you restart the Good Technology Common Services, GEMS trusts all
the certificates in the Java keystore. In this case, once you restart the Good
Technology CommonServices, GEMS trusts the HCP Anywhere SSL self-
signed certificate that you added in step 4b.

To restart the Good Technology Common Services:

1.
Click on the Windows start icon ( ).

2. Type "Services" into the search bar and then press Enter.

18
Deploying the HCP Anywhere Connector for Good
 Deploying the HCP Anywhere Connector for Good

3. Click on Services.

4. Right-click on Good Technology Common Services.

19
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good

5. In the menu that appears, click on Restart .

The Good Technology Common Services restarts.

20
Deploying the HCP Anywhere Connector for Good
Deploying the HCP Anywhere Connector for Good
Hitachi Data Systems

Corporate Headquarters
2845 Lafayette Street
Santa Clara, California 95050-2627
U.S.A.
www.hds.com

Regional Contact Information

Americas
+1 408 970 1000
info@hds.com

Europe, Middle East, and Africa

+44 (0) 1753 618000
info.emea@hds.com

Asia Pacific
+852 3189 7900
hds.marketing.apac@hds.com

MK-HCPAW013-00