Most program configuration settings and profile default settings are located in the wtm_wtx.ini file. Use this section as a reference for the settings contained in this file.
audit
The Reporting Server maintains audit files for each profile and for the program.
Table 11 - 5 Audit settings
Audit settings
archives
Archiving allows you to backup profile databases and reports at regular intervals. The archives section defines how often archiving takes place and the maximum number of archives kept for each profile.
Table 11 - 6 Archive settings
cookie
If your web server uses cookies to identify repeat visitors, this information can be used to more accurately identify unique user sessions. Using cookies is the most accurate way of tracking the user’s path through the site.
Note: See “Cookies” on page 107 for details on how cookies are defined in the GUI.
Audit settings Default
logdir ./wtm_wtx/datfiles/statuslog
Specifies the directory where the profile status logs and the audit file for the Reporting Server are stored.
logfile wtrs.audit
Specifies the name of the Reporting Server audit file. This file provides an account of program activity.
Specifies how often an archive is created for the profile.
maxarchives 11
Specifies the maximum number of archives kept for each profile using archiving.
Table 11 - 7 Cookie settings
Cookie setting Default
enable 1
1--Uses cookie data in the analysis.
0--Cookies are not used to track visitors.
validate 1
1--Includes only valid cookies in the analysis.
0--Does not validate the cookie. If enabled is set to 1, the data in the cookie field of the log file is used in the analysis. If enabled is set to 0, this value is not read.
CookieText
Allows you to specify a cookie to use to track user sessions.
1--Uses the cookie specified in the CookieString option.
0--Uses the cookie generated by the WebTrends Plugin (or none, if enable is set to 0.)
Note: You must also specify the cookie to match in the cookiestring option.
WebTrendsPlugin
Allows you to use the cookie generated by either WebTrends Netscape Extended Log Plugin or WebTrends IIS Extended Log Plugin.
1--If CookieText is set to 0, set this option to 1.
0--If CookieText is set to 1, set this option to 0.
Note: You must have installed one of these plugins to use this option.
CookieString
If the CookieText option is set to 1, specify the cookie format to validate here. Enter the string to match.
For example, the cookie field of a log file might look like this:
CookieID1=CookieValue1;CookieID2=CookieValue2;
CookieID3=CookieValue3
If the cookie that you want to use to identify user sessions is CookieID2, you would enter CookieID2 in the CookieString field.
If you are using Microsoft SiteServer, you might have cookies that look like this:
SITESERVER=ID=CookieValue1;SITESERVER=GUID=CookieValue 2
If the GUID is the cookie that you want to use to identify user sessions, then you should enter SITESERVER=GUID in the CookieString field.
Cookie settings
defaults
The settings in this section define the defaults for new profiles created through the GUI (graphical user interface).
Table 11 - 8 Defaults settings [cookie]
enable = 1 validate = 0
default setting Default
profilesdir ./wtm_wtx/datfiles/profiles Specifies the directory where all profiles are kept. Entering ./ in the path indicates that the directory is relative to the installation directory.
Note: If you change this location, only new profiles appear in the new directory. Profiles created before the change remain in the original location unless you copy them.
Note: The Reporting Server provides information on domain groupings in the Organization Breakdown table and graph. The following settings define the domains associated with each domain grouping. They can also be defined through the GUI. See “Domain groups” on page 111 for details.
edu_orgtype edu ac.at at.cn ac.cr ac.cy ac.fj ac.id ac.il ac.im ac.in ac.jp ac.kr ac.nz ac.pa ac.th ac.ug ac.uk ac.yu ac.za re.kr ed.cr edu.ac edu.bm edu.cn edu.co edu.do edu.ec edu.eg edu.ge edu.gu edu.jo edu.lc edu.lv edu.mm edu.mo edu.my edu.pa edu.py edu.sg edu.sh edu.tr edu.tw edu.uy edu.ve edu.yu edu.za edunet.tn k12.ec k12.il k12.tr sch.uk school.fj school.za Specifies the domains associated with education types of organizations in reports. Separate multiple entries with spaces.
usdomains com edu net org gov mil int arpa Specifies the domains associated with the United States in reports.
Separate multiple entries with spaces.
int_orgtype int int.co int.ve intl.tn
Specifies the domains that are reported as International types of organizations.
gov_orgtype gov go.cr go.id go.kr go.th go.ug gob.pa gov.ac gov.au gov.bm gov.br gov.cn gov.co gov.cy gov.do gov.ec gov.eg gov.fj gov.ge gov.gu gov.il gov.im gov.in gov.jo gov.jp gov.lb gov.lc gov.lv gov.mm gov.mo gov.my gov.sg gov.sh gov.tn gov.tr gov.ua gov.ua gov.uk gov.ve gov.ve gov.za gove.tw govt.nz
Specifies the domains that are reported as government types of organizations.
mil_orgtype mil mil.ac mil.br mil.co mil.do mil.ec mil.ge mil.gu mil.id mil.lb mil.lv mil.ph mil.sh mil.tr mil.ve mil.za
Specifies the domains that are reported as military types of organizations.
net_orgtype net ad.jp ne.kr net.ac net.ae net.ar net.au net.bm bet.br net.bs net.cn net.cu net.cy net.do net.ec net.eg net.ge net.gu net.hk net.id net.il net.im net.in net.jo net.jp net.la net.lb net.lc net.lv net.ly net.mm net.mo net.mt net.mx net.my net.na net.nc net.np net.nz net.pa net.pe net.ph net.pl net.py net.ru net.sg net.sh net.sy net.th net.tn net.tr net.tw net.ua net.uk net.uy net.ve net.vi net.ve net.vi net.za
Specifies the domains that are reported as network types of organizations.
default setting Default
org_orgtype org or.cr or.id or.kr or.th or.ug org.ac org.ae org.au org.bm org.br org.bs org.cn org.co org.cu org.cy org.do orge.ec org.eg org.fj org.ge org.gu org.hk org.hu org.il org.im org.jp org.la org.lb org.lc org.lv org.ly org.mm org.mo org.mt org.mx org.my org.na org.nc org.nz org.pa org.pe org.ph org.pl org.py org.ru org.sg org.sh org.sy org.tn org.tr org.tw org.uk org.uy org.ve org.vi org.yu org.za
Specifies the domains that are reported as organizations.
arpa_orgtype arpa
Specifies the domains that are reported as arpa types of organizations.
com_orgtype com co co.at co.co co.hu co.id co.id co.il co.im co.in co.jp co.kr co.nz co.sv co.th co.ug co.uk co.ve co.vi co.yu co.za com.ac com.ae com.ar com.au com.bm com.br com.bs com.cn com.co com.cu com.cy com.do com.ec com.eg com.jf com.ge com.gu com.gh com.jo com.la com.lb com.lc com.lv com.ly com.mm com.mo com.mt com.mx com.my com.na com.nc com.ni com.np com.pa com.pe com.ph com.pl com.py com.ru com.sg com.sh com.sy com.tn com.tr com.tw com.ua com.uy com.ve firm.co firm.ve ltd.uk
Specifies the domains that are associated as commercial types of organizations.
maxtopcount 500
This option is not currently used.
maxthreads 64
default setting Default
Specifies the number of threads which are allocated to reverse DNS (domain name server) lookups. The threads are divided among the number of concurrent analyses.
maxcachedcount NA
This option is not currently used.
dnscachelifespan 30
Specifies the number of days that DNS entries stored in the database are valid.
dnsthreads (Solaris 2.5) 8
(Solaris 2.6) 16 (Linux) 1
Specifies the number of threads available to perform DNS lookups on the entries in the lookup queue. The more threads working on DNS resolution, the quicker the process should go, provided that there are enough entries in the lookup queue to work on. However, if there are too many threads for the size of the lookup queue, many of the threads are not used, and remain idle. Making this number too high may overtax system resources.
dnscacheentries 5000
Specifies the number of entries in the DNS cache. Once an entry in the DNS lookup queue has been cached, it is saved here until the maximum number of entries is reached. If you are running extremely large log files, or log files with a high incidence of unique IPs, you should increase the size of the cache for better performance on subsequent analyses. Each entry takes about 50 bytes; making the cache too large may cause excessive swapping.
dnstimeout 5
Specifies the maximum number of seconds given to perform each DNS lookup. Once this number is reached, the IP is cached whether it is translated or not, and the record is ready for processing. Decreasing this value can improve performance significantly if there are a large number of IPs that cannot be translated. However, once an IP has been cached, it is not be looked up again which can affect the accuracy of reports.
downloadtypes {exe,0} {com,0} {zip,0} {pdf,0}
{arc,0} {bin,0} {sit,0} {tar,0} {gz,0}
{z,0} {arj,0}
default setting Default
Specifies the file type extensions that are associated with downloaded files and when the file type is included in reports.
0--includes the file type if it is from a script or dynamic page.
1--includes the file type only if it is not from a script or dynamic page.
2--always includes the file type.
This data is included in the Top Downloaded Files table and graph.
documenttypes {htm,0} {txt,0} {mdl,0} {shtml,0}
{htmls,0} {html,0} {htp,0} {htpl,0}
{dbm,0} {asp,0} {sht,0} {cfm,0}
Specifies the file type extensions that are counted as document files and when the file type is included in reports.
0--includes the file type if it is from a script or dynamic page.
1--includes the file type only if it is not from a script or dynamic page.
2--always includes the file type.
These are reported in the Most/Least Requested Pages table and graph, and the Top Entry/Exit Pages table and graph.
cachedtime 1800
Specifies the number of minutes of inactivity before the user session is timed-out. The default value, 1800, corresponds to 30 minutes of inactivity.
titlecachesize 1000
If the NoHTMLTitles option is disabled (set to0), specify the size of the cache for page titles here. The default value is 1000.
titlecachelifespan 259200
If the NoHTMLTitles option is disabled (set to1), specify the maximum number of seconds entries are saved in the cache.
This option is typically used for sites that change often. The default value is 259200 (3 days).
nohtmltitles 0
Setting this value to 1 leaves HTML page titles out of reports.
Tip: Setting this option to 1 may significantly reduce the time it takes to analyze the log file.
UseGlobalContentGroups
Content Group definitions can be applied to all profiles or can be selected on a profile basis.
0--Apply the definitions to all profiles.
1--Allows you to specify the definitions on a profile basis.
useglobalpathsanalysisprofil es
default setting Default
Path Analysis definitions can be applied to all profiles or be selected on a profile basis.
0--Apply the definitions to all profiles.
1--Allows you to specify the definitions on a profile basis.
useglobalquerystrings
URL Parameter Analysis definitions can be applied to all profiles or only to those that you chose.
0--Apply the definitions to all profiles
1--Allows you to specify the definitions on a profile basis.
UseGlobalURLReplacementFilte rs
URL Search and Replace definitions can be applied to all profiles or can be selected on a profile basis.
0--Uses the definitions specified in the URL Search and Replace dialog for all log analysis profiles.
1--Allows you to specify the definitions on a profile basis.
default setting Default
Defaults settings [defaults]
profilesdir = ./wtm_wtx/datfiles/profiles rtrange = 5
edu_orgtype = edu ac.at at.cn ac.cr ac.cy ac.fj ac.id ac.il ac.im ac.in ac.jp ac.kr ac.nz ac.pa ac.th ac.ug ac.uk ac.yu ac.za re.kr ed.cr edu.ac edu.bm edu.cn edu.co edu.do edu.ec edu.eg edu.ge edu.gu edu.jo edu.lc edu.lv edu.mm edu.mo edu.my edu.pa edu.py edu.sg ...
usdomains = com edu net org gov mil int arpa int_orgtype = int int.co int.ve intl.tn
gov_orgtype = gov go.cr go.id go.kr go.th go.ug gob.pa gov.ac gov.au gov.bm gov.br gov.cn gov.co gov.cy gov.do gov.ec gov.eg gov.fj gov.ge gov.gu gov.il gov.im gov.in gov.jo gov.jp gov.lb gov.lc gov.lv gov.mm ...
mil_orgtype = mil mil.ac mil.br mil.co mil.do mil.ec mil.ge mil.gu mil.id mil.lb mil.lv mil.ph mil.sh mil.tr mil.ve mil.za
net_orgtype = net ad.jp ne.kr net.ac net.ae net.ar net.au net.bm bet.br net.bs net.cn net.cu net.cy net.do net.ec net.eg net.ge net.gu net.hk net.id net.il net.im net.in net.jo net.jp net.la net.lb net.lc net.lv net.ly net.mm net.mo net.mt net.mx net.my net.na net.nc ...
org_orgtype = org or.cr or.id or.kr or.th or.ug org.ac org.ae org.au org.bm org.br org.bs org.cn org.co org.cu org.cy org.do orge.ec org.eg org.fj org.ge org.gu org.hk org.hu org.il org.im org.jp org.la org.lb org.lc org.lv org.ly org.mm org.mo org.mt org.mx org.my org.na ...
arpa_orgtype = arpa
com_orgtype = com co co.at co.co co.hu co.id co.id co.il co.im co.in co.jp co.kr co.nz co.sv co.th co.ug co.uk co.ve co.vi co.yu co.za com.ac com.ae com.ar com.au com.bm com.br com.bs com.cn com.co com.cu com.cy com.do com.ec com.eg com.jf com.ge com.gu com.gh com.jo com.la ...
maxtopcount = 500 maxthreads = 150 maxcachedcount = 4000 dnscachelifespan = 30
downloadtypes = {exe,0} {com,0} {zip,0} {pdf,0}
documenttypes = {asa,2} {asp,2} {cdx,2} {cer,2}
cachedtime = 1800 dnscacheentries = 7000 titlecachesize = 1800 titlecachelifespan = 365 nohtmltitles = 0
reports
The settings in the reports section define the number of reports that are saved for each interval by default. Once this limit is reached, the oldest report is deleted to make room for the new one.
When determining how many reports to store, consider how much disk space you want to devote to reports and how long you want to save them. A report using the Complete Summary template as it was installed needs 350-400 K.
These settings correspond to the dailyreport, weeklyreport, monthlyreport, quarterlyreport, and yearlyreport settings in the [profile] section of the wtm_wtx.ini file.
As an administrator, you can modify these setting on a profile basis.
Non-administrators can modify these settings if the histoverride option in the profiles section is set to 1.
Note: If an option is not present, if it has a value of 0, or if it is blank, reports are not deleted.
Table 11 - 9 Reportssettings
performance
If you are analyzing a large number of log files, these settings help you manage the performance of the Reporting Server.
Reports settings Default
dailystore 0
Specifies the default number of daily reports to save.
weeklystore 0
Specifies the default number of weekly reports to save.
monthlystore 0
Specifies the default number of monthly reports to save.
quarterlystore 0
Specifies the default number of quarterly reports to save.
yearlystore 0
Specifies the default number of yearly reports to save.
Note: You can also modify these settings through the GUI. See
“System performance” on page 118 for details.
Table 11 - 10 Performance settings
Performance settings
language
The language section defines the language that reports should be generated in.
Performance settings Default threadedanalysis true
This option specifies whether multiple processes are performed at the same time. Set this option to false if your system lacks the resources, or if you want the processing of profiles handled one at a time.
false--Performs profile analyses one at a time.
true--Analyzes more than one profile at once. If your system has fast processing or multiple CPUs, enabling threaded analysis may improve performance.
maxanalysis 1
Enter the maximum number of profiles that can be processed concurrently.
If your system has fast processing or multiple CPUs, increasing this number may improve performance.
lookupqueuesize 5000
Specifies the maximum number of records in the lookup queue. Records enter the lookup queue and wait to be processed by one of the lookup threads. The lookup queue should be large enough to make use of the available lookup threads, but not so large that it uses too much memory.
Each queue entry uses 2K of memory; if the lookup queue is too large, excessive swapping occurs.
[performance]
maxanalysis = 1
threadedanalysis = true
Table 11 - 11 Language Settings
Language settings
profile
The settings in the profile section are used as default settings for profiles created through the GUI.
Table 11 - 12 Default profile settings.
Language settings Default
country US
Specifies the country that will be identified as the country of origin for reports.
report english
Specifies the language to use for the report. Enter one of the following:
english
A value of true generate reports concurrently with analysis. Set this value to false to suspend analysis while reports are generated.
debuglevel 5
Specifies the degree of verbosity when debugging the profile. Enter a
Specifies the degree of verbosity when debugging the profile. Enter a