RSM Installation

Resource Standard Metrics operates on both the Windows and UNIX operating systems.   This feature allows the end user to use a single metrics tools across projects and operating systems.  The multi-operating systems and multi-language feature of RSM make it the most compatible metrics tool on the market.

RSM operates in the same manner on both the UNIX and Windows operating systems.   However, the process of installing RSM is quite different.  The end user must know which operating system they intend to install RSM.

Concept of Startup Operation

When RSM starts it will look for the RSM license file called rsm.lic.  If the RSMHOME environment variable is set, RSM looks for the rsm.lic file at this directory location.  Normally, the rsm directory is placed in the operating systems path.   If RSMHOME variable is not set, RSM will traverse the system path until it locates the file rsm.lic.  Once the rsm.lic file is found, RSM will look for the RSM configuration file, rsm.cfg, at this location.  RSM will load the rsm.cfg file for RSM's runtime configuration.  Once RSM starts, it logs its usage into the user log file called rsm.log.

Step 1:  Choose your operating system.

RSM has been successfully installed to the following operating systems.  All RSM UNIX licenses come with recompilable source code.  This allows the UNIX end user to recompile RSM on their exact UNIX operating system.  RSM can be recompiled on any POSIX compliant  UNIX operating system.

Windows 9x Windows 2000 Windows NT
Linux Sun OS 4 Sun Solaris
HPUX IBM AIX SGI Irix
BSD UNIX SCO UNIX POSIX UNIX Systems

Windows Installation

Step 2Identify the Distribution Media

Step 3Execute the setup.exe program file

  1. The installation program will unarchive the RSM files into the directory c:\rsm..
     
  2. You may enter your a different directory.

Step 4Setting the RSM directory into the system path

  1. The system path is a setting which is typically specified in the c:\autoexec.bat file.  The system path allows the operating system to locate files without specifying directories.
  2. You must edit the autoexec.bat file to add the rsm directory.
  3. You may use any ASCII text editor to modify the autoexec.bat file.
  4. We will use notepad to edit the system path.
  5. Execute the following button sequence to start notepad.
    [Start]
    [Programs]
    [Accessories]
    [Notepad]
  6. From notepad open the autoexec.bat file using the following button sequence.
    [File]
    [Open] - Under "File of Type" select "All Files *.*"
    Select the file autoexec.bat or you will have to create a new file and save it as c:\autoexec.bat.
  7. The following is an example of the path setting.
    PATH=c:\winnt;c:\rsm
  8. To enable the system path you must reboot your computer.

Step 5Execute RSM from the command shell (DOS Prompt).

  1. Execute the MS DOS Prompt.
    [Start]
    [Programs]
    [MSDOS Prompt]
  2. At the C Prompt execute RSM.
    C:\> rsm
  3. RSM should show your license name and a brief syntax:
             Resource Standard Metrics for C, C++ and Java
                           Version 5.10
License Type: Windows NT Network License - 10 Users
Licensed To : Acme Software Systems
License No. : WN1380              License Date: Tue Oct 20 19:34:00 1998
(C) 1999 M Squared Technologies       Run Date: Sat Jul 17 18:19:23 1999
________________________________________________________________________

Syntax: C:\RSM\RSM.EXE <-option -option parameter> filename or wild cards
Frequently used options, or -h for more options
c Complexity, cyclomatic and interface
f Function names and LOC per function
H HTML output mode for visual metrics
h Help (More Options) and licensing information
n Notices for code quality & common errors
o Object class analysis mode
p Printable format for source code
filename or *.c *.h ../src/*.c etc.

Press Any Key
  1. If RSM reports an error accessing the license file, double check your installation.   If this still fails to identify why RSM cannot find the license file, notify support@mSquaredTechnologies.com.

UNIX Installation

Step 2Identify the Distribution Media

Step 3Install from the distribution media.

Step 4Setting the RSM directory into the system path

  1. The system path is a setting which is typically specified in shell startup file.   This file depends on which shell you are using.  The following example will assume the csh is in use.  The system path allows the operating system to locate files without specifying directories.
  2. Using your editor, edit the .cshrc file
  3. Add /usr/local/rsm or the RSM directory you have used to the path statement
    setenv path=".\:\usr\bin:\usr\local\bin"
  4. Restart the shell for the setting to take effect.

Step 5:  Execute RSM from the shell

  1. Identify the version of RSM associated with your operating system.
    The following files are precompiled for your operating system.
    rsm.sol - Sun Solaris 2.6
    rsm.aix - IBM AIX 4.2
    rsm.lnx - Linux 2.0+

    All UNIX distributions come with recompilable source code on a special floppy diskette.   If your operating systems is not included in the precompiled RSM versions, then you will have to recompile RSM.
  2. At the shell execute RSM.
    % rsm.sol
  3. RSM should show your license name and a brief syntax:
             Resource Standard Metrics for C, C++ and Java
                           Version 5.10
License Type: Windows NT Network License - 10 Users
Licensed To : Acme Software Systems
License No. : WN1380              License Date: Tue Oct 20 19:34:00 1998
(C) 1999 M Squared Technologies       Run Date: Sat Jul 17 18:19:23 1999
________________________________________________________________________

Syntax: C:\RSM\RSM.EXE <-option -option parameter> filename or wild cards
Frequently used options, or -h for more options
c Complexity, cyclomatic and interface
f Function names and LOC per function
H HTML output mode for visual metrics
h Help (More Options) and licensing information
n Notices for code quality & common errors
o Object class analysis mode
p Printable format for source code
filename or *.c *.h ../src/*.c etc.

Press Any Key

Recompiling RSM for UNIX

All UNIX license files contain recompilable source code.  The source code may not be redistributed by any means or modified by the end user or these actions will violate the software license agreement and bring legal recourse by M Squared Technologies.

The source code escrow enable the end user to recompile RSM for the rapidly change UNIX operating system. UNIX license are more expensive than Windows licenses because of the source code escrow.  M Squared Technologies cannot recompile RSM on all the known UNIX operating systems.  We supply precompiled binaries which are sent be end users to contribute to UNIX distribution.

This source code escrow has been specially formatted into one, large C File.  This format simplifies the recompilation for the end user.  The following procedures address many of the most popular C compilers.

The rule of thumb: If your UNIX system has the GNU C compiler, then you can recompile RSM.

Step 1:  Copy the rsm.c file from the UNIX Tar Floppy.  See the UNIX floppy installation instructions.

Step 2:  Compile rsm.c with your C compiler.  RSM is written in ANSI C.   When you are successful recompiling RSM on a different operating
system, please send us a copy of your binary.  State how and what OS you compiled it on.  Email to: support@mSquaredTechnologies.com.

divider.jpg (1531 bytes)

(Last Update: August 24, 2000 )
Copyright 1997, M Squared Technologies