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 2: Identify the
Distribution Media
- Zip File: The zip file rsm.zip or rsm_update.zip
can be directly downloaded from mSquaredTechnologies.com. You must unzip the ZIP archive file.
This file contains, readme.txt and setup.exe.
- CDROM: The Windows installation files, setup.exe, are
located in the Windows subdirectory.
Step 3: Execute the
setup.exe program file
- The installation program will unarchive the RSM files into the directory
c:\rsm.
- You may enter your a different directory.
Step 4: Setting the RSM
directory into the system path
Windows 9x Path Configuration
- 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.
- You must edit the autoexec.bat file to add the RSM directory to
the PATH variable.
- You may use any ASCII text editor to modify the autoexec.bat file.
- We will use notepad to edit the system path.
- Execute the following button sequence to start notepad.
[Start]
[Programs]
[Accessories]
[Notepad]
- 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.
- The following is an example of the path setting.
PATH=c:\rsm;c:\windows
- To enable the system path you must reboot your computer.
Windows 2000 and NT Path Configuration
- 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.
- You must edit the system path through:
[Start]-[Settings]-[Control Panel]-[System]-[Advanced]-[Environment
Variables]
- 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\
- 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 5: Execute RSM from
the command shell (DOS Prompt).
- Execute the MS DOS Prompt under Windows 9x
[Start]
[Programs]
[MSDOS Prompt]
Under Windows 2000 / NT
[Start]
[Run]
cmd
- At the C Prompt execute RSM.
C:\> rsm
- 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.
- 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 2: Identify the
Distribution Media
- TAR/GZ File: The file rsm.tar.gz or rsm_update.tar.gz
can be directly downloaded from mSquaredTechnologies.com. The difference in these two files is
that the update file does not contain the Shareware license. You must use GNU gzip
to unarchive the rsm.tar.gz file. This is typically performed with gunzip. You
must the untar the rsm.tar file to extract the RSM distribution files.
- CDROM: The UNIX distribution files are located in the
UNIX subdirectory and can be copied directly to the RSM directory.
- Floppy Diskette: The RSM distribution files are
archived into a the file called rsm.tar.gz. This archive is tarred on to the floppy
diskette. The floppy diskette is in tar format.
Step 3: Install from the
distribution media.
- TAR/GZIP File Installation:
- Decompress the gzip archive file.
You can use either:
gzip -d rsm.tar.gz or
gunzip rsm.tar.gz
- Untar the decompressed archive file using the tar command. This will untar the
contents to the RSM directory. You must perform the extraction to the correct
location on your file system. For this example we will use the /usr/local
directory on the file system.
cp rsm.tar /usr/local
cd /usr/local
tar -xvf rsm.tar
- The RSM distribution files are now located in the directory /usr/local/rsm
- CDROM Installation
- Create the RSM directory
mkdir /usr/local/rsm
- Copy the RSM distribution files to the RSM directory. We will assume the CDROM
device is mounted to the /cdrom directory.
cp -r /cdrom/unix/* /usr/local/rsm
- The RSM distribution files are now located in the directory /usr/local/rsm
- Floppy Installation
- Insert the floppy diskette into the floppy drive.
- Copy the rsm.tar.gz file from the floppy to the /usr/local directory.
One of the following new methods may apply to your UNIX system.
a. Use a "file manager" to copy the files, readme.txt and rsm.tar.gz
to the destination directory.
b. cd /usr/local
tar -xvf /dev/fd0
- Follow the TAR/GZ Installation
Step 4: Setting the RSM
directory into the system path
- 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.
- Using your editor, edit the .cshrc file
- Add /usr/local/rsm or the RSM directory you have used to the path statement
setenv path=".\:\usr\bin:\usr\local\bin"
- Restart the shell for the setting to take effect.
Step 5: Execute RSM from the shell
- 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.
- At the shell execute RSM.
% rsm.sol
- 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.
- 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.
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.
- UNIX ANSI C compatible
-------------------------------------------------------
% gcc -O3 -o rsm rsm.c
- Solaris
-------------------------------------------------------
% cc -Xc -o rsm rsm.c
- HPUX
-------------------------------------------------------
% cc -Aa -o rsm rsm.c
- IBM-AIX
-------------------------------------------------------
% cc -O -o rsm rsm.c
- Linux
-------------------------------------------------------
% gcc -O3 -o rsm rsm.c

(Last Update:
June 12, 2001
)
Copyright 2001, M Squared Technologies