--- title: "Intelligent Sandbox 5.0.x Command Line Interface Reference Guide" slug: "intelligent-sandbox-5-0-x-command-line-interface-reference-guide" updated: 2026-09-08T19:56:54Z published: 2026-09-08T19:56:54Z canonical: "docs.trellix.com/intelligent-sandbox-5-0-x-command-line-interface-reference-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Intelligent Sandbox 5.0.x Command Line Interface Reference Guide # Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide Last Updated: September 17, 2023     ![Large decorative graphic of teal-to-blue dashed vector pattern filling the lower page with the Trellix wordmark logo in the bottom-right corner](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/intelligent-sandbox-5.0.x-command-line-interface-reference-guide_page_0001_img_01.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A30%3A38Z&se=2026-11-22T15%3A30%3A38Z&sr=c&sp=r&sig=olqwKRylrwCg7cRMLuraGj46bUR5vHuJH5TiDItxGX4%3D) ## Contents --- ### CLI commands........................................................................ 8 Issuing CLI commands ........................................................................ 8 Issuing commands ........................................................................ 8 Issuing a command through SSH ........................................................................ 8 Log on to the Intelligent Sandbox Appliance ........................................................................ 8 Auto-complete ........................................................................ 9 CLI syntax ........................................................................ 9 Mandatory commands ........................................................................ 9 Log on to the CLI ........................................................................ 9 Meaning of "?" ........................................................................ 10 List of CLI commands ........................................................................ 10 activeResponseStats ........................................................................ 10 amas ........................................................................ 11 archive-submission-status ........................................................................ 11 atdcounter ........................................................................ 11 backup reports ........................................................................ 12 backup reports date ........................................................................ 12 Blacklist ........................................................................ 12 clear emailcache ........................................................................ 14 clearstats all ........................................................................ 15 clearstats ActiveResponse ........................................................................ 15 clearstats dxl ........................................................................ 15 clearstats tepublisher ........................................................................ 16 clearstats taxii ........................................................................ 16 clearlbconfig ........................................................................ 16 createDefaultVms ........................................................................ 16 db_repair ............................................................................. 17 deleteblacklist ...................................................................... 17 deletesamplescore <0-5> ................................................................ 17 deletesamplereport .................................................................. 18 diskcleanup ......................................................................... 18 dxlstatus ........................................................................... 18 Exit ................................................................................ 19 extract vmimage .................................................................... 19 filetypefilter ....................................................................... 19 ftptest ............................................................................ 20 gti-restart ......................................................................... 20 help ............................................................................. 20 http_redirect ...................................................................... 21 install msu ......................................................................... 21 install package .......................................................... 22 lbstats ........................................................................... 23 list ................................................................................ 23 lowseveritystatus .................................................................. 23 no malware-dns .................................................................... 24 no malware-dns-ipv6 ................................................................ 24 no timeout .......................................................................... 24 nslookup .......................................................................... 25 passwd ............................................................................ 25 ping ............................................................................. 25 quit ............................................................................. 26 reboot ........................................................................... 26 recreatesshkey ..................................................................... 26 remove ........................................................................... 27 removeAndroid ...................................................................... 28 removenetworkaddress ................................................................. 28 removeSampleInWaiting ................................................................................................................ 28 removevmImage ................................................................................................................ 29 resetreadonlyclipasswd ................................................................................................................ 29 resetrmimport ................................................................................................................ 30 resetuiadminpasswd ................................................................................................................ 30 resetusertimeout ................................................................................................................ 30 revert package application ................................................................................................................ 31 revert package detection ................................................................................................................ 31 revertwebcertificate ................................................................................................................ 31 route add/delete network ................................................................................................................ 31 run ldt ................................................................................................................ 32 samplefilter ................................................................................................................ 33 service ................................................................................................................ 34 set appliance dns ................................................................................................................ 35 set consoleLogLevel ................................................................................................................ 35 set port80 ................................................................................................................ 35 set port 24/8505 ................................................................................................................ 36 set port 6080 ................................................................................................................ 39 set appliance gateway ................................................................................................................ 40 set appliance gateway6 ................................................................................................................ 40 set appliance ip ................................................................................................................ 41 set appliance ipv6 ................................................................................................................ 41 set appliance name ................................................................................................................ 42 set gti dns check ................................................................................................................ 42 set gti server ip ................................................................................................................ 43 set gti server url ................................................................................................................ 43 set gti server ip 0.0.0.0 ................................................................................................................ 43 set gti server url 0.0.0.0 ................................................................................................................ 43 set intfport ................................................................................................................ 44 set intfport <1-3> ipdelete ................................................................................................................ 44 set intfport auto ................................................................................................................ 44 set intfport ip ...................................................................... 45 set intfport speed duplex ...................................................................... 45 set ipAddressSwap ...................................................................... 45 set ldap enable | disable ...................................................................... 46 set malware-dns ...................................................................... 46 set malware-intfport ...................................................................... 47 set mgmtport auto ...................................................................... 47 set malware-intfport mgmt ...................................................................... 47 set maxusers ...................................................................... 48 set mgmtport speed and duplex ...................................................................... 48 set pdflinks ...................................................................... 49 set emailConnector interface ...................................................................... 49 set fips enable | disable ...................................................................... 49 set filesizes ...................................................................... 50 Set FTP ...................................................................... 53 set internal net sandbox ...................................................................... 53 set internal net emailconnector ...................................................................... 54 logconfig ...................................................................... 54 set mar-timeout ...................................................................... 55 set nsp-tcp-channel enable | disable ...................................................................... 55 set network analysis ...................................................................... 56 set resultbackup ...................................................................... 57 set stixreportstatus ...................................................................... 57 set clearblacklist enable | disable | status ...................................................................... 57 set sysloglimit ...................................................................... 58 set timeout <0-35791> ...................................................................... 58 set uilog ...................................................................... 59 set ui-timeout ...................................................................... 59 show ...................................................................... 60 show consoleLogLevel ...................................................................... 60 show dat version ...................................................................... 61 show ds status .............................................................................................................. 61 show emailConnector ...................................................................................................... 61 show epo-stats nsp ...................................................................................................... 62 show filequeue .......................................................................................................... 62 show filesizes .......................................................................................................... 62 show ftp ................................................................................................................ 64 show gti dns ............................................................................................................. 64 show gti server .......................................................................................................... 64 show hardware ........................................................................................................ 65 show history ........................................................................................................... 66 show internal net ..................................................................................................... 66 show intfport .......................................................................................................... 66 show ipAddressSwap .................................................................................................. 67 show ldap ............................................................................................................. 67 show license info ..................................................................................................... 67 show license status .................................................................................................. 68 show logconfig ........................................................................................................ 68 show mar-timeout ..................................................................................................... 68 show maxusers ........................................................................................................ 69 show pdflinks ........................................................................................................ 69 show msu ............................................................................................................. 69 show nsp scandetails ............................................................................................... 69 show nsp-ssl-channel-encryption status ................................................................. 70 show port80 ......................................................................................................... 70 show port ............................................................................................................. 71 show resultbackup ................................................................................................ 71 show route ............................................................................................................. 71 show route6 ............................................................................................................ 72 show stixreportstatus ............................................................................................... 73 show sysloglimit .................................................................................................... 73 show system id ...................................................................................................... 74 show taxii status ................................................................................................ 74 show tepublisherstatus ....................................................................................... 74 show timeout ................................................................................................ 75 show ui-timeout ............................................................................................. 75 show uilog .................................................................................................. 75 show version application ................................................................................ 76 show version detection .................................................................................. 76 show vmImage .............................................................................................. 76 show waittime ............................................................................................ 77 shutdown .................................................................................................. 77 status ..................................................................................................... 77 sync detectionpkg ..................................................................................... 78 sync webcert ........................................................................................ 78 sync yara behaviorrules ............................................................................... 79 terminal ................................................................................................ 79 tcpdump ............................................................................................... 80 unlockuser .............................................................................. 81 update_avdat .......................................................................................... 81 uploadSupportBundle .................................................................................. 82 vmlist ................................................................................................... 82 watchdog .............................................................................................. 82 whitelistMerge ......................................................................................... 83 1 | CLI commands --- # CLI commands The **Intelligent Sandbox Appliance** supports command-line interface (CLI) commands for tasks such as network configuration, restarting the appliance, and resetting the appliance to factory defaults. ## Issuing CLI commands You can issue CLI commands locally, from the **Intelligent Sandbox Appliance** console, or remotely through SSH. ## Issuing commands To perform an operation on the **Intelligent Sandbox Appliance**, you must perform the operation from the command line of the console host that connects to the **Intelligent Sandbox Appliance**. For example, when you first configure the network details for the **Intelligent Sandbox Appliance**, you must do so from the console. ## Issuing a command through SSH You can administer a **Intelligent Sandbox Appliance** remotely from a command prompt over `ssh`. # Log on to the Intelligent Sandbox Appliance Use the SSH client to log on to the **Intelligent Sandbox Appliance**. Task 1. Open an SSH client session. 2. Enter the **Intelligent Sandbox Appliance** IPv4/IPv6 address. 3. Enter 2222 as the SSH port number. 4. Enter the log on credentials. - User name — cliadmin - Password — atdadmin If you are logging on for the first time, you are prompted to changed the user name and password. You can change the CLI password by logging on to Intelligent Sandbox web interface. 1. Go to Manage → **Security** → Advanced Security Settings → Password Control. 2. Click Click here to reset CLI user password. Depending on your SSH client, the number of logon attempts differ. For example, Putty 0.54 and 0.56 allow you three log on attempts, and Putty 0.58 and Linux SSH clients allow you four attempts. --- [1 | CLI commands](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) --- # Auto-complete The CLI allows you to auto-complete commands. To auto-complete a command, press **Tab** after typing a few characters of a valid command and then press **Enter**. For example, typing pas and pressing **Tab** would result in the CLI auto-completing the entry with the command passwd. If the partially entered text matches multiple options, the CLI displays all available matching commands. ## CLI syntax You issue commands at the command prompt as shown. ``` ``` - Values that you must enter are enclosed in angle brackets (< >). - Optional keywords or values are enclosed in square brackets ([ ]). - Options are shown separated by a line (|). - Variables are indicated by *italics*. > Note > > >     >     > > Do not type the < or [ ] symbols. ## Mandatory commands There are certain commands that must be executed on the Intelligent Sandbox Appliance before it is fully operational. The remaining commands in this chapter are optional and will assume default values for their parameters unless they are executed with other specific parameter values. These are the required commands: - set appliance name - set appliance ip - set appliance gateway is also required if any of the following are true: - If the Intelligent Sandbox Appliance is on a different network than the Trellix products you plan to integrate - If you plan to access Intelligent Sandbox from a different network either using an SSH client or a browser for accessing the Intelligent Sandbox web interface ## Log on to the CLI Before you can enter CLI commands, you must first log on to the Intelligent Sandbox Appliance with a valid user name (default --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 9 ## 1 | CLI commands --- user name is cliadmin) and password (default is atdadmin). To log off, type `exit`. > **Caution** > > >     >     > > Change the password using the `passwd` command within your first interaction with the **Intelligent Sandbox Appliance**. ## Meaning of "?" ? displays the possible command strings that you can enter. ### Syntax ? > **Note** > > >     >     > > If you use ? in conjunction with another command, it shows the next word you can type. If you execute the ? command in conjunction with the `set` command, for example, a list of all options available with the `set` command is displayed. ## List of CLI commands This section lists **Intelligent Sandbox** CLI commands in the alphabetical order. ### activeResponseStats Displays the statistics on **McAfee Active Response** and **Trellix Intelligent Sandbox** integration. **Syntax:** activeResponseStats This command has no parameters. **Example:** ``` activeResponseStats [ Active Response Statistics ] Status                      : DISABLED Request Files Received      : 0 Search in Pending state     : 0 Search in Completed state   : 0 ERROR COUNT                 : 0 ``` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ## amas Use this command to restart/start/stop the amas services. > **Note** > > >     >     > > amas restart is no longer available. Syntax: amas | **Parameter** | **Description** | | --- | --- | | | The amas service you want to stop. | Example: amas start/stop ## archive-submission-status Displays status of the archive samples submitted to **Intelligent Sandbox** system. Syntax: archive-submission-status This command has no parameters. **Sample output:** ``` [ Zip adapter stats] Status : UP Archive samples received : 0 Invalid archive received : 0 Archive successfully processed : 0 Samples found by extracting archives : 0 Samples (extracted from zip) submitted to amas        : 0 ``` ## atdcounter Displays the engine specific counter e.g. files sent and processed by **McAfee GTI**, Anti-Virus Engine, Gateway Anti-Virus Engine, and amas. Syntax: atdcounter [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- This command has no parameters. ## backup reports Use this command to create a backup of the **Trellix Intelligent Sandbox** reports on an external FTP/SFTP server configured for a user under the FTP results output setting interface ports. #### Syntax backup reports This command has no parameters. ## backup reports date This command creates a backup of the **Trellix Intelligent Sandbox** reports for a particular date range on an external FTP/SFTP server configured for a user under the FTP results output setting. **Syntax:** backup reports date     | Parameter | Description | | --- | --- | | yyyy-mm-dd yyyy-mm-dd | The date range for which you want to create a backup for reports. | **Example:** 2014-07-10 2014-07-12 ## Blacklist Use the following commands to manage the **Trellix Intelligent Sandbox** blacklist. **Syntax:** - To add an MD5 to the blacklist, use blacklist add     | Parameter | Description | | --- | --- | | | The MD5 hash value of a malware that you want to add to the blacklist. | ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | | The malware severity score. A valid value is from 3 to 5. | | | The file name for the MD5. | | | The malware name for the MD5. | | | The numerical ID for the engine that detected the malware. Following is the numerical coding. Sandbox — 0, GTI — 1, GAM — 2, Anti-Malware — 4. | | | The numerical ID of the operating system that was used to dynamically analyze the malware. | Example: blacklist add 254A40A56A6E28636E1465AF7C42B71F 3 ExampleFileName ExampleMalwareName 4 2 - To delete an MD5 from the blacklist, use blacklist delete | **Parameter** | **Description** | | --- | --- | | | The MD5 hash value of a malware that you want to delete from the blacklist. | Example: blacklist delete 254A40A56A6E28636E1465AF7C42B71F - To check if an MD5 is present in the blacklist, use blacklist query | **Parameter** | **Description** | | --- | --- | | | The MD5 hash value of a malware that you want to query if it is present in the blacklist. | If the MD5 is present, the details such as the engine ID, malware severity score, and so on, are displayed. - To update the details for an entry in the blacklist, use blacklist update ## 1 | CLI commands --- `<OS-ID>` | **Parameter** | **Description** | | --- | --- | | | The MD5 hash value of a malware that you want to update. This value must exist in the blacklist for you to update the record. | | | The new malware severity score that you want to change to. A valid value is from 3 to 5. | | | The new file name for the MD5. | | | The new malware name for the MD5. | | | The new engine ID that you want to change to. | | | The new value for the operating system that was used to dynamically analyze the malware. | **Example:** blacklist update 254A40A56A6E28636E1465AF7C42B71F 4 ExampleFileName ExampleMalwareName 2 4 ## clear emailcache Use this command to clear the cache from an email-connector VM corresponding to a particular MD5 hash value. **Syntax:** clear emailcache | **Parameter** | **Description** | | --- | --- | | MD5 | MD5 hash value of the sample. | **Example:** ``` clear emailcache e5c12fadabdd118202a123fe477d168e Successfully cleared e5c12fadabdd118202a123fe477d168e from email cache ``` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#1) | CLI commands --- # clearstats all Use this command to reset all the **Trellix Intelligent Sandbox** statistics to zero. **Syntax:** `clearstats all` This command has no parameters. The following information is displayed using this command: ``` <=== DXL STATUS ===> Status                          : DISABLED DXL Channel Status              : DOWN Sample Files Received Count     : 0 Sample Files Published Count    : 0 Sample Files Queued Count       : 0 ``` ## clearstats ActiveResponse Clears all previous statistics from **McAfee Active Response** and **Trellix Intelligent Sandbox** integration. **Syntax:** `clearstats ActiveResponse` This command has no parameters. **Example:** ``` clearstats ActiveResponse All Active Response stats are reset to zero Request Files Received            : 0 Search in Pending state           : 0 Search in Completed state         : 0 Response from MAR                 : 0 ``` ## clearstats dxl Resets the DXL file counter to zero. **Syntax:** `clearstats dxl` This command has no parameters. The following information is displayed using this command. ``` All DXL stats are reset to zero ``` --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 15 ## 1 | CLI commands ---     ``` Sample Files Received Count        : 0 Sample Files Published Count       : 0 ``` ### clearstats tepublisher Clear the count of events sent to **McAfee ePO**. **Syntax:** `clearstats tepublisher` This command has no parameters. The following information is displayed using this command:     ``` All TEP stats are reset to zero Sample Files Received Count        : 0 Sample Files Published Count       : 0 ``` ### clearstats taxii Use this command to reset all TAXII stats to zero. **Syntax:** `clearstats taxii` ### clearlbconfig This command is used to destroy cluster using CLI command prompt. It is permitted to run at all nodes (Primary/Backup/Secondary). It wipes out all cluster related configurations from that node and makes it as a standalone box. This command can be used in scenarios where normal means of removing a node (Remove Node/Withdraw From Cluster) does not remove that node from cluster. When you execute the clearlbconfig command on a Primary or Active node, you must execute the command on all other nodes in the cluster. **Syntax:** `clearlbconfig` This command has no parameters. ### createDefaultVms Delete all of the existing analyzer VMs and create default analyzer VMs. **Syntax:** `createDefaultVms` ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#1) | CLI commands --- This command has no parameters. > **Note** > > >     >     > > This command will not work on the non-active nodes in the cluster. ## db_repair Repairs the **Intelligent Sandbox** database when the database is corrupt. **Syntax:** `db_repair` This command has no parameters. ## deleteblacklist Remove all the entries from the **Intelligent Sandbox** blacklist. **Syntax:** `deleteblacklist` This command has no parameters. ## deletesamplescore <0-5> Deletes all sample reports with the specified severity score. **Syntax:** `deletesamplescore <0-5>` | Parameter | Description | | --- | --- | | <0-5> | Enter a severity score between 0 to 5. | **Example:** ``` deletesamplescore 0 Deleting all sample results with score=0 delete 0 sample entries with 0 ``` Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide17 [1 | CLI commands](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) --- # deletesamplereport Deletes all of the analysis reports for a file. **Syntax:** `deletesamplereport <md5>`     | Parameter | Description | | --- | --- | | `<md5>` | The file MD5 value that you want to use to delete all the reports in **Intelligent Sandbox**. | **Example:** `deletesamplereport c0850299723819570b793f6e81ce0495` ## diskcleanup Delete old analysis reports when the **Intelligent Sandbox** disk space is low. **Syntax:** `diskcleanup` This command has no parameters. > Note > > >     >     > > To prevent **Intelligent Sandbox** from losing your results and reports, enable `set resultbackup`. ## dxlstatus View the **DXL** status. **Syntax:** `dxlstatus` This command has no parameter. The following information is displayed using this command: ``` <=== DXL STATUS ===> Status                          : DISABLED DXL Channel Status              : DOWN Sample Files Received Count     : 0 Sample Files Published Count    : 0 Sample Files Queued Count       : 0 ``` 1 | CLI commands --- # Exit Exits the CLI. This command has no parameters. **Syntax:** exit ## extract vmimage This command allows the user to copy OS Image present in **Intelligent Sandbox** to atdadmin folder. This image can further be download from atdadmin and uploaded to SR share by the customers. The command is supported from ATD version 4.12.4 and above. **Syntax:** extract vmimage Example: extract vmimage winxpSp3 To get , run show vmlmage command. ![Blue pencil note icon](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/intelligent-sandbox-5.0.x-command-line-interface-reference-guide_page_0019_img_01.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A30%3A38Z&se=2026-11-22T15%3A30%3A38Z&sr=c&sp=r&sig=olqwKRylrwCg7cRMLuraGj46bUR5vHuJH5TiDItxGX4%3D) > **Note** > > >     >     > > The images that are larger in size takes approximately 20–30 minutes to copy (depending on system load). Until the image copy completes, the CLI prompt is not available. It is recommended to run the command when no activity is being done. Also, if copying the image takes longer time, then nothing should be done that time (example, reboot or power down). ## filetypefilter Enables **Intelligent Sandbox** to use the file extension that the file carries before sending it for dynamic analysis. **Syntax:**filetypepfilter | **Parameter** | **Description** | | --- | --- | | status | Displays whether the filetypepfilter feature is enabled or disabled. By default, it is disabled. | | enable | Enables sample filtering. When enabled, Intelligent Sandbox uses the following supported file types for | --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide19 ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | | analysis: *.7z, .ace, .apk, .arj, .bat, .cab, .cgi, .chm, .class, .cmd, .com,* *.dll, .doc, .docm, .docx, .dotm, .dotx, .eml, .exe, .htm, .html, .inf, .ins, .js, .lnk, .lzh, .lzma, .mof, .msg,* *.ocx, .pdf, .potm, .potx, .ppam, .pps, .ppsm, .ppsx* | | disable | Disables sample filtering. When disabled, **Intelligent Sandbox** uses the default file types that dynamic analysis supports. | ## ftptest Tests the FTP settings. **Syntax:** `ftptest USER_NAME` | **Parameter** | **Description** | | --- | --- | | USER_NAME | The user name that you want to test the FTP settings. | **Example:** `NSPuser` ## gti-restart Restarts the **McAfee GTI** engine. **Syntax:** `gti-restart` This command has no parameters. ## help Provides a description of the interactive help system. This command has no parameters. ## 1 | CLI commands --- **Syntax:** `help` # http_redirect Enables or disables the redirection of http browser requests to https. When http_redirect is disabled, secure access to the **Intelligent Sandbox Appliance** is ignored. **Syntax:** `set http_redirect` When port 80 is disabled, then the HTTP port is used to access the **Intelligent Sandbox Appliance** interface in a browser. Any sample that you submit during the command execution is rejected as lighttpd is restarted. | Parameter | Description | | --- | --- | | enable **Intelligent Sandbox Appliance** | When http_redirect is enabled, the http url is redirected to https. RestAPI calls with only the https protocol are accepted. | | disable | When http_redirect is disabled, http is not redirected to https. RestAPI calls with the http or https protocol are accepted. | > **Note** > > >     >     > > Make sure http_redirect is always enabled. Disable http_redirect only when there are issues with certificate validation. To view if http to https redirection is enabled or disabled on the **Intelligent Sandbox Appliance**, use the show http_redirect command. By default, the redirect feature is enabled. **Syntax:** `show http_redirect` ## install msu Installs system-x.x.x.x.x.msu. **Syntax:** `install msu` Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 21 ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- | Parameter | Description | | --- | --- | | | The msu filename that you want to install. | | | Accepts the following values: - 0 — msu file installs without resetting the database - 1 — msu file install and the database is reset | ![note icon](#) **Note** > - The DB reset parameter is not required when migrating or installing Email Connector from 4.6.x to 5.0.x. > - The DB reset parameter is required during a fresh installation of the Intelligent Sandbox software. **Example:** For Email Connector: `install msu systemex-x.x.x.x.msu` For migration: `install msu migrate-x.x.x.x.msu` For fresh installation: `install msu system-x.x.x.x.msu 0` # install package Installs the detection or application package in the background. **Remember:** > Before you run this command, SFTP the install package to your Intelligent Sandbox Appliance with atdadmin user account. **Syntax:** `install package <package path>` | Parameter | Description | | --- | --- | | | Enter the package path and name. | 1 | CLI commands ## lbstats Shows the statistics for Primary node, Back up node and Secondary node in a load-balancing cluster. This command has no parameters. No output is displayed if the **Intelligent Sandbox** is not part of a cluster. **Syntax:** lbstats ## list Lists all of the available CLI commands. **Syntax:** list This command has no parameters. ## lowseveritystatus **Intelligent Sandbox** treats severity 1 and 2 samples as low-severity, and severity 3, 4, and 5 as malicious. By default, when you configure dynamic analysis, the dynamic analysis score is displayed in the summary report for all samples. The score also affects the final score for the sample. You can use the lowseveritystatus command to alter the behavior. For example, for low-severity samples that are dynamically analyzed, **Intelligent Sandbox** does not display the dynamic analysis score in the summary report, or consider the score to compute the final score. > Note > > >     >     > > The lowseveritystatus command applies only to non-PE samples, such as Microsoft Word documents and PDF files. **Syntax:** lowseveritystatus **Example:** lowseveritystatus hide | Parameter | Description | | --- | --- | | show | The default behavior. If a sample is dynamically analyzed, **Intelligent Sandbox** displays the dynamic analysis score in the report. It also considers the score to compute the final score. | | hide | Assume that the sample is a non-PE file, which has | ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | | undergone dynamic analysis. If **Intelligent Sandbox** detects the file to be low-severity, it does not display the dynamic analysis score in the report (under **Sandbox** in the **Down Selector's Analysis** section). **Intelligent Sandbox** also does not consider the dynamic analysis score for computing the final score. However, the details of the dynamic analysis such as files opened and files created are included in the report. > **Note:** > > > > > > The lowseveritystatus hide command affects only the score displayed in the report and does not affect how the results are displayed in the **Analysis Reports** page. | ## no malware-dns Use this command to configure the malware dns to the default 127.0.0.1. **Syntax:** `no malware-dns` ## no malware-dns-ipv6 Use this command to remove the IPv6 malware dns to the default ::1. **Syntax:** `no malware-dns-ipv6` **Example:** ``` no malware-dns-ipv6 Malware ipv6 DNS server has been reset to default ``` ## no timeout Removes timeout for SSH sessions. ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ### Syntax: no timeout This command has no parameters. # nslookup Queries the results for domain names. You can use nslookup to verify if **Intelligent Sandbox** can perform nslookup queries correctly. **Syntax:** nslookup | Parameter | Description | | --- | --- | | | The domain name that you want to query for nslookup. | **Example:** nslookup mcafee.com # passwd Changes the password of the CLI cliadmin user. A password must be between 8 and 25 characters in length and can consist of any alphanumeric character or symbol. You are asked to enter the current password before changing to a new password. **Syntax:** passwd # ping Pings a network host or domain name. You can specify an IPv4 address to ping network host and domain name to ping domain names. **Syntax:** ping [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- | Parameter | Description | | --- | --- | | | Denotes the 32-bit network host IP address written as four eight-bit numbers separated by periods. Each number (A, B, C or D) is an eight-bit number between 0–255. | | | The domain name that you want to ping. | ## quit Exits the CLI. This command has no parameters. **Syntax:** `quit` ## reboot Reboots the **Intelligent Sandbox Appliance** with the image in the current disk. You must confirm that you want to reboot. **Syntax:** `reboot or reboot <parameter>` | Parameter | Description | | --- | --- | | vmcreator | Recreates the analyzer VMs configured in the **Intelligent Sandbox** web interface, while rebooting the appliance. | | force | Force reboots your **Intelligent Sandbox**. | ## recreatesshkey Use this command to generate SSH key. In a load balancing cluster the **Intelligent Sandbox** appliances communicate with each other through SSH, using password SSH keys for authentication. In any setup, if the keys are erased or there is problem in --- 26 Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- communication between nodes, SSH keys can be regenerated using this command. > **Note** > > >     >     > > Do not execute this command without consulting McAfee. The command could cause disruptions in the the **Intelligent Sandbox** cluster. **Syntax:** recreatesshkey **Example:** ``` atd_111> recreatesshkey Directory /root/lb already exists, deleting the files Directory /home/lb/.ssh already exists , deleting the files Command Executed Successfully atd_111> ``` ## remove This command removes all original samples from ATD for which analysis is complete. The remove command has these parameters: - **now:** When executed, immediately removes the *original samples* for all the completed samples present on ATD. Even if you enable **Sample Download Access**, you cannot download the sample. - **enable:** When executed, immediately removes the *original samples* for all the completed samples present on ATD. It also enables you to set a daily task to automatically remove *original samples* from newly completed samples at a configured time. - **disable:** When executed, disables the daily task to remove *original samples* from newly completed sample files at the configured time. **Syntax:** remove samples all **Example 1:** ATD-6000> remove samples all now ``` Removing all sample files now... 10 sample files removed ``` **Example 2:** ATD-6000> remove samples all enable 11:37:14 ``` Removing all sample files now... 14 sample files removed Setting up daily task to remove newly completed sample files at 11:37:14 ``` --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 27 [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- **Example 3:** ATD-6000> remove samples all disable Disabling daily task # removeAndroid Remove the Android VM from the VM profile list. Ensure that Android is not the default VM profile and the Vmcreator process is not running **Syntax:** removeAndroid This command has no parameters. **Sample Output:** ATD_1U_21> removeAndroid Started deleting the android VM Successfully deleted the android VM > Note > > >     >     > > This command will not work on the non-active nodes in the cluster. # removenetworkaddress Removes the IP, subnet mask, and gateway addresses from the Intelligent Sandbox Appliance. The changes are reflected after the box is rebooted. This is a hidden command, but is useful for Support. **Syntax:** removenetworkaddress This command has no parameters. **Example:** ATD-6000> removenetworkaddress Remove the appliance network addresses ? Please enter Y to confirm: # removeSampleInWaiting Remove all of the samples to be analyzed by Intelligent Sandbox. ## 1 | CLI commands --- Syntax: `removeSampleInWaiting` This command has no parameters. The following information is displayed using this command: ``` Starting the sample queue cleaning... The cleaning is done ``` ## removevmImage To delete the VM Image from all nodes in the LB cluster when option is specified as **all**, execute this command from Primary[Active] or Backup[Active] **Intelligent Sandbox**. If option is specified as A.B.C.D, it deletes the Image only from Secondary with IP A.B.C.D. Reduce the License count for ImageName to zero before executing this command, or the command execution fails. This command does not delete the ImageName from Active (Primary/Backup) **Intelligent Sandbox**. To obtain ImageName, use the show vmImage command. Syntax: `removevmImage <ImageName> <all | A.B.C.D>` Example: ``` removevmImage winxpsp3 all removevmImage winxpsp3 10.34.2.1 ``` ## resetreadonlyclipasswd This command resets the password for the readonlycli user to its default value. Syntax: `resetreadonlyclipasswd` This command has no parameters. ``` resetreadonlyclipasswd Reset readonlycli password to Default? Please enter Y to confirm:y readonlycli password reset to default ``` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ## resetrmmport Use this command to perform a cold reset on the RMM port to reset the Management Controller. When executed, the command displays a warning as shown below. **Syntax:** resetrmmport > **Note** > > >     >     > > This command is not available for Virtual **Intelligent Sandbox**. ``` resetrmmport If Management Controller encounters any issues during reset then it may reboot the ATD appliance Are you OK to proceed? Please enter Y to confirm: ``` ## resetuiadminpasswd Resets the **Intelligent Sandbox** web interface administrator password. When you use the command, the password is reset to the default value, which is admin. The currently logged on sessions are unaffected. A change in password affects only new logon attempts. **Syntax:** resetuiadminpasswd Press Y to confirm, or N to cancel. ## resetusertimeout Enables you to log on to **Intelligent Sandbox** web interface without waiting for the timer to expire. **Syntax:** resetusertimeout     | **Parameter** | **Description** | | --- | --- | | | The **Intelligent Sandbox** web interface user name that you want to remove the logon timer. When the action is successful, the **Reset done!** message displays. | **Example:** resetusertimeout admin --- 30 Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ## revert package application Revert the current application software package and install the backup application software as current. **Syntax:** revert package application This command has no parameters. Use this command when you cannot revert the application software from the **Intelligent Sandbox** interface. ## revert package detection Revert the current detection software package and install the backup detection package as current. **Syntax:** revert package detection Use this command when you cannot revert the application software from the **Intelligent Sandbox** interface. ## revertwebcertificate Revert the uploaded web certificate to the default certificate. **Syntax:** revertwebcertificate This command has no parameters. The following information is displayed using this command: ``` revertwebcertificate Successfully reverted back web certificate to default! Restarting lighttpd service! ``` ## route add/delete network CLI commands are available for adding and deleting static routes to **Intelligent Sandbox**. **To add an IPv4 route** route add network netmask gateway intfport **Example:** ``` route add network 1.1.1.0 netmask 255.255.255.0 gateway 1.1.1.1 intfport 1 ``` ## 1 | CLI commands --- ### To add an IPv6 route route add network prefix length <1-128> gateway intfport **Example:** ``` route add network 2403:0:55a:3::1 64 255.255.255.0 gateway 2403:0:55a:3::1 intfport 1 ``` **Example:** route add network 1.1.1.0 netmask 255.255.255.0 gateway 1.1.1.1 intfport 1 ### To delete an IPv4 route route delete network netmask gateway intfport **Example:** ``` route delete network 1.1.1.0 netmask 255.255.255.0 gateway 1.1.1.1 intfport 1 ``` ### To delete an IPv6 route route delete network netmask gateway intfport **Example:** ``` route delete network 2403:0:55a:3::1 64 255.255.255.0 gateway 2403:0:55a:3::1 intfport 1 ``` ## run ldt This command allows you to collect ldt logs, abort the collection, and check the status of a running collection task. **Syntax:** run ldt     | **Parameter** | **Description** | | --- | --- | | tool | Collects LDT logs. | | status | Displays the status of LDT log collection | | abort | Stops the log collection task. | ## 1 | CLI commands --- ``` run ldt tool NOTICE: running the log collection tool may impact system performance. Running LDT log collection. Please stand by. LDT log collection has been started ``` # samplefilter This command is specific to **Network Security Platform** Sensors and all REST channel submissions. Use this command to prevent Sensors from sending unsupported file types to **Trellix Intelligent Sandbox** for analysis. **Syntax:** `samplefilter <status><enable><disable>` | **Parameter** | **Description** | | --- | --- | | status | displays whether the sample filtering feature is enabled or disabled currently. By default, it is enabled. | | enable | sets the sample filtering on. When it is enabled, **Trellix Intelligent Sandbox** considers only the supported file types from **Network Security Platform** for analysis. **Trellix Intelligent Sandbox** ignores all other file types and also informs **Network Security Platform** that a sample is of an unsupported file type. This prevents resources being spent on unsupported file types on both **Trellix Intelligent Sandbox** and **Network Security Platform**. | | disable | sets the sample filtering to off. When disabled, **Trellix Intelligent Sandbox** considers all the files submitted by **Network Security Platform** for analysis but only the supported file types are analyzed. The remaining are reported as unsupported in the **Analysis Status** and **Analysis Reports** pages. | **Example:** [1 | CLI commands](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) --- samplefilter status ## service Use this command to perform service-related tasks such as starting, stopping, restarting, or getting the status of services. Syntax: service | Parameter | Description | | --- | --- | | start | Starts a service. | | stop | Stops a service. | | status | Displays the status of one or more services. If you need to see the status of all ATD services, enter service status all | | restart | Restarts a service. | service status all VM creation in progress, amas service is down until completed. amas service [ STOPPED ] MA service [ RUNNING ] LB service [ RUNNING ] nginx service [ RUNNING ] mysql service [ RUNNING ] system networking [ RUNNING ] udnsd service [ RUNNING ] > Note > > >     >     > > The support for starting or stopping udnsd service is added from ATD 4.12.4 version and above. [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- # set appliance dns Configures the **Intelligent Sandbox Appliance** preferred and alternate DNS address. A DNS address can be either an IPv4 or IPv6 address or a combination of both. Syntax: ``` set appliance dns A.B.C.D/A:B:C:D::E E.F.G.H/F:G:H:I::J WORD ``` | Parameter | Description | | --- | --- | | `<A.B.C.D>/<A:B:C:D::E>` | DNS preferred IPv4/IPv6 address | | `<E.F.G.H/F:G:H:I::J>` | DNS alternate IPv4/IPv6 address | | `<WORD>` | Appliance domain name | Example: ``` set appliance dns 1.1.1.2 10.11.10.4 nai.com DNS setting had been configured ``` ``` set appliance dns 2001:4860:4860::8888 2001:4860:4860::8844 nai.com DNS setting had been configured ``` ## set consoleLogLevel Syntax: ``` set consoleLogLevel <1-7> ``` Example ``` set consoleLogLevel 4 ``` ``` set consoleLogLevel default ``` ## set port80 Allows you to access **Intelligent Sandbox** interface from a web browser through HTTP port 80. --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide35 [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ### Syntax `set port80 <enable/disable>` | **Parameter** | **Description** | | --- | --- | | | The **Intelligent Sandbox** interface can be accessed using the *https://* link from a browser. (Replace **Intelligent Sandbox** IP address with the actual IP address) | | | The **Intelligent Sandbox** interface can't be accessed from a browser. | > **Note** > > >     >     > > Delete the browser cache before you access the **Intelligent Sandbox** interface. If you disable port 80, the http redirect will also not work. #### Example ``` set port80 enable Enabling HTTP port 80 Http port 80 enabled ``` ## set port 24/8505 Allows you to access TCP port 24 which allows the use of Load balancing and TCP port 8505 which allows the use of NSP integration feature of **Intelligent Sandbox**. ### Syntax `set port 24/8505 <enable/disable>` | **Parameter** | **Description** | | --- | --- | | | Opens the port 24 and 8505, which allows the use of LB and NSP respectively. | | | Closes the port 24 and 8505 so LB and NSP integration are not available. | --- ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands ---     | Parameter | Description | | --- | --- | | `<disable>` | Blocks the port 24 and 8505, which restricts the use of LB and NSP respectively. | > Note > > >     >     > > By default port 24 and port 8505 are enabled, when disabled Load balancing and NSP won't work. > Note > > >     >     > > Ensure Load balancing is not configured or IPS is not integrated while blocking the ports. **Intelligent Sandbox** software does not check the configuration of these features before disabling the ports. If Load balancing is configured and port 24 is disabled Load balancing will stop working, similarly if NSP is integrated with **Intelligent Sandbox** and port 8505 is disabled, it will break the integration. So before executing the command ensure Load Balancing or NSP are not configured with **Intelligent Sandbox**. ### Example ``` set port 24 enable all TCP port 24 enabled set port 8505 enable all TCP port 8505 enabled ``` ### For port 24 You can only enable or disable port 24 (lbservice port) for all interfaces using the 'all' option. #### Syntax ``` set port 24 all ``` This does not allow to enable or disable for the specific interface. #### Syntax ``` set port 24 disable eth0 ``` ``` Invalid command: [Port 24 can only be enabled/disabled on all INTFPORT0|1|2|3 with option 'all'] ``` ``` set port 24 disable eth1 ``` ``` Invalid command: [Port 24 can only be enabled/disabled on all INTFPORT0|1|2|3 with option 'all'] ``` --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide37 ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- set port 24 disable eth2     ``` Invalid command: [Port 24 can only be enabled/disabled on all INTFPORT0|1|2|3 with option 'all'] ``` set port 24 disable eth3     ``` Invalid command: [Port 24 can only be enabled/disabled on all INTFPORT0|1|2|3 with option 'all'] ``` set port 24 disable all     ``` TCP port 24 disabled on all interfaces ``` ### For port 8505 You can only enable or disable port 8505 (ipsservice port) for all interfaces using the 'all' option. #### Syntax set port 8505 all This does not allow to enable or disable for the specific interface. #### Syntax set port 8505 disable eth0     ``` Invalid command: [Port 8505 can only be enabled/disabled on all INTFPORT0|1|2|3 using the 'all' option] ``` set port 8505 disable eth1     ``` Invalid command: [Port 8505 can only be enabled/disabled on all INTFPORT0|1|2|3 using the 'all' option] ``` set port 8505 disable eth2     ``` Invalid command: [Port 8505 can only be enabled/disabled on all INTFPORT0|1|2|3 using the 'all' option] ``` set port 8505 disable eth3     ``` Invalid command: [Port 8505 can only be enabled/disabled on all INTFPORT0|1|2|3 using the 'all' option] ``` set port 8505 disable all     ``` TCP port 8505 disabled on all interfaces ``` ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands ---     TCP port 8505 disabled on all interface # set port 6080 You can enable or disable port 6080 for specified interfaces or for all interfaces using this command. - Enable or disable the port 6080 on eth0 interface.         **Syntax:**         `set port 6080 <enable or disable> eth0` - Enable or disable the port 6080 on eth1 interface.         **Syntax:**         `set port 6080 <enable or disable> eth1` - Enable or disable the port 6080 on eth2 interface.         **Syntax:**         `set port 6080 <enable or disable> eth2` - Enable or disable the port 6080 on eth3 interface.         **Syntax:**         `set port 6080 <enable or disable> eth3` - Enable or disable the port 6080 on all eth interfaces.         **Syntax:**         `set port 6080 <enable or disable> all` vATD supports only two interfaces (eth0 and eth1), but actual appliance supports four interfaces (eth0, eth1, eth2 and eth3). So when you enable or disable the port for interfaces eth2 and eth3 in vATD, you will the message as " not supported for vATD". **Syntax:** `set port 6080 disable eth2`     eth2 not supported for vATD **Syntax:** ## 1 | CLI commands --- `set port 6080 disable eth3` ``` eth3 not supported for vATD ``` # set appliance gateway Specifies the IPv4 address of the gateway for the **Intelligent Sandbox Appliance**. **Syntax:** `set appliance gateway <A.B.C.D>` | **Parameter** | **Description** | | --- | --- | | | A 32-bit address written as four eight-bit numbers separated by periods. A, B, C or D represents an eight-bit number between 0–255. | **Example:** ``` set appliance gateway 192.34.2.8 ``` # set appliance gateway6 Specifies the IPv6 address of the gateway for the **Intelligent Sandbox Appliance**. **Syntax:** `set appliance gateway6 <A:B:C:D::E>` | **Parameter** | **Description** | | --- | --- | | | An IPv6 address. | **Example:** ``` set appliance gateway6 2400:0:44a:5::1 ``` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ## set appliance ip Specifies the **Intelligent Sandbox Appliance** IPv4 address and subnet mask. Changing the IP address requires a restart for the changes to take effect. See the `reboot` command for instructions on how to reboot the **Intelligent Sandbox Appliance**. **Syntax:** `set appliance ip <A.B.C.D E.F.G.H>` | Parameter | Description | | --- | --- | | | Indicates an IPv4 address followed by a netmask. The netmask strips the host ID from the IP address, leaving only the network ID. Each netmask consists of binary ones (decimal 255) to mask the network ID and binary zeroes (decimal 0) to retain the host ID of the IP address (For example, the default netmask setting for a Class C address is 255.255.255.0). | | dhcp | Allows **Intelligent Sandbox Appliance** to receive its IP configuration from a DHCP server. | **Example:** `set appliance ip 192.34.2.8 255.255.0.0` ## set appliance ipv6 Specifies the **Intelligent Sandbox Appliance** IPv6 address and the prefix length of an appliance. If you change the IP address, you must restart the appliance. See the `reboot` command for instructions to reboot the **Intelligent Sandbox Appliance**. **Syntax:** `set appliance ipv6 <A:B:C:D::E> <1-128>` | Parameter | Description | | --- | --- | | | An IPv6 address followed by a prefix length. | | <1-128> | Prefix length of the appliance that ranges from 1-128. | --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 41 [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- **Example:** ``` set appliance ipv6 2400:0:44a:5::182:76 64 ``` # set appliance name Sets the name of the **Intelligent Sandbox Appliance**. This name is used to identify the **Intelligent Sandbox Appliance** if you integrate it with **Network Security Platform**. **Syntax:** set appliance name     | **Parameter** | **Description** | | --- | --- | | | Indicates a case-sensitive character string up to 25 characters. The string can include hyphens, underscores, and periods, and must begin with a letter. | **Example:** set appliance name SanJose_MATD1 ## set gti dns check This command requires DNS to be set for **McAfee GTI** to work. By default this command is set to disabled, which means that if there is no internet access, **McAfee GTI** works fine. If this command is enabled, **McAfee GTI** will not work unless **Intelligent Sandbox** is connected to the Internet and resolves **McAfee GTI** lookup URLs. You need to restart amas for these changes to reflect in **Intelligent Sandbox**. **Syntax:** set gti dns check **Example:** ATD-6000> set gti dns check enable DNS access check is now enabled ATD-6000> set gti dns check disable DNS access check is now disabled 1 | CLI commands ## set gti server ip Sets to a valid GTI Private Cloud using its IP address. **Syntax:** set gti server ip     | Parameter | Description | | --- | --- | | | Enter the IP address for the GTI Private Cloud. | ## set gti server url Sets to a valid GTI Private Cloud using its URL. **Syntax:** set gti server url     | Parameter | Description | | --- | --- | | | Enter the URL for the GTI Private Cloud. | ## set gti server ip 0.0.0.0 Resets GTI to Public Cloud. **Syntax:** set gti server ip 0.0.0.0 ## set gti server url 0.0.0.0 Resets GTI to Public Cloud. **Syntax:** set gti server url 0.0.0.0 [1 | CLI commands](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) --- # set intfport Enable or disable the **Intelligent Sandbox** interface ports. **Syntax:** ``` set intfport <1><2><3> ``` **Example:** `set intfport 1 enable` ## set intfport <1-3> ipdelete Removes IP addresses assigned to an interface. **Syntax:** ``` set intfport <1-3> ipdelete ``` | **Parameter** | **Description** | | --- | --- | | <1-3> | Enter one of the three available ports. | | | Enter the IP address that you want to remove. | **Example:** ``` set intfport 1 ipdelete 0.0.0.0 Interfaceport 1 IP deleted successfully ``` # set intfport auto Sets an interface port to auto-negotiate the connection with the immediate network device. **Syntax:** ``` set intfport <1><2><3> auto ``` **Example:** ``` set intfport 1 auto ``` --- 44 Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ## set intfport ip Sets an IP address to an interface port. **Syntax:** set intfport <1><2><3> ip A.B.C.D E.F.G.H **Example:** set intfport 1 ip 10.10.10.10 255.255.255.0 ## set intfport speed duplex Configures the speed and duplex setting on the specified interface port. **Syntax:** set intfport <1><2><3> speed <10 | 100> duplex | **Parameter** | **Description** | | --- | --- | | <1> <2> <3> | Specifies the interface port ID that you want to use to configure the speed and duplex. | | <10 \| 100> | Configures the speed on the interface port. The speed value can be either 10 or 100. | | | Configures the duplex setting on the interface port. Set the value "half" for half duplex, and full for 'full' duplex. | **Example:** set intfport 1 speed 100 duplex full ## set ipAddressSwap When you submit samples for analysis through **Network Security Platform**, the source and destination IP information is swapped for the submitted samples. To reverse the aberration caused by Network Security Platform, Intelligent Sandbox enables set IPAddressSwap command. This --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 45 ## 1 | CLI commands --- command nullifies the swap effect of **Network Security Platform** and displays the correct the source and destination IP information for samples submitted through **Network Security Platform**. When samples are submitted from **Forcepoint NGFW** to **Intelligent Sandbox**, the source and destination IP information are displayed correctly. Based on the preference, you can use the following command to enable or disable IPAddressSwap. **Syntax:** `set ipAddressSwap <enable><disable>` By default, set ipAddressSwap is enabled. **Example:** `set ipAddressSwap enable` ## set ldap enable|disable Enables or disables LDAP authentication. Make sure that all LDAP parameters are configured correctly in the web interface to use this command LDAP. **Syntax:** `set ldap enable|disable` | Parameter | Description | | --- | --- | | enable | Enables LDAP authentication. | | disable | Disable LDAP authentication. | **Example:** ``` set ldap disable Disabling ldap support... Note: Authentication method got changed! Terminating matdcli session in 10 seconds! Please login again! ``` ## set malware-dns Use this command to configure the malware DNS IPv4/IPv6 that **Intelligent Sandbox** uses to route the malware DNS queries. **Syntax:** `set malware-dns A.B.C.D/A:B:C:D::E` ---     46     Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide ## 1 | CLI commands --- ### Example: ``` set malware-dns 192.168.200.110 ``` ``` set malware-dns 2001:4860:4860::6464 ``` ## set malware-intfport Configure the required port to route Internet traffic from an analyzer VM. > ![Note icon](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/intelligent-sandbox-5.0.x-command-line-interface-reference-guide_page_0047_img_03.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A30%3A38Z&se=2026-11-22T15%3A30%3A38Z&sr=c&sp=r&sig=olqwKRylrwCg7cRMLuraGj46bUR5vHuJH5TiDItxGX4%3D) **Note** > > >     >     > > Before you run this command, make sure that the required port is enabled and configured with an IP address. **Syntax:** `set malware-intfport <1><2><3> gateway A.B.C.D` **Example:** `set malware-intfport 1 gateway 10.10.10.252` Run the `show intfport 1` and verify the **Malware Interface Port** and **Malware Gateway** entries. **Intelligent Sandbox** uses the configured port to provide Internet access to analyzer VMs. ## set mgmtport auto Configures the network port to auto-negotiate the connection between the **Intelligent Sandbox Appliance** and the immediate network device. This command has no parameters. **Syntax:** ``` set mgmtport auto ``` **Default Value:** By default, the network port is set to **auto** (auto-negotiate). ## set malware-intfport mgmt By default, Internet access to analyzer VMs is through the **Trellix Intelligent Sandbox's** management port (eth-0). Use this command, if you had configured a different port for routing Internet traffic and want to revert to the management port. **Syntax:** `set malware-intfport mgmt` --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 47 ## 1 | CLI commands --- Run the `show intfport mgmt` and verify the Malware Interface Port and Malware Gateway entries. **Trellix Intelligent Sandbox** uses the management port to provide Internet access to analyzer VMs. ### set maxusers Enables you to configure **Intelligent Sandbox** users limit from the range 128 to 512. By default, the value is set to 128. **Syntax:** set maxusers <128-512> | **Parameter** | **Description** | | --- | --- | | <128-512> | Specifies the number of users you can create in the range from 128 to 512. | When the action is successful, the command displays a following message. ``` Max users value is set ``` #### Example: ``` set maxusers 250 ``` **Sample output:** ``` set maxusers 250 Max users value is set to 250 ``` ### set mgmtport speed and duplex Configures the network port to match the speed of the network device connecting to the **Intelligent Sandbox Appliance**, then runs in full- or half-duplex mode. **Syntax:** set mgmtport duplex > | **Parameter** | **Description** | | --- | --- | | <10 \| 100> | Specifies the speed on the Ethernet network port. The speed value can be either 10 or 100 Mbps. To | ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | | set the speed to 1000 Mbps, use the set mgmtport auto command. | | | Specifies the duplex setting on the Ethernet network port. - half — Half duplex - full — Full duplex | **Default Value:** By default, the network port is set to **auto** (auto-negotiate). ## set pdflinks Enable or disable validation operation performed by McAfee GTI on links embedded inside PDFs during dynamic analysis. **Syntax:** set pdflinks **Sample Output:** set pdflinks enable Enable pdflinks operation ## set emailConnector interface Enables you to configure any ethernet port as EC interface, Intelligent Sandbox opens port 25 on the configured interface .The default Email Connector interface is **mgmt**. **Syntax** set emailConnector interface **Example** set emailConnector interface intf3 ## set fips enable|disable Enables or disables FIPS mode in **Intelligent Sandbox** **Syntax:** set fips enable --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 49 ## 1 | CLI commands --- This will enable FIPS mode in **Intelligent Sandbox**.Device will go on reboot to take into effect. **set fips disable**: This will disable FIPS mode in **Intelligent Sandbox**.Device will go on reboot to take into effect. **show fips**: This will show FIPS enabled/disabled in **Intelligent Sandbox** . # set filesizes Enables you to change the minimum and maximum file sizes. **Syntax:** set filesizes | Parameter | Description | | --- | --- | | type number | Type of file submitted for analysis. | | minimum size | Minimum file size. | | maximum size | Maximum file size. | | restart engine | Uses a value of 1 or 0. 1 — Restart AMAS service; this is needed for NSP and NGFW integration. 0 — Keeps AMAS service running; use this when submission is through GUI/RestAPI. | | Type number | File description | Default Minimum Size | Default Maximum Size | Configurable Minimum | Configurable Maximum | | --- | --- | --- | --- | --- | --- | | 1 | Windows portable executable (PE) exe, dll or sys file | 1024 bytes | 10 MB | 100 | 128000000 | ## 1 | CLI commands --- | **Type number** | **File description** | **Default Minimum Size** | **Default Maximum Size** | **Configurable Minimum** | **Configurable Maximum** | | --- | --- | --- | --- | --- | --- | | 2 | PDF document file with .pdf extension | 2048 bytes | 25 MB | 100 | 128000000 | | 3 | Java class data file with .class extension | 1024 bytes | 5 MB | 100 | 128000000 | | 4 | Microsoft Office older files with .doc, .ppt or .xls extension | 5120 bytes | 10 MB | 100 | 128000000 | | 5 | Microsoft rich text format file with .rtf extension | 1024 bytes | 10 MB | 100 | 128000000 | | 6 | .zip file, APK file, or newer Microsoft Office file with .docx, .pptx or .xlsx extension | 200 bytes | 20 MB | 100 | 128000000 | | 7 | JPEG image file | 5120 bytes | 1 MB | 100 | 128000000 | | 8 | PNG image file | 5120 bytes | 1 MB | 100 | 128000000 | | 9 | GIF image/bitmap file | 5120 bytes | 1 MB | 100 | 128000000 | | 10 | Microsoft DOS executable file with .com extension | 1024 bytes | 5 MB | 100 | 128000000 | --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 51 | Type number | File description | Default Minimum Size | Default Maximum Size | Configurable Minimum | Configurable Maximum | | --- | --- | --- | --- | --- | --- | | 1 1 | Flash file with .swf extension | 1024 bytes | 5 MB | 100 | 128000000 | | 1 2 | 7-zip compressed archive file with .7z extension | 200 bytes | 10 MB | 100 | 128000000 | | 1 3 | RAR compress archive file with .rar extension | 200 bytes | 10 MB | 100 | 128000000 | | 1 4 | Microsoft cabinet compressed archive file with .cab and .msi extension | 200 bytes | 10 MB | 100 | 128000000 | | 1 5 | Miscellaneous text or script files, such as .js, .bat, .vbs, .xml, .URL, .htm. | 100 bytes | 1 MB | 100 | 128000000 | | 1 6 | ACE archive data | 200 bytes | 10 MB | 100 | 128000000 | | 1 7 | Gzip archive data | 100 bytes | 10 MB | 100 | 128000000 | | 1 8 | ISO 9660 CD-ROM filesystem data | 100 bytes | 10 MB | 100 | 128000000 | | 1 9 | News or mail, ASCII text, with CRLF line terminators | 100 bytes | 10 MB | 100 | 128000000 | ## 1 | CLI commands --- | Type number | File description | Default Minimum Size | Default Maximum Size | Configurable Minimum | Configurable Maximum | | --- | --- | --- | --- | --- | --- | | 20 | XZ compressed data | 200 bytes | 10 MB | 100 | 128000000 | For example, if you want to change the minimum file size of a JPEG image file to 300 bytes, then run the command: `set filesizes 7 300 1000000 0`. > Note > > >     >     > > Make sure that the file size you specify is within the configurable minimum and configurable maximum value range. ## Set FTP > Note > > >     >     > > In Common Criteria (CC) mode, FTP is not supported. **Syntax:** `set ftp <enable><disable>` By default, FTP is disabled. **Example:** `set ftp enable` ## set internal net sandbox Sets new IP network for the sandbox VMs. **Syntax:** `set internal net sandbox <ip address>` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- | Parameter | Description | | --- | --- | | | Type the IP address that you want to set for the sandbox VMs. Use one of the following IP addresses: - 192.168.122.0 - 192.168.50.0 - 192.168.112.0 | ## set internal net emailconnector Enable or Disable the IP network for the Email Connector. For more information on Email Connector, see *Intelligent Sandbox Installation Guide*. Syntax: `set internal net emailconnector <enable|disable>` | Parameter | Description | | --- | --- | | | Enables the email connector network 192.168.55.0/24. | | | Disables the email connector network 192.168.55.0/24. | ## logconfig Set the debugging mode to be applied for logs. Syntax: `logconfig <module> <enable| | <disable>` The following information is displayed using this command: ``` AMAS        Enable logconfig support  Summary      Disable logconfig support IPS AvDat CLI EPO Monitor Amaslib ``` ## 1 | CLI commands --- ``` GTI GAM MAV Scanners LB DXL INI SNMP YARA TELEMETRY LDAP CONFIG TEP RestAdapter WrapperTool ``` ## set mar-timeout Configure a timeout period after which **Intelligent Sandbox** stops querying MAR server for results. The supported timeout range is 1 to 3600 seconds. **Syntax:** `set mar-timeout <seconds>` **Example:** ``` >set mar-timeout 60 Updated the MAR timeout value to 60 seconds ``` ## set nsp-tcp-channel enable | disable Enables or disables communication between **Network Security Platform** and **Intelligent Sandbox** over TCP. **set nsp-tcp-channel enable:** - This will switch Intelligent Sandbox to use TCP channel to communicate with Network Security Platform. - When the command `set nsp-tcp-channel enable` is executed in Intelligent Sandbox, check the MATD channel in use in Network Security Platform. - Log on to the Sensor CLI and enter into debug mode. - Execute the CLI command `show matd channel`. - If the MATD Network Security Platform channel type is seen as SSL, execute the CLI command `switch matd channel tcp` to switch to TCP channel. - Execute `set amchannelencryption off`. **set nsp-tcp-channel disable:** - This will switch Intelligent Sandbox to use SSL encrypted channel to communicate with Network Security Platform. - Encrypted data transfer from Network Security Platform. ## 1 | CLI commands --- - When SSL encryption is enabled on **Intelligent Sandbox** and **Network Security Platform**, the data sent from **Network Security Platform** to **Intelligent Sandbox** is encrypted. - There would be no support for NULL cipher from 4.10.x release onwards. - When the command `set nsp-tcp-channel disable` is executed in **Intelligent Sandbox**, check the MATD channel in use in **Network Security Platform**. - Log on to the Sensor CLI and enter into the debug mode. - If the MATD **Network Security Platform** channel type is seen as TCP, execute the CLI command `switch matd channel SSL` to switch to SSL channel. - Execute `set amchannelencryption on`. **Syntax:** ``` set nsp-tcp-channel enable | disable ``` | Parameter | Description | | --- | --- | | enable | Enable TCP channel support | | disable | Disable TCP channel support | **Example:** ``` set nsp-tcp-channel enable NSP TCP Channel Support Enabled and restarted service ``` ## set network analysis **Intelligent Sandbox** can analyze pcaps and provide more information regarding the network activities of the sample. By default, network analysis status is enabled and you can disable it from cli commands. **Syntax:** `set network analysis enable` Intelligent Sandbox can analyze pcap files and provide more information regarding the network activities of the sample. `set network analysis disable` Intelligent Sandbox will not analyze pcap files. `show network analysis status` Allows you to see status of network analysis. 1 | CLI commands --- ## set resultbackup Use this command to back up old reports and results to the FTP server during disk cleanup. When enabled, **Intelligent Sandbox** backs up old reports and results before disk cleanup. **Syntax:** set resultbackup ## set stixreportstatus Use this command to enable or disable the STIX report generation. This command has no parameters. **Syntax:** set stixreportstatus By default, stixreportstatus is disabled. **Example:** set stixreportstatus ## set clearblacklist enable | disable | status This command enables or disables a flag for clearing the blacklist from the database while uploading a detection package. By default, this command is disabled. **Syntax:** set clearblacklist enable|disable|status | Parameter | Description | | --- | --- | | enable | Enable the flag to clear the blacklist after installing the detection package. | | disable | Disable the flag to prevent the blacklist from getting cleared after installing the detection package. | | status | Displays the blacklist clear flag status as 0 or 1. | - If flag status = 0, then it is disabled. - If flag status = 1, then it is enabled. **Example:** --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 57 ## 1 | CLI commands --- ``` set clearblacklist enable Alert: Blacklist will be cleared during detection package upload. set clearblacklist disable Blacklist will NOT be cleared during detection package upload. set clearblacklist status Blacklist DB clear flag status = 0 or 1 ``` ## set sysloglimit Use this command to set the syslog message limit. The syslog limit refers to the number of syslog messages displayed in the user interface by selecting **Manage → Logs → Syslog**. The number of messages displayed ranges from 1000 to 25000. When there is a high volume of sample submissions or VM creations consuming system resources, the UI may take longer to load syslog messages if the maximum range of 25000 is configured. **Syntax:** set sysloglimit <1000-25000> | Parameter | Description | | --- | --- | | <1000-25000> | Sets syslog limit ranging from 1000-25000. | **Example:** ``` set sysloglimit 15000 Syslog limit value set to 15000 ``` ## set timeout <0-35791> Sets timeout for the CLI session. **Syntax:** set timeout <0-35791> | Parameter | Description | | --- | --- | | <0-35791> | The command accepts the input value in **minutes**. The session timeout value is then displayed in | --- ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | | seconds. | **Example:** ``` set timeout 600 CLI session timeout value set to 36000 seconds ``` ### set uilog Sets the amount of web interface access information to be logged. Level ranges from 0 to 7. **Syntax:** set uilog | **Parameter** | **Description** | | --- | --- | | | Sets the amount of UI access information to be logged. | **Example:** ``` ATD-6000> set uilog 5 new log level is 5 ``` ### set ui-timeout Specifies the number of minutes the Intelligent Sandbox web interface is inactive before the connection times out. **Syntax:** set ui-timeout <60 - 86400> ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- | Parameter | Description | | --- | --- | | <60 - 86400> | You can set a timeout period from 60 to 86,400 seconds. | **Example:** `set ui-timeout 600` **Default Value:** 15 minutes ## show Shows all the current configuration settings on the **Intelligent Sandbox Appliance**. This command has no parameters. **Syntax:** `show` **Example:** ``` ATD-3000-62> show [Appliance Info] System Name: ATD-3000-62 Date: Tue Sep 25 11:27:34 2018 TZ Name: America/Los_Angeles System Uptime: 20 hrs 28 min 25 secs System Type: ATD-3000 Serial Number: A0A3308010 Software Version: 4.6.0.2 license Status: Valid License Expires in: Never expires MGMT Ethernet port: auto negotiated to 1000 mbps, full duplex, link up [Appliance Network Config] IP Address (dhcp): 10.71.119.62 IPv6 Address: 2403:0:55a:3::214:229/64 Netmask: 255.255.255.0 Default Gateway: 10.71.119.252 Default Gateway IPv6: 2403:0:55a:3::1 DNS domain: nai.org primary nameserver: 161.69.96.5 secondary nameserver: 161.69.5.201 ``` ## show consoleLogLevel **Syntax** `show consoleLogLevel` 1 | CLI commands --- ### Example show consoleLogLevel Console logging level 4 # show dat version View the current DAT version of analyzing options. **Syntax:** show dat version **Sample Output:** ``` AV   DAT     version=7868 AV   Engine  version=5700 GAM  DAT     version=3811 GAM  Engine  version=7001.1302.1842 ``` ## show ds status View the status of all analyzing options. **Syntax:** show ds status This command has no parameters. **Sample Output:** GTI is alive MAV is alive GAM is alive Yara is alive ## show emailConnector Displays the configured parameters for the EC along with the health status. **Syntax** show emailConnector Information displayed by the show emailConnector command includes: --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide61 ## 1 | CLI commands --- - **Email Connector status:** enabled or disabled - **Listen Port:** SMTP port number that **Intelligent Sandbox** is listening on for the configured **Intelligent Sandbox** interface - **Interface:** EC interface where **Intelligent Sandbox** is listening - **Smart Hosts:** Configured relay host details - **Maximum time per email:** Maximum time to wait for all scans to complete, default value is 600s - **Normal Mode:** enabled or disabled - **EC Health status:** Not Enabled or Healthy or Degraded - **Skip Protected Files:** enabled or disabled. ## show epo-stats nsp Displays the number of requests sent to **McAfee ePO**, the count of responses received from **McAfee ePO**, and the count of requests that failed. **Syntax:** `show epo-stats nsp` This command has no parameters. ## show filequeue Displays the file queue statistics, such as the estimated average processing time, analyzing time, and files that are pending. This command has no parameter. **Syntax:** `show filequeue` Following is the information displayed by the `show filequeue` command: ``` Processing   Time:   58.00 Analyzing    Time:   58.00 Files in waiting: 0 files in SandBox: 0 Estimated average processing time for all samples:    58.00 seconds ``` ## show filesizes Displays all the filetypes supported by **Intelligent Sandbox** with details such as type number, minimum and maximum file size, and short description. This command has no parameters. **Syntax:** `show filesizes` ## 1 | CLI commands --- Following is the information displayed by the `show filesizes` command: | Type number | File description | Minimum size | Maximum size | | --- | --- | --- | --- | | 1 | Windows portable executable (PE) file, PE+ file, dll and sys file | 1024 bytes | 10 MB | | 2 | PDF document file with .pdf extension | 2048 bytes | 25 MB | | 3 | Java class data file with .class extension | 1024 bytes | 5 MB | | 4 | Microsoft Office older files with .doc, .ppt or .xls extension | 5120 bytes | 10 MB | | 5 | Microsoft rich text format file with .rtf extension | 1024 bytes | 10 MB | | 6 | Zip file, APK file, or newer Microsoft Office file with .docx, .pptx or .xlsx extension | 200 bytes | 20 MB | | 7 | JPEG image file | 5120 bytes | 1 MB | | 8 | PNG image file | 5120 bytes | 1 MB | | 9 | GIF image/bitmap file | 5120 bytes | 1 MB | | 10 | Microsoft DOS executable file with .com extension | 1024 bytes | 5 MB | | 11 | Flash file with .swf extension | 1024 bytes | 5 MB | | 12 | 7-zip compressed archive file with .7z extension | 200 bytes | 10 MB | ## 1 | CLI commands ---     | **Type number** | **File description** | **Minimum size** | **Maximum size** | | --- | --- | --- | --- | | 13 | RAR compress archive file with .rar extension | 200 bytes | 10 MB | | 14 | Microsoft cabinet compressed archive file with .cab and .msi extension | 200 bytes | 10 MB | | 15 | Miscellaneous text or script files, for example .js, .bat, .vbs, .xml, .py, .url, .htm etc | 100 bytes | 10 MB | ### show ftp Use this command to know if FTP is enabled or disabled currently. By default, FTP is disabled. **Syntax:** `show ftp` ### show gti dns Checks the status of DNS lookup for GTI queries. If the status is enabled, then ensure that Intelligent Sandbox has access to the DNS for the GTI queries to be generated. **Syntax:** `show gti dns` This command has no parameters. **Example:** ``` show gti dns DNS access check is disabled ``` ### show gti server Displays the current configuration of your McAfeeMcAfee GTI integration. **Syntax:** `show gti server` This command has no parameters. [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#1) | CLI commands --- **Example:** ``` show gti server GTI Server configured to Private Cloud Private Cloud address: example.com ``` ## show hardware Displays hardware information based on the command parameter. **Syntax:** show hardware > ![Blue note icon showing a pencil and square.](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/intelligent-sandbox-5.0.x-command-line-interface-reference-guide_page_0065_img_02.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A30%3A38Z&se=2026-11-22T15%3A30%3A38Z&sr=c&sp=r&sig=olqwKRylrwCg7cRMLuraGj46bUR5vHuJH5TiDItxGX4%3D) **Note** > > >     >     > > This command is not available for Virtual **Intelligent Sandbox**.     | **Parameter** | **Description** | | --- | --- | | | Displays the list of parameters for this command. | | | Replace with **save**. This optional keyword allows you to save the output to a file instead of displaying it. The file is saved in the ~atdadmin directory where it can be access using SFTP by logging on as atdadmin. The filenames are shown in the following table. | | diskinfo | Display the RAID, HDD, and SSD diagnostic information. | | ldtlog | Displays the LDT summary log. > ![Blue note icon showing a pencil and square.](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/intelligent-sandbox-5.0.x-command-line-interface-reference-guide_page_0065_img_02.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A30%3A38Z&se=2026-11-22T15%3A30%3A38Z&sr=c&sp=r&sig=olqwKRylrwCg7cRMLuraGj46bUR5vHuJH5TiDItxGX4%3D) **Note** > > > > > > Ensure that the run the ldt tool before you run this command. For more information, see *run ldt topic*. | | rmm | Displays the RMM hardware and system firmware information. | ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | sdr | Displays the repository entries and readings of the sensor data. | ## show history Displays the list of CLI commands issued in the session. **Syntax:** show history This command has no parameters. ## show internal net Displays the list of all configured network. **Syntax:** show internal net **Example:** ``` ATD-6000>show internal net Name                    Network               Status ----------------------------------------------- sandbox                 192.168.122.0         Active emailconnector          192.168.55.0          Active ``` ## show intfport Shows the status of the specified interface port or the management port of Trellix Intelligent Sandbox. **Syntax:** show intfport <1><2><3> Information displayed by the show intfport command includes: - Whether the port's administrative status is enabled or disabled. - The port's link status. - The speed of the port. - Whether the port is set to half or full duplex. - Total packets received. - Total packets sent. - Total CRC errors received. 66 Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide ## 1 | CLI commands --- - Total other errors received. - Total CRC errors sent. - Total other errors sent. - IP address of the port. - MAC address of the port. - Whether the port is used to provide Internet access to analyzer VMs. - If configured to provide Internet access to analyzer VMs, then the corresponding gateway for this traffic. ## show ipAddressSwap Use this command to know if ipAddressSwap is enabled or disabled currently. By default, FTP is enabled. **Syntax:** `show IPAddressSwap` See also: [set ipAddressSwap](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#). ## show ldap Displays the configured parameters for LDAP authentication. **Syntax:** `show ldap` This command has no parameters. **Example:** ``` show ldap +++++ LDAP Configuration +++++ LDAP username                 : (null) Base DN                       : (null) LDAP Login Attribute          : (null) LDAP Search scope             : subtree LDAP Auth Method              : Simple LDAP Server                   : IP:[(null)] Port:[0] LDAP Service status           : DOWN LDAP Fallback status          : DISABLE ``` ## show license info Displays the license information of the appliance. **Syntax:** `show license info` ## 1 | CLI commands --- This command has no parameters. **Example:** ``` show license info ATD License Manager, on non-license-restricted platform Authorized to SystemId  : NA Valid before date       : Infinity ``` ## show license status Displays the license status of the appliance. **Syntax:** `show license status` This command has no parameters. **Example:** ``` show license status ATD License Manager, on non-license-restricted platform Valid License ``` ## show logconfig Lists the current debug mode employed for debugging. **Syntax:** `show logconfig` This command has no parameters. **Sample Output:** Logging is ON, mode: send to syslog ## show mar-timeout Displays a configured timeout period after which Intelligent Sandbox stops querying MAR server for results. **Syntax:** `show mar-timeout` This command has no parameters. **Default value:** 60 Seconds. **Sample Output:** MAR Timeout is currently set to 90 seconds [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ## show maxusers View the maximum users configured on **Intelligent Sandbox**. **Syntax:** `show maxusers` **Sample output:** ``` Max users configured is 250 Max users configured is 315 Max users configured is 512 ``` ## show pdflinks view whether or not validation operation is performed by **McAfee GTI** on links embedded inside PDFs during dynamic analysis. **Syntax:** `show pdflinks` This command has no parameters. **Sample Output:** GTI validation of PDF URLs is OFF ## show msu Displays all the msu files copied to **Intelligent Sandbox** via SFTP. **Syntax:** `show msu` ## show nsp scandetails Shows the file scan details regarding the integrated IPS Sensors. **Syntax:** `show nsp scandetails <Sensor IP address>` If you do not specify the Sensor IP address, the details are displayed for all the Sensors integrated with the **Intelligent Sandbox Appliance**. Information displayed by the `show nsp scandetails` command includes: - The IP address of the IPS Sensor. - Total number of packets received from the Sensor. - Total number of packets sent to the Sensor. - The timestamp of when the last packet was sent to and received from the Sensor. - The encryption method used for the communication with the Sensor. --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 69 ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- - Session handle null counts. - Count of internal errors. - Count of unknown commands received from the Sensor. - File string null. - File data null. - Count of unknown files. - Count of out of order packets. - Count of MD5 mismatches between what was sent by the Sensor and what was calculated by **Intelligent Sandbox**. - Count of memory allocation failures. - File transfer timeout. - New file count. - Count of shared memory allocation failures. - Count of the number of static analysis responses sent. - Count of the number of dynamic analysis responses sent. - Count of scan request received. - MD5 of the last file that was streamed by the Sensor. # show nsp-ssl-channel-encryption status Displays the SSL channel encryption status for **Network Security Platform**. **Syntax:** `show nsp-ssl-channel-encryption status` | Parameter | Description | | --- | --- | | status | Displays the SSL channel encryption status for **Network Security Platform**. | ### Example: ``` show nsp-ssl-channel-encryption status NSP SSL Channel Encryption is Enabled. ``` # show port80 Displays the status of HTTP port 80. **Syntax:** [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- show port80 This command has no parameters. **Example:** ``` show port80 HTTP port 80 is closed or blocked ``` ## show port The command displays whether the port (24, 8505, 6080) is enabled or disabled. **Syntax:** show port **Sample Output:** For vATD, ``` Port 6080: Enabled on - eth0, eth1 | Disabled on - NA Port 24: Enabled on all interfaces Port 8505: Enabled on all interfaces ``` For ATD, ``` Port 6080: Enabled on - eth0, eth1, eth2, eth3 | Disabled on - NA Port 24: Enabled on all interfaces Port 8505: Enabled on all interfaces ``` ## show resultbackup This command displays the resultbackup status. **Syntax:** show resultbackup ## show route Displays the routes that you configured using the route add command as well as the system IP routing table. **Syntax:** --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 71 ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- `show route` The details from a sample output of the command in the following table. ### System IP routing table | Destination | Gateway | Genmask | Flags | Metric | Ref | Use | Iface | | --- | --- | --- | --- | --- | --- | --- | --- | | 10.10.10.0 | 0.0.0.0 | 255.255.255.0 | U | 0 | 0 | 0 | mgmt | | 11.11.11.0 | 0.0.0.0 | 255.255.255.0 | U | 0 | 0 | 0 | mgmt | | 12.12.0.0 | 0.0.0.0 | 255.255.0.0 | U | 0 | 0 | 0 | mgmt | | 13.0.0.0 | 0.0.0.0 | 255.0.0.0 | U | 0 | 0 | 0 | mgmt | | 0.0.0.0 | 10.10.10.253 | 0.0.0.0 | UG | 0 | 0 | 0 | mgmt | ## show route6 Displays IPv6 routes that you have configured using the route add command as well as the system IP routing table. **Syntax:** `show route6` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- ### System IP routing table | Destination | Next Hop | Flags | Metric | Ref | Use | Iface | | --- | --- | --- | --- | --- | --- | --- | | 2403:0:55a:3::/64 | :: | U | 100 | 11 | 0 | mgmt | | fe80::/64 | :: | U | 100 | 1 | 0 | mgmt | | fe80::/64 | :: | U | 256 | 1 | 0 | 1 | | ::/0 | 2403:0:55a:3::1 | UG | 100 | 17 | 0 | mgmt | | 2403:0:55a:3::/128 | :: | Un | 0 | 3 | 0 | mgmt | | 2403:0:55a:3::214:2 29/128 | :: | Un | 0 | 9 | 0 | mgmt | | fe80::/128 | :: | Un | 0 | 3 | 0 | mgmt | | fe80::20c:29ff:fe5a:7077/128 | :: | Un | 0 | 7 | 0 | mgmt | | ff00::/8 | :: | U | 256 | 4 | 0 | mgmt | ## show stixreportstatus Displays the current status of the stixreportstatus. This command has no parameter. **Syntax:** `show stixreportstatus` **Sample Output:** STIX reporting is OFF ## show sysloglimit Use this command to view the current syslog limit. This command has no parameters. You can view the limit on the Manage → Logs → Syslog page. **Syntax:** `show sysloglimit` --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 73 [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- Example: ``` show sysloglimit Syslog limit value is 15000 ``` # show system id Displays the system ID. **Syntax:** show system id This command has no parameters. **Example:** show system id ``` 71xxxxxxxx-xxxxxxx-xxxxx-xxxxxx-xxxxxxxxxxxxx ``` ## show taxii status View the TAXII status of the STIX file published by **Intelligent Sandbox**. **Syntax:** show taxii status This command has no parameters. **Example:** ``` [ TAXII Status for STIX file publish ] Configuration               : enable Channel Status              : UNKNOWN Stix Files Received Count   : 0 Stix Files Published Count  : 0 Stix Files Queued Count     : 0 ``` ## show tepublisherstatus Displays the status of **McAfee ePO** Threat Event Publisher. **Syntax:** show tepublisherstatus This command has no parameters. [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- **Example:** `show tepublisherstatus` ``` ********eP0 Threat Event Publisher Status******** tepublisher is not running ``` ## show timeout Displays the CLI timeout. **Syntax:** `show timeout` This command has no parameters. **Example:** `show timeout` ``` CLI session timeout is 360000 seconds. ``` ## show ui-timeout Displays the Intelligent Sandbox web interface client timeout in seconds. **Syntax:** `show ui-timeout` **Sample output:** `Current timeout value: 600` ## show uilog Check the current level of uilog. This command has no parameters. **Syntax:** `show uilog` Following is the information displayed by the `show uilog` command: ``` ATD-6000> show uilog Current log level is 7 ``` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- # show version application Displays the current and backup versions of the application software. **Syntax:** show version application This command has no parameters. **Example:** ``` ATD-3000-37> show version application Current VERSION=3.8.0.21.58782 Current LastModifiedTime=2016-12-04 17:23:29 Backup   VERSION=3.8.0.19.58759 Backup   LastModifiedTime=2016-12-02 02:01:23 ``` # show version detection Displays the current and backup versions of the detection software. **Syntax:** show version detection This command has no parameters. **Example:** ``` ATD-3000-37> show version detection Current VERSION=3.8.0.161202.58782 Current LastModifiedTime=2016-12-04 17:23:40 ``` # show vmImage This command displays the list of the VM Images in **Intelligent Sandbox**. **Syntax:** show vmImage **Example:** ATD-3000> show vmImage [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- `android` `winxpSp3` `win7sp1` `ATD-3000>` ## show waittime Displays the wait time threshold set for **Email Gateway**. **Syntax:** show waittime **Sample output:** Current MEG wait time threshold=780 seconds ## shutdown Stops the **Intelligent Sandbox Appliance** so you can power it down. Then, after about a minute, you can power down the **Intelligent Sandbox Appliance** manually and unplug both the power supplies. **Intelligent Sandbox Appliance** does not power off automatically. You must confirm that you want to shut it down. This command has no parameters. **Syntax:** `shutdown` ## status Shows **Intelligent Sandbox** system status, such as the health and the number of files submitted to various engines. This command has no parameters. > **Note** > > >     >     > > In the output, **Sample files received count: #** shows the count of number of samples submitted to **Intelligent Sandbox** for analysis. When archive samples are submitted, this count increases based on the number of files extracted. **Syntax:** status **Sample output:** System Health Status : good --- Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide 77 ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- Sample files received count: 300 Sample files submitted count: 300 GTI Scanner files submitted count: 50 GAM Scanner files submitted count: 100 MAV Scanner files submitted count: 200 Sandbox files submitted count: 25 Sandbox files finished count: 25 Sample files finished count: 300 Sample files error count: 0 # sync detectionpkg This command syncs detection packages from the Primary [Active] or Backup [Active] node to all other nodes in the LB cluster. Upon execution, this command displays a success, failure, or already-installed message for each node other than the active node. **Syntax:** ``` sync detectionpkg Are you sure to sync detection package to all nodes in cluster ? Please enter Y to confirm: y Syncing detection package to all nodes in cluster 10.253.214.183: SUCCESS 10.253.214.182: SUCCESS Sync detectionpkg command executed successfully. ``` This command has no parameters. # sync webcert This command syncs web certificates from the Primary [Active] or Backup [Active] node to all other nodes in the load balancer cluster. Before executing the command, you must ensure that the certificate to be synced is installed on the active node. This certificate must have a valid common name (CN) where the SAN field contains the IP addresses or FQDNs of all nodes in the cluster. **Syntax:** ## [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- sync webcert This command has no parameters. ``` sync webcert Use a certificate with a valid CN where the SAN field contains the IP addresses or FQDNs of all nodes in the cluster. Please enter Y to confirm: y Sync webcert command executed successfully. ``` ## sync yara behaviorrules This command syncs custom behavior rules from the Primary [Active] or Backup [Active] node to all other nodes in the LB cluster. Upon execution, this command displays a success, failure, or already-installed message for each node other than the active node. **Syntax:** sync yara behaviorrules This command has no parameters. ``` sync yara behaviorrules Are you sure to sync yara behavior rules to all nodes in cluster ? Please enter Y to confirm: y Syncing Current yara rule bheav.yara to all nodes in cluster 10.253.214.173: SUCCESS sync bheav.yara 10.253.214.22: SUCCESS sync bheav.yara No Backup yara rule present in Active node, Executing sync command. 10.253.214.173: SUCCESS 10.253.214.22: SUCCESS Sync yara behaviorrules command executed successfully. ``` # terminal Sets the number of lines to display on the Intelligent Sandbox web interface. **Syntax:** terminal |no | Parameter | Description | | --- | --- | | | Sets the number of lines to display. The value ranges from 0 - 512. | ## 1 | CLI commands --- | Parameter | Description | | --- | --- | | no | Negates the previous command or sets the default value. | ## tcpdump Capture tcpdump on any physical interface of **Intelligent Sandbox**. **Syntax:** `tcpdump <parameter>` > **Important** > > >     >     > > - Post tcpdump capture, the binary pcap files can be downloaded from **Intelligent Sandbox** web UI. File name: **atd_netdata.zip**. > - The maximum pcap file size is limited to 10 MB. The maximum pcap file count is limited to 25 files. > > > >     > > **Maximum file size:** Once, the maximum size is reached tcpdump automatically begins recording to a new file. > > > >     > > **Maximum file count:** Once, the maximum count is reached, tcpdump automatically overwrites the first and subsequent log file until the user stops the capture. | Parameter | Description | | --- | --- | | start | Starts the packet capture operation on the specified tcp dump. You can set custom port option using the following syntax: ``` tcpdump start ``` > **Note:** is a required parameter. Interface value should be eth0, eth1, eth2, or eth3. **Example:** `tcpdump start eth0 host_8.8.8.8` To set multiple filters, use *and* and *or* operators separated by underscores. **Example:** `tcpdump start eth0 host_8.8.8.8_and_port_53` | | stop | Stops the packet capture operation. | | clean | Removes tcpdump results and .zip files. | ## 1 | CLI commands --- | Parameter | Description | | --- | --- | | listfiles | Displays tcpdump output files. | | ls | Displays tcpdump output files. | | save | Saves .zip archive of tcpdump results to atdadmin account. | | status | Displays tcpdump progress status. | | view | Displays tcpdump results. | ## unlockuser Unlock a locked account. **Syntax** ``` unlockuser ``` | Parameter | Description | | --- | --- | | | Enter the username of the locked user account. | Example ``` unlockuser admin Unlock user: admin User unlocked! ``` ## update_avdat By default, **Intelligent Sandbox** updates the DAT files for the **Trellix** Gateway Anti-Malware Engine and **Trellix** Anti-Malware Engine every 90 minutes. To update these files immediately, use the `update_avdat` command. This command has no parameters. **Syntax:** ``` update_avdat ``` [1](/network-and-platform/docs/intelligent-sandbox-5-0-x-command-line-interface-reference-guide#) | CLI commands --- # uploadSupportBundle This command allows you to upload the support bundle to a specific FTP site. The bundle includes the following logs: - Configuration - Diagnostic - Debug - System - VM - Install - UI - Integration - Email connector - Hardware - Network capture pcap files - LDT Follow these steps to upload the support bundle. 1. In the console type `uploadSupportBundle`. 2. Type the relevant values and press **Enter** for each prompt. The command automatically creates the bundle, then uploads it to `<username>@<host IP>/<remote path>`. ## vmlist Displays a list of all the VMs configured in **Intelligent Sandbox**. **Syntax:** `vmlist` ## watchdog The watchdog process reboots the **Intelligent Sandbox Appliance** when an unrecoverable failure is detected. **Syntax:** `watchdog <on | off | status>` | Parameter | Description | | --- | --- | | | Enables the watchdog. | --- 82 Trellix Intelligent Sandbox 5.0.x Command Line Interface Reference Guide ## 1 | CLI commands --- | **Parameter** | **Description** | | --- | --- | | | Disables the watchdog. Use it if the appliance reboots continuously due to repeated system failure. | | | Displays the status of the watchdog process. | ## whitelistMerge Manually copy the Global Whitelist database of the Active node onto the Secondary or Backup nodes. This is only a one-time activity, after which the Whitelist database of Secondary/Backup nodes is automatically overwritten by that of Active node at 0000 hours on a daily basis. **Syntax:** whitelistMerge - `whitelistMerge <cluster>` executed on Active node of a cluster: In this scenario, the Global Whitelist database of the Active node is copied onto Secondary/Backup nodes and following sample output is displayed.         **Sample Output:**         Performing merge of whitelist dB from LB cluster nodes - `whitelistMerge <cluster>` executed on Secondary node or Backup node of a cluster: In this scenario, the following sample output is displayed.         **Sample Output:**         Not an active LB cluster node         Execute this command from active node in LB mode - `whitelistMerge <standalone>` executed on a standalone Intelligent Sandbox: In this scenario, the following sample output is displayed.         **Sample Output:**         Performing Whitelist Merge for standalone ## COPYRIGHT Copyright © 2026 Musarubra US LLC. Trellix and FireEye are the trademarks or registered trademarks of Musarubra US LLC, FireEye Security Holdings US LLC, and their affiliates in the US and /or other countries. Other names and brands are the property of these companies or may be claimed as the property of others.     ![Trellix logo — black Trellix wordmark with a small multicolored check/mark to the upper-right](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/intelligent-sandbox-5.0.x-command-line-interface-reference-guide_page_0084_img_01.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A30%3A38Z&se=2026-11-22T15%3A30%3A38Z&sr=c&sp=r&sig=olqwKRylrwCg7cRMLuraGj46bUR5vHuJH5TiDItxGX4%3D)