TOP

Installing the OSS ASN.1 Tools for Java

Applies to: ASN.1/Java 8.4

System Requirements

  • Operating system: Windows 8.1 or later
  • CPU:
    x86-64 (or compatible) for 64-bit version
    x86/x86-64 (or compatible) for 32-bit version
  • Build tools: JDK 1.7 or later

Install Instructions

The License Key: A valid ossinfo license authorization file (or ossinfojavatrial for trial tools) is required to successfully install and run the OSS ASN.1 Tools Compiler. This file is provided 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, contact customerservice@oss.com.

  1. You must have administrator privileges on the system where the OSS ASN.1 Tools for Java will be installed.
  2. Download and run the installation executable for your license and platform. Follow the on-screen instructions. The install program prompts you for the location of the ossinfo file. Specify the folder location using the Browse button or allow the program to search for the file. Once the license key is found, it is validated and copied to the \Program Files\OSS Nokalva folder.

    By default, the installation folder is
    \Program Files\OSS Nokalva\asn1pjav\<platform name>\<version number>
    However, the installation program gives you the option to select a different folder, if you wish.

    ASN.1 Studio, a powerful IDE, is packaged with the OSS ASN.1 Tools for Java. The default installation folder for ASN.1 Studio is
    \Program Files\OSS Nokalva\asn1studio\<platform name>

    NOTE: If a Windows 32-bit (x86) version of the Tools is installed on a Windows 64-bit (x64) system, the default installation folder will be
    \Program Files (x86)\OSS Nokalva\...
  3. 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 (oss.jar, osslean.jar, or osstoed.jar) as specified in the ASN.1/Java Runtime Package Overview. The CLASSPATH must include only one of the libraries: oss.jar, osslean.jar, or osstoed.jar.

    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\<version number>
    
    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 that none of the OSS runtime class libraries (oss.jar, osslean.jar, or osstoed.jar) are 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).

  4. When installation is complete, launch the program from the OSS ASN.1 Tools for Java program menu.
  5. Select Introduction from the program menu 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.

System Requirements

Linux 64-bit

  • Operating system:
    Linux with kernel 2.6.32 or later, compatibility checked up to kernel 4.15.0
  • Hardware: x86-64 (or compatible)
  • Build tools:
    OSS Compiler/ASN.1 Studio: glibc 2.12 or later, compatibility checked up to 2.27, libstdc++ version 6
    OSS Runtime Tools: JDK 1.7 or later (64-bit)

Linux 32-bit

  • Operating system:
    Linux with kernel 2.6.32 or later, compatibility checked up to kernel 4.19.4
  • Hardware: x86-64 (or compatible)
  • Build tools:
    OSS Compiler/ASN.1 Studio: glibc 2.12 or later, compatibility checked up to 2.28, libstdc++ version 6
    OSS Runtime Tools: JDK 1.7 or later (32-bit or 64-bit)

Install Instructions

The License Key: A valid ossinfo license authorization file (or ossinfojavatrial for trial tools) is required to successfully install and run the OSS ASN.1 Tools Compiler. This file is provided 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, contact customerservice@oss.com.

  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/<platform name>/<version number>
  3. To set the OSSINFO (or OSSINFOTRIAL) environment variable, follow the steps below:
    • Select the asn1pjav/<platform name>/<version number>/bin directory and execute the makevars script. The script creates the template command files:
      cd /usr/local/asn1pjav/<platform name>/<version number>/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/<platform name>/<version number>
    • 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 Java runtime library (oss.jar, osslean.jar, or osstoed.jar) as specified in the ASN.1/Java Runtime Package Overview to the CLASSPATH. The CLASSPATH must include only one of the libraries: oss.jar, osslean.jar, or osstoed.jar. 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 that none of the OSS runtime class libraries (oss.jar, osslean.jar, or osstoed.jar) are 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
      
  5. 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.
  6. The OSS ASN.1 Tools for Java also includes ASN.1 Studio (asn1studio-<version number>.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.
    Access documentation and information on getting started with ASN.1 Studio from Help on the ASN.1 Studio main menu.

System Requirements

macOS x86-64

  • Operating system: macOS 10.7.x or later
  • Hardware: x86-64 (or compatible)
  • Build tools:
    JDK 1.7 or later (64-bit)
    Apple clang version 3.0 (tags/Apple/clang-211.12)
    Xcode 4.2.1

Install Instructions

The License Key: A valid ossinfo license authorization file (or ossinfojavatrial for trial tools) is required to successfully install and run the OSS ASN.1 Tools Compiler. This file is provided 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, contact customerservice@oss.com.

  1. Download the product distribution .dmg file into a directory of your choice. Execute the .dmg file and proceed to follow the instructions.
    If you dragged the icon to the applications folder the files will extract into the following directory structure:
    /Applications/asn1pjav/asn1pjav/<platform name>/<version number>
    A 30 day trial will extract into this directory structure:
    /Applications/asn1pjav/asn1pjav/<platform name>.trial/<version number>
    When ASN.1 Studio is included in your software distribution, the following .dmg archive will also be created:
    Applications/asn1pjav/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.
  2. Copy the ossinfo (or ossinfojavatrial) file to the root installation directory of the OSS ASN.1 Tools for Java:
    cp ossinfo /Aplications/asn1pjav/asn1pjav/<platform name>/<version number>
  3. To set the OSSINFO (or OSSINFOTRIAL) environment variable, follow the steps below:
    • Select the asn1pjav/<platform name>/<version number>/bin directory and execute the makevars script. The script creates the template command files:
      cd /Applications/asn1pjav/asn1pjav/<platform name>/<version number>/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 bash or zsh 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 bash shell with the following command:
      OSS_ASN1_JAVA=/Applications/asn1pjav/asn1pjav/<platform name>/<version number>; export OSS_ASN1_JAVA;
    • Set the environment variable OSSINFO (or OSSINFOTRIAL for trial tools). Issue the following command under the bash shell:
      OSSINFO=$OSS_ASN1_JAVA; export OSSINFO;
    • Add the OSS Java runtime library (oss.jar, osslean.jar, or osstoed.jar) as specified in the ASN.1/Java Runtime Package Overview to the CLASSPATH. The CLASSPATH must include only one of the libraries: oss.jar, osslean.jar, or osstoed.jar. 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 DYLD_LIBRARY_PATH. Under bash use the commands below.
      NOTE: Make sure that none of the OSS runtime class libraries (oss.jar, osslean.jar, or osstoed.jar) are 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).
      CLASSPATH=$OSS_ASN1_JAVA/lib/oss.jar:$CLASSPATH; export CLASSPATH;
      PATH=$OSS_ASN1_JAVA/bin:$PATH;
      DYLD_LIBRARY_PATH=$OSS_ASN1_JAVA/lib:$DYLD_LIBRARY_PATH; export DYLD LIBRARY_PATH;
      SHLIB_PATH=$OSS_ASN1_JAVA/lib:$SHLIB_PATH; export SHLIB_PATH;
      
  5. 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.

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.

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.4 and later.

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