MSI Installation Guide for IT Administrators

Overview

The CICB MSI installer provides enterprise-grade deployment capabilities using Windows Installer technology. This guide covers installation, silent deployment, configuration, optional feature flags, uninstallation, and troubleshooting.

Installer Type

The current Windows MSI packaging model uses a single package, typically named CICBv2-Win-vX.X.X.X.msi.

This package installs the CICB application set as one product. It does not currently expose separate client-only or server-only core installation modes.

System Requirements

  • Operating System: Windows 10 or later (64-bit)
  • Privileges: Administrator rights required for installation
  • Disk Space: Minimum 500 MB free disk space
  • .NET Runtime: Included with the installer when required by the packaged build

Installation Methods

Interactive Installation

  1. Download CICBv2-Win-vX.X.X.X.msi.
  2. Double-click the MSI file.
  3. Accept the license agreement.
  4. Choose the installation directory if you do not want the default path.
  5. Complete the wizard.

Standard Command-Line Installation

msiexec /i "CICBv2-Win-vX.X.X.X.msi"

Silent Installation

Basic Silent Install

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart

Silent Install with Progress Bar

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /passive /norestart

Silent Install with Verbose Logging

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart /l*v "C:\Temp\CICB_Install.log"

Silent Install with Server Configuration

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart SERVER_IP="192.168.1.50" SERVER_PORT="56789"

MSI Parameters

ParameterDescription
/iInstall the product
/xUninstall the product
/quietSilent mode with no user interaction
/qnAlternative fully silent option
/passiveProgress bar only, no prompts
/qbBasic user interface
/norestartPrevent automatic restart
/l*vEnable verbose logging to the specified file

Public Properties

You can pre-configure deployment values during installation by passing MSI public properties on the command line.

PropertyDefaultDescription
SERVER_IPEmptyCICB server host name or IP address
SERVER_PORT56789TCP port used for CICB communication
INSTALLDIR%ProgramFiles(x86)%\ClassificationBannerCustom installation directory

Example:

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart SERVER_IP="cicb-server.contoso.local" SERVER_PORT="56789" INSTALLDIR="C:\Apps\CICB"

If SERVER_IP is not provided during installation, the application can be configured after deployment through the Client Config Manager (CCM).

Optional Feature Flags

The current MSI is a single installer for the CICB application set. It does not provide feature flags for installing only one core application role.

Optional ADDLOCAL flags are available for startup behavior only:

  • ClientAutoStartupFeature
  • ServerAutoStartupFeature

Examples:

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart ADDLOCAL=ProductFeature,ClientAutoStartupFeature
msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart ADDLOCAL=ProductFeature,ServerAutoStartupFeature

Uninstallation

Uninstall by Product Code

msiexec /x {PRODUCT-CODE-GUID} /quiet /norestart

Uninstall by MSI File

msiexec /x "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart

Uninstall with Logging

msiexec /x {PRODUCT-CODE-GUID} /quiet /norestart /l*v "C:\Temp\CICB_Uninstall.log"

Deployment via Group Policy

  1. Copy the MSI to a network share accessible by all target computers, for example \\server\share\software\CICBv2-Win-vX.X.X.X.msi.
  2. Ensure target computers have read access to the share.
  3. Open Group Policy Management Console.
  4. Create or edit a GPO for the target OU.
  5. Navigate to Computer Configuration > Policies > Software Settings > Software Installation.
  6. Add a new package using the UNC path to the MSI.
  7. Choose Assigned.
  8. Apply policy and reboot or refresh policy on the target machine.

Verification

Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" |
   Where-Object { $_.DisplayName -like "*CICB*" }

Get-ItemProperty "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*" |
   Where-Object { $_.DisplayName -like "*CICB*" }

Troubleshooting

Enable MSI Logging

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart /l*v "C:\Temp\CICB_Install.log"

Review the log for Return value 3, which usually indicates the failure point.

Common Issues

Access Denied

Run the installation from an elevated shell.

Start-Process powershell -Verb RunAs

Another Installation Is In Progress

Get-Process msiexec

Wait for the existing MSI transaction to complete, or restart the system if necessary.

Silent Install Appears to Do Nothing

Re-run with verbose logging enabled and verify the MSI path, permissions, and command-line property syntax.

Summary

Recommended baseline deployment command:

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart

Recommended deployment command with preconfigured server values:

msiexec /i "CICBv2-Win-vX.X.X.X.msi" /quiet /norestart SERVER_IP="192.168.1.50" SERVER_PORT="56789"