CmapTools - Console Mode & Silent Mode Installations

Introduction

In today's environments, we frequently find heterogeneous systems with different platforms, different operating environments, and different interaction modes. The installer of CmapTools provides two alternative modes to the standard graphical installation, which allow greater flexibility to install CmapTools in complex systems.

These modes of installation are the following:

  • Console Mode, for command-line-driven installations.
  • Silent Mode, for working with limited or no user interaction.

Console mode installation is an interactive installation without the use of a graphical user interface. It is convenient for CmapTools remote installations over the Internet or for installing CmapTools on systems without a graphical windowing environment. For example, when you need to install CmapTools in a remote server and the access of this remote server is using a telnet or ssh session.

Silent installation eliminates the need to monitor your CmapTools installation because no graphical output is displayed and no input by the user is required. The installer runs either with the default configuration values of the installer or with a properties file containing configuration values created by the user. The Silent Mode installation is ideal for automating installations of CmapTools, especially in cases in which there are multiple computers, for example: in a computer lab.

Console Mode Installation

Console mode mimics the default GUI steps provided by Graphic Mode installation and uses standard input and output. Console mode installation scrolls the lines of the panel onto the screen one line at a time and prompts the user for input on the bottom line. It does not allow for any formatting, clearing of the screen, or positioning of the cursor.

Running Console Mode Installation (Windows/Linux)

To run the installer in Console Mode from the command line, type the following command:

    WinCmapTools_vx.xx_mm-dd-yy -i console (in Windows)
    LinuxCmapTools_vx.xx_mm-dd-yy -i console (in Linux)

where “vx.xx” is the CmapTools version, and “mm-dd-yy” is the publishing date.

See Download The Installer of CmapTools to download the last installer corresponding to your system.

Running Console Mode Installation (Mac OS X)

The installer of CmapTools is made with InstallAnywhere. The last version of this software does not officially support Console Mode Installation in OS X; however, below is a workaround that can be used to run a CmapTools installation in Console Mode.

  1. Download the last version of CmapTools for Mac OS X.
  2. Unzip the installer.
  3. Edit the Info.plist (within the app bundle) of your installer
    • Go to the folder: MacOSXCmapTools_vx.xx_mm-dd-yy.app/Contents

    • (where “vx.xx” is the CmapTools version and “mm-dd-yy” is the publishing date)

      If you are using Finder press Ctrl-Mouse click and select “Show Package Contents”,
      if you are using a Terminal session type: cd MacOSXCmapTools_vx.xx_mm-dd-yy.app/Contents.

    • Edit the Info.plist and change the parameter: “lax.installer.macosx.ui.default” from GUI to CONSOLE.

  4. Now you have an installer that run in console mode by default.
  5. How to invoke the installer?


  6. Open a Terminal session and type the commands:

      cd MacOSXCmapTools_vx.xx_mm-dd-yy.app/Contents/MacOS
      ./ CmapTools_vx.xx_mm-dd-yy

The installer program will guide through the installation of IHMC CmapTools:

Console Mode Installation

Respond to each prompt to proceed to the next step in the installation of CmapTools. If you want to change something on a previous step, type “back”. You may cancel this installation at any time by typing “quit”.

Silent Mode Installation

Silent mode enables the CmapTools installer to run without any user interaction. The installer runs either with the default configuration values of the installer or with a properties file containing configuration values created by the user. The Silent Mode Installation allows you to define an installation configuration only once and then use the configuration to duplicate the installation on many computers. The installation program reads the settings for your configuration from a properties file that you create before beginning the installation.

Installation Type

When installing CmapTools, you can select one of the installation type:

  • Typical Configuration

  • Typical configuration includes default installation settings for CmapTools in stand-alone computers. This option is recommended for most users.

  • Advanced Configuration

  • Advanced configuration includes advanced installation settings for CmapTools in stand-alone computers or network workstations. This option is recommended for Advanced Users and Network Administrators.
Running Silent Mode Installation using Typical Configuration (Windows/Linux)

(See below for Mac OS X)

To run the installer in Silent Mode from the command line, type the following command:

    WinCmapTools_vx.xx_mm-dd-yy -i silent (in Windows)
    LinuxCmapTools_vx.xx_mm-dd-yy -i silent (in Linux)

where “vx.xx” is the CmapTools version, and “mm-dd-yy” is the publishing date.

See Download The Installer of CmapTools to download the last installer corresponding to your system.

Running Silent Mode Installation using Advanced Configuration (Windows/Linux)

(See below for Mac OS X)

To run the installer in Silent Mode from the command line, type the following command:

    WinCmapTools_vx.xx_mm-dd-yy -i installer.properties (in Windows)
    LinuxCmapTools_vx.xx_mm-dd-yy -i installer.properties (in Linux)

where “vx.xx” is the CmapTools version, and “mm-dd-yy” is the publishing date.

See Download the installer of CmapTools to download the last installer corresponding to your system.

Running Silent Mode installation (Mac OS X)

The installer of CmapTools is made with InstallAnywhere. The last version of this software does not officially support Silent Mode Installation in OS X; however, below is a workaround that can be used to run a CmapTools installation in Silent Mode.

  1. Download the last version of CmapTools for Mac OS X.
  2. Unzip the installer.
  3. Edit the Info.plist (within the app bundle) of your installer
    • Go to the folder: MacOSXCmapTools_vx.xx_mm-dd-yy.app/Contents

    • (where “vx.xx” is the CmapTools version and “mm-dd-yy” is the publishing date)

      If you are using Finder press Ctrl-Mouse click and select “Show Package Contents”,
      if you are using a Terminal session type: cd MacOSXCmapTools_vx.xx_mm-dd-yy.app/Contents.

    • Edit the Info.plist and change the parameter: “lax.installer.macosx.ui.default” from GUI to SILENT.

  4. Now you have an installer that run in console mode by default.
  5. Copy the file of properties to the same folder of the installer (i.e. MacOSXCmapTools_vx.xx_mm-dd-yy.app). You can use a file called “installer.properties” or “CmapTools_vx.xx_mm-dd-yy.properties”.
  6. How to invoke the installer?


  7. Open a Terminal session and type the commands:
      cd MacOSXCmapTools_vx.xx_mm-dd-yy.app/Contents/MacOS
      ./ CmapTools_vx.xx_mm-dd-yy

The "installer.properties" File

A properties file (installer.properties) is a text file with the pre-configured values of a CmapTools installation. The entries of this file are single lines of the form:

    propertyName=propertyValue

Rules for Finding the Properties File

If no properties file is specified, then the installer automatically checks the directory in which it resides in for a file called “installer.properties” or “CmapTools_vx.xx_mm-dd-yy.properties”. If properties files with both of these names exist in the same directory as the client executable, the “installer.properties” file will take precedence.

You can use the following template of the properties file to pre-configure your installation of CmapTools when run the installer in Silent Mode. The following is the content of the installer properties file for CmapTools. Each of the entries is described by the comments on the entry itself.

You can download the installer.properties for CmapTools here.

In the installer.properties file that showing below you can see all the configuration properties to install CmapTools.

    
# -------------------------------------------------------------------
# W A R N I N G
#
#    If you install CmapTools in the same directory of a previous
#    installation, the installer will preserve your cmaps and
#    resources.
#
# -------------------------------------------------------------------
# How to Install CmapTools in Silent Mode using a properties file.
#
# 1. Fill in all properties values corresponding with your 
#    CmapTools's configuration.
#
# 2. To run the installer type the following command:
#
#            CmapTools_vx.xx_dd-mm-yy -f installer.properties
#
#      Where:
#	          vx.xx is the CmapTools version.
#	          mm-dd-yy is the publishing date.
#
#       You may use direct or relative paths to the properties file.
#
# -------------------------------------------------------------------
# Silent Mode Installation
#

INSTALLER_UI=SILENT

# -------------------------------------------------------------------
#Installation Type, 
#

CONFIGURATION=Advanced

# -------------------------------------------------------------------
# Choose Install Folder.
# The full path to the directory in which the CmapTools will be
# installed.
#
# You can use "/" as the file separator for all platforms, but if you 
# use "\", you must escape all special characters with an additional
# "\". See the samples:
#
# Windows:  C\:\\Program Files\\IHMC CmapTools
# Windows:  C:/Program Files/IHMC CmapTools
# Mac OS X: /Applications/IHMC CmapTools
# Linux:    /usr/local/IHMC CmapTools

USER_INSTALL_DIR=

# -------------------------------------------------------------------
# Choose a Shortcut, Alias or Link Folder
# The full path to the directory in which the installer can install the
# shortcuts, alias or link to run CmapTools.
#
# You can use "/" as the file separator for all platforms, but if you 
# use "\", you must escape all special characters with an additional
# "\". See the samples:
#
# Windows:  C\:\\Users\\John\\AppData\\Roaming\\Microsoft\\Windows\\
#		Start Menu\\Programs\\IHMC CmapTools
# Mac OS X: /Users/Ann/Desktop
# Linux:    /home/Robert/Desktop

USER_SHORTCUTS=

# -------------------------------------------------------------------
# CmapTools permanently stores all userids and passwords
# that the user provides when accessing resources in servers or for 
# collaboration. If this computer is shared with other users and each
# user does not have a separate account, or if the same account is used
# by more than one user, it is recommended that these userids and 
# passwords not be saved permanently.
#
# Set 1 to Keep all User IDs and Passwords across sessions (default).
# Set 0 to Delete all User IDs and Passwords at the end of each session

KEEP_USERIDS=1

# -------------------------------------------------------------------
# CmapTools stores information (userid, passwords, preferences, etc.) in a
# User Profile directory. 
#
# Leave this entry blank to use the default location to store this information 
# depending on your operating system.
#
# For network or laboratory environments, you should indicate
# a network drive and/or path.
#
# You can use "/" as the file separator for all platforms, but if you 
# use "\", you must escape all special characters with an additional
# "\". See the samples:
#
# Windows:  H:\\data\\CmapTools\\profile
# Mac OS X: /Users/john/Library/preferences/CmapTools/profile
# Linux:    /home/mary/CmapTools/profile

USER_PROFILE=

# -------------------------------------------------------------------
# CmapTools stores information (Cmaps and Resources) in a User 
# "My Cmaps" directory. 
#
# Leave this entry blank to use the default location to store this 
# information depending on your operating system.
#
# You can use "/" as the file separator for all platforms, but if you 
# use "\", you must escape all special characters with an additional
# "\". See the samples:
#
# For network or laboratory environments, you should indicate a 
# network drive and/or path.
#
# Windows:  H:\data\CmapTools\My Cmaps
# Mac OS X: /Users/john/preferences/CmapTools/My Cmaps
# Linux:    /home/mary/CmapTools/My_Cmaps

USER_MYCMAPS=

# -------------------------------------------------------------------
#The Cmap Recorder could be start automatically.
#
# A record of all edits made within each Cmap will be recorded and
# saved automatically with the Cmap. 
#
# This option can be changed later from the General tab in the 
# CmapTools Preferences panel.
#
# This feature will increase Cmap file sizes and may reduce the speed
# of the Cmap client, therefore it should be used with caution.  
#
# Set 1 to start Cmap Recorder automatically. 
# Set 0 to do not start Cmap Recorder (default).

AUTO_RECORDER=0

# -------------------------------------------------------------------
# The Cmap Recorder could be run in Audit Mode. 
#
# All Cmap changes will be recorded automatically and the user will not
# be allowed to turn off the Cmap Recorder. 
#
# Set 1 to run Cmap Recorder in Audit Mode. 
# Set 0 to do not run Cmap Recorder in Audit Mode (default).

STOP_RECORDER=0

# -------------------------------------------------------------------
# CmapTools supports PKI authentication for communication with 
# secure servers. 
#
# Set true to enable PKI authentication.
# Set false to disable PKI authentication (default).

pki.enable=false

# -------------------------------------------------------------------
# PKI settings
#
# To enable PKI authentication using Windows certificate settings

pki.ms.cert=

# -------------------------------------------------------------------
# PKI settings
#
# The path name to the PKCSI12 file containing the user's 
# certificate and his private key.

pki.keystore=

# -------------------------------------------------------------------
# PKI settings
#
# Password to unlock the private key.

pki.keystore.password=

# -------------------------------------------------------------------
# PKI settings
#
# The path name to the X.509 file containing the trusted 
# CA certificate.

pki.ca.certificate=

# -------------------------------------------------------------------
# PKI settings
#
# The hostname of the LDAP server to retrieve Certificate
# Revocation Lists (CRLs).

pki.ldap.host=

# -------------------------------------------------------------------
# PKI settings
#
# The port number of the LDAP server to retrieve Certificate
# Revocation Lists (CRLs).

# The default is 389.

pki.ldap.port=389

# -------------------------------------------------------------------
# PKI settings
#
# Select the security protocol to communicate with the 
# LDAP Server.
#    - TLS (Transport Layer Security Protocol)
#    - SSL (Secure Socket Layer Protocol)

pki.ldap.mode=tls

# -------------------------------------------------------------------
# CmapTools provides an option to automatically record an 
# audit trail in a log file that can be used to diagnose any 
# problems that might occur.
#
# Set 1 to create the log files.  (Default).
# Set 0 to do not create the log files

LOGS=1

# -------------------------------------------------------------------
# This parameter specifies the path to the directory where
# log files are created.
#
#                 %h = user home directory
#                 %t = user temporary directory
#
# If you delete this entry the default value is: %h/logs

LOGS_PATH=%h/CmapToolsLogs

# -------------------------------------------------------------------
# This parameter specifies the prefix of the log file name. 
#
# The log file name is generated using this prefix and a 
# counter. For example: cmaptools0.log, cmaptools1.log, etc., 
# with cmaptools0.log as the most recently modified.
#
# If you delete this entry the default value is: cmaptools

LOGS_PREFIX=cmaptools

# -------------------------------------------------------------------
# This parameter specifies the maximum size (in bytes) 
# of each log file. 
#
# When the maximum size is reached, a new log file is 
# created.
#
# If you delete this entry the default value is:  5242880  (5 MB)

LOGS_SIZE=5242880

# -------------------------------------------------------------------
# This parameter specifies the maximum number of log files 
# that can be created.
#
# When the maximum number is reached, the oldest log file 
# gets removed.
#
# If you delete this entry the default value is:  3

LOGS_NO=3

        
Download The Installer of CmapTools

Type of Installers

CmapTools is distributed for Windows, Linux, and Mac operating systems. Furthermore, CmapTools is distributed for two type of architectures: 32-bit and 64-bit. You can download the CmapTools installer according to your system architecture.

How to determinate if your OS runs in 32-bit or 64-bit?

In order to find out if your computer is running a 32-bit or 64-bit version of Windows Vista or newer, do the following: Open System by clicking the Start button, right-clicking Computer, and then clicking Properties. Under System, you can view the System type. Otherwise, you can run the command: “wmic os get osarchitecture” to find out whether it's 32 or 64 bit.

If you don't know whether your Linux distribution is 32-bit or 64-bit, open a Terminal or shell window and type the command arch. The arch command displays whether the system is 32-bit (“i686”) or 64-bit (“x86-64”).

Under Mac OS X there is no 32-bit version of the OS, therefore there is only one installer of CmapTools.

Installers’ Conventional Name

For 32-bits Systems

    WinCmapTools_vx.xx_mm-dd-yy.exe
    LinuxCmapTools_vx.xx_mm-dd-yy.bin

For 64-bits Systems

    Win64CmapTools_vx.xx_mm-dd-yy.exe
    Linux64CmapTools_vx.xx_mm-dd-yy.bin
    MacOSXCmapTools_vx.xx_mm-dd-yy.zip

where “vx.xx” is the CmapTools version, and “mm-dd-yy” is the publishing date.

You can download the latest version of CmapTools from here.