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
Enable the CLI configuration mode.
hostname > enable hostname # configure terminalEnter 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
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.
Enable VNC for malware repository.
malware file repository shared-point vnc enableTo 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:
Enable the CLI configuration mode.
hostname > enable hostname # configure terminalSpecify the repository for each guest image.
hostname (config) # malware file guestos <guestos name>where guestos-name is the available guest image profile.
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/srcTo configure the Output (Good) path for each guest image:
Enable the CLI configuration mode.
hostname > enable hostname # configure terminalSpecify the repository for each guest image.
hostname (config)# malware file guestos <guestos name>where guestos-name is the available guest image profile.
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/goodTo configure the Output (Bad) path for each guest image:
Enable the CLI configuration mode.
hostname > enable hostname # configure terminalSpecify the repository for each guest image.
hostname (config) # malware file guestos <guestos name>where
<guestos-name>is the available guest image profile.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/badConfiguring 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:
Enable the CLI configuration mode.
hostname > enable hostname # configure terminalSet 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:
Enable the CLI configuration mode.
hostname > enable hostname # configure terminalEnter 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