Netlib Howto Start

Netlib Howto Start

Abstract: This page describes the installation of silvertunnel.org Netlib.

Install Netlib

• download the newest source+binary package silvertunnel.org_netlib-VERSION.zip from the silvertunnel files download page
  • all necessary software is included in the package, a separate installation of the classic Tor or other software is not necessary.
• ensure that your computer time is quite correct (has less than 5 minutes difference to the official time) - use e.g. NTP to synchronize your clock

• extract the archive - you will get a directory structure like

      netlib/
  
          build/                         - binary data
  
              deploy/
  
                  silvertunnel.org_netlib.jar   - binary Netlib library for Java
  
          lib/                           - used libraries
  
          src/                           - source code
  
          GPL_LICENSE.txt
  
          README.txt
  
      start_CheckNetConnectivity.bat - program to check network/Internet
                                       for error diagnostics
                                       for Windows
      start_CheckNetConnectivity.sh  - for UNIX/Linux/MAC OS X
  
      start_NetlibProxy.bat          - proxy server program to connect Netlib
                                       with non-Java programs
                                       for Windows
      start_NetlibProxy.sh           - for UNIX/Linux/MAC OS X
  
  
  
  

• check that your PATH environment variable contains java of version 1.5 (Java SE 5) or higher:

  • run on Windows/UNIX/Linux/MAC OS X on command line:

    java -version
    
    

should show a result like:

java version "1.6.0_17"

...

• check whether Java and Netlib can access to the Internet (which is the precondition for the most Netlib features)

  • run on Windows on command line:

    cd netlib
    
    start_CheckNetConnectivity.bat
    
    

  • run on UNIX/Linux/MAC OS X on command line:

    cd netlib/
    
    ./start_CheckNetConnectivity.sh
    
    

  • check the result - if everything is OK you should see at the end of the output:

    ...

    === Test Results ==================================

    JavaVersion: JAVA_1_6
    test1 (Socket before initSocketImplFactory): OK
    test2 (NetSocket before initSocketImplFactory): OK
    test3 (Socket after initSocketImplFactory): OK
    test4 (NetSocket after initSocketImplFactory): OK
    

if you see a FAILED instead of an OK, something is wrong with your network connectivity of your Java - maybe you have a firewall that blocks your request

Use Netlib

• a Java developer can now adapt its application to use Netlib - different strategies are described on the Netlib Best Practices page

  • but donn't forget to set the correct CLASSPATH

    • on Windows:

      set CLASSPATH=lib\main\bcprov-jdk15-145.jar;lib\main\jdom.jar;lib\main\silvertunnel.org_netlib.jar;YOUR_OWN_CLASSES
      
      

    • or on UNIX/Linux/MAC OS X:

      CLASSPATH=lib/main/bcprov-jdk15-145.jar:lib/main/jdom.jar:lib/main/silvertunnel.org_netlib.jar:YOUR_OWN_CLASSES
      
      export CLASSPATH
      
      

• or use the [Netlib Proxy] to use Netlib with a non-Java application

• or use any of the Demo applications or the Browser application

---

Top: [Netlib], Up: [Netlib Best Practices], Next: [Tor]