Deployment options FileCap Outlook Plugin

There are two methods of installing the FileCap Outlook Plugin, installing the EXE file or the MSI file.

Install the EXE file

When the FileCap Outlook Plugin .exe installation is started you see the following screen.

All the input fields are mandatory:

outlook-plugin

Installation directory Select the installation directory, the default setting is recommended.
Plugin language Select one of the options for the desired language. You can also change this later by setting a registry value.

Note when using System language: The FileCap Outlook Plugin will use the detected system language, if the system language is not available it will fallback to English.

FileCap server API key Enter the FileCap server API key, this API key can be found at the FileCap Server Admin portal under: “Plugin settings -> API Key

Note: the API key needs8bitdo to be 30 characters long.

FileCap external domain Enter the FQDN (full external hostname) of the FileCap server on which it is reachable from the internet. (for example: filecap.company.com)

Note: The format needs to be: filecap.company.com

Note: If you don’t see the API Key and External domain field the setup already detected a Registry setting and will use this.

Install the MSI file

The MSI installation can be used to install the FileCap Outlook Plugin silently with a loginscript or Group policy you can choose between a 32bit or 64bit installation depending on the operating system used.

The MSI installation requires two parameters to be set, and one optional parameter:

APIKEY Enter the FileCap server API key, this API key can be found at the FileCap Server Admin portal under: “Plugin settings -> API Key

Note: the API key needs to be 30 characters long.

FILECAPDOMAIN Enter the FQDN (full external hostname) of the FileCap server on which it is reachable from the internet. (for example: filecap.company.com)

Note: The format needs to be: filecap.company.com

LANGUAGE (Optional Parameter) When you want to set the FileCap Outlook Plugin language you can set this parameter with one of the languages mentioned below.

Note: If you don’t set the parameter it will use the System language. If the system language is not available it will fallback to English.

MSI silent installation example command

msiexec /quiet /i FileCap_Outlook_Plugin.msi APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx FILECAPDOMAIN=filecap.company.com

Registry settings

By default the installation will put the registry keys containing the API settings in HKEY_LOCAL_MACHINE but you can also choose for HKEY_CURRENT_USER registry key deployment.

Note: When the HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE registry settings are both set the FileCap Outlook Plugin will use HKEY_CURRENT_USER settings.

Registry keys example

Name Type Value
APIKey REG_SZ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Server REG_SZ filecap.company.com
Language REG_SZ en

HKEY_LOCAL_MACHINE

By default after installation the registry key’s will be written in HKEY_LOCAL_MACHINE\SOFTWARE\FileCap and/or HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\FileCap

HKEY_CURRENT_USER

If you want to use HKEY_CURRENT_USER you can download the .reg file with the following link:

Note when downloading above .reg file: You still need to edit the downloaded .reg file in a text editor like notepad. And replace the following:

Enter-FileCap-API-Key-Here” by the API key which can be found at “Plugin settings -> API Key” this is a unique key per FileCap server.

Enter-FileCap-FQDN-Here” by the FQDN of the FileCap server (For example: filecap.company.com)

Languages

Currently the FileCap Outlook Plugin is available in the following languages:

Language Value
English en
Dutch nl

The value can be used in the registry setting or when installing the MSI.

Resolving the name “filecap” (This function is removed since FileCap Outlook Plugin version 4.0.7)

The Outlook plugin discovers the FileCap server using a DNS hostname. This hostname should be present in your internal DNS servers / DNS domain. The record should be an “A” Record with the name “filecap” and point to the FileCap Server IP.

If you have set the hostname in the internal DNS, it requires no additional configuration on the client.

Using this method requires some additional firewall ports to be opened. (TCP 8080 and TCP 8443).

Downloading the FileCap Outlook Plugin

The FileCap Outlook plugin can be downloaded from the FileCap update website.

There is one installation file for all languages. The language can be selected during installation, you can download the FileCap Outlook Plugin with the following link: http://update.filecap.net/downloads/FileCap-Plugin/FileCap_Outlook_Plugin_latest.zip