TOP

Installing the OSS ASN.1 Tools for Java

Applies to: ASN.1/Java 8.2

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 8 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.
  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 Nokalva root directory.

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

PATH points to the location of the OSS Nokalva 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).

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.

  1. Download the product distribution .dmg file into a directory of your choice. Execute the .dmg file and proceed to follow the instructions.
    The files will extract into the following directory structure:
    asn1pjav/<platform name>/<version number>
    When ASN.1 Studio is included in your software distribution, the following .dmg archive will also be created:
    asn1studio/<asn1studio platform>/ASN.1 Studio.dmg
    If an earlier ASN.1 Studio release is already installed on your machine and you prefer to keep using it, skip to the next step. Otherwise, execute ASN.1 Studio.dmg from the asn1studio/<asn1studio platform>/ directory, and follow the instructions.

    NOTE: Starting with release 6.2, Java Runtime Environment (JRE) 1.7 or later is required to use the OSS ASN.1 Tools for Java. Compile the classes generated by the ASN.1/Java compiler with JDK 1.7 or above and also run your application with JRE 1.7 or above.
  2. The License Key: A valid ossinfo license authorization file must be available to your system in order to run the OSS ASN.1 Tools Compiler. This file is provided to you by email at the time of purchase or trial and contains specific information about your license and the system on which you are authorized to run the program. If you need help locating your ossinfo file, please contact customerservice@oss.com.

    The OSS ASN.1 Compiler will not run unless it can locate this file. The compiler looks at the OSSINFO environment variable for the name of the directory in which the license key is located. If the OSSINFO environment variable is not defined, the compiler searches for the ossinfo license key in the /usr/local/ossasn1 directory.

    To set the OSSINFO variable in
    • csh-like UNIX shells (csh, tcsh, etc.), use the following command:
    • setenv OSSINFO <path to directory containing ossinfo file>
    • sh-like UNIX shells (sh, ksh, bash, etc.), use the following command:
    • export OSSINFO=<path to directory containing ossinfo file>

    NOTE: If you are installing a 30-day trial version of the OSS ASN.1 Tools for Java, the following exceptions apply:
    • The license authorization filename is ossinfojavatrial.
    • The default installation directory for the trial is
      C:/Program Files/OSS Nokalva/asn1pjav/<platform name>.trial/<version number>.
    • Use the OSSINFOTRIAL environment variable to point to a non-default location of the ossinfojavatrial file.
  3. Access the online Product Documentation. For more information about setting up the Tools on your system, see Getting Started. Important information about setting required environment variables is located there.

  4. Open the asn1pjav/<platform name>/<version number>/doc/WELCOME.HTML file to read about what's new in this release, how to access samples, runtime choices, and more.

    Access documentation and information on getting started with ASN.1 Studio from Help on the ASN.1 Studio main menu.

  5. Our Product Knowledge Center provides answers to frequently asked questions, programming and protocol examples, and sample programs that demonstrate support for various industry standards using ASN.1.

  6. For assistance with software installation please send email to customerservice@oss.com.

    For technical support send email to support@oss.com and include the following information in your message:
    • Your license number
    • Your name
    • Your company name
    • A brief description of the problem

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

Copyright © 2020 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.