Sentinel Cloud V.3.6Installation Guide

ii Sentinel Cloud Installation Guide

Document Revision History

Part number 007-012146-001, Rev R

May 2015

Disclaimer and Copyrights

Copyright © 2015, SafeNet, Inc. All rights reserved. http://www.safenet-inc.com/

We have attempted to make these documents complete, accurate, and useful, but we cannot guarantee them to be perfect. When we discover errors or omissions, or they are brought to our attention, we endeavor to correct them in succeeding releases of the product. SafeNet, Inc. is not responsible for any direct or indirect damages or loss of business resulting from inaccuracies or omissions contained herein. The specifications contained in this document are subject to change without notice.

SafeNet® and Sentinel® are registered trademarks of SafeNet, Inc. All other product names referenced herein are trademarks or registered trademarks of their respective manufacturers.

ContentsAbout This Document 1Sentinel Cloud Services Media Contents 1Installing Sentinel Cloud Services on Windows 1

Specific Requirements 1Installation 2Installed Components 2Installing Sentinel Cloud Run-time at Customer’s Site (Windows) 3

Installing Sentinel Cloud Services on Linux 4Installation 4Extracted Components 4Installing Sentinel Cloud Run-time at Customer’s Site (Linux) 4

Uninstalling Sentinel Cloud Services on Windows 5Upgrade Notes 5

What if you do not want to upgrade? 5What points to consider during the upgrade? 6

Obtaining Support 6

1 Sentinel Cloud Installation Guide

About This DocumentThis document provides installation information about Sentinel® Cloud Services.

Visit documentation.sentinelcloud.com to access the complete product documentation.

Sentinel Cloud Services Media ContentsThis section lists the contents of the media provided to a software provider.

Directory/File Contents

Windows

Sentinel Cloud Runtime.exe

Installer for installing SDK components of Sentinel Cloud Services on Windows. This is a common installer for all the supported interfaces - Java, .NET, and C. For information of SDK components installed by installer, See "Installed Components" on page 2.

Manuals Contains product acknowledgments.

Installation Guide.pdf

This document containing installation instructions.

Linux

Sentinel Cloud Services (Linux).tar

Contains all the required components for deploying C and Java Run-times on Linux.

Sentinel Cloud Services installer supports Unicode character encoding.

Installing Sentinel Cloud Services on Windows

Specific Requirements

Given below are the requirements you need to ensure before installing Sentinel Cloud Services.

n JRE 6 should be installed on the system where you want to install Sentinel Cloud Services Java SDK. You can download JRE from http://www.oracle.com/technetwork/java/javase/downloads/ index.html.

n You should have complete read and write permissions on the directory where you want to install Sentinel Cloud Run-time.

Installation

A common setup for Java, .NET, and C SDK is available in the Sentinel Cloud Services media, by the name Sentinel Cloud Runtime.exe. Double-click the setup to launch a self-extracting installer. Follow the on-screen instructions to complete the installation.

On Windows 7 and Windows Server 2008, you need to run installer as Administrator.

Installation Notes

n The default installation directory for Sentinel Cloud Services Run-time is:

o On 32-bit system: C:\Program Files\SafeNet Sentinel\Sentinel Cloud Services\

o On 64-bit system: C:\Program Files (x86)\SafeNet Sentinel\Sentinel Cloud Services\

You can specify a different directory during the installation.

n On Windows, you can access Sentinel Cloud Services by using Start > All Programs > SafeNet Sentinel > Sentinel Cloud Services.

Installed Components

The directory structure of the installed components is described below:

Directory Contents

Configurations Stores client configuration file (SentinelCloudRuntime.properties) that contains Run-time configuration settings for all supported interfaces.

Documentation Contains product acknowledgments.

Redistributables Contains redistributable components, such as customized License Manager Server by the name haspdinst.exe. A software provider can distribute these components to customers for on-premise deployments.

RunTimes Contains jars or library files

\C SDK n \include: Contains the header files. n \Win32: Contains C Run-time and third-party libraries for Windows 32-

bit platform. n \Win64: Contains C Run-time and third-party libraries for Windows 64-

bit platform.

\Dot Net SDK n \Library: Contains the main library of Cloud Run-time. n \External Libraries: Contains the third party libraries and XML based

configuration file.

\Java SDK n \Jars: Contains jar files and property file. n \Third party libraries: Contains the third party jar files.

Samples Contains API samples for cloud and on-premise deployments.

\Cloud Connect WebServices

Contains Python sample for Cloud Connect Web services.

Installing Sentinel Cloud Services on Windows 2

3 Sentinel Cloud Installation Guide

Directory Contents

\Runtime n \C: Contains C source code and workspace of cloud and on-premise samples.

n \Dot Net: Stores .NET source code of cloud and on-premise samples. n \Java: Stores Java source code of cloud and on-premise samples.

XML Schema Stores the XML schema for Cloud Connect Web services.

Installing Sentinel Cloud Run-time at Customer’s Site (Windows)

The on-premise Run-time environment is required for your protected software to run at the customer’s site. The components required to install on-premise Run-time environment are available in the \Redistributables folder. To install the on-premise Run-time environment:

Open command prompt, navigate to the Redistributables directory, and run the following command: haspdinst.exe -i

Antivirus Compatibility

If you use Trend Micro Antivirus, ensure that its latest version is installed to avoid any installation issues with on-premise Run-time environment of Sentinel Cloud. This is applicable for both Windows and Linux.

Installing Sentinel Cloud Services on Linux

Installation

Extract the Sentinel Cloud Services (Linux).tar package to a location on your system, by using the following command:

tar -xvf Sentinel Cloud Services(Linux).tar

Extracted Components

The directory structure of the extracted components is described below:

Directory Contents

Configurations Stores client configuration file (SentinelCloudRuntime.properties) that contains Run-time configuration settings for all supported interfaces.

Documentation Contains product acknowledgments.

Redistributables Contains redistributable components, such as customized License Manager Server. A software provider can distribute these components to customers for on-premise deployments.

RunTimes Contains jars or library files.

/C SDK n /include: Contains the header files. n /32-bit: Contains C Run-time libraries and third-party libraries for Linux

32-bit platform. n /64-bit: Contains C Run-time libraries and third-party libraries for Linux

64-bit platform.

/Java SDK n /Jars: Contains jar files, property file, and DLLs. n /Third party libraries: Contains the third party jar files.

Samples Contains API samples for cloud and on-premise deployments.

/Cloud Connect WebServices

Contains Python sample for Cloud Connect Web services.

/Runtime n /C: Contains C source code and workspace of cloud and on-premise samples.

n /Java: Contains the Java source code of cloud and on-premise samples.

XML Schema Stores the XML schema for Cloud Connect Web services.

Installing Sentinel Cloud Run-time at Customer’s Site (Linux)

The on-premise Run-time environment is required for your protected software to run at the customer’s site. The components required to install on-premise Run-time environment are available in the /Redistributables folder.

In addition, on Windows 7 and Windows 2008, you must have administrative privileges to perform the installation.

Installing Sentinel Cloud Services on Linux 4

5 Sentinel Cloud Installation Guide

To install the on-premise Run-time environment:

Open command prompt, navigate to the /Redistributables folder, and run the following command:

rpm -Uvh aksusbd-2.2.2.i386.rpm

To install and operate the Sentinel Cloud Run-time package under a 64-bit Linux operating system, you must also install the 32-bit base library package (x86 compatibility packages):

n glibc-2.12-1.47.el6.i686.rpm

n nss-softokn-freebl-3.12.9-11.el6.i686.rpm

Antivirus Compatibility

If you use Trend Micro Antivirus, ensure that its latest version is installed to avoid any installation issues with on-premise Run-time environment of Sentinel Cloud. This is applicable for both Windows and Linux.

Uninstalling Sentinel Cloud Services on WindowsTo uninstall Sentinel Cloud Services on Windows, select Start > All Programs > SafeNet Sentinel > Sentinel Cloud Services > Uninstall SentinelCloudRuntime.

Upgrade NotesOnce the back-end environment has been updated to the latest version of Sentinel Cloud, your designated contact receives an e-mail containing the upgrade details. You can choose to continue using the old Run-time SDK or upgrade it to the latest version.To use the new features, an upgrade to the latest Run-time is recommended.

You can refer to the latest Release Notes to learn about what’s new in the release.

What if you do not want to upgrade?

If you decide to continue using the old Run-time version, you are not required to take any additional step because we provide Run-time backward compatibility for a designated period (usually 3 years from the release date). So if you do not want to use new features:

n For Run-time, you can continue using the old Run-time with the latest Sentinel Directory Services and Sentinel Cloud Connect.

n For EMS Web services, you can continue using the old web service URLs with the latest Sentinel EMS.

What points to consider during the upgrade?

n The installation of the latest SDK version will uninstall previous version, if found. So it is recommended to take a backup of the previously installed SDK components before the upgrade.

n After installing the latest SDK, you need to perform the following steps to start using the new features:

o For Run-time, use all the latest libraries provided in the SDK.

o For EMS Web services, you need to use the latest version in web service URLs.

Obtaining SupportIf you encounter a problem while installing, registering or operating this product, please make sure that you have read the documentation. If you cannot resolve the issue, contact your supplier or SafeNet Customer Support. SafeNet Customer Support operates 24 hours a day, 7 days a week. Your level of access to this service is governed by the support plan arrangements made between SafeNet and your organization. Please consult this support plan for further information about your entitlements, including the hours when telephone support is available to you.

Contact Method Contact Information

Address SafeNet, Inc.4690 Millennium Drive Belcamp, Maryland 21017, USA

Phone US 1-800-545-6608

International 1-410-931-7520

Technical Support Customer Portal

https://serviceportal.safenet-inc.comExisting customers with a Technical Support Customer Portal account can log in to manage incidents, get the latest software upgrades, and access the SafeNet Knowledge Base

Obtaining Support 6