Jatp Cli Reference Guide
Jatp Cli Reference Guide
Jatp Cli Reference Guide
Modified: 2019-03-13
Juniper Networks, the Juniper Networks logo, Juniper, and Junos are registered trademarks of Juniper Networks, Inc. in the United States
and other countries. All other trademarks, service marks, registered marks, or registered service marks are the property of their respective
owners.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify,
transfer, or otherwise revise this publication without notice.
The information in this document is current as of the date on the title page.
Juniper Networks hardware and software products are Year 2000 compliant. Junos OS has no known time-related limitations through the
year 2038. However, the NTP application is known to have some difficulty in the year 2036.
The Juniper Networks product that is the subject of this technical documentation consists of (or is intended for use with) Juniper Networks
software. Use of such software is subject to the terms and conditions of the End User License Agreement (“EULA”) posted at
https://support.juniper.net/support/eula/. By downloading, installing or using such software, you agree to the terms and conditions of
that EULA.
ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
set honeypot (collector mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
set traffic-monitoring (for JATP700 Appliances only) (collector
mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
set traffic-filter (collector mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
set protocols (collector mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
set proxy (collector mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
set (diagnosis mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
set appliance-type (server mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
set ip interface (server mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
set (server mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
set system-alert (server mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
setupcheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
show (collector mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
show (collector mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
show (core mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
show (diagnosis mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
traceroute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
updateimage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Configuration Wizard for the All-in-One Server . . . . . . . . . . . . . . . . . . . . . . . . 51
Core/CM Server CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Basic Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
CM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Core Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Server Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Diagnosis Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
CoreCM CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
capture-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
cm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
diagnosis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
gssreport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
ifrestart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
set (core mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
set system-alert (server mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
If the information in the latest release notes differs from the information in the
documentation, follow the product Release Notes.
Juniper Networks Books publishes books by Juniper Networks engineers and subject
matter experts. These books go beyond the technical documentation to explore the
nuances of network architecture, deployment, and administration. The current list can
be viewed at https://www.juniper.net/books.
Documentation Conventions
Caution Indicates a situation that might result in loss of data or hardware damage.
Laser warning Alerts you to the risk of personal injury from a laser.
Table 2 on page xii defines the text and syntax conventions used in this guide.
Bold text like this Represents text that you type. To enter configuration mode, type the
configure command:
user@host> configure
Fixed-width text like this Represents output that appears on the user@host> show chassis alarms
terminal screen.
No alarms currently active
Italic text like this • Introduces or emphasizes important • A policy term is a named structure
new terms. that defines match conditions and
• Identifies guide names. actions.
• Junos OS CLI User Guide
• Identifies RFC and Internet draft titles.
• RFC 1997, BGP Communities Attribute
Italic text like this Represents variables (options for which Configure the machine’s domain name:
you substitute a value) in commands or
configuration statements. [edit]
root@# set system domain-name
domain-name
Text like this Represents names of configuration • To configure a stub area, include the
statements, commands, files, and stub statement at the [edit protocols
directories; configuration hierarchy levels; ospf area area-id] hierarchy level.
or labels on routing platform • The console port is labeled CONSOLE.
components.
< > (angle brackets) Encloses optional keywords or variables. stub <default-metric metric>;
# (pound sign) Indicates a comment specified on the rsvp { # Required for dynamic MPLS only
same line as the configuration statement
to which it applies.
[ ] (square brackets) Encloses a variable for which you can community name members [
substitute one or more values. community-ids ]
GUI Conventions
Bold text like this Represents graphical user interface (GUI) • In the Logical Interfaces box, select
items you click or select. All Interfaces.
• To cancel the configuration, click
Cancel.
> (bold right angle bracket) Separates levels in a hierarchy of menu In the configuration editor hierarchy,
selections. select Protocols>Ospf.
Documentation Feedback
We encourage you to provide feedback so that we can improve our documentation. You
can use either of the following methods:
• Online feedback system—Click TechLibrary Feedback, on the lower right of any page
on the Juniper Networks TechLibrary site, and do one of the following:
• Click the thumbs-up icon if the information on the page was helpful to you.
• Click the thumbs-down icon if the information on the page was not helpful to you
or if you have suggestions for improvement, and use the pop-up form to provide
feedback.
Technical product support is available through the Juniper Networks Technical Assistance
Center (JTAC). If you are a customer with an active J-Care or Partner Support Service
support contract, or are covered under warranty, and need post-sales technical support,
you can access our tools and resources online or open a case with JTAC.
• JTAC hours of operation—The JTAC centers have resources available 24 hours a day,
7 days a week, 365 days a year.
• Find solutions and answer questions using our Knowledge Base: https://kb.juniper.net/
To verify service entitlement by product serial number, use our Serial Number Entitlement
(SNE) Tool: https://entitlementsearch.juniper.net/entitlementsearch/
• Visit https://myjuniper.juniper.net.
• Preface on page 17
• Introduction on page 19
• All-in-One CLI Commands on page 25
• Core/CM Server CLI Commands on page 52
• Mac OS X Engine CLI Commands on page 75
• Traffic Collector CLI Commands on page 95
• Glossary of Terms on page 118
Preface
This guide is intended for system administrators responsible for deploying, operating,
and maintaining the Juniper ATP Appliance.
Organization
This guide is organized as follows:
• “Mac OS X Engine CLI Commands” on page 75—Provides information about Mac Mini
Mac OS X Detection Engine-specific commands for configuration and status monitoring.
• “Traffic Collector CLI Commands” on page 95—Provides information about the Juniper
ATP Appliance Traffic Collector commands available for identifying, monitoring, and
configuring distributed Collector hardware, software and virtual appliances.
Typographical Conventions
This guide uses the following typographical conventions for special terms and instructions.
courier font Coding examples and text to be entered at Enter the following command:
the command prompt
Click server set dns
A left-mouse button click.
Click Download IVP to perform endpoint
infection verification.
Double-click A double-click of the left mouse button. Double-click the report name to open in
the integrated SIEM application.
Right-click A right mouse button click. Right-click on the icon to view its
properties.
< | > (text in angle brackets; items Option for selection of required parameter interfaces set stp <on | off >
separated by the pipe symbols) and/or value.
[ ] (text in square brackets) Optional parameters and values, with show device alarm [cpu_util | paging]
selection options separated by the pipe
or symbol.
Related Documentation
The following is a list of additional Juniper ATP Appliance documentation:
• Juniper ATP Appliance Release Notes— Describes the latest release of the Juniper ATP
Appliance software.
• Juniper ATP Appliance Quick Start Guides— Quick Starts describe how to install and
initially configure a Juniper ATP Appliance; refer to the Quick Start for your device or
model.
• Juniper ATP Appliance Operator’s Guide— The Operator’s Guide describes usage of
all aspect of the Juniper ATP Appliance All-in-One or distributed defense system.
• Juniper ATP Appliance CEF/SYSLOG Support for SIEM — This guide provides
information about Juniper ATP Appliance CEF and Syslog Logging for SIEM.
• Juniper ATP Appliance Safety and Regulatory Guide—Contains conformance and safety
information for Juniper ATP Appliances.
• Juniper ATP Appliance HTTP API Reference Guide— Provides Juniper ATP Appliance
HTTP API functions and information about usage.
Introduction
This chapter explains how to use the Juniper ATP Appliance command line interface
(CLI) to configure and administer a Juniper ATP Appliance.
1. Connect the end of the keyboard cable to any of the USB ports on the back panel of
the appliance.
2. Connect the end of the video monitor cable to the VGA port on the back panel of the
appliance.
3. At the CLI prompt, enter your username and password. By default, the admin user
name is admin and the password is 1JATP234.
Be sure to change the default password for the admin account after initial setup; the
password must be at least 8 characters in length.
NOTE: Enter CTRL-C to exit the Configuration Wizard at any time. If you exit
without completing the configuration, you will be prompted again whether
to run the Configuration Wizard.
You may also rerun the Configuration Wizard at any time with the CLI
command wizard.
Configuration Wizard Prompts Customer Response from Customer Response from Core Customer Response
All-in-One or Mac Mini from Collector
Use DHCP to obtain the IP We strongly discourage the use We strongly discourage the use We strongly discourage
address and DNS server address of DHCP addressing because it of DHCP addressing because it the use of DHCP
for the administrative interface changes dynamically. A static changes dynamically. A static addressing because it
(Yes/No)? IP address is preferred. IP address is preferred. changes dynamically. A
static IP address is
NOTE: Only if your DHCP Recommended: Recommended: preferred.
response is no,enter the
following information when Respond with no: Respond with no: Recommended:
prompted:
a. Enter an IP address a. Enter an IP address Respond with no:
a. IP address b. Enter a netmask using the b. Enter a netmask using the
form 255.255.255.0. form 255.255.255.0. a. Enter an IP address
b. Netmask
c. Enter a gateway IP address. c. Enter a gateway IP address. b. Enter a netmask
c. Enter a gateway IP address
using the form
for this management d. Enter the DNS server IP d. Enter the DNS server IP
255.255.255.0.
(administrative) interface: address address
c. Enter a gateway IP
d. Enter primary DNS server IP e. If yes, enter the IP address e. If yes, enter the IP address
address.
address. of the secondary DNS of the secondary DNS
server. server. d. Enter the DNS server
e. Do you have a secondary
IP address
DNS Server (Yes/No). f. Enter yes if you want DNS f. Enter yes if you want DNS
lookups to use a specific lookups to use a specific e. If yes, enter the IP
f. Do you want to enter the
domain. domain. address of the
search domains?
secondary DNS
g. Enter the search domain g. Enter space domain(s) g. Enter space domain(s)
server.
(separate multiple search separated by spaces; for separated by spaces; for
example: example.com example: example.com f. Enter yes if you want
domains by space):
lan.com dom2.com lan.com dom2.com DNS lookups to use a
Restart the administrative specific domain.
interface (Yes/No)? Enter yes to restart with the Enter yes to restart with the g. Enter space
new configuration settings new configuration settings domain(s) separated
applied. applied. by spaces; for
example:
example.com
lan.com dom2.com
Enter a valid hostname (enter a Type a hostname when Type a hostname when Type a hostname when
unique name) prompted; do not include the prompted; do not include the prompted; do not include
domain; for example: domain; for example: the domain; for example:
NOTE: Only alpha-numeric
characters and hyphens (in the juniperatp1 juniperatp1 juniperatp1
middle of the hostname) are
allowed.
[OPTIONAL] If the system Refer to “Configuring an Refer to “Configuring an [Traffic Collectors do not
detects a Secondary Core with Alternate Analysis Engine Alternate Analysis Engine send or receive Core
an eth3 port, then the alternate Interface” in the Juniper ATP Interface” in the Juniper ATP analysis engine CnC
CnC exhaust option is displayed: Appliance Operator’s Guide for Appliance Operator’s Guide for network traffic, so no
more information. more information. eth2 interface is
Use alternate-exhaust for the needed.]
analysis engine exhaust traffic Enter yes to configure an Enter yes to configure an
(Yes/No)? alternate eth2 interface. alternate eth2 interface.
Enter IP address for the Enter the IP address for the Enter the IP address for the
alternate-exhaust (eth2) eth2 interface. eth2 interface.
interface:
Enter the eth2 netmask. Enter the eth2 netmask.
Enter netmask for the
alternate-exhaust (eth2) Enter the gateway IP address. Enter the gateway IP address.
interface: (example:
255.255.0.0) Enter the primary DNS server Enter the primary DNS server
IP Address for the IP Address for the
Enter gateway IP Address for alternate-exhaust (eth2) alternate-exhaust (eth2)
the alternate-exhaust (eth2) interface. interface.
interface: (example:10.6.0.1)
Enter yes or no to confirm or Enter yes or no to confirm or
Enter primary DNS server IP deny an eth2 secondary DNS deny an eth2 secondary DNS
Address for the server. server.
alternateexhaust (eth2)
interface: (example: 8.8.8.8) Enter yes or no to indicate Enter yes or no to indicate
whether you want to enter whether you want to enter
Do you have a secondary DNS search domain. search domain.
server for the alternate-exhaust
(eth2) interface?
Regenerate the SSL self-signed Enter yes to create a new SSL Enter yes to create a new SSL Not applicable to
certificate (Yes/No)? certificate for the Juniper ATP certificate for the Juniper ATP Collector.
Appliance Server Web UI. Appliance Server Web UI.
Enter the following server Enter Yes; the system will Enter Yes; the system will Enter Yes; the system
attributes: auto-set IP 127.0.0.1 as the auto-set IP 127.0.0.1 as the will auto-set IP 127.0.0.1
All-in- One IP address. All-in- One IP address. as the All-in- One IP
Is this a Central Manager device: address.
Enter the Juniper ATP Enter the Juniper ATP
Device Name: (must be unique) Appliance Collector Host Appliance Collector Host Enter the Juniper ATP
Name; this identifies the Name; this identifies the Appliance Collector Host
Device Description
Collector in the Web UI. Collector in the Web UI. Name; this identifies the
Collector in the Web UI.
Device Key PassPhrase
Enter a device Description Enter a device Description
Enter a device
NOTE: Remember this
Enter a user-defined Enter a user-defined Description
passphrase and use it for all
PassPhrase to be used to PassPhrase to be used to
distributed devices!
authenticate the Core to the authenticate the Core to the Enter a user-defined
Central Manager. Central Manager. PassPhrase to be used
to authenticate the Core
to the Central Manager.
To access the Juniper ATP Appliance CLI over the management network:
1. Start a terminal window session and use the ssh command to access the appliance.
For example, if the IP address of the appliance is 10.1.1.2, enter the following command:
xssh admin@10.1.1.2
2. When prompted, enter your password. By default, the admin user name is admin and
the password is 1JATP234.
# wizard
For context-sensitive help, alternatively, enter a “?” to display either a list of possible
command completions with summaries, or the full syntax of the current command. A
subsequent repeat of this key, when a command has been resolved, will display a detailed
reference, as described below.
• Enter “?” at the prompt to display a list of the available commands in the current mode.
• Enter “?” after you type a command to display its available options and parameters.
• Enter “?” after a partially typed keyword to display command matches for
auto-completions
You can enter commands in abbreviated form if you enter enough characters to uniquely
identify each keyword. For example, the show interface command can be abbreviated
as:
sh in
To identify a command’s minimum abbreviation, type a few characters then press Tab.
When you have entered enough characters, the keyword is completed.
Exit mode or logout exit Exit current mode or exit the CLI session.
You must enclose non-alphabet characters in double quotes in CLI commands; for
example:
CLI Modes
The CLI commands that you can enter depend on your user privileges and the CLI
command mode. User roles are “admin” and “debugging.” The following table describes
the CLI command mode.
Note that the prompt in each mode includes the host name of the Juniper ATP Appliance.
Basic Mode Monitor system operation and issue basic system commands. This is the Enter exit to log out of the
default login mode. The following prompt is displayed: CLI.
JATP#
CM Mode Monitor system history and upgrades from the Core or vCore in cm Enter exit to leave cm
(Central Manager) mode. mode.
JATP_Hostname# cm
JATP_Hostname (cm)# ?
Core Configuration To access Core configuration mode in the Core/CM, All-in- One, and Mac Enter exit to leave server
Mode Mini, enter “core” in Basic mode. The prompt changes to indicate the mode.
mode in parentheses:
JATP_Hostname# core
JATP_Hostname (core)# ?
Collector Configuration Configure the Juniper ATP Appliance Collector (includes all commands). Enter exit to leave server
Mode To access Collector configuration mode, enter “collector” in Basic mode. mode.
The prompt changes to indicate the mode in parentheses:
JATP_Hostname# collector
JATP_Hostname (collector)# ?
Diagnosis Packet Check Initial Setup, Diagnose, Monitor, Set GSS, and Configure the Juniper Enter exit to leave
Capture, Monitoring, ATP Appliance (includes all commands). To access Diagnosis mode, diagnosis mode.
GSS Reporting and enter “diagnosis” in Basic mode. The prompt changes to indicate the
Configuration Mode mode in parentheses:
JATP_Hostname# diagnosis
JATP_Hostname (diagnosis)# ?
Server Configuration Set up and monitor the system (includes all Basic commands plus Enter exit to leave server
Mode server-specific commands). To access Server configuration mode, enter mode.
“server” in Basic mode. The prompt changes to indicate the mode in
parentheses:
JATP-Hostname# server
JATP-Hostname (server)# ?
Wizard Configuration Configure the system during installation and setup the management Enter exit to leave wizard
Mode network and connected Juniper ATP Appliance components. To access mode.
wizard configuration mode, enter “wizard” in Basic mode. The prompt
changes to indicate the mode in parentheses:
JATP-Hostname# wizard
JATP-Hostname (wizard)# ?
This chapter describes the administration commands for a Juniper ATP Appliance
All-in-One server appliance, software appliance or virtual appliance.
These commands are used to configure the Juniper ATP Appliance All-in-One appliance,
manage configurations, and set system-level settings for interfaces, network services,
and SIEM integration.
• cm on page 29
• core on page 30
• collector on page 29
• diagnosis on page 31
• exit on page 31
• help on page 33
• history on page 33
• server on page 36
• wizard on page 50
Refer to the sections in this guide to review CM Mode, Collector Mode, Core Mode,
Diagnosis Mode, Server Mode and Wizard mode commands per device-- All-in-One,
CoreCM, Traffic Collector and Mac OS X Detection Engine on a Mac Mini.
CM Commands
• exit on page 31
• help on page 33
• history on page 33
• upgrade on page 49
• help on page 33
• history on page 33
• updateimage on page 50
• help on page 33
• history on page 33
• ifrestart on page 34
• ping on page 34
• reboot on page 35
• restart on page 35
• [Unresolved xref]
• shutdown on page 48
• shutdown on page 48
• traceroute on page 49
• help on page 33
• history on page 33
• copy on page 30
• exit on page 31
• gssreport on page 32
• help on page 33
• history on page 33
• setupcheck on page 44
• diagnosis on page 31
• exit on page 31
• gssreport on page 32
• help on page 33
• history on page 33
• ifrestart on page 34
• ping on page 34
• reboot on page 35
• restart on page 35
• server on page 36
• set honeypot (collector mode) on page 37
• set traffic-monitoring (for JATP700 Appliances only) (collector mode) on page 37
• set traffic-filter (collector mode) on page 38
• set protocols (collector mode) on page 38
• set proxy (collector mode) on page 39
• set (diagnosis mode) on page 40
• set appliance-type (server mode) on page 41
• set ip interface (server mode) on page 41
• set (server mode) on page 42
• set system-alert (server mode) on page 44
• setupcheck on page 44
• show (collector mode) on page 45
• show (collector mode) on page 46
• show (core mode) on page 46
• show (diagnosis mode) on page 47
• shutdown on page 48
• traceroute on page 49
• upgrade on page 49
• updateimage on page 50
• wizard on page 50
capture-start
Table 5: capture-start
Description Starts packet capture as a means for diagnosing and debugging network traffic
and obtaining stats.
Mode(s) Diagnosis
Syntax capture-start
Sub-Commands None
Example The following example starts a packet capture process on interface eth1 for a
Traffic Collector with IP address 8.8.8.8:
hostname # diagnosis
NOTE: Note: Address 8.8.8.8 need not be a Juniper ATP Appliance. It is just a
host that the capture filters on.
cm
Table 6: cm
Mode(s) Basic
Syntax cm
Parameters None
hostname # cm
hostname (cm)#
collector
Table 7: collector
Mode(s) Basic
Syntax collector
Parameters None
Sub-Commands “exit” on page 31;“help” on page 33;“history” on page 33;“set (server mode)” on
page 42;“show (collector mode)” on page 45
hostname # collector
hostname (collector)# ?
copy
Table 8: copy
Description Uses Secure Copy (SCP) to copy and transfer packet capture or traceback (crash)
data to a remote location, providing the same authentication and level of security
as an SSH transfer.
The copy traceback command, upon Customer Support's request, copies the
traceback files out of the box to a remote location.
Mode(s) Diagnosis
Sub-Commands None
Example The following example copies the file "Eth1.txt" from the local host to a remote host:
admin@remotehost.edu:/some/remote/directory
core
Table 9: core
Mode(s) Basic
Syntax core
Parameters None
hostname # core
hostname (core)#
diagnosis
Mode(s) Basic
Syntax diagnosis
Parameters None
Example The following example enters diagnosis configuration and status check mode:
hostname # diagnosis
hostname (diagnosis)# ?
exit
Syntax exit
Parameters None
JATP#
JATP# exit
gssreport
Description Use the gssreport command to submit reports to Juniper Global Security Services
(GSS), and to display the status of the current GSS report.
Mode(s) diagnosis
Sub-Commands None
Example The following examples display the status of a GSS report submission:
hostname # diagnosis
hostname (diagnosis)# gssreport submit
Successfully started GSS report
help
Syntax help
Parameters None
Example The following example shows some of the output of the help command.
AUTO-COMPLETION
The following keys both perform auto-completion for the current command line.
If the command prefix is not unique then the bell will ring and a subsequent
repeat of the key will display possible completions.
If “<cr>” is shown, that means that what you have entered so far is a complete
command, and you may press Enter (carriage return) to execute it.
history
Syntax history
Parameters None
Example The following examples returns command line history for the current CLI session.
ifrestart
Description Restarts the interface driver and services using the interface.
Mode(s) Server
Parameters
eth0 Restarts the management network administra interface.
Example The following example restarts the eth0 interface for the management network.
ping
Description Sends ICMP (Internet Control Message Protocol) echo request packets to a specified host
name or IP address to verify that the destination is reachable over the network.
Mode(s) Server
Parameters
-ccount Number of echo requests to send. By default, pings ar continuou
Ctrl+C.
Example The following example sends three echo requests to the device with the IP Address
10.10.10.1
reboot
Mode(s) Server
Syntax reboot
Parameters None
hostname# reboot
restart
Mode(s) Server
Parameters
all Restarts all Juniper ATP Appliance services.
JATP# restart cm
server
Mode(s) Basic
Syntax server
Sub-Commands “exit” on page 31; “help” on page 33; “history” on page 33; “ifrestart” on page 34;
“ping” on page 34; “reboot” on page 35; [Unresolved xref]; “set (server mode)”
on page 42; “upgrade” on page 49
hostname # server
hostname (server) # ?
Description Enables and disables the SSH-Honeypot feature for a Traffic Collector.
• Enable/disable a honeypot
• Set a Static IP (IP, mask, and gateway) or DHCP of a publicly addressable
interface
Mode(s) collector
Example The following example enables the SMB parser for lateral detections:
NOTE: The static IP configuration does not require configuring DNS. Honeypots do
not require a DNS server at this time.
Mode(s) collector
NOTE: After making an interface type change, the system must be rebooted for
the change to take effect.
Description Sets traffic filter rules to avoid analysis on a set of configured traffic, which cannot be made
retroactive; for example: any analysis skipped as a result of the filtering cannot be reversed.
This command can be applied to an entire network/subnet/ CIDR range.
See Also:“set (server mode)” on page 42;“show (diagnosis mode)” on page 47 [show
traffic-filter]
Mode(s) collector
Parameters
traffic-filter add Adds a traffic filter rule where:
Example The following example add a traffic filter rule to the Traffic Collector.
Description Enables and disables the HTTP or SMB parser for a Traffic Collector.
Mode(s) collector
Example The following example enables the SMB parser for lateral detections:
Description Sets an Inside or Outside data path proxy from collector mode.
Deploy Traffic Collectors in locations where the monitoring interface is (1) placed
“outside” between the proxy and the egress network for customer environments in
which the proxy supports XFF (X-Forwarded-For), or (2) [the more typical deployment
scenario], the Collector is placed between the proxy and the internal network using
FQDN (if available) to identify the threat source for all types of incidents (“inside”
proxy). When configured, the Juniper ATP Appliance Traffic Collector will monitor all
traffic and correctly identify source and destination hosts for each link in the kill chain
wherever the data allows for it.
Note that if the “X-Forwarded-For” header is provided in the HTTP request, detection
will identify threat targets when deployed outside of the proxy (customers can choose
to disable the XFF feature in the proxy setting, if desired).
See Also: “set (server mode)” on page 42[“set proxy” command for management
network]; “set (diagnosis mode)” on page 40;
NOTE: The mitigation IP address of a CNC server is not be available for Inside proxy
deployments. When a Juniper ATP Appliance is deployed behind a proxy, the
Mitigation-> Firewall page in the Juniper ATP Appliance Central Manager Web UI (which
typically displays the CNC server IP address to mitigate) will be empty. The destination
IP address of any callback is made to the proxy server ip address, so it is not relevant
to display the proxy server IP address on the Mitigation->Firewall page.
Mode(s) collector
Syntax set proxy inside {add <proxy IP address> <proxy port> | remove <proxy IP address>
<proxy port>
Parameters
inside Sets the inside proxy IP addresses
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis
mode.
Mode(s) diagnosis
Parameters
all Sets logging for all Juniper ATP Appliance components.
Example The following example sets the default logging level for all Juniper ATP Appliance
components.
Description Change the appliance type at any time. For example, change from All-In-One to
Core/CM. Note that if you change the appliance type after the initial installation,
all data files related to the current type are lost and you must set up the appliance
as you would a fresh box.
Mode(s) server
Parameters
all-in-one
core-cm
email-collector
traffic-collector
Example The following example changes the form factor of the appliance from all-in-one
(the default) to core-cm:
Description Sets the management interface (eth0) and/or the alternate-exhaust interface
(eth2) for the Juniper ATP Appliance.
Refer to the Operator’s Guide for information about configuring the optional
alternate analysis engine eth2 interface option (it moves CnC traffic during analysis
engine processing off the enterprise’s eth0 management network).
Mode(s) server
Parameters
dhcp Enables DHCP for the management or alternate-exhaust interface.
address Sets the static IP address for the management (eth0) or lternate-exhau
netmask Sets the netmask for the management network or the alternate-exhaus
gateway Sets the Gateway IP address for the management interfac or the option
network.
Example The following example configures the management interface (eth0) for a Juniper
ATP Appliance Core device:
The following example configures the management interface (eth0) using DHCP:
This example configures the alternate-exhaust interface (eth2) for a Juniper ATP
Appliance Core device:
Mode(s) Server, See Also:“set (diagnosis mode)” on page 40;“set traffic-filter (collector
mode)” on page 38
Syntax set [autoupdate {on | off} | cli timeout secs | clock | cm address | support
{enable | disable} localmode {enable | disable}| passphrase string | dns |
firewall {all <backup | flush> | whitelist} | hostname string | ip interface
{management | alternate-exhaust}| ntpserver | password | proxy {config |
enabled | remove} | timezone string | uipassword]
Parameters Note: vCore for AWS does not use the following CLI commands:
set hostname
[Users cannot set static IP address or change the hostname directly on an EC2
AWS instance]
server mode “set proxy” command is a management network proxy tool; for data
path Collector proxy configurations, refer to
autoupdate {content | software} {on | Turn on or off automatic product updates. set autoupdate content on
off}
Sets CLI timeout period in seconds (0 indicates no timeout).
cli timeout secs
Sets the current date and time.
clock
cm address Sets the IP address of the Central Manager and netmask using the slash notation;
example: AAA.BBB.CCC.DD/X
set support {enable | disable} |
{localmode} Enables remote SSH login “support” account or localmode enable|/disable.
dns
Sets DNS (or enables DHCP for DNS) for the management interface by default
firewall {all <backup | flush> | whitelist if interface is unspecified.
<add | delete | flush>}
Backs up or flushes (clears) all current iptables for a firewall, or adds, deletes or
hostname string flushes the current iptables whitelist-specific settings for the firewall.
ip interface {management |
The “add” option adds an IP address to the iptables outbound whitelist.
alternateexhaust} <dhcp | address |
netmask | gateway}
# set firewall whitelist add 10.1.1.1
Sets the IP address, netmask, or default gateway, or enables DHCP for the
management or alternate-exhaust interface.
proxy {config <all|http> | enabled Config, enable/disable, or remove “all” proxy configs, or remove an HTTP-specific
<on|off> | remove <all|http>} proxy server.
TIP: Tip: Config the proxy for “all” protocols first, and then change HTTP proxy
as needed.
Description Configure the traffic threshold and checking interval for the Collector “monitored
traffic” health status.
When the monitored traffic of a collector within the checking interval time is lower
than the threshold, a system health alert is generated. You can send an email
notification of the alert if email notifications of system health events are configured.
Mode(s) Server, See Also:“set (diagnosis mode)” on page 40;“set traffic-filter (collector
mode)” on page 38; show
NOTE: Note that both "traffic" and "time" parameters are required in order to set
the threshold for both the minimum traffic and time.
Parameters
traffic - the minimum traffic (in KB)
This example sets the system alert such that, if the total monitored traffic of a
collector within the last 30 minutes dips lower than 100KB, then a system health
alert will be generated (and users will receive an email notification of the alert if
email notifications are configured for system health events).
By default this alert is disabled, and users must set the minimum traffic and interval
in order to enable it. Also note that all bytes seen on Ethernet frames are counted
in the traffic.
The minimum interval for the "set system-alert traffic" time interval command is
10 minutes. If the minimum interval is set to less than 10 minutes, no alerts will be
triggered.
setupcheck
Description Checks and reports on basic configuration settings and analysis pipeline setup.
Mode(s) diagnosis
Parameters
all Checks both basic settings and analysis pipelin
Example The following example checks all basic configuration settings as well as the analysis
pipeline:
Description Displays the Traffic Collector HOMENET settings and all configured subnets, as well
as current traffic filters and the current XFF status (enabled or disabled)
Mode(s) Collector
Syntax show
Parameters
traffic-filter Shows all traffic filter rules.
proxy {inside|outside} Shows Traffic Collector proxy for inside or outside configu
Example The following example displays the current Collector proxy inside settings:
The following example displays the current SMB protocol parser setting:
Mode(s) Collector
Mode(s) Core
Syntax show
Parameters
images Displays guest image update and status information.
whitelist Displays the name, hit count and the time of last hit of a user configured whit
Note that when a whitelist rule is deleted, it will be removed from the list. Upd
are not affected by the presence of the rule in the output, but hit count could
more than one rule can be hit by a single incident.
Example The following example demonstrates the show images command usage:
The following example shows how to get the alternate-exhaust interface (eth2)
status:
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis mode.
Mode(s) diagnosis
Syntax show
Parameters
device {collectorstatus | | Display connected device statistics for Traffic Collector, CoreCM, or Mac
corestatus | slavecorestatus} Secondary “slave core.”
protocol {web | email} Displays the session counts for network web or email protocols.
log error traceback Displays only the tracebacks (if any) generated by Juniper ATP Applian
logs. A traceback is a stack of functions that were executing when an e
encountered.
log error last <integer: number Displays n [1-1000] lines of the contents of the common log file.
of lines to display>
Example The following example displays the connected Traffic Collector status.
IP : 10.2.9.68
Enabled : True
Last Seen : 2015-07-25 15:13:17.967000-07:00
Install Date : 2015-06-25 19:03:38-07:00
IP : 10.2.20.3
Enabled : True
Last Seen : 2015-07-28 11:07:42.046000-07:00
Install Date : 2013-11-14 09:25:39-08:00
shutdown
Mode(s) Server
Syntax shutdown
Parameters None
JATP# shutdown
traceroute
Syntax traceroute
Parameters
-h unsigned integer Specifies the number of hops
upgrade
Description Upgrade Juniper ATP Appliance software for the Core/CM device or vCore, and all
connected physical or virtual devices.
Mode(s) cm
Parameters
<String_URI> Specifies the software packages to copy .from a remo location for upgra
Example The following example copies Juniper ATP Appliance software to the Core from a
remote location defined by the path provided.
updateimage
Description Update or correct the guest-image OS profile used by the detection and analysis
behavioral engine.
The updateimage command will update the guest images from the Juniper ATP
Appliance update servers or a USB drive attached to the Juniper ATP Appliance.
Mode(s) Core
Syntax updateimage
Parameters
built-in Updates the guest-image on the detection Engine
Example The following example performs a built-in profile update for the Core detection
engine.
wizard
Description Enters the Configuration Wizard. For Configuration Wizard commands and response,
see “Configuration Wizard for the All-in-One Server” in the next section to follow
command prompts and recommended responses.
Mode(s) Basic
Syntax wizard
Parameters None
hostname # wizard
Use DHCP to obtain the IP address and DNS server address for We strongly discourage the use of DHCP addressing because
the administrative interface (Yes/No)? it changes dynamically. A static IP address is preferred.
Note: Only if your DHCP response is no ,enter the following Recommended: Respond with no:
information when prompted:
a. Enter an IP address
a. IP address (no CIDR format) b. Enter a netmask using the form 255.255.255.0.
b. Netmask c. Enter a gateway IP address.
c. Enter a gateway IP address for this management d. Enter the DNS server IP address
(administrative) interface:
e. If yes enter the IP address of the secondary DNS server.
d. Enter primary DNS server IP address.
f. Enter yes if you want DNS lookups to use a specific domain.
e. Do you have a secondary DNS Server (Yes/No).
g. Enter search domain(s) separated by spaces; for example:
f. Do you want to enter the search domains? example.com lan.com dom2.com
g. Enter the search domain (separate multiple search domains
by space): Enter yes to restart with the new configuration settings
applied.
Restart the administrative interface (Yes/No)?
Enter a valid hostname. Type a hostname when prompted; do not include the domain;
for example: JuniperATP1.
Enter IP address for the alternate-exhaust (eth2) interface: Enter the eth2 netmask.
Enter netmask for the alternate-exhaust (eth2) interface: Enter the gateway IP address.
(example: 255.255.0.0)
Enter the primary DNS server IP Address for the
Enter gateway IP Address for the alternateexhaust (eth2) alternate-exhaust (eth2) interface.
interface: (example:10.6.0.1)
Enter yes or no to confirm or deny an eth2 secondary DNS
Enter primary DNS server IP Address for the alternate-exhaust server.
(eth2) interface: (example: 8.8.8.8)
Enter yes or no to indicate whether you want to enter search
Do you have a secondary DNS server for the alternate-exhaust domain.
(eth2) interface?
Regenerate the SSL self-signed certificate (Yes/No)? Enter yes to create a new SSL certificate for the Juniper ATP
Appliance Server Web UI.
This chapter describes the commands for available for Juniper ATP Appliance Core/CM
or vCore servers. These commands are used to configure devices and software, manage
security events, and show system information and status.
• cm on page 29
• core on page 30
• diagnosis on page 31
• exit on page 31
• help on page 33
• history on page 33
• server on page 36
• wizard on page 50
Refer to the respective sections in this guide to review Diagnosis Mode, CM Mode, Collector
Mode and Server Mode commands per product device.
CM Commands
• exit on page 31
• help on page 33
• history on page 33
• upgrade on page 49
• help on page 33
• history on page 33
• updateimage on page 50
• help on page 33
• history on page 33
• ifrestart on page 34
• ping on page 34
• reboot on page 35
• restart on page 35
• [Unresolved xref]
• server on page 36
• shutdown on page 48
• traceroute on page 49
• upgrade on page 49
• copy on page 30
• exit on page 31
• gssreport on page 32
• help on page 33
• history on page 33
• setupcheck on page 44
• updateimage on page 73
• wizard on page 73
capture-start
Description Starts packet capture as a means for diagnosing and debugging network traffic and obtaining
stats.
Mode(s) Diagnosis
Syntax capture-start
Sub-Commands None
Example The following example starts a packet capture process on interface eth1 for a Traffic Collector
with IP address 8.8.8.8:
hostname # diagnosis
NOTE: Note: Address 8.8.8.8 need not be a Juniper ATP Appliance. It is just a host that the
capture filters on.
cm
Table 41: cm
Mode(s) Basic
Syntax cm
Parameters None
hostname # cm
hostname (cm)#
core
Mode(s) Basic
Syntax core
Parameters None
hostname # core
hostname (core)#
copy
Description Uses Secure Copy (SCP) to copy and transfer packet capture or traceback (crash) data to a remote
location, providing the same authentication and level of security as an SSH transfer.
The copy traceback command, upon Customer Support's request, copies the traceback files out
of the box to a remote location.
Mode(s) Diagnosis
Sub-Commands None
Example The following example copies the file "Eth1.txt" from the local host to a remote host:
admin@remotehost.edu:/some/remote/directory
diagnosis
Mode(s) Basic
Syntax diagnosis
Parameters None
Sub-Commands “capture-start” on page 55; “copy” on page 30; “exit” on page 31; “gssreport” on
page 32;“help” on page 33;“history” on page 33;“set (server mode)” on
page 42;“setupcheck” on page 44;“show (diagnosis mode)” on page 47;“show (server
mode)” on page 68
Example The following example enters diagnosis configuration and status check mode:
hostname # diagnosis
hostname (diagnosis)# ?
exit
Syntax exit
Parameters None
gssreport
Description Use the gssreport command to submit reports to Juniper Global Security Services (GSS), and to
display the status of the current GSS report.
Mode(s) diagnosis
Sub-Commands None
Example The following examples display the status of a GSS report submission:
hostname # diagnosis
hostname (diagnosis)# gssreport submit
Successfully started GSS report
help
Syntax help
Parameters None
Example The following example shows some of the output of the help command.
history
Syntax history
Parameters None
Example The following examples returns command line history for the current CLI
session.
ifrestart
Description Restarts the interface driver and services using the interface.
Mode(s) Server
Example The following example restarts the eth0 interface for the management network.
ping
Description Sends ICMP (Internet Control Message Protocol) echo request packets to a specified host name or IP address to verify that the
destination is reachable over the network.
Mode(s) Server
Parameters
-ccount Number of echo requests to send. By default, pings ar continuously until you press Ctrl+C.
Example The following example sends three echo requests to the device with the IP Address 10.10.10.1
reboot
Mode(s) Server
Syntax reboot
Parameters None
hostname# reboot
restart
Mode(s) Server
Parameters
all Restarts all Juniper ATP Appliance services.
JATP# restart cm
Description Resets the Secondary Core UUID, if the virtual core is cloned.
Syntax set id
Sub-Commands None
Example The following example sets the Virtual Core appliance id:
hostname # core
hostname (core) # set id
<cr>
server
Mode(s) Basic
Syntax server
Sub-Commands “exit” on page 31;“help” on page 33;“history” on page 33;“ifrestart” on page 34;“ping” on
page 34;“reboot” on page 35;[Unresolved xref];“set (server mode)” on page 42;“show (server
mode)” on page 68;“traceroute” on page 49;“upgrade” on page 49
Whitelist rules rely on normal service shutdown to be backed up.Powering off a VM directly will
lose the whitelist state as rules cannot be saved in that case.
hostname # server
hostname (server) # ?
Description Configure the traffic threshold and checking interval for the Collector “monitored traffic” health status.
When the monitored traffic of a collector within the checking interval time is lower than the threshold, a
system health alert is generated. You can send an email notification of the alert if email notifications of
system health events are configured.
Mode(s) Server, See Also:“set (diagnosis mode)” on page 40; set (collector mode); show
NOTE: Note that both "traffic" and "time" parameters are required in order to set the threshold for both
the minimum traffic and time.
This example sets the system alert such that, if the total monitored traffic of a collector within the last
30 minutes dips lower than 100KB, then a system health alert will be generated (and users will receive
an email notification of the alert if email notifications are configured for system health events).
By default this alert is disabled, and users must set the minimum traffic and interval in order to enable
it. Also note that all bytes seen on Ethernet frames are counted in the traffic.
The minimum interval for the "set system-alert traffic" time interval command is 10 minutes. If the
minimum interval is set to less than 10 minutes, no alerts will be triggered.
Mode(s) Server, See Also: “set (diagnosis mode)” on page 40; “set (core mode)” on
page 62; “show (core mode)” on page 46
Syntax set [autoupdate {on | off} | cli timeout secs | clock | cm address | support
{enable | disable} localmode {enable | disable}| passphrase string | dns
| firewall {all <backup | flush> | whitelist} | hostname string | ip interface
{management | alternate-exhaust}| ntpserver | password | proxy {config
| enabled | remove} | timezone string | uipassword]
Parameters
set ip
set hostname
autoupdate {content | software} {on | off} Turn on or off automatic product updates.
Sets the IP address, netmask, or default gateway, or enables DHCP for the
management or alternate-exhaust interface.
proxy {config <all|http> | enable <on|off> Config, enable/disable, or remove “all” proxy configs, or remove an
| remove <all|http>} HTTP-specific proxy server.
TIP: Config the proxy for “all” protocols first, and then change HTTP proxy as
needed.
Description Change the appliance type at any time. For example, change from All-In-One to
Core/CM. Note that if you change the appliance type after the initial installation,
all data files related to the current type are lost and you must set up the appliance
as you would a fresh box.
Mode(s) server
Parameters
all-in-one
core-cm
email-collector
traffic-collector
Example The following example changes the form factor of the appliance from all-in-one
(the default) to core-cm:
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis mode.
Mode(s) diagnosis
Parameters
all Sets logging for all Juniper ATP Appliance components.
Example The following example sets the default logging level for all Juniper ATP Appliance
components.
setupcheck
Description Checks and reports on basic configuration settings and analysis pipeline setup.
Mode(s) diagnosis
Example The following example checks all basic configuration settings as well as the analysis pipeline:
Mode(s) Core
Syntax show
Parameters
images Displays guest image update and status information.
whitelist Displays the name, hit count and the time of last hit of a user configured whitelist.
Note that when a whitelist rule is deleted, it will be removed from the list. Updates to existing
rule are not affected by the presence of the rule in the output, but hit count could increment.
Further, more than one rule can be hit by a single incident.
Example The following example demonstrates the show images command usage:
The following example shows how to get the alternate-exhaust interface (eth2) status:
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis mode.
Mode(s) diagnosis
Syntax show
Parameters
device {collectorstatus | | corestatus | Display connected device statistics for Traffic Collector, CoreCM, or Mac Mini
slavecorestatus} Detection Engine Secondary “slave core.”
protocol {web | email} Displays the session counts for network web or email protocols.
log error traceback Displays only the tracebacks (if any) generated by Juniper ATP Appliance OS process
error logs. A traceback is a stack of functions that were executing when an error
condition was encountered.
log error last <integer: number of lines to Displays n [1-1000] lines of the contents of the common log file.
display>
Example The following example displays the connected Traffic Collector status.
IP : 10.2.9.68
Enabled : True
Last Seen : 2015-07-25 15:13:17.967000-07:00
Install Date : 2015-06-25 19:03:38-07:00
IP : 10.2.20.3
Enabled : True
Last Seen : 2015-07-28 11:07:42.046000-07:00
Install Date : 2013-11-14 09:25:39-08:00
Syntax show
Parameters
interface [management | Show information about the management (administrative) network interface eth0, or
monitoring | alternateexhaust] the monitoring interface (eth1), or the alternate-exhaust interface (eth2).
See Also: Show the IP address of the management (administrative) interface eth0.
show controller
ip Results may show both private and public IP addresses if the AWS vCore has a public
IP.
See also show (collector mode) for cpuload shows average CPU load in the system for running processes in the last 1, 5
show proxy inside/outside data path and 15 min intervals.
stats [cpuload | disk | memory] disk shows the disk space usage in the system.
TIP:
versions:
Example The following example displays information about the CoreCM server device type:
The following example requests data about the alternate-exhaust interface (eth2):
The following example shows details about the Collector’s monitoring interface (eth1):
Full
Overruns: 0
RX bits/sec: 108616/160176/442736
RX packets/sec: 44/46/91
TX bits/sec: 0/112/128
TX packets/sec: 0/0/0
shutdown
Mode(s) Server
Syntax shutdown
Parameters None
JATP# shutdown
traceroute
Mode(s) Server
Syntax traceroute
Parameters
-h unsigned integer Specifies the number of hops
upgrade
Description Upgrade Juniper ATP Appliance software for the Core/CM device or vCore, and all connected physical or virtual devices.
Mode(s) cm
Parameters
<String_URI> Specifies the software packages to copy .from a remo location for upgrading via the Core.
Example The following example copies Juniper ATP Appliance software to the Core from a remote location defined by the path provided.
updateimage
Description Update or correct the guest-image OS profile used by the detection and analysis behavioral engine.
The updateimage command will update the guest images from a USB drive attached to the Juniper ATP Appliance.
Mode(s) Core
Syntax updateimage
Parameters
built-in Updates the guest-image on the detection Engine.
Example The following example performs a built-in profile update for the Core detection engine.
wizard
Description Enters the Configuration Wizard. For Configuration Wizard commands and response, see
“Configuration Wizard for the CoreCM Server” in the next section to follow command
prompts and recommended responses.
Mode(s) Basic
Parameters wizard
Example None
hostname # wizard
NOTE: Enter CTRL-C to exit the Configuration Wizard at any time. If you exit
without completing the configuration, you will be prompted again whether
to run the Configuration Wizard.
You may also rerun the Configuration Wizard at any time with the CLI command wizard.
Use DHCP to obtain the IP address and DNS server address We strongly discourage the use of DHCP addressing because it
for the administrative interface (Yes/No)? changes dynamically. A static IP address is preferred.
NOTE: Only if your DHCP response is no,enter the following Recommended: Respond with no:
information when prompted:
a. Enter an IP address
a. IP address (no CIDR format) b. Enter a netmask using the form 255.255.255.0.
b. Netmask c. Enter a gateway IP address.
c. Enter a gateway IP address for this management d. Enter the DNS server IP address
(administrative) interface:
e. If yes, enter the IP address of the secondary DNS server.
d. Enter primary DNS server IP address.
f. Enter yes if you want DNS lookups to use a specific domain.
e. Do you have a secondary DNS Server (Yes/No).
g. Enter search domain(s) separated by spaces; for example:
f. Do you want to enter the search domains? example.com lan.com dom2.com
g. Enter the search domain (separate multiple search
domains by space): Enter yes to restart with the new configuration settings applied.
Enter a valid hostname. Type a hostname when prompted; do not include the domain;
for example: juniperatp1
Enter IP address for the alternate-exhaust (eth2) interface: Enter the eth2 netmask.
Enter netmask for the alternate-exhaust (eth2) interface: Enter the gateway IP address.
(example: 255.255.0.0)
Enter the primary DNS server IP Address for the
Enter gateway IP Address for the alternateexhaust (eth2) alternate-exhaust (eth2) interface.
interface: (example:10.6.0.1)
Enter yes or no to confirm or deny an eth2 secondary DNS server.
Enter primary DNS server IP Address for the alternate-exhaust
(eth2) interface: (example: 8.8.8.8) Enter yes or no to indicate whether you want to enter search
domain.
Do you have a secondary DNS server for the alternate-exhaust
(eth2) interface?
Regenerate the SSL self-signed certificate (Yes/No)? Enter yes to create a new SSL certificate for the Juniper ATP
Appliance Server Web UI.
Central Manager (CM) IP Address: Enter Yes; the system will auto-set IP 127.0.0.1 as the All-in-One
IP address.
Device Name: (must be unique)
Enter a connected Juniper ATP Appliance Collector Device
Device Name: (must be unique) Name; this identifies the Collector in the Web UI.
NOTE: Remember this passphrase and use it for all Enter a user-defined PassPhrase to be used to authenticate the
distributed devices. Core to the Central Manager.
This chapter describes the CLI commands available for the Mac Mini Mac OS X “Secondary
Core” detection engine device. There is no Collector Mode on this device.
• core on page 30
• diagnosis on page 31
• exit on page 31
• help on page 33
• histroy on page 82
• server on page 36
• wizard on page 50
Refer to the respective chapters in this guide to review Collector Mode, Diagnosis Mode
and Server Mode commands per device-- All-in-One, Mac OS X Engine, Traffic Collector
and CoreCM.
• help on page 33
• histroy on page 82
• updateimage on page 50
• help on page 33
• histroy on page 82
• ifrestart on page 34
• ping on page 34
• reboot on page 35
• restart on page 35
• [Unresolved xref]
• server on page 36
• shutdown on page 48
• traceroute on page 49
• copy on page 30
• exit on page 31
• gssreport on page 32
• help on page 33
• histroy on page 82
• setupcheck on page 44
• server on page 84
• set (server mode) on page 85
• set (diagnosis mode) on page 87
• setupcheck on page 87
• show (core mode) on page 88
• show (diagnosis mode) on page 89
• show (server mode) on page 89
• shutdown on page 91
• traceroute on page 91
• updateimage on page 92
• upgrade on page 93
• wizard on page 93
capture-start
Description Starts packet capture as a means for diagnosing and debugging network traffic and obtaining
stats.
Mode(s) Diagnosis
Syntax capture-start
Sub-Commands None
Example The following example starts a packet capture process on interface eth1 for a Traffic Collector
with IP address 8.8.8.8:
hostname # diagnosis
NOTE: Note: Address 8.8.8.8 need not be a Juniper ATP Appliance. It is just a host that the
capture filters on.
copy
Description Uses Secure Copy (SCP) to scp to copy and transfer packet capture or
traceback (crash) data to a remote location, providing the same authentication
and level of security as an SSH transfer.
Mode(s) Diagnosis
Sub-Commands None
Example The following example copies the file "captureEth1.txt" from the local host to
a remote host:
admin@remotehost.edu:/some/remote/directory
core
Mode(s) Basic
Syntax core
Parameters None
hostname # core
hostname (core)#
diagnosis
Mode(s) Basic
Syntax diagnosis
Parameters None
Sub-Commands “capture-start” on page 55;“copy” on page 30;“exit” on page 31; “gssreport” on page 32;
“help” on page 33; “histroy” on page 82; “set (server mode)” on page 42;“setupcheck” on
page 44; “show (diagnosis mode)” on page 47; “shutdown” on page 48
Example The following example enters diagnosis configuration and status check mode:
hostname # diagnosis
hostname (diagnosis)# ?
exit
Syntax exit
Parameters None
gssreport
Description Use the gssreport command to submit reports to Juniper Global Security Services (GSS), and to
display the status of the current GSS report.
Mode(s) diagnosis
Sub-Commands None
Example The following examples display the status of a GSS report submission:
hostname # diagnosis
hostname (diagnosis)# gssreport submit
Successfully started GSS report
help
Syntax help
Parameters None
Example The following example shows some of the output of the help command.
histroy
Syntax history
Parameters None
Example The following examples returns command line history for the current CLI
session.
ifrestart
Description Restarts the interface driver and services using the interface.
Mode(s) Server
Example The following example restarts the eth0 interface for the management
network.
ping
Description Sends ICMP (Internet Control Message Protocol) echo request packets to a specified host name or IP address to verify that the
destination is reachable over the network.
Mode(s) Server
Parameters
-ccount Number of echo requests to send. By default, pings ar continuously until you press Ctrl+C.
Example The following example sends three echo requests to the device with the IP Address 10.10.10.1
reboot
Mode(s) Server
Syntax reboot
Parameters None
hostname# reboot
restart
Mode(s) Server
Parameters
all Restarts all Juniper ATP Appliance services.
JATP# restart cm
server
Mode(s) Basic
Syntax server
Sub-Commands “exit” on page 31; “help” on page 33; “histroy” on page 82; “ifrestart” on page 34; “ping” on
page 34; “reboot” on page 35; [Unresolved xref]; “set (server mode)” on page 42; “show
(server mode)” on page 68; “traceroute” on page 49; “updateimage” on page 50
Whitelist rules rely on normal service shutdown to be backed up.Powering off a VM directly will
lose the whitelist state as rules cannot be saved in that case.
hostname # server
hostname (server) # ?
Syntax set [autoupdate {on | off} | cli timeout secs | clock | cm address | support
{enable | disable} localmode {enable | disable}| passphrase string | dns
| firewall {all <backup | flush> | whitelist} | hostname string | ip interface
{management | alternate-exhaust}| ntpserver | password | proxy {config
| enabled | remove} | timezone string | uipassword]
Parameters
autoupdate {content | software} {on | off} Turn on or off automatic product updates.
firewall {all <backup | flush> | whitelist Sets the device key password; enter a string.
<add | delete | flush>}
Sets DNS (or enables DHCP for DNS) for the management interface by default
NOTE: Whitelist rules rely on normal service
if interface is unspecified.
shutdown for backup.Powering off a VM
directly loses the whitelist state as rules
Backs up or flushes (clears) all current iptables for a firewall, or adds, deletes
cannot be saved in that case.
or flushes the current iptables whitelist-specific settings for the firewall.
hostname string
The “add” option adds an IP address to the iptables outbound whitelist.
ip interface {management |
alternateexhaust} <dhcp | address | # set firewall whitelist add 10.1.1.1
netmask | gateway}
Sets the system’s host name.
Sets the IP address, netmask, or default gateway, or enables DHCP for the
management or alternate-exhaust interface.
proxy {config <all|http> | enable <on|off> Config, enable/disable, or remove “all” proxy configs, or remove an
| remove <all|http>} HTTP-specific proxy server.
TIP: Config the proxy for “all” protocols first, and then change HTTP proxy as
needed.
timezone {US/ Eastern | US/ Central | US/ Show the current timezone; example:
Mountain
set timezone US/Pacific
Examples The following example sets an ip address for the device management interface
eth0.
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis mode.
Mode(s) diagnosis
Parameters
all Sets logging for all Juniper ATP Appliance components.
Example The following example sets the default logging level for all Juniper ATP Appliance
components.
setupcheck
Description Checks and reports on basic configuration settings and analysis pipeline setup.
Mode(s) diagnosis
Parameters
all Checks both basic settings and analysis pipelin.
Example The following example checks all basic configuration settings as well as the analysis
pipeline:
See Also: “show (server mode)” on page 68; show (diagnostic mode)
Mode(s) Core
Syntax show
Parameters
images Displays guest image update a
Example The following example demonstrates the show images command usage:
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis
mode.
Mode(s) diagnosis
Syntax show
Parameters
device {collectorstatus | | corestatus | Display connected device statistics for Traffic
slavecorestatus} Mini Detection Engine Secondary “slave core.”
protocol {web | email} Displays the session counts for network web o
log error traceback Displays only the tracebacks (if any) generate
OS process error logs. A traceback is a stack
log error last <integer: number of lines to display> Displays n [1-1000] lines of the contents of th
Example The following example displays the connected Traffic Collector status.
Syntax show
Parameters
interface [management | monitoring | (administrative) network interface eth0, or the monitoring interface (eth1), or the
alternateexhaust] alternate-exhaust interface (eth2).
• cpuload shows the average CPU load in the system for running processes in the
last 1, 5 and 15 minute intervals.
• disk shows the disk space usage in the system.
• memory shows the system memory usage.
version Show Juniper ATP Appliance software and content security versions.
Example The following example displays information about the MacOSX cpuload statistics:
The following example requests details for the Collector’s monitoring interface (eth1):
shutdown
Mode(s) Server
Syntax shutdown
Parameters None
JATP# shutdown
traceroute
Mode(s) Server
Syntax traceroute
Parameters
-h unsigned integer Specifies the number of hops
updateimage
Description Update or correct the guest-image OS profile used by the detection and
analysis behavioral engine.
The updateimage command will update the guest images from a USB drive
attached to the Juniper ATP Appliance.
Mode(s) Core
Syntax updateimage
Parameters
built-in Updates the guest-image on the Mac OSX Detection “Seconda
Example The following example performs a built-in profile update for the Core
detection engine.
upgrade
Description Upgrade a configured Juniper ATP Appliance Mac OSX Mac Mini device. If the Mac Mini has already been upgraded to Ubuntu
14.04, this upgrade command will not be visible at the CLI because it will not be needed.
Please note that this command will only show up for existing customers that have Mac Mini devices configured as Juniper ATP
Appliance Mac OSX detection engine Secondary Cores (running Ubuntu 13.10). For new customers running Juniper ATP Appliance
Release 3.2.5, each Mac Mini device is shipped with the new Ubuntu 14.04 version already installed, so in this case, the upgrade
command will again not be available from the Juniper ATP Appliance Mac OSX Engine CLI.
Mode(s) Core
Syntax upgrade
Parameters
built-in Updates the guest-image on the Mac OSX Detection “secondary core.”.
Example The following example performs a built-in Mac OS X profile update for the Mac Mini-based Secondary core detection engine..
MAC2(core)# upgrade
wizard
Description Enters the Configuration Wizard. For Configuration Wizard commands and response, see
“Configuration Wizard for the CoreCM Server” in the next section to follow command
prompts and recommended responses.
Mode(s) Basic
Parameters wizard
Example None
hostname # wizard
Use DHCP to obtain the IP address and DNS server address We strongly discourage the use of DHCP addressing because it
for the administrative interface (Yes/No)? changes dynamically. A static IP address is preferred.
NOTE: Only if your DHCP response is no,enter the following Recommended: Respond with no:
information when prompted:
a. Enter an IP address
a. IP address (no CIDR format) b. Enter a netmask using the form 255.255.255.0.
b. Netmask c. Enter a gateway IP address.
c. Enter a gateway IP address for this management d. Enter the DNS server IP address
(administrative) interface:
e. If yes, enter the IP address of the secondary DNS server.
d. Enter primary DNS server IP address.
f. Enter yes if you want DNS lookups to use a specific domain.
e. Do you have a secondary DNS Server (Yes/ No).
g. Enter search domain(s) separated by spaces; for example:
f. Do you want to enter the search domains? example.com lan.com dom2.com
g. Enter the search domain (separate multiple search
domains by space): Enter yes to restart with the new configuration settings applied.
Enter a valid hostname. Type a hostname when prompted; do not include the domain;
for example: juniperatp1
Enter IP address for the alternate-exhaust (eth2) interface: Enter the eth2 netmask.
Enter netmask for the alternate-exhaust (eth2) interface: Enter the gateway IP address.
(example: 255.255.0.0)
Enter the primary DNS server IP Address for the
Enter gateway IP Address for the alternate-exhaust (eth2) alternate-exhaust (eth2) interface.
interface: (example:10.6.0.1)
Enter yes or no to confirm or deny an eth2 secondary DNS server.
Enter primary DNS server IP Address for the alternate-exhaust
(eth2) interface: (example: 8.8.8.8) Enter yes or no to indicate whether you want to enter search
domain.
Do you have a secondary DNS server for the alternate-exhaust
(eth2) interface?
Regenerate the SSL self-signed certificate (Yes/ No)? Enter yes to create a new SSL certificate for the Juniper ATP
Appliance Server Web UI.
Enter the following server attributes: Required:Enter the IP address of the Juniper ATP Appliance
Server Core/CM or All-in-One.
Central Manager (CM) IP Address:
Enter a Juniper ATP Appliance Mac Mini or Core/CM Device
Device Name: (must be unique) Name; this identifies the Mac OS X or Core Engine in the Web
UI.
Device Description
Enter a device Description
Device Key PassPhrase
Enter the same PassPhrase used to authenticate the Core or
NOTE: Remember this passphrase and use it for all Mac Mini to the Central Manager.
distributed devices!
This chapter describes the commands specific to the Juniper ATP Appliance Collector
CLI. The available commands are as follows:
• diagnosis on page 31
• exit on page 31
• help on page 33
• history on page 33
• server on page 36
• wizard on page 50
• help on page 33
• history on page 33
• copy on page 30
• exit on page 31
• gssreport on page 32
• help on page 33
• history on page 33
• setupcheck on page 44
• help on page 33
• history on page 33
• ifrestart on page 34
• ping on page 34
• reboot on page 35
• restart on page 35
• [Unresolved xref]
• shutdown on page 48
• traceroute on page 49
capture-start
Description Starts packet capture as a means for diagnosing and debugging network traffic
and obtaining stats.
Mode(s) Diagnosis
Syntax capture-start
Sub-Commands None
Example The following example starts a packet capture process on interface eth1 for a
Traffic Collector with IP address 8.8.8.8:
hostname # diagnosis
NOTE: Note: Address 8.8.8.8 need not be a Juniper ATP Appliance. It is just a
host that the capture filters on.
collector
Mode(s) Basic
Syntax collector
Parameters None
Sub-Commands “exit” on page 31;“help” on page 33; “history” on page 33; “set proxy (collector
mode)” on page 39; “show (collector mode)” on page 45
hostname # collector
hostname (collector)# ?
copy
Description Uses Secure Copy (SCP) to scp to copy and transfer packet capture or traceback
(crash) data to a remote location, providing the same authentication and level
of security as an SSH transfer.
The copy traceback command, upon Customer Support's request, copies the
traceback files out of the box to a remote location.
Mode(s) Diagnosis
Sub-Commands None
Example The following example copies the file "captureEth1.txt" from the local host to
a remote host:
admin@remotehost.edu:/some/remote/directory
diagnosis
Mode(s) Basic
Syntax diagnosis
Parameters None
Sub-Commands “capture-start” on page 55; “copy” on page 30; “exit” on page 31; “gssreport” on
page 32; “help” on page 33; “history” on page 33; “set (server mode)” on page 42;
“setupcheck” on page 44; “show (diagnosis mode)” on page 47; “show (server
mode)” on page 68
Example The following example enters diagnosis configuration and status check mode:
hostname # diagnosis
hostname (diagnosis)# ?
exit
Syntax exit
Parameters None
gssreport
Description Use the gssreport command to submit reports to Juniper Global Security Services
(GSS), and to display the status of the current GSS report.
Mode(s) diagnosis
Sub-Commands None
Example The following examples display the status of a GSS report submission:
hostname # diagnosis
hostname (diagnosis)# gssreport submit
Successfully started GSS report
help
Syntax help
Parameters None
Example The following example shows some of the output of the help command.
history
Syntax history
Parameters None
Example The following examples returns command line history for the current CLI session.
JATP# history
ifrestart
Description Restarts the interface driver and services using the interface.
Mode(s) Server
Example The following example restarts the eth0 interface for the management network.
ping
Description Sends ICMP (Internet Control Message Protocol) echo request packets to a
specified host name or IP address to verify that the destination is reachable over
the network.
Mode(s) Server
Parameters
-ccount Number of echo requests to send. By default, pings ar continuously u
Example The following example sends three echo requests to the device with the IP
Address 10.10.10.1
reboot
Mode(s) Server
Syntax reboot
Parameters None
hostname# reboot
restart
Mode(s) Server
Parameters
all Restarts all Juniper ATP Appliance services.
JATP# restart cm
server
Mode(s) Basic
Syntax server
Sub-Commands “exit” on page 31; “help” on page 33; “history” on page 33; “ifrestart” on page 34;
“ping” on page 34; “reboot” on page 35; [Unresolved xref]; “set (server mode)”
on page 42; “show (server mode)” on page 68
hostname # server
hostname (server) # ?
Description Sets an Inside or Outside data path proxy from collector mode.
Deploy Traffic Collectors in locations where the monitoring interface is (1) placed
“outside” between the proxy and the egress network for customer environments
in which the proxy supports XFF (X-Forwarded-For), or (2) [the more typical
deployment scenario], the Collector is placed between the proxy and the internal
network using FQDN (if available) to identify the threat source for all types of
incidents (“inside” proxy). When configured, the Juniper ATP Appliance Traffic
Collector will monitor all traffic and correctly identify source and destination
hosts for each link in the kill chain wherever the data allows for it.
See Also: “set (server mode)” on page 42; “set (diagnosis mode)” on page 40
NOTE: The mitigation IP address of a CNC server is not be available for Inside
proxy deployments. When a Juniper ATP Appliance is deployed behind a proxy,
the Mitigation-> Firewall page in the Juniper ATP Appliance Central Manager
Web UI (which typically displays the CNC server IP address to mitigate) will be
empty. The destination IP address of any callback is made to the proxy server ip
address, so it is not relevant to display the proxy server IP address on the
Mitigation->Firewall page.
Mode(s) collector
Syntax set proxy inside {add <proxy IP address> <proxy port> | remove <proxy IP
address> <proxy port>
Parameters
inside Sets the inside proxy IP addresses
Description Enables and disables the SSH-Honeypot feature for a Traffic Collector.
• Enable/disable a honeypot
• Set a Static IP (IP, mask, and gateway) or DHCP of a publicly addressable
interface
Mode(s) collector
Example The following example enables the SMB parser for lateral detections:
NOTE: The static IP configuration does not require configuring DNS. Honeypots
do not require a DNS server at this time.
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis
mode.
Mode(s) diagnosis
Parameters
all Sets logging for all Juniper ATP Appliance components.
Example The following example sets the default logging level for all Juniper ATP Appliance
components.
Description Enables and disables the HTTP or SMB parser for a Traffic Collector.
Mode(s) collector
Example The following example enables the SMB parser for lateral detections:
Mode(s) Server, See Also:“set (diagnosis mode)” on page 40; “set proxy (collector mode)”
on page 39
Syntax set [autoupdate {on | off} | cli timeout secs | clock | cm address | support {on
| off} | passphrase string | dns | firewall {all <backup | flush> | whitelist} |
hostname string | ip {interface | dhcp | address | netmask | gateway} |
ntpserver | password | proxy {config | enabled | remove} |timezone string
| uipassword]
Parameters
autoupdate {software| content} {on|off} Turn on or off the automatic product update feature.
cli timeout secs Set CLI timeout period in seconds (0 indicates no timeout).
cm address Sets the IP address of the Central Manager and netmask using the slash notation;
example: AAA.BBB.CCC.DD/x
set support {enable | disable} | Enables remote SSH login “support” account or localmode enable|/disable.
{localmode}
dns Sets the DNS servers (or enable DHCP for DNS) for the management interface
eth0.
firewall {all <backup | flush> | whitelist Backs up or flushes (clears) all current iptables for a firewall, or adds, deletes or
<add | delete | flush>} flushes the current iptables whitelist-specific settings for the firewall.
Whitelist rules rely on normal service shutdown to be backed up. Powering off a
VM directly will lose the whitelist state as rules cannot be saved in that case
ip {interface | dhcp | address | netmask Sets the IP address, netmask, or default gateway, or enables DHCP for the
|gateway} management interface eth0.
proxy {config <all|http> | enable <on|off> Config, enable/disable, or remove “all” proxy configs, or remove an HTTP-specific
| remove <all|http>} proxy server.
TIP: Config the proxy for “all” protocols first, and then change HTTP proxy as
needed.
timezone {US/ Eastern | US/ Central | Show the current timezone; example:
US/ Mountain
set timezone US/Pacific
Examples The following example sets an ip address for the device management interface
eth0.
Description Change the appliance type at any time. For example, change from All-In-One to
Core/CM. Note that if you change the appliance type after the initial installation,
all data files related to the current type are lost and you must set up the appliance
as you would a fresh box.
Mode(s) server
Parameters
all-in-one
core-cm
email-collector
traffic-collector
Example The following example changes the form factor of the appliance from all-in-one
(the default) to core-cm:
Description Sets traffic filter rules to avoid analysis on a set of configured traffic, which cannot
be made retroactive; for example: any analysis skipped as a result of the filtering
cannot be reversed. This command can be applied to an entire network/subnet/
CIDR range.
See Also: “set (server mode)” on page 42;“show (diagnosis mode)” on page 47
[show traffic-filter]
Mode(s) collector
Parameters
traffic-filter add Adds a traffic filter rule where:
Example The following example add a traffic filter rule to the Traffic Collector.
Description Sets the traffic monitoring interface on the JATP700 and JATP400.
Mode(s) collector
NOTE: After making an interface type change, the system must be rebooted for
the change to take effect.
setupcheck
Description Checks and reports on basic configuration settings and analysis pipeline setup.
Mode(s) diagnosis
Parameters
all Checks both basic settings and analysis pipelin.
Example The following example checks all basic configuration settings as well as the
analysis pipeline:
Description Displays the Traffic Collector current traffic filters and the current XFF status
(enabled or disabled)
Mode(s) Collector
Syntax show
Parameters
traffic-filter Shows all traffic filter rules.
Example The following example displays the current Collector proxy inside settings:
The following example displays the current SMB protocol parser setting:
Description Sets the logging levels for Juniper ATP Appliance components from diagnosis
mode.
See Also:“show (server mode)” on page 68; “show (collector mode)” on page 45
Mode(s) diagnosis
Syntax show
Parameters
device {collectorstatus | | corestatus | Display connected device statistics for Traffic Co
slavecorestatus} Mini Detection Engine Secondary “slave core.”
protocol {web | email} Displays the session counts for network web or e
log error traceback Displays only the tracebacks (if any) generated b
OS process error logs. A traceback is a stack
log error last <integer: number of lines to display> Displays n [1-1000] lines of the contents of the c
Example The following example displays the connected Traffic Collector status.
IP : 10.2.9.68
Enabled : True
Last Seen : 2014-07-25 15:13:17.967000-07:00
Install Date : 2014-06-25 19:03:38-07:00
IP : 10.2.20.3
Enabled : True
Last Seen : 2014-07-28 11:07:42.046000-07:00
Install Date : 2013-11-14 09:25:39-08:00
Mode(s) Server, See Also: show (collector mode); “show (diagnosis mode)” on page 47
Syntax show
Parameters
interface Show information about the management (administrative) network interface eth0
and the monitoring interface eth1.
Results may show both private and public IP addresses if the AWS vCore has a
public IP.
version Show Juniper ATP Appliance software and content security versions.
Example The following example displays information about the All-in-One server device
type:
shutdown
Mode(s) Server
Syntax shutdown
Parameters None
JATP# shutdown
traceroute
Table 116: traceroute
Syntax traceroute
Parameters
-h unsigned integer Specifies the number of hops
wizard
Description Enters the Configuration Wizard. For Configuration Wizard commands and response,
see “Configuration Wizard for the CoreCM Server” in the next section to follow
command prompts and recommended responses.
Mode(s) Basic
Syntax wizard
Parameters None
hostname # wizard
Use DHCP to obtain the IP address and We strongly discourage the use of DHCP addressing because it changes
DNS server address for the administrative dynamically. A static IP address is preferred.
interface (Yes/No)?
Recommended: Respond with no:
NOTE: Only if your DHCP response is no
,enter the following information when a. Enter an IP address
prompted: b. Enter a netmask using the form 255.255.255.0.
c. Enter a gateway IP address.
a. IP address (no CIDR format)
d. Enter the DNS server IP address
b. Netmask
e. If yes, enter the IP address of the secondary DNS server.
c. Enter a gateway IP address for this
management (administrative) f. Enter yes if you want DNS lookups to use a specific domain.
interface: g. Enter search domain(s) separated by spaces; for example: example.com
d. Enter primary DNS server IP address. lan.com dom2.com
e. Do you have a secondary DNS Server Enter yes to restart with the new configuration settings applied.
(Yes/ No).
f. Do you want to enter the search
domains?
g. Enter the search domain (separate
multiple search domains by space):
Enter a valid hostname. Type a hostname when prompted; do not include the domain; for example:
juniperatp1
NOTE: Only alphanumeric characters and hyphens (in the middle of the hostname)
are allowed.
Enter the following server attributes: Required: Enter the IP address of the Juniper ATP Appliance Server All-in-One CM
or CoreCM to which you are connecting [another] Collector in order to register with
Central Manager (CM) IP Address: and view the Collector in the CM Web UI.
Device Name: (must be unique) Enter the Juniper ATP Appliance Collector Device
Device Description Name; this identifies the Collector in the Web UI.
NOTE: Remember this passphrase and Enter the same PassPhrase used to authenticate the Collector to the Central
use it for all distributed devices! Manager.
NOTE: Enter CTRL-C to exit the Configuration Wizard at any time. If you exit
without completing the
Glossary of Terms
Alternate Exhaust Interface An eth2 interface configured (optionally) to contain analysis engine CnC traffic off the
management network (eth0).
Anti-SIEM A Juniper ATP Appliance Advanced Threat Analytics (ATA) feature that allows for more
detailed endpoint and log ingestion handling, management and reporting; includes Active
Directory, Splunk and Direct Log Ingestion options.
AWS Amazon Web Services and EC2 management console from which Juniper ATP Appliance
administrators can configure vCore AMI images.
Blacklist A list or register of entities to be denied a specified access or privilege. During detection
engine analysis, when content matches any pattern on the blacklist, the content is deemed
malicious and therefore an alert or block action is enacted immediately.
Collector Juniper ATP Appliance’s Traffic inspection and object collection mechanism
CnC server Command and control server that directs the operation of a botnet.
CLI Command-line interface. The Juniper ATP Appliance has a CLI interface for administering
the appliance.
CM The Juniper ATP Appliance Central Manager component that has a web-based graphical
user interface.
DMZ Demilitarized zone. An area of the network where systems have direct access to the Internet
or an external network.
Greylist Greylists provide control over the priority of workorders for known IP addresses and URLs.
Greylists contain files that contain either URLs or IP addresses and are used by the Juniper
ATP Appliance analysis engines to check if the specified URLs or IP addresses contain a
malicious rule match.
GUI Graphical user interface. The Juniper ATP Appliance uses a web-based GUI for managing
the appliance.
Known botnet server bot command Events that are triggered when the appliance sees any of the common IRC bot commands
or detects any communication sent to known botnet servers.
Lateral Detection East-west detection of malware within the enterprise spread from endpoint host to host.
Malware Malicious software used by attackers to disrupt, control, steal, cause data loss, spy upon,
or gain unauthorized access to computer systems.
OSPF Open Shortest Path First. A protocol that computes an optimal path for traffic in a TCP/IP
network.
Sandbox mode A mode in which malware is permitted to run, but results of the malware action are
restricted to the virtual machine and not permitted to escape.
spyware A type of malware installed on computers that collects small pieces of information about
user(s) it is spying on.
VM Virtual Machine. A software program that runs an instance of an operating system. The
operating system runs on top of a program that emulates a hardware system.
Worm A self-replicating malware program that uses a computer network to send copies of itself
to other computers. This may be done without any user intervention.
Zero-day attack An attack by malware that exploits unknown or newly discovered vulnerabilities in software
before they become known or before security patches are applied to fix them