Ukraine We stand with Ukraine

TOP
home | What's New | Installing the Tools | Getting Started | Knowledge Center | Standards Conformance

Installing the OSS ASN.1 Tools for C++

Applies to: ASN.1/C++ v7.3-7.3.1

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: VS2015-VS2022

Install Instructions

The License Key: For Compiler+Runtime and Compiler-only versions, a valid ossinfo license authorization file (or ossinfocpptrial 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 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 VS2015, all Microsoft Visual Studio versions are supported.

    When installation is complete, you will find the OSS command prompt window under the OSS ASN.1 Tools for C++ menu for VS2015 and later. If at installation when prompted you specified the location of the VS environment batch file, you can use the OSS Command prompt window as is with all the environment set as needed for use of the OSS ASN.1 Tools for C++ from the command line.

    The installers for OSS ASN.1 Tools for C++ can be run in unattended silent mode from the command line. The command to install in silent unattended mode would be as follows:

    <installer name> -s -v/qn -v"OSSINFO=\"<path to ossinfo file>\"" -v"VSBATCH=\"<path to VS  environment batch file>\""
    where
    • <installer name> - is the name of the installer executable.
    • <path to ossinfo file> - is the absolute path to the location of the ossinfo file.
    • <path to VS environment batch file> - is the absolute path to the location of the VS environment batch file needed for setting up the command line environment.

      For example, the path for the VS2015 32-bit environment file would be as follows:
      C:/Program Files (x86)/Microsoft Visual Studio 14.0/Common7/Tools
      The path for the VS2015 64-bit environment file would be as follows:
      C:/Program Files/Microsoft Visual Studio 14.0/VC/bin/amd64
    For ASN.1 Studio and addons silent mode installation, the command would be as follows:
    <installer name> -s -v/qn -v"OSSINFO=no"
    where
    • <installer name> - is the name of the installer executable.
    For more information about manual setup of the Microsoft command-line environment, see the samples/README.TXT file.
    In unattended silent installation mode, the installers will print no messages when successful. On error, a popup that indicates what error occurred is displayed.
  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.

System Requirements

Linux 64-bit

  • Operating system:
    OSS Compiler/ASN.1 Studio: Linux with kernel 2.6.32 or later, compatibility checked up to kernel 5.13
    OSS Runtime Tools: Linux with kernel 2.4 or later, compatibility checked up to kernel 5.13
  • Hardware: x86-64 (or compatible)
  • Build tools:
    OSS Compiler/ASN.1 Studio: glibc 2.12 or later, compatibility checked up to 2.33, libstdc++ version 6
    OSS Runtime Tools: glibc 2.5 or later, compatibility checked up to 2.33; gcc 4.1.2 or later, compatibility checked up to 11.2.1

Linux 32-bit

  • Operating system:
    OSS Compiler/ASN.1 Studio: Linux with kernel 2.6.32 or later, compatibility checked up to kernel 5.13
    OSS Runtime Tools: Linux with kernel 2.3 or later, compatibility checked up to kernel 5.13
  • Hardware: x86/x86-64 (or compatible)
  • Build tools:
    OSS Compiler/ASN.1 Studio: glibc 2.12 or later, compatibility checked up to 2.33, libstdc++ version 6
    OSS Runtime Tools: glibc 2.5 or later, compatibility checked up to 2.33; gcc 4.1.2 or later, compatibility checked up to 11.2.1

NOTE: The 32-bit version of the glibc package is required to run 32-bit applications on a 64-bit Linux system.

Install Instructions

  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 (or ossinfocpptrial for trial tools) 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.

System Requirements

macOS X

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

macOS M1

  • Operating system: macOS 11.0.1 or later
  • Hardware: Apple M1
  • Build tools: Apple clang version 12.0.0 (clang-1200.0.32.29), Xcode 12.4

Install Instructions

  1. Download the product distribution .dmg file into a directory of your choice. Execute the .dmg file and proceed to follow the instructions.

    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 .dmg archive will also be created: 
    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. The License Key: For Compiler+Runtime and Compiler-only versions, a valid ossinfo license authorization file (or ossinfocpptrial for trial tools) 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 7.3 and later of the OSS® ASN.1 Tools for C++.

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