Configuring the malware repository network share using the CLI

Prev Next

The following topics explain how to manage the malware repository network share using the CLI:

Prerequisites

  • Administrator access to the Malware Analysis appliance

  • Install the guest images on the Malware Analysis appliance. For details about installing the guest images, see Guest images.

  • Determine the guest images for which you want to configure the repositories.

  • Determine the IP address of the server you want to use for the network share.

  • Verify that theMalware Analysis appliance can communicate with the network share site from your local machine before configuring the malware repository for unattended mode.

  • Copy the files to the configured network share source directory locations.

  • Configure the malware repository paths for each guest image.

Configuring the network share settings

Use the malware file repository shared-point url command to configure the access point for the network share. Use the malware file repository shared-point auth command to configure the user credentials to access the network share.

After you have configured the network share settings, you must log in to the Web UI to verify the network share status that is displayed on the Malware Repository Configuration page. For instructions, see Configuring malware repository network share using the Web UI.

Note

The network share status cannot be verified using the CLI.

To configure the network share settings

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Enter the relevant path to the network share.

    hostname (config) # malware file repository shared-point url <protocol>://<IP address-of-network-server/share-name>

    where <protocol> is either the SMB or CIFS path.

    For example, cifs://172.16.220.88/puertorico

  3. Enter the username and password configured for the network share.

    hostname (config) # malware file repository shared-point auth user <username> password <password>

    Note

    These user credentials are different from the credentials used to access the appliance.

  4. Enable VNC for malware repository.

    malware file repository shared-point vnc enable

    To disable VNC for malware repository:

    no malware file repository shared-point vnc enable

Configuring the repositories for each guest image

Use the malware file guestos command to configure the malware repository paths for each guest image. The Input (src), Output (Good), and Output (Bad) paths are relative to the share point. You must use the same path for all guest image files in the input and output directories. Each operating system for each guest image have different names. The Malware Analysis appliance will move files to the Output (Good) path that are determined to be nonmalicious if no malware is detected. The Malware Analysis appliance will move files to the Output (Bad) path that are determined to be malicious if malicious characteristics are detected.

To configure the Input (src) path for each guest image:

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Specify the repository for each guest image.

    hostname (config) # malware file guestos <guestos name>

    where guestos-name is the available guest image profile.

  3. Specify the Input (src) path for each guest image.

    hostname (config)# malware file guestos <guestos-name> repository path src <source directory path>

The following example configures the repositories for the Input (src) paths for each guest image:

hostname (config)# malware file guestos winxp-sp2m repository path src sp2/src
hostname (config)# malware file guestos winxp-sp3m repository path src sp3/src
hostname (config)# malware file guestos win7-sp1m repository path src w7/src
hostname (config)# malware file guestos win7x64-sp1m repository path src w7-64-sp1/src
hostname (config)# malware file guestos osx-10.8.2 repository path src 10.8.2/src
hostname (config)# malware file guestos osx-10.9 repository path src 10.9/src

To configure the Output (Good) path for each guest image:

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Specify the repository for each guest image.

    hostname (config)# malware file guestos <guestos name>

    where guestos-name is the available guest image profile.

  3. Specify the Output (Good) path for each guest image.

    hostname (config)# malware file guestos <guestos name> repository path good <good directory path>

The following example configures the repositories for the Output (Good) paths for each guest image:

hostname (config)# malware file guestos winxp-sp2m repository path good sp2/good
hostname (config)# malware file guestos winxp-sp3m repository path good sp3/good
hostname (config)# malware file guestos win7-sp1m repository path good w7-sp1/good
hostname (config)# malware file guestos win7x64-sp1m repository path good w7-64-sp1/good
hostname (config)# malware file guestos osx-10.8.2 repository path good 10.8.2/good
hostname (config)# malware file guestos osx-10.9 repository path good 10.9/good

To configure the Output (Bad) path for each guest image:

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Specify the repository for each guest image.

    hostname (config) # malware file guestos <guestos name>

    where <guestos-name> is the available guest image profile.

  3. Specify the Output (Bad) path for each guest image.

    hostname (config) # malware file guestos <guestos name> repository path bad <bad directory path>

The following example configures the repositories for the Output (Bad) paths for each guest image:

hostname (config)# malware file guestos winxp-sp2m repository path bad sp2/bad
hostname (config)# malware file guestos winxp-sp3m repository path bad sp3/bad
hostname (config)# malware file guestos win7-sp1m repository path bad w7-sp1/bad
hostname (config)# malware file guestos win7x64-sp1m repository path bad w7-64-sp1/bad
hostname (config)# malware file guestos osx-10.8.2 repository path bad 10.8.2/bad
hostname (config)# malware file guestos osx-10.9 repository path bad 10.9/bad

Configuring the polling period for the repositories

Use the malware file repository poll command to configure the poll rate for the repositories. The Malware Analysis appliance polls the repositories at regular intervals to analyze potential malware and sort it into malicious and nonmalicious directories.

To configure the polling period:

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Set the repository polling interval in minutes. The default value is five minutes.

    hostname (config)# malware file repository poll interval <minutes>

Viewing the configuration for the repositories

Use the show malware file repositories command to view the results of the configuration for the network share settings and profile repositories.

To view the configuration for the repositories:

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Enter the show malware file repositories command.

    hostname (config) # show malware file repositories
    Shared Point:
     Enabled      : yes
     Share URL    : cifs://172.16.220.88/puertorico
    Auth
     Enabled    : yes
     User       : root
     Pass       : ********
    Profile Repositories:
    Guest OS ID: 23   winxp-sp2m
     Enabled       : yes
     Input (src)   : sp2
     Input (good)  : sp2/good
     Input (bad)   : sp2/bad
    Guest OS ID: 43   winxp-sp3m
     Enabled       : yes
     Input (src)   : sp3
     Input (good)  : sp3/good
     Input (bad)   : sp3/bad
    Guest OS ID: 65   win7-sp1m
     Enabled       : yes
     Input (src)   : w7
     Input (good)  : w7-sp1/good
     Input (bad)   : w7-sp1/bad
    Guest OS ID: 66   win7x64-sp1m
     Enabled       : yes
     Input (src)   : w7-64-sp1
     Input (good)  : w7-64-sp1/good
     Input (bad)   : w7-64-sp1/bad
    Guest OS ID: 90   osx-10.8.2
     Enabled       : yes
     Input (src)   : 10.8.2
     Input (good)  : 10.8.2/good
     Input (bad)   : 10.8.2/bad
    Guest OS ID: 91   osx-10.9
     Enabled       : yes
     Input (src)   : 10.9
     Input (good)  : 10.9/good
     Input (bad)   : 10.9/bad
    Poll Interval (min): 5