TOP

Installing the OSS ASN.1 Tools for Java

Applies to: ASN.1/Java 7.1

Prerequisites

JDK 1.7 or later (32- or 64-bit) is required to install the OSS ASN.1 compiler for Java and the OSS ASN.1/Java runtime packages along with one of the following operating systems:

  • Windows 7 or later
  • Linux with Kernel 2.6.15 or later (x86 or x64)
  • Solaris 2.x

Every distributed copy of the OSS ASN.1 Tools for Java is associated with a unique license number. The license determines, among other things, which functions of the OSS ASN.1 Tools are available to you.

Before you install the OSS ASN.1 Tools for Java, make sure you have a valid ossinfo license file (or ossinfojavatrial for trial tools). The name of the installation executable will be similar in format to asn1pjav_win32_x.x.x.exe where "x.x.x" is the specific version of the OSS ASN.1 Tools for Java you are installing.

  1. Run the installer executable and follow the on-screen instructions. Additionally, you can issue the following command:
    asn1pjav_win32_x.x.x
  2. The installation software will search for the ossinfo license file or you can provide its location when prompted.
  3. Once installed, the compiler/runtime will look for the ossinfo license file in dest:\Program Files\OSS Nokalva. Note that prior to the 5.0 release, the files were installed to the directory: \Program Files\OSS\asn1pjav\win32\<x.x.x>. The ossinfo license file was copied to the \Program Files\OSS directory.
  4. By default, the environment variables are set automatically. To create a permanent OSS Java environment, set up the following environment variables manually:

OSS_ASN1_JAVA points to the OSS root directory.

OSSINFO or OSSINFOTRIAL points to the location of the ossinfo file.

PATH points to the location of the OSS bin directory.

CLASSPATH points to the OSS Java runtime library.

Additionally, you can use the set command in any open system console window. The following example assumes that the installation directory is C:\Program Files\OSS Nokalva.

set OSS_ASN1_JAVA=C:\Program Files\OSS Nokalva\asn1pjav\win32\x.x.x

set OSSINFO=%OSS_ASN1_JAVA%

set CLASSPATH=%OSS_ASN1_JAVA%\lib\oss.jar;%CLASSPATH%

set PATH=%OSS_ASN1_JAVA%\bin;%PATH%

rem for trial tools: set OSSINFOTRIAL=%OSS_ASN1_JAVA%

NOTE: Make sure the oss.jar file is not placed in a location where the JVM searches for bootstrap classes and java extension packages (<javahome>\lib\ext or in any directory that is listed by the java.ext.dirs system property).

To install the OSS ASN.1 Tools for Java on UNIX:

Before you install the OSS ASN.1 Tools for Java, make sure you have a valid ossinfo license file (or ossinfojavatrial for trial tools).

  1. Select a directory and unzip the OSS ASN.1 Tools for Java file. In this document, it is assumed that the Tools are installed in the /usr/local directory. To install the Tools in a different directory, replace /usr/local with your own directory path. Make sure you have write permission for the directory in which you are installing the Tools. To install in /usr/local, execute the following commands. Note that filename.zip is the name of the software distribution file that you downloaded:
    cd /usr/local
    unzip <path to >/filename.zip
    
  2. Copy the ossinfo (or ossinfojavatrial) file to the root installation directory of the OSS ASN.1 Tools for Java:
    cp ossinfo /usr/local/asn1pjav/Unix/x.x.x
  3. To set the OSSINFO (or OSSINFOTRIAL) environment variable, follow the steps below:
    • Select the asn1pjav/Unix/x.x.x/bin directory and execute the makevars script. The script creates the template command files: cd /usr/local/asn1pjav/Unix/x.x.x/bin./makevars. It will create the oss_vars.csh and the oss_vars.sh files. You can either paste the contents of the appropriate file to your login script (to save the settings), or execute them from the command prompt.
    • To set environment variables in csh, use the command: source oss_vars.csh. To set environment variables in sh or ksh use: . oss_vars.sh. The generated files are templates. Make sure you apply the appropriate corrections before using them.
  4. To set the required environment variables manually, follow the steps below:
    • Set the OSS_ASN1_JAVA environment variable to point to the asn1pjav root directory of the OSS ASN.1 Tools for Java. For example, the OSS_ASN1_JAVA variable can be set under the csh shell with the following command:
      setenv OSS_ASN1_JAVA /usr/local/asn1pjav/Unix/x.x.x
    • Set the environment variable OSSINFO (or OSSINFOTRIAL for trial tools). Issue the following command under the C shell:
      setenv OSSINFO $OSS_ASN1_JAVA
    • Add the $OSS_ASN1_JAVA/lib/oss.jar file specification to the CLASSPATH. Also, add the $OSS_ASN1_JAVA/bin directory to the executable search path environment variable PATH and the $OSS_ASN1_JAVA/lib directory to the shared library search path environment variable LD_LIBRARY_PATH. Under csh use the commands below.
      NOTE: Make sure the oss.jar file is not placed in locations where the JVM searches for bootstrap classes and java extension packages (<javahome>/lib/ext or in any directory that is listed by the java.ext.dirs system property).
      setenv CLASSPATH $OSS_ASN1_JAVA/lib/oss.jar:$CLASSPATH
      setenv PATH $OSS_ASN1_JAVA/bin:$PATH
      setenv LD_LIBRARY_PATH $OSS_ASN1_JAVA/lib:$LD_LIBRARY_PATH
      

The OSS ASN.1 Tools for Java also includes ASN.1 Studio (asn1studio-<x.x.x>.zip) which is located under the asn1studio/<platform> directory.

Extract the contents of the zip file to deploy ASN.1 Studio. If it is already installed, you may skip this step, unless you want to upgrade an existing installation.


This documentation applies to the OSS® ASN.1 Tools for Java release 7.1 and later.

Copyright © 2017 OSS Nokalva, Inc. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording or otherwise, without the prior permission of OSS Nokalva, Inc.
Every distributed copy of the OSS® ASN.1 Tools for Java is associated with a specific license and related unique license number. That license determines, among other things, what functions of the OSS ASN.1 Tools for Java are available to you.