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 the 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 All Variants

Sun OS 4

Sun Solaris Unix & PC
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

    Windows 9x Path Configuration

  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 to the PATH variable.
  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:\rsm;c:\windows
  8. To enable the system path you must reboot your computer.

    Windows 2000 and NT Path Configuration

  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 system path through:
    [Start]-[Settings]-[Control Panel]-[System]-[Advanced]-[Environment Variables]
  3. Under the edit windows names "System Variable", located the variable named Path.  Highlight the selection and edit the text string.  You MUST place the RSM directory at the beginning of the path statement.  Under Windows 2000 there is a new Window program names rsm.exe.  It is not used by Windows, but it will conflict with c:\rsm\rsm.exe if c:\rsm is not the first directory in the path.

    Example
    c:\rsm;%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\
  4. When you are through editing the PATH, click Ok and close the tool.  When you open a command shell, the path will be correct.

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

  1. Execute the MS DOS Prompt under Windows 9x
    [Start]
    [Programs]
    [MSDOS Prompt]

    Under Windows 2000 / NT
    [Start]
    [Run]
    cmd

  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 6.00
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
hf 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.
  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 6.00
License Type: Windows Unix Single User
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: /usr/local/rsm/rsm.lnx <-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
hf 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.

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 changing UNIX operating system. UNIX licenses 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 by 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: June 12, 2001 )
Copyright 2001, M Squared Technologies