Install PDF Reader - SQL-FineBuild/Common GitHub Wiki

Previous Install Extended Events Manager	Manual Install	Install Process Explorer Next

FineBuild can install and configure Sumatra PDF Reader as part of the SQL Server install process.

If you do not want to include Sumatra PDF Reader in your FineBuild install, then do not download it.

Sumatra PDF Reader was produced by Krzysztof Kowalczyk. It was chosen to be included in FineBuild because it a light-weight product that has a stable code base more suited for a Production server.

It is very common to have PDF files on a SQL Server machine, but many Windows administrators take the view that the Adobe Acrobat PDF reader is not a suitable product for installation on a Production server, due to the large number of fixes issued on a monthly basis. Sumatra PDF Reader provides a more stable alternative.

Item	Location
PDF Reader home page	https://www.sumatrapdfreader.org/free-pdf-reader.html
PDF Reader download 3.2	https://www.sumatrapdfreader.org/dl2/SumatraPDF-3.2-install.exe

FineBuild PDF Reader Install

Automated silent installation of PDF Reader is performed by Process Id 4TC and is controlled by the parameters below:

SQL Version	Parameter	FULL Build	WORKSTATION Build	CLIENT Build
SQL2019	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2017	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2016	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2014	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2012	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2008R2	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2008	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes
SQL2005	/SetupPDFReader:	Yes	Yes	Yes
	/SetupSQLTools:	No	Yes	Yes

In order to maintain compatibility with older versions of SQL FineBuild, the parameters /InstPDFReader: and /InstSQLTools: can also be used.

FineBuild also uses the following parameters to help install PDF Reader:

Parameter	Default Value	Description
/PDFexe:	SumatraPDF-*-install.exe	Name of PDF Reader install file

PDF Reader will be installed with CLIENT and WORKSTATION builds, but not with a FULL build. If you want to install it with a FULL build, the following parameter should be added at run time:

/SetupSQLTools:Yes

The FineBuild install for PDF Reader includes the following:

Perform a PDF Reader install
Configure Sumatra as default PDF Reader

Top

Manual PDF Reader Install

The following steps show what you would have to do to install PDF Reader manually. FineBuild does all of this work for you automatically.

PDF Reader Install

Navigate to the Additional Components folder

Double-click on the Sumatra PDF Reader install file

![Explorer](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/PDFReader/PDF Explorer.png)
The Installation Options window is displayed

Click Next to continue

![alt-Options](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/PDFReader/PDF Options.png)
Accept the file location

Click Install to continue

![Install Location](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/PDFReader/PDF Location.png)
The install is completed successfully

Click Close to end

![Complete](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/PDFReader/PDF Complete.png)

Configure PDF Reader

Set Sumatra to be the default PDF reader using the following commands.

Define a file type for Sumatra and link it to the Sumatra executable

For a 32-bit system:

FTYPE Sumatra="C:\Program Files\SumatraPDF\SumatraPDF.exe %1 %*

For a 64-bit system:

FTYPE Sumatra="C:\Program Files(x86)\SumatraPDF\SumatraPDF.exe %1 %*

Associate PDF files with the Sumatra file type:
```
ASSOC .PDF=Sumatra
```

Previous Install Extended Events Manager	Top	Install Process Explorer Next