TOP

Installing the OSS ASN.1 Tools for C++

Applies to: ASN.1/C++ 6.5

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. Supported Microsoft Visual Studio versions: VS2005 through VS2015

    Support for Microsoft VS2015 was added in release 10.2.1. When installation is complete, you will find two OSS command prompts under the OSS ASN.1 Tools for C++ menu: one for VS2005-VS2013 and the other for VS2015. In order to build/run your code using VS2015, use the VS2015 command prompt. Conversely, to build/run your code using any VS2005 through VS2013 version, use the VS2005-VS2013 command prompt.

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

    The OSS ASN.1 runtime libraries/DLLs for use with VS2005 through VS2013 are installed under the "lib" and "bin" folders of the installation. Link to these libraries/DLLs from your project when building/running your code using any VS2005 through VS2013 version.
  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.5 and later of the OSS® ASN.1 Tools for C++.

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