QuickStart Guide for Java

For Java developers, this QuickStart provides the basics for configuring your development platform to begin building iControl applications.

After configuring your development environment, be sure to download the iControl SDK for samples to begin working with the iControl API.

Still have questions or need guidance? Be sure to visit the DevCentral Forums for help.

 

Because Sun® Java\u2122 offers cross-platform compatibility, you can configure a development environment on your choice of operating system. The guidelines below outline our recomendation for installing and configuring a Java development environment for iControl.

Configuring a Java development environment

You can use these guidelines to configure a development environment on a Microsoft® Windows® or UNIX® platform.

  1. Download a copy of the latest official Java 2 Platform from java.sun.com.
    Multiple Java 2 Platform releases are available for several operating systems at http://java.sun.com.
     
  2. Install the appropriate Java 2 Platform on your system.
     
  3. Download a binary copy (soap-bin-*) of the Apache SOAP package from http://xml.apache.org/dist/soap/. Additional information about Apache SOAP can be found at: http://ws.apache.org/soap/index.html.
     
  4. Install the Apache SOAP release on your system.
     
  5. Extract soap.jar from the Apache SOAP package and copy it to the Java\u2122 2 SDK subdirectory /jre/lib/ext on your system.
     
  6. Download a copy of latest binary Java Xerces parser from http://xml.apache.org/dist/xerces-j/.
     
  7. Extract xerces.jar from the Java Xerces parser package and copy it to the Java 2 SDK subdirectory /jre/lib/ext on your system.
     
  8. Download a binary copy of the JavaBeans\u2122 Activation Framework from http://java.sun.com/products/javabeans/glasgow/jaf.html.

  9. Extract activation.jar from the JavaBeans Activation Framework and copy it to the Java 2 SDK subdirectory /jre/lib/ext on your system.
     
  10. Download a binary copy of the JavaMail API from http://java.sun.com/products/javamail/
     
  11. Extract mail.jar from the JavaMail API and copy it to the Java SDK subdirectory /jre/lib/ext on your system.
     
  12. Because the Java 2 SDK v1.4 or later includes the Java Cryptography Extension (JCE) and Java Secure Socket Extension (JSSE) packages, please perform following changes, depending on your operating system:

    Windows system
    a. Edit make.bat by commenting out the following lines,
    If Not Exist %JAVAHOME%jrelibextjcert.jar Goto BadEnv3
    If Not Exist %JAVAHOME%jrelibextjnet.jar Goto BadEnv4
    If Not Exist %JAVAHOME%jrelibextjsse.jar Goto BadEnv5


    b. Edit each run.bat by commenting out the following lines,
    If Not Exist %JAVAHOME%jrelibextjcert.jar Goto BadEnv3
    If Not Exist %JAVAHOME%jrelibextjnet.jar Goto BadEnv4
    If Not Exist %JAVAHOME%jrelibextjsse.jar Goto BadEnv5


    UNIX system
    a . Edit java.inc.mk by commenting out the following line,
    SSL_JAR := ${JAVALIB}/jsse.jar

    b. Edit run.sh by commenting out the followings lines,
    if test ! -r "$JAVAHOME/jre/lib/ext/activation.jar"
    then
    echo "ERROR: Cannot find activation.jar $JAVAHOME/jre/lib/ext."
    "Please verify your JAVAHOME environment variable."
    exit 1