IMPORTANT:
Server Directory Structure and Important Files
Directory/Filename | Description |
---|---|
/_jvm
|
Contains files pertaining
to Java and Java Runtime Environment (JRE).
|
/_uninst
|
Contains files for
uninstalling the WEM application.
|
uninst
|
Executable file for
uninstalling the WEM application.
|
/apache
|
Contains files pertaining
to the Apache Web Server used to provide access to the WEM.
|
/bin
|
Contains files required
for starting/stopping the Apache process and HTTP daemon.
|
apachectl
|
Executable file for
starting/stopping the Apache Web Server.
Refer to the Controlling Server Component
Processes section later in this chapter for more information.
|
/client
|
Contains files pertaining
to the WEM Client.
|
.java.policy
|
Java Policy file required
by client to access the WEM Server.
Refer to Preparing and Using
the Client Workstation chapter of this guide for more information.
|
/xxxx
|
A directory containing
client files for the current build, xxxx is the last four digits
of the current build number.
|
/audio
|
.WAV audio files used
for WEM's audio alarming functions
|
/mapimages
|
.GIF map image files
that can be configured for the client(s)
|
/webhelp
|
HTML-based online help
files for the application; they are accessible through the client
Graphical User Interface (GUI).
|
img.html
|
Webpage used for accessing
WEM.
Refer to Preparing and Using
the Client Workstation chapter of this guide for more information.
|
imgdebug.html
|
The same as the img.html
file except that it enables application level logs in the Java Console.
|
policy.html
|
Provides instructions
on how and where to save and where to save the policy file for the
varios operating systems that support WEM.
|
solaris-linux.html
|
Provides settings required
for running WEM using Netscape 6.0 and earlier, and Netscape 6.0
and later, on Solaris/Linux operating systems.
|
versions.html
|
Provides the recommended
versions for the various Operating Systems that support WEM.
|
console.log
|
Log file containing
console messages generated during installation.
|
inst.log
|
Log file created to
track installation progress.
|
/perlx.x.x
|
Contains files pertaining
to the specified version of the PERL scripting language, x.x.x is
the version of PERL.
|
/postgresx.x.x
|
Contains files pertaining
to the PostgreSQL database used by the WEM, x.x.x is the version
of Postgres.
|
/bin
|
Contains files required
for starting/stopping PostgreSQL and the Postmaster daemon.
|
pg_ctl
|
Executable for starting/stopping
the PostgreSQL server.
|
pg_start
|
Executable for starting
Postmaster daemon.
Refer to the Controlling Server Component
Processes section later in this chapter for more information.
|
pg_stop
|
Executable for stopping
Postmaster daemon.
Refer to the Controlling Server Component
Processes section later in this chapter for more information.
|
psql
|
Enters the PostgreSQL
interactive terminal.
|
vacuumdb
|
Removes old and/or
unused records from the various WEM databases.
Refer to WEM Database Maintenance chapter
of this guide for more information.
|
logfile
|
Log file containing
information pertaining to PostgreSQL operation.
|
/server
|
Contains files pertaining
to the WEM Server.
|
/alarmscripts
|
A directory for storing
user-defined scripts.
|
/bin
|
Contains WEM server
and component executable files.
|
/bsschema
|
Contains WEM Bulk Statistics
Schema configuration files.
|
/bulkstat_archive
|
Contains Bulk statistics
archive files (if collected).
|
/crondir
|
A directory for storing
cron-specific files.
|
/dbscripts
|
Contains scripts for
use with the PostgreSQL database.
|
/data
|
Contains un-parsed
bulk statistic data received from managed systems.
|
/etc
|
Contains
WEM configuration files.
Many of these files
contain user-configurable parameters for tailoring the operation
of the WEM. Information on the various parameters in these files
is provided within the files. Refer to the Server Configuration
Files section of this chapter for more information.
|
alarmid.cfg
|
SNMP alarm identification
configuration file
|
audio.cfg
|
Audio alarms configuration
file
|
blacklist.cfg
|
Configuration file
containing information used to enable the blacklisting feature on
WEM.
|
bs.cfg
|
Bulk statistic configuration
file
|
bsparser.cfg
|
Bulk statistic parser
configuration file
|
bsparserlogger.xml
|
Bulk statistic parser
logger file.
Refer to Enhanced WEM Logging chapter
of this guide for more information.
|
bsserver.cfg
|
Bulk statistic server module configuration file |
bsserverlogger.xml
|
Bulk statistic server
logger file
Refer to Enhanced WEM Logging chapter
of this guide for more information.
|
bstca.cfg
|
Bulk statistic threshold
configuration file
|
cf.cfg
|
Configuration file
for Content Filtering settings.
|
configupdate.cfg
|
System software update
functionality configuration file
|
db.cfg
|
Postgres
database configuration file
|
emscert.txt
|
WEM
RSA key and certificate
|
emslic.cfg
|
WEM license configuration
file.
|
emslogger.xml
|
WEM Server logger file
Refer to Enhanced WEM Logging chapter
of this guide for more information.
|
fm.cfg
|
Fault management configuration
file containing default severity levels for product SNMP traps.
|
hwinv.cfg
|
Contains the e-mail
ID used when sending notifications of hardware changes.
|
ism.cfg
|
WEM/managed
system communication configuration file.
|
mcrdbs.cfg
|
MCRDBS configuration
file
|
MeasurementStat.dtd
|
Document Type Definition
(DTD) configuration file for validating bulk statistic data.
|
nb.cfg
|
NorthBound Notification
Service configuration file
|
nbserver.cfg
|
File containing configuration
parameters for NorthBound Server and Notification Service processes
and other configuration parameters for the NorthBound interface.
|
nbserverlogger.xml
|
NorthBound Server logger
file
|
nms.cfg
|
WEM parameter configuration
file
|
pcrfrepgen.cfg
|
Configuration file for
the generation of 3GPP XML reports for PCRF.
|
processmonitor.cfg
|
Process Monitor server
configuration file
|
ps.cfg
|
Polling support configuration
file
|
psmon.cfg
|
Process Monitor rule
configuration file
|
pw_dict.*
|
All pw_dict
files pertain to the password-complexity checking algorithm in support
of ANSI security.
|
res.cfg
|
Screen-specific
resource-bundle path configuration file
|
scriptlogger.xml
|
Script Server logger
file
Refer to Enhanced WEM Logging chapter
of this guide for more information.
|
ssl-key-cert.txt
|
Secure
Sockets Layer (SSL) RSA key and certificate configuration file
|
STARENT-EMS-MIB.txt
|
WEM Server SNMP MIB
file. Refer to the Cisco
ASR 5000 Series SNMP MIB Reference for more information on the
objects and alarms defined in the MIB.
|
thr.cfg
|
Thread pool configuration
file
|
ua.cfg
|
User administration
configuration file
|
vacuum.cfg
|
Database vacuuming
configuration file
|
wblist.cfg
|
Configuration file
storing the white black list database file paths
|
./flash
|
Storage Server Directory
where the periodic backup of database is stored.
|
/installdata
|
Contains copies of
the configuration files used at the time of installation.
|
/log
|
Contains log files
for the various components of the WEM.
|
psmon
|
Process Monitor executable
file
Refer to WEM Process Monitor chapter
of this guide for more information.
|
/scripts
|
Contains script files
that can be used in conjunction with the WEM.
|
serv
|
Executable file for
starting/stopping the WEM Server.
Refer to the Controlling Server Component Processes section
later in this chapter for more information.
|
/xmldata
|
Contains XML-parsed
bulk statistic records if the “Generate XML Files” option
is enabled.
|
ems_migrate
|
Script
used for backup and restore of EMS directories.
This script should be
used with the same EMS releases. It will be required in case of
EMS setup migration from one machine to another machine, OS change
(Solaris 8 to Solaris 10), etc. There is a config file with this
script (ems_migrate.cfg),
in which the list of directories for backup and restore can be specified.
For example: dir_list=postgres/data server/etc
server/bsschema
|
/tools
|
Contains files pertaining to tools that can be used to obtain debugging information. |
getSupportDetails.pl
|
Script used for collecting
server logs and other information that is useful for troubleshooting.
Refer to the Capturing
WEM Server Logs using Script section of the Troubleshooting the
WEM appendix of this guide for more information on using this
script.
|
Server Configuration Files
CAUTION:
IMPORTANT:
The audio.cfg File
The bs.cfg File
The bsparser.cfg File
The bsserver.cfg File
IMPORTANT:
The db.cfg File
The fm.cfg File
The hwinv.cfg File
The ism.cfg File
The nb.cfg File
The nbserver.cfg File
The nms.cfg File
The res.cfg File
Server Log Files
Log File Severities
Server Scripts
Controlling Server Component Processes
Manually Verifying that WEM Components are Running
cd /<ems_dir>/server
./serv status
The
output of this command is a table listing the process, its ID (PID)
and its status as shown in the following example:
PID Process Status
----------------------------------------------------------
2093 Monitor
Server Running
1972 EMS
Server Running
2004 Script
Server Running
1929 BulkStat
Server Running
2022 BulkStat
Parser Running
2076 NorthBound
Server Running
2057 Notification
Service Running
----------------------------------------------------------
IMPORTANT:
cd /<ems_dir>/server
./serv stop
ps -ef | grep
server
cd /<ems_dir>/postgresx.x.x/bin/
./pg_stop
ps -ef | grep postgres
cd /<ems_dir>/apache/bin/
./apachectl
stop
ps -ef | grep apache
Manually Starting the WEM Server Components
cd /<ems_dir>/apache/bin
./apachectl
start
cd /<ems_dir>/postgresx.x.x/bin
./pg_start
cd /<ems_dir>/server
./serv start