Installation
This page shows how and where to install Board Connector.
Prerequisites
Administrator permissions are required to install Board Connector.
Setup
BOARDConnectorSetup.exe is an industry standard setup.
Execute the BOARDConnectorSetup.exe file and follow the instructions of the setup program.
The setup leads through the following steps:
- License Agreement.
- Installation Location: by default, Board Connector in installed in
C:\Program Files\BOARDConnector. - Version History: displays any changes that were published between the current version and the last installed version. If Board Connector is installed for the first time, no changes are displayed.
- Usage Analytics: information about Board Connector usage analytics and how to opt-out.
-
Choose Components: Select which of the following components to install:
Component Description Main Product Files All required files to use Board Connector. Designer Installs the Designer application, uncheck this option if you want to use Board Connector without a graphical interface. Server Installs the Board Connector Server Convert config files Converts extractions, sources, etc. from previous version format to new format. Crucial when installing major releases and upgrading from e.g., version 3.x to 4.x. Install Service Installs the server component as a windows service that runs under a virtual service account with the least required privileges, see Server. Start Menu Shortcuts Component that adds shortcuts to the start menu. Note
Make sure to mark the option “Server > Install Service” during the Installation, as installing a server without the service is only used for development purposes.
For information on how to install a license, see Licensing.
Troubleshooting
After installation, the button [Save log to file] is available.
In case of errors, click [Save log to file] to save the logs of the installation process to a .log file.
The log file contains status and error messages with stack traces.
Warning
Errors due to different version numbers.
Differences in version numbers of Designer and Server may lead to errors.
Make sure that Designer and Server have identical version numbers.
Installation Directory Files
The list below shows several most important files that are placed into the default directory C:\Program Files\BOARDConnector after installation:
| Filename | Description |
|---|---|
| ABAP directory | Directory with customer-specific function modules (.txt) corresponding to SAP transport requests (.zip). |
| logs directory | Directory with server and extraction logs. See also Logs. |
| config directory | Directory created automatically with the first extraction, containing all extractions and the corresponding log files, see Backup. |
| private directory | Directory containing keys for encrypted SAP passwords. This directory contains sensitive information and must be to be secured accordingly. |
| result-cache directory | Directory with extraction cache files. |
| BCDesigner.exe | Application that launches Board Connector Designer to create, test and monitor extractions. |
| BCService.exe | Application that launches Board Connector Server as Windows Service. Usually boots automatically and runs in the background. |
| BCApiServer.exe | Unencrypted WCF service for retrieving metadata to the Designer. |
| Theobald.Bc.Web.Listener.exe | Theobald.Bc.Web.Listener.exe a listener process that waits for HTTP requests. |
| Theobald.Bc.Web.Worker.exe | For each TCP connection the Theobald.Bc.Web.Listener.exe starts a new instance of Theobald.Bc.Web.Worker.exe, which processes all HTTP requests coming in over the TCP connection. |
| BCCleanup.exe | Application that cleans up the old server logs, as defined in the server settings. |
| BCConfigServer.exe | Listener process waits for new connection requests from the Designer. |
| ConfigConverter.exe | Application that converts extractions, sources, etc. from previous version format to new format. Crucial when installing major releases and upgrading from e.g., version 3.x to 4.x. |
| uninstall.exe | Tool for uninstalling and removing Board Connector with all its components from your machine. |
| BOARDConnectorSetup.exe | Setup of the currently installed version. See also Migration to a Different Machine. |
| Eula_Board Connector.rtf | Document containing the license agreement for the use of the software Board Connector. |
| BOARDConnectorLicense.json | License file with information about the server, the component and runtime. |
Note
The Board Connector Server can be started as a console program for test purposes. For more details on starting Board Connector Server as a console program, see Knowledge Base Article: Target Principal Field.
The installation of Board Connector can be initiated unattended without the GUI in a non-interactive way via the Windows Command Prompt.
Execute the BOARDConnectorSetup.exe via command line and use the switch --unattended.
BOARDConnectorSetup.exe is Windows applications, meaning the Windows Command Prompt does not wait until the installation is complete.
To wait until the installation is complete, use the start command with the /wait switch.
Note
All switches are case sensitive.
Version Number
When installing Board Connector, the version of the product is displayed in the installation menu. To check the version of the installed product in Windows, open the Windows Settings and navigate to Apps > Installed apps.