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 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
- 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.
- 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:\winnt;c:\rsm
- To enable the system path you must reboot your computer.
Step 5: Execute RSM from
the command shell (DOS Prompt).
- Execute the MS DOS Prompt.
[Start]
[Programs]
[MSDOS Prompt]
- 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 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
- 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 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
- 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 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.
- 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: August 24, 2000
)
Copyright 1997, M Squared Technologies