How to setup your E-Series development environment for Java

Originally published 6/28/14.

 

Overview

In this blog post you will learn about how to configure the E-Series SANtricity simulator, install the SANtricity web services proxy, and start accessing the RESTful API to your E-Series SANtricity web services proxy using Java.

 

About NetApp E-Series Storage

NetApp E-Series is extremely fast and reliable SAN storage. The main use cases for E-Series storage are simple SAN, backup to disk, video surveillance, and high performance applications / databases.

 

More information about NetApp E-Series

 

Setup NetApp E-Series SANtricity simulator

NetApp provides a simulator for SANtricity, which is the operating system which runs on E-Series storage systems. Right now, the SANtricity simulator runs only under Windows. In our setup, we used the simulator under Windows 2012. The SANtricity simulator is based on Java, but as the JRE is bundled with the simulator, there is no need to install Java separately.

 

Download E-Series SANtricity simulator

 

Installation instructions

  • Unzip the SANtricity simulator bundle under C: (make sure there are no spaces in the path, else things won't work properly)
  • Execute the StartSANtricity_1110 V1pkg.bat script - this will start the SANtricity simulator and the SANtricity GUI
  • After the SANtricity GUI has started, select the automatic discover option. This will create multiple, simulated E-Series storage systems.

 Select Addition Method

Upon completion of discovery you can click on the devices tab and you should now see all the simulated E-Series storage systems:

 

SANtricity

 

Now, install the SANtricity web services proxy on same host running the simulator.

 

NetApp E/EF-Series REST API basics and examples using cURL

cURL is a library and CLI command for transferring data with various protocols. It is a great tool for testing RESTful APIs since one of the protocols it supports is HTTP/HTTPS. Our own Clemens Siebler has written an extensive blog post on how to send RESTful APIs to the SANtricity web services proxy using curl.

 

NetApp E/EF-Series RESTful API examples using Java

Since there is no Java SDK (hopefully this will be provided one day) there is quite a bit of low-level stuff that needs to be handled in order to use the RESTful APIs provided by the SANtricity web services proxy in Java. E/EF-Series RESTful APIs also require JSON (JavaScript Object Notation) for inputs and outputs. We have provided exemplary code, which handles a lot of the low level stuff and should provide you with a good basis for sending RESTful APIs in Java to E/EF-Series. The code provided is not intended to be production code, it should be used just for example.

 

Requirements

  • Java 7 or higher
  • Maven 3
  • Apache CXF
  • Gson
  • Git 

Downloading the code

The source code is located on GitHub in a repository called ktenzer/Eseries-Java-Client. You can either download a zipfile of the repository from GitHub or install the git cli and run the following command:

git clone https://github.com/ktenzer/Eseries-Java-Client.git

 

Running the code

Before you run the code it goes without saying that you need to install the Java JDK. In addition dependencies such as Apache CXF and Gson also need to be downloaded. To make things easy we have configured maven. Make sure you install Apache Maven 3. Once you have maven installed run the following command from the Eseries-Java-Client directory which will download any required dependencies:

mvn clean compile

 

Finally you can import the project into Eclipse or whatever IDE you like and run the code. Under examples you will find several programs which can be executed directly from Eclipse as a Java Application.

 

We hope you have enjoyed and found this blog useful. Please leave comments or reach out to us for more information. We are happy to show more examples of how you can integrate with NetApp E/EF-Series RESTful APIs.

Comments

Hello,

 

I want to install NetApp E series simulator on linux platform. After carefully looking into page it seems like E series simulator is only used for windows 2012 OS. In my case I have to install then first Windows 2012 OS VM and then install E series simulator on top of VM. Is there any way I can install E series simulator directly on Sles 11 linux operating system. I will use the simulator and proxy server mainly for media sanitization purpose.