Installing FORNAV Toolbox with FORNAV Report Service in a Docker Container
Overview
This guide describes how to install the FORNAV Toolbox with the FORNAV Report Service into a Business Central Docker container using a PowerShell script.
Prerequisites
- Docker installed and running.
- Business Central Docker container is already created and running.
- FORNAV Toolbox installer file (e.g.,
ReportsForNAV.exe
) available locally. - PowerShell with administrative privileges.
Installation Steps
Step 1: Prepare Installer File
Ensure you have downloaded the FORNAV Toolbox installer (.exe
) file to your local machine.
Step 2: Run Installation Script
Use the following PowerShell script to install the FORNAV Toolbox and Report Service:
$containerName = "<YourContainerName>"
$installerFile = Get-Item "<PathToYourInstaller>\fornav_installer.exe"
$filesFolder = "files"
$localPath = Join-Path -Path $filesFolder -ChildPath $installerFile.Name
Write-Host "Installing FORNAV Toolbox..." -ForegroundColor Magenta
# Create directory inside container
docker exec -it $containerName cmd.exe "/c md $filesFolder"
# Stop container to copy files safely
docker stop $containerName
# Copy FORNAV installer into the container
docker cp $installerFile.FullName "${containerName}:\\$filesFolder"
# Restart the container
docker start $containerName
# Run the installer silently within the container
docker exec -it $containerName powershell.exe -Command `
"Start-Process -FilePath $localPath `
-ArgumentList '/COMPONENTS=\"deployment\reportservice\"', '/VERYSILENT', '/NORESTART', '/SUPPRESSMESSAGEBOXES', '/LOG=fornav-installer.log'"
Replace placeholders with your actual container name and path to the installer file.
Step 3: Verify Installation
Verify the installation by viewing the installer log file within the container:
docker exec -it $containerName powershell.exe -Command "Get-Content fornav-installer.log"
Check for successful installation messages in the log.
Post-Installation
After successful installation, configure and validate the FORNAV Report Service within your Business Central environment. You can do that by running a FORNAV report or check if the service is running using the sc
command.