Welcome to the home of Krakatau Essential Project Manager |
 |
|
 |
Frequently Asked Questions
How do install the license to try the tool on my C# code? 
After requesting a license from Powersoftware.com:
- please detach the "license.dat" file from the email you receive
- and save into the EPM install directory - by default
C:\Program Files\Power Software\Essential Metrics PM (Csharp). - Run EPM again and it will accept the license.
Do I have to install MySQL to run EPM?
No. MySQL is bundled with EPM. If you are not concerned about managing and querying a MySQL database, simply run the tool with no "-s" (MySQL server) parameter and it will start MySQL locally before running EPM.
What if I have a MySQL server I wish to utilise?
If this case, specify the "-s" parameter, followed by the machinename of the server where MySQL is running. Suppose the machine were called "mysql1", you would include "-s mysql1" in your call to EPM and this would create your database on this server, and build metrics data there.
Why do I get a MySQL error when running EPM repeatedly?
Each time you execute EPM, it starts a MySQL server process in order to store and report results.
It takes a few hundreths of a second to close open files and stop the server process, and therefore you should pause a moment before re-running MySQL. In normal operation you would not see this error, only when testing the tool manually from the command line.
This problem is also resolved by running a stand-alone MySQL server and pointing EPM to it using the "-s" parameter.
What is the format of an EPM filelist?
- Line 1: Project Name
- Line 2: Project Snapshot date (a text representation of the date snapshot taken)
- Line 3: Base directory (useful for cropping long paths and essential for PM comparisons)
- Line 4-end: full path and filename of each file
What do the metrics mean?
Your tool seems to be working very well. I've been able to generate stats for big projects once I got the file list format right.
I have an outstanding question, while I'm still testing it, if you don't mind:
Is the exact meaning of all the metric codes documented somewhere? For instance, I suppose LOC in the tables means "lines of code" but what about SLOC? NSC?
If you go to the EPM product page and click on the metrics acronym (shown in blue) you will get an explanation of each metric.
Specifically:
- SLOC is source lines of code (LOC minus comments and whitespace)
- NSC is semi-colon lines of code sometimes called LLOC or logical lines of code.
How are added, deleted and changed files and source lines calculated?
Added files are in the new project, but not in the old. Deleted files were in the old project but no longer in the new. Changed files exist in both but have Changed in some way (i.e. CHG_SLOC is greater than zero).
ADD_SLOC, DEL_SLOC and CHG_SLOC are calculated using the standard Unix difference ("diff") algorithm. Please open and view this document for a full explanation of these calculations: http://www.powersoftware.com/pm/pm_chg_ex.pdf.
If this case, specify the "-s" parameter, followed by the machinename of the server where MySQL is running. Suppose the machine were called "mysql1", you would include "-s mysql1" in your call to EPM and this would create your database on this server, and build metrics data there.
Why do I get a MySQL error when running EPM repeatedly?
Each time you execute EPM, it starts a MySQL server process in order to store and report results.
It takes a few hundreths of a second to close open files and stop the server process, and therefore you should pause a moment before re-running MySQL. In normal operation you would not see this error, only when testing the tool manually from the command line.
This problem is also resolved by running a stand-alone MySQL server and pointing EPM to it using the "-s" parameter.
What is the format of an EPM filelist?
- Line 1: Project Name
- Line 2: Project Snapshot date (a text representation of the date snapshot taken)
- Line 3: Base directory (useful for cropping long paths and essential for PM comparisons)
- Line 4-end: full path and filename of each file
What do the metrics mean?
Your tool seems to be working very well. I've been able to generate stats for big projects once I got the file list format right.
I have an outstanding question, while I'm still testing it, if you don't mind:
Is the exact meaning of all the metric codes documented somewhere? For instance, I suppose LOC in the tables means "lines of code" but what about SLOC? NSC?
If you go to the EPM product page and click on the metrics acronym (shown in blue) you will get an explanation of each metric.
Specifically:
- SLOC is source lines of code (LOC minus comments and whitespace)
- NSC is semi-colon lines of code sometimes called LLOC or logical lines of code.
How are added, deleted and changed files and source lines calculated?
Added files are in the new project, but not in the old. Deleted files were in the old project but no longer in the new. Changed files exist in both but have Changed in some way (i.e. CHG_SLOC is greater than zero).
ADD_SLOC, DEL_SLOC and CHG_SLOC are calculated using the standard Unix difference ("diff") algorithm. Please open and view this document for a full explanation of these calculations: http://www.powersoftware.com/pm/pm_chg_ex.pdf.
Is the exact meaning of all the metric codes documented somewhere? For instance, I suppose LOC in the tables means "lines of code" but what about SLOC? NSC?
 |  | ||||||||||||||||||||||||||||||
 | | ||||||||||||||||||||||||||||||
| | ||||||||||||||||||||||||||||||
 | | ||||||||||||||||||||||||||||||
 | | ||||||||||||||||||||||||||||||
 | | ||||||||||||||||||||||||||||||
 | | ||||||||||||||||||||||||||||||
25 Nov 2023
Copyright © 2023 PowerSoftware.com