NetApp SANtricty Web Services Proxy 1.3 Install Guide

Transcription

NetApp® SANtricity® Web Services Proxy 1.3
Installation Guide
NetApp, Inc.
495 East Java Drive
Sunnyvale, CA 94089
U.S.
Telephone: +1 (408) 822-6000
Fax: +1 (408) 822-4501
Support telephone: +1-(888) 463-8277
Web: http://www.netapp.com
Feedback: doccomments@netapp.com
Part number: 215-10639_A0
Release date: October 2015
Table of Contents
About This Guide .................................................................................................................................. 1
Overview of the NetApp SANtricity Web Services Proxy ................................................................. 1
New in this Release ......................................................................................................................... 1
Abbreviations, Acronyms, Terms, and Definitions ........................................................................... 1
System Requirements .......................................................................................................................... 1
Compatible Operating Systems ....................................................................................................... 2
Linux Standard Base ........................................................................................................................ 2
Installing and Maintaining Web Services Proxy ................................................................................ 2
Capacity Planning for Web Services Proxy ..................................................................................... 2
Installing Multiple Instances of Web Services Proxy ....................................................................... 2
Installation Modes ............................................................................................................................ 2
Web Services Proxy License ........................................................................................................... 3
Web Services Proxy Readme File ................................................................................................... 3
Auto Update Notice .......................................................................................................................... 3
Installing Web Services Proxy.......................................................................................................... 4
Installing Web Services Proxy on a Windows Operating System ............................................. 4
Installing Web Services Proxy on a Linux Operating System ................................................... 9
Installing Web Services Proxy in the Graphical Mode............................................................. 10
Installing Web Services Proxy in the Console Mode ............................................................... 14
Installing Web Services Proxy in the Silent Mode ................................................................... 17
Stopping and Restarting the NetApp SANtricity Web Services Proxy Application Server ............ 18
Stopping and Restarting the Web Services Proxy Webserver ...................................................... 18
Uninstalling Web Services Proxy...................................................................................................... 18
Uninstalling Web Services Proxy from a Windows Operating System .......................................... 18
Uninstalling Web Services Proxy from a Linux Operating System ................................................ 20
Using the Graphical Mode to Uninstall Web Services Proxy ......................................................... 21
Using the Console Mode to Uninstall Web Services Proxy ........................................................... 23
Using the Silent Mode to Uninstall Web Services Proxy ............................................................... 23
Trademark information ...................................................................................................................... 24
Copyright information ........................................................................................................................ 25
How to send your comments ............................................................................................................ 26
NetApp SANtricity Web Services Proxy 1.3 Installation Guide
i
About This Guide
This guide describes how to install, configure, and uninstall the NetApp SANtricity Web Services Proxy.
Overview of the NetApp SANtricity Web Services Proxy
The NetApp SANtricity Web Services Proxy provides access through standard HTTPS mechanisms to configuring
management services for NetApp storage arrays. You can install Web Services Proxy on either a Linux machine or a
Windows machine. As Web Services Proxy satisfies the client request by collecting data or executing configuration
change requests to a target storage array, the Web Services Proxy module issues SYMbol requests to the target
storage arrays.
Web Services Proxy provides a Representative State Transfer (REST) Application Programming Interface (API) for
managing NetApp controllers. The API enables you to integrate storage array management into other applications or
ecosystems.
New in this Release
This release of the Web Services Proxy features the following enhancements:
•
•
•
•
Enhanced Analyzed Statistics Endpoints to include cache utilization.
Added Software Service Catalog Endpoints to aid the user in discovering the capabilities of configured
storage pools and creating volumes based on user criteria.
Organized interactive documentation to aid the user in finding documentation.
Several minor enhancements to data returned on Endpoints.
•
Hardware and firmware
E5600, EF550, EF560 storage arrays
Dual Port FDR 56-Gb InfiniBand
Support for controller firmware 8.20
o
o
o
Abbreviations, Acronyms, Terms, and Definitions
The following table shows the abbreviations and acronyms used in this document and their definitions.
Abbreviations, Acronyms, Terms
Definitions
API
Application Programming Interface
CORS
Cross-Origin Resource Sharing
FDR
Fourteen Date Rate
LSB
Linux Standard Base
JSON
JavaScript Object Notation
REST
Representational State Transfer
System Requirements
Make sure that your system meets the following compatibility requirements before you install Web Services Proxy.
1
Compatible Operating Systems
Web Services Proxy is compatible with and supported on the following operating systems:
Operating System
Version
Architecture
Red Hat Enterprise Linux (RHEL)
6.x
64 bit
SUSE Linux Enterprise Server
(SLES)
10.x, 11.x
Oracle Enterprise Linux (OEL)
5.x, 6.x, 7x
64 bit
Windows Server
2008 R2, 2012, 2012 R2
64 bit
64 bit
Linux Standard Base
The Linux Standard Base (LSB) package for your Linux distribution must be installed to properly start up and shut
down the Web Services Proxy.
Installing and Maintaining Web Services Proxy
Capacity Planning for Web Services Proxy
Web Services Proxy requires adequate space for logging. Ensure that your system has adequate available disk space
for Web Services Proxy. You can use a disk-space monitoring tool to verify available disk drive space for persistent
storage and logging.
•
•
Required Installation Space - 194 MB
Minimum Logging Space - 200 MB
Installing Multiple Instances of Web Services Proxy
You can install only one instance of Web Services Proxy on a server, but you can install multiple instances of Web
Services Proxy on multiple servers within a network. Installing multiple instances of Web Services Proxy on multiple
servers within a network provides several advantages.
•
•
Configuring multiple instances of Web Services Proxy with the same set of storage arrays can achieve highavailability service for a common set of storage arrays.
Creating multiple instances of Web Services Proxy allows you to manage separate storage management domains
independently. Management domains can have different sets of user accounts.
Installation Modes
You can install Web Services Proxy in the following operating systems and modes. The Compatible Operating System
section identifies the compatible operating systems and versions.
•
•
Windows
Linux
o
o
o
2
Graphical mode
Console mode
Silent mode
Web Services Proxy License
Web Services Proxy is a standalone product. The Proxy itself is free and does not require a license key. However,
applicable copyrights and terms of service apply. During the graphical mode installation and the console mode
installation, you must accept the End User License Agreement (EULA).
•
Linux Installation
o
On a Linux operating system, the eula.html file is installed in the default directory.
/opt/netapp/santricity_web_services_proxy
o
To open the eula.html file, type the following file name and directory path in the address bar of a web
browser:
file:///opt/netapp/santricitywebservicesproxy/eula.html
•
Windows Installation
o
On a Windows operating system, the eula.html file is installed in the default directory.
C:\Program Files\NetApp\SANtricity Web Services Proxy
o
To open the eula.html file either type the following file name and directory path in the address bar of a
web browser, or use a web browser to search for the file.
C:\Program Files\NetApp\SANtricity Web Services Proxy\eula.html
Web Services Proxy Readme File
•
Linux Installation
o
On a Linux operating system, the readme.html file is installed in the default directory.
/opt/netapp/santricity_web_services_proxy
o
To open the readme.html file, type the following file name and directory path in the address bar of a web
browser.
file:///opt/netapp/santricity web services proxy/readme.html
•
Windows Installation
o
On a Windows operating system, the readme.html file is installed in the default directory.
o
To open the readme.html file, either type the following file name and directory path in the address bar of a
web browser, or use a web browser to search for the file.
C:\Program Files\NetApp\SANtricity Web Services Proxy\readme.txt
Auto Update Notice
After you accept accepting the End User License Agreement (EULA) during the installation process, the following
Auto Update notice appears:
3
This version of the software has the ability to check for software updates and
download those updates automatically to be installed when:
• The application is restarted
• On demand by the user with the application
This feature is enabled by default and requires internet connectivity to the NetApp
software update server to be able to fetch the update allowing your client side IP
address to be revealed. It can be disabled by selecting the ‘‘Disabling Auto
Updates’’ option during installation or by editing the configuration file after
installation. No user data or customer data is provided during the download process.
For details on editing the configuration file and how to restore to the previous software version, refer to the “Managing
Auto Updates” section of the NetApp SANtricity Web Services Proxy 1.3 User Guide.
Installing Web Services Proxy
Installing Web Services Proxy on a Windows Operating System
The Web Services Proxy installation file for Windows is webservice-01.nn.nnnn.nnnn.exe, where
nn.nnnn.nnnn is the version number of Web Services Proxy.
The default destination path on a Windows operating system is at the following location:
NOTE: You cannot change the destination path.
To install Web Services Proxy on a Windows operating system, perform the following actions:
1.
2.
3.
4.
Download the installation file to the location on your server from which to install Web Services Proxy.
Download the Web Services Proxy installation file to your local computer.
Go to the directory that contains the downloaded Web Services Proxy installation file.
Double-click the Web Services Proxy installation file.
The InstallAnywhere message with the progress bar appears.
NOTE: If the User Account Control message appears before the InstallAnywhere message appears, click Yes.
The NetApp SANtricity Web Services Proxy splash screen appears.
4
The NetApp SANtricity Web Services Proxy splash screen disappears, and the Please Wait message appears.
NOTE: If the operating system is not compatible with Web Services Proxy, the Unsupported Operating System
message appears superimposed on the Please Wait dialog box.
•
•
To continue the installation process on an unsupported operating system, click OK.
To exit the installation process, click Exit.
The NetApp SANtricity Web Services Proxy Installer dialog box appears.
•
•
To continue the installation process on an unsupported operating system, click OK.
To exit the installation process, click Exit.
The NetApp SANtricity Web Services Proxy Installer dialog box appears.
5. Click Next.
5
The License Agreement appears.
6. Select I accept the terms of the License Agreement and then click Next.
The Choose Install Folder dialog box appears.
•
•
6
To change the installation location, delete the path in the Where Would You Like to Install? text box and then
type the new path.
To search for the installation folder, click Choose and then select the folder in the Browse for Folder dialog
box.
7. Click Next.
The Auto Update Feature dialog box appears.
•
•
To enable Auto Update functionality, select Enable Auto Updates.
To disable Auto Update functionality, select Disable Auto Updates.
8. Click Next.
The ASUP Enabled dialog box appears.
•
•
To enable AutoSupport functionality, select Enable ASUP (Recommended).
To disable AutoSupport functionality, select Disable ASUP.
9. Click Next.
The Pre-Installation Summary dialog box appears.
10. Review the information.
NOTE: If you do not accept the summary information, click Previous to return to the Choose Install Folder dialog
box.
7
11. Click Install to accept the summary information.
The Installing NetApp SANtricity Web Services Proxy message appears and shows the installation progress bar.
The Installing NetApp SANtricity Web Services Proxy message disappears, and the Please Wait dialog box
appears.
When the NetApp SANtricity Web Services Proxy configuration is complete, the Webserver Started message
appears superimposed on the Please Wait message.
8
12. On the Webserver Started message, click OK to complete the installation.
When the installation is complete, the Install Complete dialog box appears.
13. Click Done.
The NetApp SANtricity Web Services Proxy is installed in the Services (Local) window and automatically starts.
Installing Web Services Proxy on a Linux Operating System
You can install Web Services Proxy on a Linux operating system in the following three ways:
•
•
•
Graphical
Console
Silent
Web Services Proxy installation file for Linux is webservice-01.nn.nnnn.nnnn.bin, where nn.nnnn.nnnnn is the version
number of the Web Services Proxy. The default destination path on a Linux operating system is
opt/netapp/santricity_web_service_proxy.
To install Web Services Proxy, perform the following actions:
9
1.
2.
3.
4.
5.
Download the installation file to the location on your server from which to install Web Services Proxy.
Download the Web Services Proxy installation file to your local computer.
Open a terminal window, and log in.
Go to the directory that contains the Web Services Proxy installation file.
Refer to the appropriate instructions for installing Web Services Proxy.
•
•
•
Installing Web Services Proxy in the Graphical Mode
Installing Web Services Proxy in the Console Mode
Installing Web Services Proxy in the Silent Mode
Installing Web Services Proxy in the Graphical Mode
The graphical mode is the default installation mode. The default location for the graphical installation is
/opt/netapp/santricity_web_services_proxy.
1. Run the following command, where nn.nnnn.nnnn is the version number of the application:
./webservice-01.nn.nnnn.nnnn.bin
10
•
•
The installation process starts.
The NetApp SANtricity Web Services Proxy splash screen appears.
•
The NetApp SANtricity Web Services Proxy splash screen disappears, and the Please Wait message
appears and then disappears.
•
The Please Wait message disappears and the Introduction dialog box appears.
2. Click Next.
3. Select I accept the terms of the License Agreement and click Next.
The Choose Install Folder dialog box appears.
•
•
To change the installation location, delete the path in the Where Would You Like to Install? text box and then
type the new path.
To search for the installation folder, click Choose and then select the folder in the Browse for Folder dialog
box.
4. Click Next.
11
The Auto Update Feature dialog box appears.
•
•
To enable Auto Update functionality, select Enable Auto Updates.
To disable Auto Update functionality, select Disable Auto Updates.
5. Click Next.
The ASUP Enabled dialog box appears
•
•
To enable AutoSupport functionality, select Enable ASUP (Recommended).
To disable AutoSupport functionality, select Disable ASUP.
6. Click Next.
The Pre-Installation Summary dialog box appears.
7. Review the Information.
NOTE: If you do not accept the summary information, click Previous to return to the Choose Install Folder dialog
box.
8. Click Install.
12
•
The Installing NetApp SANtricity Web Services Proxy message appears and shows the installation progress
bar.
•
The Installing NetApp SANtricity Web Services Proxy message disappears, and the Please Wait message
appears.
•
When the NetApp SANtricity Web Services Proxy configuration is complete, the Webserver Started message
appears superimposed on the Please Wait message.
For more information about the web_services_proxy webserver go to Stopping and Restarting the Web
Services Proxy Webserver.
•
13
9. On the Webserver Started message, click OK to complete the installation.
When the installation is complete, the Install Complete message appears.
10. Click Done.
•
•
The NetApp SANtricity Web Services Proxy installs successfully.
The Install closes.
Installing Web Services Proxy in the Console Mode
The default location for the console installation is /opt/netapp/santricity_web_services_proxy.
./webservice-01.nn.nnnn.nnnn.bin
•
14
–i
console
The installation process starts. The Launching Installer – Introduction message appears.
•
To cancel the installation at any time during the installation process, type Quit at the command prompt.
2. Press Enter.
NOTE: The License Agreement displays on multiple pages.
15
3. After each page, press Enter to go to the next page.
The last page contains the License Agreement acceptance statement.
4. Type Y to accept the License Agreement.
If you do not accept the License Agreement, a warning message appears. If you again do not accept the License
Agreement, the installation process terminates and returns you to the installation location.
5. Press Enter.
•
•
The Choose Install Folder option appears.
To change the installation location, type the absolute path to the new location after the colon.
•
The Pre-Installation Summary appears.
6. Review the Pre-Installation Summary.
7. Press Enter to accept the Install folder.
NOTE: You cannot change the installation location. To install Web Services Proxy in a different location, you
must quit the installation process and start the installation again.
The Installing and Webserver Started messages appear. For more information about the web_services_proxy
webserver, see Stopping and Restarting the Web Services Proxy Webserver.
16
8. Press Enter to complete the installation.
The Installation Complete message appears.
9. Press Enter to exit the installation and return to the installation directory.
Installing Web Services Proxy in the Silent Mode
The default location for the silent location is /opt/netapp/santricity_web_services_proxy.
./webservice-01.nn.nnnn.nnnn.bin –i silent
2. Press Enter.
•
•
•
The installation process can take several minutes to complete.
The installation process runs, but no return messages or script appear in the terminal window.
After Web Services Proxy is successfully installed, a command prompt appears in the terminal window. The
following screenshot displays an example of the Silent Installation Mode.
17
Stopping and Restarting the NetApp SANtricity Web Services Proxy Application Server
1. In the start menu, select Administrative Tools > Services.
2. To stop the NetApp SANtricity Web Services Proxy, select Stop the Service.
3. To restart the NetApp SANtricity Web Services Proxy, select Restart the Service.
Stopping and Restarting the Web Services Proxy Webserver
1. Change to the root directory.
2. At the command prompt, type the appropriate command.
•
•
•
To stop the Web Services Proxy webserver type /etc/init.d/ web_services_proxy stop at the
command prompt.
To start the Web Services Proxy webserver, type /etc/init.d/ web_services_proxy start at the
command prompt.
To restart the Web Services Proxy webserver, type /etc/init.d/ web_services_proxy restart at
the command prompt.
3. After Web Services Proxy has restarted, start a Web Services Proxy web session and verify that the changes
have taken effect.
Uninstalling Web Services Proxy
Uninstalling Web Services Proxy from a Windows Operating System
1. Go to the directory that contains the Web Services Proxy uninstall file. The default directory is at the following
location:
C:/Program Files/NetApp/SANtricity Web Services Proxy/uninstall_web_services_proxy
2. In the uninstall_web_services_proxy folder, double-click uninstall_web_services_proxy.exe.
18
The SANtricity Web Services Proxy splash screen appears.
NOTE: If the User Account Control message appears before the SANtricity Web Services Proxy splash screen
appears, click Yes.
The Uninstall NetApp SANtricity Web Services Proxy dialog box appears.
3. Click Uninstall.
•
The Uninstall NetApp SANtricity Web Services Proxy message disappears and the Please Wait message
appears.
19
•
The Please Wait message disappears and the Uninstall NetApp SANtricity Web Services Proxy message
appears.
•
The Uninstall NetApp SANtricity Web Services Proxy message disappears and the Uninstall Complete dialog
box appears.
4. Select either Yes, restart my system or No, I will restart the system myself and then click Done.
Uninstalling Web Services Proxy from a Linux Operating System
The default uninstall mode is the same as the installation mode. However, you can specify any of the following modes
to use for uninstalling Web Services Proxy.
•
•
20
Graphical mode
Console mode
•
Silent mode
To uninstall Web Services Proxy, perform the following actions:
1. Open a terminal window, and log in.
2. Go to the directory that contains the Web Services Proxy uninstall file.
The default directory is at the following location:
/opt/netapp/santricity_web_services_proxy/uninstall_web_services_proxy
3. Refer to the appropriate instructions for uninstalling Web Services Proxy.
•
•
•
Using the Graphical Mode to Uninstall Web Services Proxy
Using the Console Mode to Uninstall Web Services Proxy
Using the Silent Mode to Uninstall Web Services Proxy
Using the Graphical Mode to Uninstall Web Services Proxy
Regardless of the installation mode, you can use the graphical mode to uninstall Web Services Proxy. To uninstall
Web Services Proxy, perform these actions:
1. Run the following command:
uninstall_web_services_proxy -i gui
The SANtricity Web Services Proxy splash screen appears.
•
•
The SANtricity Web Services Proxy splash screen closes.
The Uninstall NetApp SANtricity Web Services Proxy dialog box appears.
21
2. Click Uninstall.
•
•
The Please Wait message appears and closes.
The Uninstaller progress bar appears and shows the uninstall progress.
The Uninstall Complete – all items were successfully uninstalled message appears.
3. Click Done.
•
•
22
Web Services Proxy is removed from the server.
The Uninstall Complete dialog box closes.
Using the Console Mode to Uninstall Web Services Proxy
Regardless of the installation mode, you can use the console mode to uninstall Web Services Proxy. To uninstall Web
Services Proxy, perform these actions:
1. Run the following command:
uninstall_web_services_proxy -i console
The uninstall process starts.
2. Press Enter.
Using the Silent Mode to Uninstall Web Services Proxy
Regardless of the installation mode, you can use the silent mode to uninstall Web Services Proxy. To uninstall Web
Services Proxy, run the following command:
uninstall_web_services_proxy -i silent
•
•
The uninstall process runs, but no return messages or script appear in the terminal window.
After Web Services Proxy is successfully uninstalled, a command prompt appears in the terminal window. The
following screenshot displays an example of the Silent Installation Mode.
23
Trademark information
NetApp, the NetApp logo, Go Further, Faster, ASUP, AutoSupport, Campaign Express, Cloud ONTAP, clustered Data
ONTAP, Customer Fitness, Data ONTAP, DataMotion, Fitness, Flash Accel, Flash Cache, Flash Pool, FlashRay,
FlexArray, FlexCache, FlexClone, FlexPod, FlexScale, FlexShare, FlexVol, FPolicy, GetSuccessful, LockVault,
Manage ONTAP, Mars, MetroCluster, MultiStore, NetApp Insight, OnCommand, ONTAP, ONTAPI, RAID-DP,
SANtricity, SecureShare, Simplicity, Simulate ONTAP, Snap Creator, SnapCopy, SnapDrive, SnapIntegrator,
SnapLock, SnapManager, SnapMirror, SnapMover, SnapProtect, SnapRestore, Snapshot, SnapValidator, SnapVault,
StorageGRID, Tech OnTap, Unbound Cloud, and WAFL are trademarks or registered trademarks of NetApp, Inc. in
the United States, and/or other countries. A current list of NetApp trademarks is available on the web at
http://www.netapp.com/us/legal/netapptmlist.aspx.
Cisco and the Cisco logo are trademarks of Cisco in the U.S. and other countries. All other brands or products are
trademarks or registered trademarks of their respective holders and should be treated as such.
24
Copyright information
Copyright © 1994-2015 NetApp, Inc. All rights reserved. Printed in the U.S.
No part of this document covered by copyright may be reproduced in any form or by any means—graphic, electronic,
or mechanical, including photocopying, recording, taping, or storage in an electronic retrieval system—without prior
written permission of the copyright owner.
Software derived from copyrighted NetApp material is subject to the following license and disclaimer:
THIS SOFTWARE IS PROVIDED BY NETAPP “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE, WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL NETAPP
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
NetApp reserves the right to change any products described herein at any time, and without notice. NetApp assumes
no responsibility or liability arising from the use of products described herein, except as expressly agreed to in writing
by NetApp. The use or purchase of this product does not convey a license under any patent rights, trademark rights,
or any other intellectual property rights of NetApp.
The product described in this manual may be protected by one or more U.S. patents, foreign patents, or pending
applications.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to restrictions as set
forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.2777103 (October 1988) and FAR 52-227-19 (June 1987).
25
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback.
Your feedback is important in helping us to provide the most accurate and high-quality information. If you have
suggestions for improving this document, send us your comments by email to doccomments@netapp.com. To help us
direct your comments to the correct division, include in the subject line the product name, version, and operating
system.
You can also contact us in the following ways:
•
•
•
•
26
NetApp, Inc., 495 East Java Drive, Sunnyvale, CA 94089 U.S.
Telephone: +1 (408) 822-6000
Fax: +1 (408) 822-4501
Support telephone: +1 (888) 463-8277

NetApp SANtricty Web Services Proxy 1.3 Install Guide

Transcription

Similar documents

Regions CD Check Viewer Installation Guide

Munchausen By Proxy and the Intestinal Failure Patient

“Usability-Proxy” für Webseiten

DOMAIN REGISTRATION AND HOSTING OF A WEBSITE: THE

field services

installation instructions

Echo Flooring Gallery will Floor You with Huge Savings and 0% 12

Xactimate System Requirements

The Open Proxy Problem

PDF - Armstrong World Industries

Proxy Sniffer Installation and Configuration Guide

Using Proxy Servers with Citrix MetaFrame Presentation Server