[INIT PARAMETERS]
set to '1' during testing. This directive will display messages to your screen. When all is well set to '0'
This way, when you run the program unattended (via a scheduler), you can be sure that it will work properly.
IMPORTANT: LogFileManager, to get the logfile's period dates, opens the logfile. If the logfile is active then LogFileManager will notify you that the file cannot be opened. In this case, simply set displayMessages to 0 and it will run fine.
--------------------------------------
displayMessages=0
--------------------------------------
if you want to have the report file emailed to you set this option to '1'
--------------------------------------
emailReportFile=1
--------------------------------------
if you want to view the report after it is generated enter 1
if you do not want to view it enter 0
use this while getting everything right
--------------------------------------
viewReport=1
--------------------------------------
the default viewer is notepad.exe
if you would like to use your own viewer enter its name here.
enter the path also, if it's not in the windows default path
--------------------------------------
reportViewer=notepad.exe
--------------------------------------
this field will prompt you for all of the available options for LogFileManager
if promptMeForInfo is set to '1' you will be prompted for the info.
the default info (from the logfilemanager.ini file) will be displayed.
if you are prompted for info, and you leave it blank, LogFileManager will take its input from the logfilemanager.ini file
--------------------------------------
promptMeForInfo=1
--------------------------------------
[DIR INFO]
LogFileManager is a very powerful program. Along with power comes a bit of complexity.
======================================
PLEASE read each option and
understand it before using LogFileManager.
================================================
This represents the length you want for the serverComment to print on the report
Our default length is 15 characters. This directive lets you print the report, see what your longest server comment is, then set this value to it. This directive takes a numeric value only.
--------------------------------------
serverCommentLen=15
-----------------------------------------------
We now have multiple report formats for you to choose from. They are outlined below.
Report Format Standard:
Web# ServerComment DT File Size Log file/Date Period
-----------------------------------------------------
Report Format 1:
web# servercomment Data-transfer LogFilename
------------------------------------------------------
Report Format 2:
web# servercomment Data-transfer userDefinedInfo LogFilename
-----------------------------------------------------------------
The Standard Report Format is the default.
For the report formats select the appropriate value below:
Report Format Standard (default) set to: 0
Report Format 1 set to: 1
Report Format 2 set to: 2
--------------------------------------
reportFormatToUse=0
-----------------------------------------------
A new option we recently added (4/15/01) to LogFileManager is the userDefinedInfo directive. This directive will allow you to display any piece of information below in your report. You can read the documentation for the analog.exe program at http://www.analog.cx for a complete description of each line below. To run this directive you must be using the Format-two for the report. If you review the c:\dscinc\logfilemanger\analog\web.txt file you will see the options that analog.cx creates in the GENERAL SUMMARY REPORT. You can use any of these options to print and total on your LogFileManager report.
NOTE: Make sure you get the colon ':' below in the directive.
#####################################
Successful requests:
Average successful requests per day:
Successful requests for pages:
Logfile lines without status code:
Failed requests:
Distinct files requested:
Data transferred:
Average data transferred per day:
######################################
userDefinedInfo=Distinct files requested:
-----------------------------------------------
include the dir path to the report file LogFileManager will generate
DO NOT INCLUDE the trailing slash
do not include the report name, it will always be logfilemanager.txt
the default is the LogFileManager install directory - c:\dscinic\logfilemanager
------------------------------------------------------------
pathToReportFileDir=c:\dscinc\logfilemanager
-----------------------------------------------
this is the directory path where you'd like to start your search
there is no default for this. It must be set or LogFileManager won't work.
if you are sizing logfiles, set this to your logfile directory
if it is left blank the directory will be the root of c:
------------------------------------------------------------
dirPathToStart=c:\winnt\system32\logfiles
-----------------------------------------------
the file extension you'd like to search for
1. if you want to search for only the
logfiles with a specific extension
then set <fileExtensionsToSearchFor=*.log|ex0101.log|ex0012.log>
You can search for and process all logfiles, or, just a particular month or period logfile
------------------------------------------------------------
fileExtensionsToSearchFor=*.log
-----------------------------------------------
the file extensions you want to exclude from the search
-------------------------------------------------------------
fileExtensionsToExclude=
-----------------------------
the following two variables set the minimum and maximum logfile size to find
the code is:
if sizeOfLogFile >= fileSizeMin && sizeOfLogFile <= fileSizeMax
you need to specify the true values. 30 is 30. 30000 is 3k.
----------------------------
fileSizeMin=0
fileSizeMax=99999999
------------------------
zipIt takes a numeric value, one of 4 actually.
All options: 1, 2, 3 or 4 will zip the log file
1 - move the zipped logfile to selected directory
2 - move the zipped logfile to selected directory and delete the log file
3 - copy the zipped logfile to selected directory.
move the zipped logfile to clients root path.
4 - copy the zipped logfile to selected directory.
move the zipped logfile to clients root path. delete
log file from the log file directory
--------------------------------------
zipIt=0
----------------------------------------------
the program's install directory 'c:\dscinc\logfilemanager\' is the default zip directory
if you set the following variable make sure that you have write permission in that directory. This feature only works if you are working with logfiles.
----------------------------------------------------------
zipDirectory=d:\zips
-----------------------------------------------
this needs to be set to '1' to check the data-transfer of each logfile
if it is not set to '1' the report will not show the data-transfer
the report *will* show the web num, ServerComment, logfile size and the logfile path/name
NOTE: If you are getting a *total* from LogFileManager but no records, make sure your "checkBandwidth set to '0'". If it is set to '1' and the extension is not a log, the file will not filter through to be printed.
------------------------------------------------------------
checkBandwidth=1
-----------------------------------------
LogFileManager will run silent or it will display a text box showing what the heck is going on
To run silent set runSilent=1. LogFileManager must be run silent if running through a scheduler program, otherwise it will not run properly.
To see what LogFileManager is doing, set runSilent to '0'. If LogFileManager is being run through a scheduler then set this to '1'
-----------------------------------------------
runSilent=0
------------------------------------------------------
eCPU set to '1', will give the process which reads the logfiles more cpu time
it won't HOG the cpu and leave everything else without, it will just run faster and not respond as quickly to other processes needs.
------------------------------------------------------
eCPU=1
------------------------------------------------------------
Set this to 1 and LFM will subtotal all the logfiles in one logfile directory
subTotal=1
_____________________________________________
NOTE: Please read the 'how_to_use_analog.txt' file
____________________________________________
[ANALOG]
NOTE: *ALWAYS* LEAVE THIS SET TO '1'
-------------
runAnalog=1
-------------------
NOTE: THE FOLLOWING OPTIONS ARE NOT PROMPTED FOR EVEN IF 'promptMeForInfo' is set to '1'
if you would like analog to create a complete log analysis report for the client's logfile
you have three options here. if you just want a report, don't put anything here.
1 - copy the report to the client's web root
2 - copy the report to the path named in 'clientReportDir'
3 - copy the report to the client's web root and move it to the path named in 'clientReportDir'
--------------------------------------------------------------
createClientReport=0
--------------------------------------------------------------
if you would like analog to create a complete log analysis report for the client's logfile, and copy it to an archive directory, type the pathname in here. if the directory does not exist, you will not be warned, the report simply won't copy to it. however, the report will still be created by analog and it will remain in the default analog directory.
--------------------------------------------------------------
clientReportDir=c:\dscinc\logfilemanager\reports
---------------------------------------------------------------
A little on the SMTP settings:
host - your SMTP server. Either the domain name (i.e., mail.ourserver.com) or the IP# (i.e., 216.232.11.1) either way will work.
fromaddr - your FROM address. Some mail servers require this to be a valid email address on the mail server. So, make sure it is.
port - for SMTP usually 25. If you know yours is specific then change this, otherwise, leave it alone.
tolist - The email address or news-group name of the recipient. You can specify multiple to addresses, by specifying a tab- or vertical bar-delimited list. NOTE: You can also use addresses of the longer form, i.e, "john cesta john@cesta.com" and the older variant, john@cesta.com(john cesta).
cclist - The email address of the recipient. You can specify multiple cc addresses, by specifying a tab or vertical bar-delimited list.
bcclist - The email address of the recipient. You can specify multiple bcc addresses, by specifying a tab or vertical bar-delimited list.
subject - you can put what you want here to appear as the subject in your email. The WPC, however, will append the relevant error message to this subject. So, don't make it too long.
msg - this is what you want in the body of the email message. You don't need too much here as the relevant error message from WPC will already be in the subject line.
attachments - You can attach any file you'd like here but a good idea is to attach the WPC error log file to the email. Also, maybe you want to attach the IIS error log or the ColdFusion error log etc.
tolist would look like - "wart@wartman.com|dude@bestdude.com|fred@andethel.com"
[SMTP INFO]
host=0.0.0.0
fromaddr=john@lookwww.com
port=
tolist=john@lookwww.com
cclist=
bcclist=
subject=LogFile analysis
msg=Email contains our LogFileManager Report. Generated using LogFileManager from DSC, Inc. at: http://www.serverautomationtools.com
; set attachments to the directory your report is output to
attachments=c:\dscinc\logfilemanager\logfilemanager.txt

