TOP

Installing the OSS ASN.1 Tools for C++

Applies to: ASN.1/C++ 6.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\asn1cpp\<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 ossinfocpptrial.
    • Use the OSSINFOTRIAL environment variable to point to a non-default location of the ossinfocpptrial 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. In order to build or run your code using VS2015 and later, use the VS2015 command prompt. Conversely, to build or run your code using any VS2008 through VS2013 version, 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:
    asn1cpp/<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 ossinfocpptrial.
      • Use the OSSINFOTRIAL environment variable to point to a non-default location of the ossinfocpptrial file.
  3. Open the asn1cpp/<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 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 release 6.7 and later of the OSS® ASN.1 Tools for C++.

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 C++ 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 C++ are available to you.