TOP

Installing the OSS ASN.1 Tools for C

Applies to: ASN.1/C 10.7

The License Key: For Compiler+Runtime and Compiler-only versions, a valid ossinfo license authorization file 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 C will be installed.

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

    By default, the installation folder is
    \Program Files\OSS Nokalva\ossasn1\<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 C. 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\...

    NOTE: If you are installing a 30-day trial version of the OSS ASN.1 Tools for C, the following exceptions apply:
    • The license authorization filename is ossinfoctrial.
    • The default installation directory for the trial is
      C:\Program Files\OSS Nokalva\ossasn1\<platform name>.trial\<version number>.
    • Use the OSSINFOTRIAL environment variable to point to a non-default location of the ossinfoctrial file.
  2. Starting with VS2008, all Microsoft Visual Studio versions are supported.

    When installation is complete, you will find two OSS command prompts under the OSS ASN.1 Tools for C menu: one for VS2008-VS2013 and the other for VS2015 and later. To build or run your code using VS2015 and later, use the VS2015 command prompt. Alternatively, to build or run your code using VS2008 through VS2013, use the VS2008-VS2013 command prompt.

    The OSS ASN.1 runtime libraries or DLLs for use with VS2015 and later are installed under the lib\vs2015 and bin\vs2015 folders of the installation. Link to these libraries or DLLs from your project when building or running your code using VS2015 and later.

    The OSS ASN.1 runtime libraries or DLLs for use with VS2008 through VS2013 are installed under the lib and bin folders of the installation. Link to these libraries or DLLs from your project when building or running your code using VS2008 through VS2013.
  3. 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.
  1. Download the appropriate .zip file for your license/platform into a directory of your choice and unzip it.
    The files will extract into the following directory structure:
    ossasn1/<platform name>/<version number>

    When ASN.1 Studio is included in your software distribution, the following zip archive will also be created:
    asn1studio/<asn1studio platform>/asn1studio-<asn1studio version>.zip 
    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, unzip asn1studio-<asn1studio version>.zip from the asn1studio/ directory.
  2. The License Key: For Compiler+Runtime and Compiler-only versions, 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 C, the following exceptions apply:
    • The license authorization filename is ossinfoctrial.
    • The default installation directory for the trial is
      C:/Program Files/OSS Nokalva/ossasn1/<platform name>.trial/<version number>.
    • Use the OSSINFOTRIAL environment variable to point to a non-default location of the ossinfoctrial file.
  3. Open the ossasn1/<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.
  1. Download the appropriate .zip file for your license/platform into a directory of your choice and unzip it.
    The files will extract into the following directory structure:
    ossasn1/<platform name>/<version number>

    When ASN.1 Studio is included in your software distribution, the following zip archive will also be created:
    asn1studio/<asn1studio platform>/asn1studio-<asn1studio version>.zip 
    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, unzip asn1studio-<asn1studio version>.zip from the asn1studio/<asn1studio platform>/ directory. Execute the ASN.1 Studio.dmg installer file to complete the installation of ASN.1 Studio.
  2. The License Key: For Compiler+Runtime and Compiler-only versions, 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 C, the following exceptions apply:
    • The license authorization filename is ossinfoctrial.
    • The default installation directory for the trial is
      C:/Program Files/OSS Nokalva/ossasn1/<platform name>.trial/<version number>.
    • Use the OSSINFOTRIAL environment variable to point to a non-default location of the ossinfoctrial file.
  3. Open the ossasn1/<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.

For assistance with software installation, 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 C release 10.7 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 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.