Installing Report Builder 3.0

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Report Builder is a report authoring tool that you can use to create, update, and share reports. Report Builder is available as a stand-alone or a ClickOnce application. You or your administrator download and install the stand-alone version on your local computer whereas ClickOnce is installed with SQL Server 2008 R2. You can download Report Builder from the Microsoft Download Center.

Note

Report Builder 3.0 cannot be installed on Itanium 64-based computers. This applies to the ClickOnce and stand-alone versions of Report Builder 3.0.

ClickOnce is a Microsoft technology for deploying Windows applications. ClickOnce enables users to install and run a Windows application such as Report Builder by clicking a link on a web page. Users can install and run Report Builder from Report Manager or a SharePoint site.

For more information about deploying ClickOnce applications, applying ClickOnce application security, or running ClickOnce applications in the Internet zone, see the "ClickOnce Deployment for Windows Forms Applications", "Security in Windows Forms Overview", or "Trusted Application Deployment Overview" articles on the Microsoft Developer Network Web site at www.microsoft.com/msdn.

System Requirements

Report Builder requires that the Microsoft .NET Framework version 3.5 is installed on the local computer. If the .NET Framework is not installed on the local computer when you try to install Report Builder, the following message displays:

"The Microsoft .NET Framework 3.5 must be installed on your computer before you can install Report Builder. Please install .NET Framework 3.5 and then install Report Builder."

You can download the .NET Framework from the Microsoft Download Center.

You can install Report Builder on any Microsoft Windows operating system that supports the .NET Framework 3.5. For example, you can install Report Builder on Windows XP or Vista.

It is recommended that the computers that will run Report Builder have 512 MB of RAM. However, depending on the complexity of reports you run, you might want less or more RAM.

Report Builder requires 150 MB of disk space. However, you should allow for additional space for storing reports.

Installing Report Builder Directly to Your Computer

To deploy the stand-alone version of Report Builder, an administrator can use software such as Microsoft Systems Manager Server (SMS) to push the program to users' computers or make available the ReportBuilder3.msi file on a share from which users can install it.

You can also perform a command line installation and include options such as making the installation silent and writing log files for the installation. The documentation for Windows Installer that runs the .msi file provides information about the available options. You can also use the /? option to display the command prompt options for Windows Installer Help.

Install Using Software

To learn how to use specific software to install the application, consult the documentation for the software. For more information about SMS, go to the SMS site on www.microsoft.com.

Install From a Share

Contact your administrator for the location of ReportBuilder3.msi that you run to install Report Builder on your local computer.

To install Report Builder
  1. Browse to locate the ReportBuilder3.msi, the Windows Installer Package (MSI) for Report Builder, and click it. The Microsoft SQL Server Report Builder Wizard is launched.

  2. On the Welcome to the Installation Wizard page for Report Builder, click Next.

  3. On the License Agreement page, read the agreement and then select the I accept the terms in the license agreement option. Click Next.

  4. Provide your personal name and company name. Click Next.

  5. On the Feature Selection page, optionally click Browse or Disk Cost. Click Next.

    • Click Browse to see the default location of Report Builder and update it.

      Note

      The default installation folder for Report Builder is <drive>Program Files\Microsoft SQL Server.

    • Click Disk Cost to learn how much disk space Report Builder consumes.

      Note

      If a volume does not have sufficient amount of free disk space, the volume is highlighted.

  6. On the Default Target Server page, optionally provide the URL to the target report server if it is different from the default. Click Next.

    Note

    If you plan to work with Report Builder when it is connected to a report server, it is convenient to provide the URL to the server at this time. However, you can also do this from the Options dialog box when you are working in Report Builder.

  7. Click Install to complete the installation of Report Builder.

Install Using the Command Line

When you perform a command line installation of Report Builder, you can provide arguments to customize the installation. In addition to the standard MSI intrinsic parameters, you can use the custom parameters that Report Builder provides. The custom parameters are name/value pairs. Two custom parameters are available: RBINSTALLDIR and REPORTSERVERURL.

If you want a completely silent installation, with no user interface interaction at all, specify the /quiet option. By design, the quite option flag suppresses installation errors. It is therefore recommended that you include the /l option, which specifies logging, when you use the quiet option.

Important

Vista security features require elevated permissions to run command line operations and Vista will prompt for permission to run the command line and the installation is not silent. To make the installation silent you need to run the command line as an administrator.

Syntax

msiexec/i ReportBuilder3.msi /option [value] [/option [value]]

Parameters

Option Description

/?

Displays the command prompt options for Windows installer help.

Note

The Report Builder customer parameters are not included.

RBINSTALLDIR

Specifies the root installation folder for Report Builder.

For example: using RBINSTALLDIR=C:\myRBFolder installs MSReportBulder.exe (the executable for Report Builder) in the root folder: C:\myRBFolder\Report Builder 3.0.

REPORTSERVERURL

Specifies the default report server that Report Builder uses to save reports on the server.

For example: using REPORTSERVERURL ="http://myServer/reportserver" makes myServer the default report server.

Examples

The following examples show command lines for installing Report Builder.

Basic command line installation.

msiexec /i ReportBuilder3.msi /quiet

Command line with logging enabled.

msiexec /i ReportBuilder3.msi /quiet /l*v c:\junk\install.log

Command line that includes logging and a custom installation directory. This installs Report Builder in C:\myRB20\Report Builder 3.0.

msiexec /i ReportBuilder3.msi /quiet /l*v c:\junk\install.log RBINSTALLDIR="C:\myRB20

Command line that includes logging and a custom installation directory. The name of the installation directory contains spaces. This installs Report Builder to C:\myFolder toplevel folder\sub folder\Report Builder 3.0.

msiexec /i ReportBuilder3.msi /quiet /l*v install.log RBINSTALLDIR=”C:\myFolder toplevel folder\sub folder”

Command line that invokes the user interface. The installation directory path is loaded into the wizard page, on which you can modify the path.

msiexec /i ReportBuilder3.msi /l*v install.log RBINSTALLDIR=”C:\mydesired toplevel folder\and some sub folder”

Installing the ClickOnce Version of Report Builder on Your Computer

The ClickOnce version of Report Builder is located on the report server, and opens on your computer when you click the Report Builder button in Report Manager or from a SharePoint site where it is installed. An administrator needs to install the application on the report server before you can access it. For more information about opening Report Builder, see How to: Start Report Builder (Report Builder 3.0).

Report Builder Languages

Report Builder is available in 21 languages in addition to English. When you download the stand-alone version of Report Builder, you select the language version that you want to install. You must repeat the download for each language version that you want to install. For the ClickOnce version, all language versions are installed on the server. The culture of the user's computer determines which language version is installed. If the culture does not match an available language, the English version is installed.

The following table has information about the available language versions.

LCID Language Culture

1028

Chinese (Traditional)

zh-TW

1029

Czech

cs-CZ

1030

Danish

da-DK

1031

German

de-DE

1032

Greek

el-GR

1033

English

en-US

1035

Finnish

fi-FI

1036

French

fr-FR

1038

Hungarian

hu-HU

1040

Italian

it-IT

1041

Japanese

ja-JP

1042

Korean

ko-KR

1043

Dutch

nl-NL

1044

Norwegian (Bokmal)

nb-NO

1045

Polish

pl-PLl

1046

Portuguese (Brazil)

pt-BR

1049

Russian

ru-RU

1053

Swedish

sv-SE

1055

Turkish

tr-TR

2052

Chinese (Simplified)

zh-CN

2070

Portuguese (Portugal)

pt-PT

3082

Spanish (Spain)

es-ES

See Also

Concepts

Uninstalling Report Builder 3.0
Administering Report Builder 3.0