DNCA Discover Command Line Reference

This section contains a reference of commands, actions, and options that can be run by using the Discover script command. This command is used primarily for post-installation of following tasks :

  • Some administration and maintenance functions
  • Some access to web console functions when the interface is not available
  • Debugging operations

Basic Command


./discover [options] action [service ...]

See

Options

Option
Description
-h
Show this help.
-n
Show the commands without running them.
-v
Show more messages (verbose mode).

Options are passed along to the service except when you specify service all. See Services.

Actions

Action
Description
allselfsignedcerts
Generate all self-signed certificates if missing.
bwmon
Run the bwMon utility.
capturekeys2ptl
Convert all PEM files in the capturekeys directory.
clearstats
Clear statistics for all instances.
configdiffs
Show differences for current and default configuration files.
deletestats
Delete statistics for all instances.
disable
Prevent one or all services from starting.
enable
Allow one or all services to start.
env
Display the "Discover environment".
genselfsignedcert
Generate a self-signed certificate.
ifdetails
Show detailed information about the specified network device.
ifstat
Show statistics about the specified network device.
ifsummary
Show summary information about network devices.
ifup
Start all network devices.
ipconfig
Configure network devices.
maint
Run maintenance script.
man
Show provided manual pages.
no
Set a runtime configuration variable to "NO".
openssl
Run provided OpenSSL.
pem2ptl
Encrypt PEM files into PTL format.
ps
Show capture processes by using /bin/ps.
restart
Stop and then start the specified service.
rolllog
Roll all log files or the specified one.
showstats
Show capture statistics.
showstatsxml
Show capture statistics in XML.
start
Start all or the specified service.
stats
Run statistics utility.
status
Show status of capture and HTTPd.
stop
Stop all or the specified service.
tcpdump
Run provided tcpdump.
testconn
Run Discover Transport Service connection test program.
top
Show capture processes using /usr/bin/top.
tzconfig
Configure time zone.
Note: Time zone settings must comply with the time zones that are supported by PHP. For a list of supported time zones, see http://www.php.net/manual/en/timezones.php.
userauthpw
Add or update a web console user password.
validate
Validate the user, owner, and permissions of DNCA files.
yes
Set a runtime configuration variable to "YES".

Services

For the actions disable, enable, start, status, and stop, the following Services can be specified:

  • all
  • capture - through captured
  • httpd - through httpd

Example commands


./discover ifdetails em0

./discover showstats

./discover start
  • Using start as root causes this script to bring up the primary and secondary capture interfaces.

./discover start all
  • Using start as root causes this script to bring up the primary and secondary capture interfaces.

./discover stop capture
./discover start capture
./discover start capture -r