Installing the ASN.1/Java Tools on UNIX Platforms

Download the appropriate .zip file for your license/platform.
Unzip the downloaded product distribution .zip file into a directory of your choice. On a UNIX system, the command is likely
```
unzip asn1pjav_<platform name>_<version number>.zip 
```
The files will extract into the following directory structure:
```
asn1pjav/<platform name>/<version number>
```
Optionally install the JIAAPI (Java Interactive ASN.1 Application Program Interface) add-on. Unzip the jiaapi.zip file found in the asn1pjav/<platform name>/<version number> directory. The files will extract into the jiaapi/ subdirectory.

Merge the extracted files into the ASN.1/Java Tools installation as follows:
- Copy the contents of the jiaapi/doc directory to the asn1pjav/<platform name>/<version number>/doc directory.
- Copy the contents of the jiaapi/lib directory to the asn1pjav/<platform name>/<version number>/lib directory.
- Copy the contents of the jiaapi/mlib directory to the asn1pjav/<platform name>/<version number>/mlib directory.
- Copy the contents of the jiaapi/samples directory to the asn1pjav/<platform name>/<version number>/samples directory.
On a UNIX system the commands are likely
```
cd asn1pjav/<platform name>/<version number>
unzip jiaapi.zip
cp -r jiaapi/*
```
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:
- sh-like UNIX shells (sh, ksh, bash, etc.), use the following command:
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.

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 latest version of the OSS® ASN.1 Tools. If you are using an earlier version, consult the documentation that was included with your product.

Copyright © 2025 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 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 are available to you.