RiverBed AppInternal Configuration

Command Line Interface Reference

max_num_parser Maximum number of threads that silo uses to concurrently process trace data. Valid values are
max_index_procs 1 to 100. 1 is the default.
timeout_incompl
Maximum number of processes that silo uses to index stitched multi-tier transactions. Valid values
are 1 to 100. 2 is the default.

Number of seconds that silo waits to abandon attempts to stitch multi-tier transactions after it
determining that it lacks some dependencies. If the dependencies are not found during this interval,
the transactions will not be stitched. Valid values are 10 to 600. 120 is the default.

For example, to change max_index_procs:

set silo_settings max_index_procs 3
show silo_settings

Silo Settings:
disk_quota_pct (Maintain Minimum Disk Free Percent): 10%
disk_quota_min (Disk Minimum Quota): 4 GiB
disk_quota_max (Disk Maximum Quota): 10000 GiB
log_diagnostic (Log Diagnostic Messages): no
max_num_parser (Maximum Number of Parser Threads): 2
max_index_procs (Maximum number of processes that index stitched

multi-tier transactions data): 3
timeout_incompl (Timeout if Stitch is Incomplete) : 120 seconds

show

Display system information. The “show“ command in enable-mode has additional options.

show { capabilities | hostname |interface | ip | silo_settings }

show hostname

Show the host name for the AppInternals virtual machine. Set the host name with the configuration-mode “hostname“
command.

show interface

show interface { brief | name <name> }

Display network interface configuration and state.

show interface brief

Display details for all interfaces.

appinternals # show interface brief

Interface lo state:

Up: yes

Interface type: ethernet

IP address: 127.0.0.1

Netmask: 255.0.0.0

Link-local address:

Speed: UNKNOWN

Duplex: UNKNOWN

MTU: 16436

HW address: 00:00:00:00:00:00

Link: yes

Riverbed SteelCentral AppInternals Version 10.0 11

Command Line Interface Reference

Interface eth0 state:

Up: yes

Interface type: ethernet

IP address: 10.46.35.84

Netmask: 255.255.255.0

Link-local address: fe80::a00:27ff:fef8:d0f8/64

Speed: 1000 Mbit/Sec (auto)

Duplex: full (auto)

MTU: 1500

HW address: 08:00:27:f8:d0:f8

Link: yes

show interface name <name>

Display details for the specified network interface name. Type ? to see available names.

appinternals # show interface name eth0

Interface eth0 state:

Up: yes

Interface type: ethernet

IP address: 10.46.35.84

Netmask: 255.255.255.0

Link-local address: fe80::a00:27ff:fef8:d0f8/64

Speed: 1000 Mbit/Sec (auto)

Duplex: full (auto)

MTU: 1500

HW address: 08:00:27:f8:d0:f8

Link: yes

show ip default-gateway

Display the default network gateway.

appinternals > show ip default-gateway
Active default gateway: 10.46.35.11

show silo_settings

Show the current value of silo settings. See the “set silo_setting <setting> <value>“ command for details on the
different settings.

show silo_settings

Silo Settings:
disk_quota_pct (Maintain Minimum Disk Free Percent): 10%
disk_quota_min (Disk Minimum Quota): 4 GiB
disk_quota_max (Disk Maximum Quota): 10000 GiB
log_diagnostic (Log Diagnostic Messages): no
max_num_parser (Maximum Number of Parser Threads): 2
max_index_procs (Maximum number of processes that index stitched

multi-tier transactions data): 1
timeout_incompl (Timeout if Stitch is Incomplete) : 120 seconds

Enable-Mode Commands

This section describes commands you can issue in enable-mode. In addition to the commands described here, you can
also use “User-Mode Commands“ in enable-mode.

12 Riverbed SteelCentral AppInternals Version 10.0

Command Line Interface Reference

Use the enable command from user-mode to enter enable-mode. From enable-mode, you can also issue user-mode
commands. You can enter configuration-mode but not issue configuration-mode commands.
The command-line prompt for enable-mode is hostname #.

nhv1-ams-5 > enable
nhv1-ams-5 #

To exit enable-mode, use the disable command.

configure terminal

Enter configuration-mode. See “Configuration-Mode Commands“ for the additional commands available in
configuration-mode.

appinternals # configure terminal
appinternals (config) #

date

Show the current date and time on the analysis server.

nhv1-ams-5 # date
Fri Jun 26 11:44:13 EDT 2015

Change the current date and time with the configuration-mode “setdate“ command.

disable

Exit enable-mode and return to enable-mode.

exit

In user-mode and enable-mode, log out of the virtual machine session.

free

Memory statistics
Run the Linux free command to show free and used memory statistics. See http://linux.die.net/man/1/free for more
details.

halt

Shut down the virtual machine. You will need to use the hypervisor for the virtual machine to restart. Use the “reboot“
command to shut down and restart.

appinternals # halt
Broadcast message from [email protected]

(/dev/pts/0) at 13:21 ...
The system is going down for power off NOW!
appinternals #

Riverbed SteelCentral AppInternals Version 10.0 13

Command Line Interface Reference

iostat

Run the Linux iostat command to show input/output statistics. See http://linux.die.net/man/1/iostat for more details.

iptraf

Run the Linux IPTraf network monitor in interactive mode. See http://linux.die.net/man/8/iptraf for more details.

netstat

Run the Linux netstat command to show TCP connection information. See http://linux.die.net/man/8/netstat for more
details.

ntpq

Run the Linux ntpq -p command to show a list of connected NTP servers. See http://linux.die.net/man/8/ntpq for more
details.

nhv1-ams-5 # ntpq

remote refid st t when poll reach delay offset jitter

==============================================================================

*time-b.nist.gov .ACTS. 1 u 105 128 377 24.553 0.294 0.820

+host2.kingrst.c 129.6.15.29 2 u 93 128 377 45.790 -3.669 1.748

-4.53.160.75 204.9.54.119 2 u 100 128 377 38.863 -2.951 2.074

+bindcat.fhsu.ed 132.163.4.103 2 u 106 128 377 69.189 -0.379 3.106

ntpstat

Run the Linux netstat command to show NTP synchronization status. See http://linux.die.net/man/8/ntpstat for more
details.

nhv1-ams-5 # ntpstat
synchronised to NTP server (129.6.15.29) at stratum 2

time correct to within 37 ms
polling server every 128 s

ntpsync

Immediately synchronize the time with an NTP server. The following example:

 Shows the current date and time with the “date“ command.

 Sets the time to an incorrect time (to 1 a.m. instead of 1 p.m.) with the configuration-mode “setdate“ command

 Re-synchronizes with the NTP server using ntpsync.

 Shows the (now correct) time with the date command.

nhv1-ams-5 # date
Fri Jun 26 13:10:42 EDT 2015
nhv1-ams-5 # configure terminal
nhv1-ams-5 (config) # setdate
Year: 2015
Month: 6
Day: 26
Hour: 1
Minute: 0

14 Riverbed SteelCentral AppInternals Version 10.0

Command Line Interface Reference

Second: 0

2015-06-26 01:00:00

nhv1-ams-5 (config) # date

Fri Jun 26 01:00:02 EDT 2015

nhv1-ams-5 (config) # ntpsync

Shutting down ntpd: [ OK ]

26 Jun 13:11:30 ntpdate[31898]: step time server 198.60.22.240 offset 43875.987165 sec

Starting ntpd: [ OK ]

nhv1-ams-5 (config) # date

Fri Jun 26 13:11:35 EDT 2015

ping

Run the Linux ping command to send a network ping to the specified IP address or host name. See
http://linux.die.net/man/8/ping for more details.

reboot

Reboot the virtual machine. Use the “halt“ command to shut down without restarting.

appinternals (config) # reboot
Rebooting...

Broadcast message from [email protected]
(/dev/pts/1) at 16:59 ...

The system is going down for reboot NOW!

request-root

Use this command at the direction of Riverbed technical support to enable temporary root access to the virtual
machine.

service <name> { start | stop }

Start or stop the specified service. The following table shows the service names and their function.

agentconfig:negotiator Uploads agent configuration changes to agents. Retrieves details of discovered processes to
auth instrument (such as process name, process ID, packages, classes, and methods) from agents.

Manages communication with the authentication server.

collector:ferryman Manages the list of known agents and retrieves transaction trace and environmental metrics
collector:proxy files from agents.

Websocket-to-http proxy that routes messages to agents.

harvester Retrieves traces from legacy agents.

networking Manages network configuration on the analysis server.

nginx-external External web server process that handles requests and data from the web interface, transaction
trace and metric data from AppInternals agents, and web page performance data from
browsers.

Riverbed SteelCentral AppInternals Version 10.0 15

Command Line Interface Reference

nginx-internal Internal web server process that routes messages between components on the analysis server.

odb_server Manages database storage.

silo_aggr_map Aggregates data for application maps.

silo_aggr_metrics_env Aggregates data from environmental metrics.

silo_aggr_metrics_stx Aggregates data from stitched transactions.

silo_aggr_metrics_utx Aggregates data from unstitched transactions.

silo_dispatch Processes transaction trace, metric, and web page performance data.

silo_stitch Processes stitched end-to-end transactions

supervisord Manages most services (all except the auth, networking, and webui services). Stopping or
webui starting the supervisord service stops or starts the services it manages.

Controls the web interface.

yarder-core Manages utility services responsible for tasks such as adjusting system time, NTP settings and
yarder-core-monitor upgrades.

Monitors status of the yarder-core service.

show

Display system information.

show { auth | dns | drive | service | upgrade {packages | repository} }

show auth config

Display the system name and port for the authentication server. You can change these values with the
configuration-mode “auth“ command.

appinternals # show auth config

Steel Central Authentication Service Settings:

Hostname: 127.0.0.1

Port: 8222

show dns

Show the IP address of the DNS server if it has been set. Set the address with the configuration-mode “dns <address>“
command.

show drive

Display information about storage on the virtual machine.

show drive { all | disk <name> | unpartitioned }

16 Riverbed SteelCentral AppInternals Version 10.0

Command Line Interface Reference

show drive all

Display information about all disk drives on the virtual machine.

appinternals > show drive all

sda 16G

- dm-1 1.6G [SWAP]

- sda2 15.5G /
/boot
- dm-0 13.9G

- sda1 500M

sdb 50G /mnt/data
- sdb1 50G
- dm-2 50G

sdc 50G /mnt/data
- sdc1 50G
- dm-2 100G

The output shows the drive name and partitions on it.

show drive disk <name>

Display information about the specified disk drive on the virtual machine.

appinternals > show drive disk sda

sda 16G

- dm-1 1.6G [SWAP]

- sda2 15.5G

- dm-0 13.9G /

- sda1 500M /boot

show drive unpartitioned

show service <name> status

Show the status of the specified service. See the “service <name> { start | stop }“ command for details on the different
services.

show service status

Show the status of the all services. See the “service <name> { start | stop }“ command for details on the different
services.

appinternals # show service status

/etc/init.d/appinternals-webui is already running at 4722

/etc/init.d/authservice-webui is already running at 1130

Configured devices:

lo eth0

Currently active devices:

lo eth0

agentconfig:negotiator RUNNING pid 1058, uptime 5:20:07

collector:ferryman RUNNING pid 1056, uptime 5:20:07

collector:proxy RUNNING pid 1057, uptime 5:20:07

harvester RUNNING pid 1055, uptime 5:20:08

nginx-external RUNNING pid 1045, uptime 5:20:08

nginx-internal RUNNING pid 1044, uptime 5:20:08

odb_server RUNNING pid 1046, uptime 5:20:08

silo_aggr_map RUNNING pid 1053, uptime 5:20:08

silo_aggr_metrics_env RUNNING pid 1052, uptime 5:20:08

silo_aggr_metrics_stx RUNNING pid 1049, uptime 5:20:08

silo_aggr_metrics_utx RUNNING pid 1048, uptime 5:20:08

silo_dispatch RUNNING pid 1047, uptime 5:20:08

Riverbed SteelCentral AppInternals Version 10.0 17

Command Line Interface Reference

silo_stitch RUNNING pid 1051, uptime 5:20:09
yarder-core RUNNING pid 1050, uptime 5:20:09
yarder-core-monitor RUNNING pid 1054, uptime 5:20:09

show upgrade packages

Display any available upgrade packages. Note that this command is not available from the user-mode “show“
command. You must be in enable-mode or configuration-mode. The following example shows that several upgrade
packages are available, and that the latest (0.4.39) has been downloaded (either by using “upgrade download version
<version>“ or in the web interface “Software Upgrade Screen“):

nhv1-ams-4 (config) # show upgrade packages

current version: appinternals 0.8.5

upgrade info source: web

available versions:

- 0.7.20 344MB

- 0.7.21 440MB

- 0.7.22 440MB

- 0.7.23 440MB

- 0.7.26 440MB

- 0.7.27 440MB

- 0.7.28 440MB

- 0.7.31 440MB

- 0.7.32 441MB

* 0.8.5 439MB

- 0.8.6 439MB Upgradeable

nhv1-ams-4 (config) #

show upgrade repository

Show the repository from which AppInternals will download upgrade packages. Note that this command is not
available from the user-mode “show“ command. This command shows a value only if the repository was changed with
the “upgrade repository url <url>“ command. Otherwise the command shows a value of default.

top

Run the Linux top command to display running tasks. Type Ctrl+C to stop the output. See
http://linux.die.net/man/1/top for more details.

watchlogs

Displays the latest changes in several AppInternals log files. The output updates when any of the log files it monitors
change. Type Ctrl+C to stop the output.

appinternals # watchlogs

==> /var/log/appinternals/agentconfig/negotiator.log <==

2015-02-28 12:57:21,018 INFO agentconfig.agent Poll results: 1 agents connected, 0 new agents,

0 offline agents, 0 agents now online

.

.

.

Ctrl+C

appinternals #

18 Riverbed SteelCentral AppInternals Version 10.0

Command Line Interface Reference

Configuration-Mode Commands

This section describes the commands you can issue in configuration-mode. In addition to the commands described
here, you can also use “User-Mode Commands“ and “Enable-Mode Commands“ in configuration-mode.
Use the configure terminal command to enter configuration-mode (you must be in enable-mode first).
The command-line prompt for configuration-mode is hostname (config) #.

nhv1-ams-5 # configure terminal
nhv1-ams-5 (config) #

To exit this mode, use the exit or no configure command.

auth

Specify connection details for the authentication server. See “Changing the Server for the Authentication Service“ for
more details.

auth hostname

Specify the system name of the system running the authentication server.

appinternals (config) # auth hostname hummer
Updated auth hostname to: hummer

auth port

Specify the port for connections to the authentication server. The default is 8222.

appinternals (config) # auth port 8223
Updated auth port to: 8223

debug generate

Generate a “diagnostic bundle”, a compressed package of analysis server log files and other troubleshooting aids. This
command has the same effect as clicking “Generate Diagnostic Bundle“ in the “Diagnostic Bundle Screen“.

debug generate detailed

Generate a detailed diagnostic bundle for the analysis server. This command has the same effect as clicking “Generate
Detailed Diagnostic Bundle“ in the “Diagnostic Bundle Screen“.

dns <address>

Set the IP address for the DNS (Domain Name System) server to translate a domain name to an IP address.

exit

Exit configuration-mode and return to enable-mode.

Riverbed SteelCentral AppInternals Version 10.0 19

Command Line Interface Reference

appinternals (config) # exit
appinternals #

hostname

Set the host name for the AppInternals virtual machine.

interface <interfacename>

Configure the specified network interface. Typically, you use the default interface eth0. However, other interfaces may
have been configured in the hypervisor for the virtual machine.
Note that the “Network Configuration Screen“ in the web user interface supports many of the options of this command.
You may have to use the CLI if the web user interfaces is unavailable.
The command has the following syntax:

[no] interface <interfacename> <option>

<options>

dhcp

Enable DHCP on the interface or renew DHCP:

interface name eth0 dhcp

DHCP (Dynamic Host Configuration Protocol) dynamically assigns an IP address to the network interface.
Use the corresponding no command to disable DHCP:

no interface name eth0 dhcp

ip address <ip-addr> netmask <subnetmask>

Specify the static IP address and subnet mask for the interface:

interface name eth0 ip address 1.1.1.2 netmask 255.255.255.0

There is not a corresponding no version for this command.

shutdown

Shut down the interface.

interface name eth0 shutdown

Use the corresponding no command to disable dynamic DNS:

no interface name eth0 shutdown

ip default-gateway <address>

Set the default gateway for the virtual machine.

ip default-gateway 1.1.1.1

20 Riverbed SteelCentral AppInternals Version 10.0

Command Line Interface Reference

Use the corresponding no command to remove the current default gateway:

no ip default-gateway

networkcfg

Runs a script that configures multiple network settings. This command is described in detail in “Configuring
Networking on the Virtual Machine“ in the “Analysis Server Installation“ documentation.

no

Disable a feature or return a setting to its default value.

no { configure | interface | ip }

no configure

Exit configuration-mode and return to enable-mode. This command has the same effect as the configuration-mode
“exit“ command.

appinternals (config) # no configure
appinternals #

no interface

See the “interface <interfacename>“ command for details on which options allow the no syntax.

no ip default-gateway

Remove the current default gateway:

no ip default-gateway

partition disk

Partition an unpartitioned disk that has been added to the virtual machine and makes the storage available for
AppInternals data.
The partition disk command automatically adds the new storage to the logical volume on which the /mnt/data
filesystem is mounted. The added storage is available for AppInternals data without further configuration.
See “Adding Data Storage“ for more details.

passwd <newpassword>

Set a new the password for the admin user.

appinternals (config) # passwd mynewpassword
Password changed

Riverbed SteelCentral AppInternals Version 10.0 21