Unattended installation of Burp Suite Enterprise Edition

BUSINESS

Instead of installing Burp Suite Enterprise Edition manually through the installation wizard, you can perform an unattended/silent installation through the command line, passing the required input in a varfile. This is much more efficient when installing on multiple machines.

The easiest way to prepare the varfile is to perform the installation once manually. This will generate a varfile already containing the required parameters. You can then reuse this file to perform future unattended installations.

To note

For a single deployment of Burp Suite Enterprise Edition, you only need one license. It doesn’t matter how many scan machines you deploy or how many scans you run. However, if you wish to deploy Burp Suite Enterprise Edition in multiple environments, you must purchase a separate license for each environment. This also applies to test, development or staging environments, for example.

If you have any questions about your licensing requirements, please contact our customer support team at hello@portswigger.net.

Performing an unattended installation for scan machines

To perform an unattended installation for a scanning machine, you can simply copy a response.varfile from an existing scan machine installation and pass it to the installer from the command line.

Generate a response.varfile to scan the machine deployment

Perform a manual installation using the same options you want to use for your unattended installations. This generates the response.varfile in the .install4j subdirectory of your installation directory.

To note

If you have already deployed a scanning machine, you can simply copy the response.varfile.

The default installation directory depends on the operating system you are using:

macOS

/Applications/Burp Suite Enterprise Edition/.install4j

the Windows

C:Program Filesburpsuite_enterprise.install4j

linux

/opt/burpsuite_enterprise/.install4j

Perform an unattended analytics machine deployment using response.varfile

Perform an unattended installation by running the installer from the command line using your response.varfile.

Burpsuite_enterprise_linux_v2021_8_1.sh -c -q -varfile response.varfile

-c run the installer in command line mode
-q runs the installer in unattended mode
-varfile allows you to specify a response file

The scanner fingerprint is sent to standard output (stdout).

Performing an Unattended Enterprise Server Installation

To perform an unattended installation of the Enterprise Server, you must add values ​​in the response.varfile which are not stored by the installer. You can then pass the modified file to the installer from the command line.

Generate a response.varfile for deploying enterprise servers

Perform a manual installation using the same options you want to use for your unattended installations. This generates the response.varfile in the .install4j subdirectory of your installation directory.

To note

If you have already deployed an enterprise server, you can simply copy the response.varfile.

The default installation directory depends on the operating system you are using:

macOS

/Applications/Burp Suite Enterprise Edition/.install4j

the Windows

C:Program Filesburpsuite_enterprise.install4j

linux

/opt/burpsuite_enterprise/.install4j

Example response.varfile

The following is an example of response.varfile.

beuser=burpsuite
beuserandgroup=burpsuite:burpsuite
dataDirectory=/var/lib/BurpSuiteEnterpriseEdition
databaseBackupsDirectory=/var/lib/BurpSuiteEnterpriseEdition
dbType=h2
escapedDataDir=/var/lib/BurpSuiteEnterpriseEdition
escapedInstallationDir=/opt/burpsuite_enterprise
jreHome=/opt/burpsuite_enterprise/jre
logsDirectory=/var/log/BurpSuiteEnterpriseEdition
platformScriptSuffix=sh
sys.adminRights$Boolean=true
sys.component.agent$Boolean=true
sys.component.db$Boolean=true
sys.component.enterprise$Boolean=true
sys.component.web$Boolean=true
sys.installationDir=/opt/burpsuite_enterprise
sys.languageId=en
sys.programGroupDisabled$Boolean=true
webserver_port$Integer=8080

To note

Earlier versions of Burp Suite Enterprise Edition required you to enter additional parameters regarding the database and the administrator user in the var file. This is no longer necessary, as this information is now entered during the initial setup process.

Perform an unattended enterprise server deployment using the response.varfile

Perform an unattended installation by running the installer from the command line using your response.varfile.

Burpsuite_enterprise_linux_v2021_8_1.sh -c -q -varfile response.varfile

  • -c run the installer in command line mode
  • -q runs the installer in unattended mode
  • -varfile allows you to specify a response file

Comments are closed.