--- title: "Performing malware analysis" slug: "performing-malware-analysis-5" tags: ["Product Usage", "EX 11.x", "FX 11.x", "AX 11.x", "NX 11.x", "Customer", "Network Security"] updated: 2026-09-09T10:05:41Z published: 2026-09-09T10:05:41Z canonical: "docs.trellix.com/performing-malware-analysis-5" --- > ## 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. # Performing malware analysis The following topics explain how to perform malware analysis using the CLI: - [Submitting malware to the virtual machine for analysis](/network-and-platform/docs/performing-malware-analysis-5#submitting-malware-to-the-virtual-machine-for-analysis) - [Canceling pending machine analysis jobs](/network-and-platform/docs/performing-malware-analysis-5#canceling-pending-malware-analysis-jobs) - [Viewing the results for the malware analysis](/network-and-platform/docs/performing-malware-analysis-5#viewing-the-results-for-the-malware-analysis) - [Viewing malware submissions](/network-and-platform/docs/performing-malware-analysis-5#viewing-malware-submissions) ### Submitting malware to the virtual machine for analysis Use these commands in this topic to perform the following functions: - Download the malware to the specified URL. - Analyze the malware on the virtual machine of the appliance. - Show the results of the analysis. After you submit a malware sample to the Malware Analysis appliance, it is assigned a system-generated Malware ID. You can use this identifier to check the status of the submission. ### Prerequisites Before submitting malware to the virtual machine for analysis, verify that you have completed the requirements in the following order: 1. Configure the settings for the correct type of analysis. 2. Obtain malicious URLs and save them as a .txt file to your local machine. This file contains a single malicious URL per line, as shown in the following example: `http://172.16.146.53/AllObjects/doc_1370846` `http://172.16.146.53/AllObjects/doc_3429086` `http://172.16.146.53/AllObjects/doc_3523707` 3. Copy this .txt file to the */data/analysis* directory. You must have the correct credentials to access this directory. **To submit a single URL or file for analysis:** 1. Enable the CLI configuration mode. ```plaintext hostname > enable hostname # configure terminal ``` 2. Enter one of the following commands. For sandbox: ```plaintext hostname (config) # malware analyze sandbox ``` For live: ```plaintext hostname (config) # malware analyze live ``` 3. Assign a URL or file for analysis. ```plaintext hostname (config) # malware analyze sandbox url ``` where is the URL or file that is associated with the malware. For example: - `file:malware.exe` - `http://1.2.3.4/1.exehttp://1.2.3.4/1.exe` 4. (Optional) Specify a password to apply for an encrypted file submission. ```plaintext hostname (config) # malware analyze sandbox file filename password ``` 5. (Optional) Specify the interval after which the malware analysis times out if the analysis is not complete. ```plaintext hostname (config) # malware analyze sandbox url timeout ``` where is the value in seconds. The range is 30–3600 seconds. The default value is 500 seconds. 6. (Optional) Specify the priority for this analysis. The default value is the normal setting. To set a normal setting: ```plaintext malware analyze sandbox url priority normal ``` To set an urgent setting: ```plaintext malware analyze sandbox url priority urgent ``` - To enable VNC access for all submissions: ```plaintext _debug vmmd external-vnc enable ``` - To disable VNC access for all submissions: ```plaintext _debug no vmmd external-vnc enable ``` - To view the status of VNC access: ```plaintext _debug show vmmd external-vnc ``` 7. (Optional) Enable interactivity with the VM through VNC access. To enable VNC access for current submission only, enter `enable-vnc` after specifying the object to analyze. For example: ```plaintext malware analyze sandbox url file:mal75.zip enable-vnc force ``` > [!NOTE] > Note > > When VNC access is enabled, automatic mouse simulation is disabled in the VM. 8. (Optional) Specify the guest operating system against which the malware is analyzed. ```plaintext hostname (config) # malware analysis sandbox url guestos ``` where is the available guest image profile. The default is the winxp-sp3 guest image. The following example shows how to submit a sandbox malware analysis with normal priority on the URL *file:malware.exe* for the winxp-sp2m guest image: ```plaintext hostname (config) # malware analyze sandbox url file:malware.exe timeout 200 priority normal guestos winxp-sp2m Malware Id = 802 ``` **To submit a list of malicious URLs for a text file for analysis:** 1. Enable the CLI configuration mode. ```plaintext hostname > enable hostname # configure terminal ``` 2. Enter one of the following commands. For sandbox: ```plaintext hostname (config) # malware analyze sandbox ``` For live: ```plaintext hostname (config) # malware analyze live ``` 3. Assign a URL list file for analysis. ```plaintext hostname (config) # malware analyze sandbox list ``` where is the .txt file that is associated with the malware. For example, `file:urls.txtfile:urls.txt` 4. (Optional) Specify the interval after which the malware analysis times out. ```plaintext hostname (config) # malware analyze sandbox list timeout ``` where is the value in seconds. The range is from 30–3600 seconds. The default value is 500 seconds. 5. (Optional) Specify the priority for this analysis. The default value is the normal setting. - To set a normal setting: ```plaintext malware analyze sandbox list priority normal ``` - To set an urgent setting: ```plaintext malware analyze sandbox list priority urgent ``` 6. (Optional) Enable interactivity with the VM through VNC access. To enable VNC access for current submission only, enter `enable-vnc` after specifying the object to analyze. ```plaintext malware analyze sandbox url file:mal75.zip enable-vnc force ``` > [!NOTE] > Note > > When VNC access is enabled, automatic mouse simulation is disabled in the VM. 7. (Optional) Specify the guest operating system against which the malware is analyzed. ```plaintext hostname (config) # malware analyze sandbox list guestos ``` where is the available guest image profile. The default is the winxp-sp3 guest image. 8. (Optional) Make the Malware Analysis appliance perform the submitted analysis even if it matches a previous submission. ```plaintext hostname (config) # malware analyze sandbox list force ``` The following example shows how to submit a list of malicious URLS named *urls.txt* for sandbox malware analysis for the winxp-sp3 guest image: ```plaintext hostname (config) # malware analyze sandbox list file:urls.txt guestos winxp-sp3m force Analyzing URL 'http://172.16.146.53/AllObjects/doc_1370846' [ID: 1019] Analyzing URL 'http://172.16.146.53/AllObjects/doc_3429086' [ID: 1020] Analyzing URL 'http://172.16.146.53/AllObjects/doc_3523707' [ID: 1021] Processed 3 URLs (3 submitted, 0 failed) ``` ### Canceling pending malware analysis jobs You can cancel jobs that are pending analysis. Jobs that are already running in the MVX engine will continue to be processed and cannot be canceled. Use the **malware abort queued** command to cancel all the pending malware analysis jobs that you have submitted. Include the **all** option to cancel all pending jobs submitted by other users. You must have administrator privileges to cancel queued jobs that are submitted by other users. You cannot selectively cancel jobs by a particular user. **To cancel pending malware analysis jobs:** 1. Start the CLI enable mode. ```plaintext hostname > enable ``` 2. Cancel all the pending malware analysis jobs that you submitted. ```plaintext hostname # malware abort queued ``` 3. Cancel all queued malware analysis jobs submitted by other users. ```plaintext hostname # malware abort queued all ``` 4. Verify the canceled malware analysis jobs. ```plaintext hostname # show malware Total Objects Submitted                     :    1337  Objects Queued                           :      10  Objects Running                          :       2  Objects Analyzed                         :    1325  Objects identified as Malicious          :    1084    - VM verified                         :    1084    - Duplicate to VM verified            :       0    - Known checksum match                :       1 Total events                                :    5237  vm-signature-match events                :     585  os-change-anomaly  events                :    1280  checksum-match     events                :    2978  vm-outbound-comm   events                :     394 Objects break down by system status, Total  :    1337  Submitted for VM analysis                :    1268  Submit Disabled                          :       3  Invalid                                  :      55  Static Analysis Only                     :      11 ``` ### Viewing the results for the malware analysis Use the **show malware mode sandbox** command to verify the results of the sandbox malware analysis job. Use the **show malware mode live** command to verify the results of the live malware analysis job. **To verify the results of the sandbox malware analysis job:** 1. Enable the CLI configuration mode. ```plaintext hostname > enable hostname # configure terminal ``` 2. Enter the **show malware mode sandbox** command. ```plaintext hostname (config) # show malware mode sandbox Malware ID 800 Submission ID 800  Analysis Type:         sandbox  URL:                   http://172.16.146.53/AllObjects/pdf_7602255  Analysis Timeout:      500  Analysis Priority:     normal  Application:           Multiple Adobe Reader X  Force:                 true  Profile Name:          win7x64-sp1  Profile ID:            66  Md5Sum:                69e9125cbee713b96c09db95188fd138  State:                 done  Status:                success  Submitted Time:        2015-08-27 20:54:21 UTC  Download Start Time:   2015-08-27 20:54:21 UTC  Download End Time:     2015-08-27 20:54:22 UTC  Run Start Time:        2015-08-27 23:06:02 UTC  Run End Time:        2015-08-27 23:15:00 UTC  IM:                  YES  Number of Events:   (null)  Children Malware ID(s) -  Parent Malware ID      - ``` **To verify the results of the live malware analysis job:** 1. Enable the CLI configuration mode. ```plaintext hostname > enable hostname # configure terminal ``` 2. Enter the **show malware mode live** command. ```plaintext hostname (config) # show malware mode live Malware ID 563 Submission ID 563    Analysis Type:         live    URL:                   file:ftest4.bat    Analysis Timeout:      900    Analysis Priority:     normal    Application:           Windows Explorer    Force:                 true    Profile Name:          win7-sp1m    Profile ID:            65    Md5Sum:                ce42db4701504dcddc533e3afa85cdd2    State:                 done    Status:                success    Submitted Time:        2015-08-27 11:42:17 UTC    Run Start Time:        2015-08-27 11:42:18 UTC    Run End Time:          2015-08-27 11:57:29 UTC    IM:                    YES    Number of Events:      (null)    Children Malware ID(s) -    Parent Malware ID      - Event 638: Occurrence Time        : 2015-08-27 11:57:29 UTC Event Type             : os-change-anomaly Analysis Type          : Malware Trace ID               : 563 Malware ID             : 563 OS Change Analysis:   EDP URL              : https://mil.fireeye.com/edp.php?sname=Malware.Binary.bat   PCAP URL            : https://10.2.252.201/event_stream/send_pcap_file?ev_id=638   PCAP (text)         : https://10.2.252.201/event_stream/send_pcap_ascii?ev_id=638 ``` ### Viewing malware submissions Use the **show submission** command to view detailed statistics about the number of malware submissions that were analyzed and the number submitted per minute during the past 24 hours. Use the **show submission malicious** command to view detailed statistics about the malware submissions that are marked as malicious. The results of both types of analysis are displayed on the Malware Analysis page in the Web UI. For details about each **show submission** command, refer to the *CLI Command Reference*. **To view statistics of malware submissions:** 1. Enable the CLI enable mode. ```plaintext hostname > enable ``` 2. View the summary of malware submission jobs. ```plaintext hostname # show submission Runtime Submission Stats:  Total queued submission                           : 0  Total running submissions                         : 12  Total DA running submissions                      : 2 Cumulative Stats in timespan 2015-08-20 21:16:53 to 2015-08-21 21:16:53                                                   : Total      : Rate/minute Submissions                                       : 1019       : 0.708 Completed submissions                             : 1007       : 0.699 Malicious submission count                        : 932        : 0.647 ``` **To view statistics of the malware submissions that are marked as malicious:** 1. Enable the CLI enable mode. ```plaintext hostname > enable ``` 2. View the summary of the malware submissions that are marked as malicious. ```plaintext hostname # show submission malicious Submission ID: 9351   Malware ID            : 9381   md5sum                : fa428563f4162ac3865b27e8a19ba95c   File type             : exe   Status                : success   Malicious             : YES Analysis Object ID      : 8890      Analysis Object Name    : fa428563f4162ac3865b27e8a19ba95c.bin      Analysis File Type      : exe      md5sum                  : fa428563f4162ac3865b27e8a19ba95c      Static Analysis weight  : 100      Dynamic Analysis jobs   : 1      Static Analysis jobs    : 4           SA engine weight       : 100           SA job ID              : 34401                SA sub-engine name         : malware_intrinsic_analysis                SA sub-engine signature    : Dropper.DTI.DroppedFiles                SA sub-engine weight       : 100           SA engine weight       : 100           SA job ID              : 34399                SA sub-engine name         : pe_sign                SA sub-engine signature    : Wuhan Weijun Keji Co.,Ltd.                SA sub-engine weight       : 0           Job ID                 : 8539           OS name                : win7-sp1m           Application name       : Windows Explorer           OS Changes weight      : 0           CNC Match weight       : 0           Assigned time          : 2015-09-05 17:45:47.548646           Complete time          : 2015-09-05 17:46:50.32269           Job runtime            : 00:01:02.774044 ```