Skip to main content
Version: 3.28 (latest)

Manage and maintain manually installed Calico for Windows services

note

The manual method for installing Calico for Windows is deprecated in favor of using the Operator and Windows HostProcess containers (HPC). Support for this method will be dropped in a future Calico version.

Big picture​

Start, stop, and update Calico for Windows services on the Linux control plane node, and uninstall for Calico for Windows.

How to​

Start and stop Calico for Windows services​

  • Install and boot Calico for Windows: install-calico.ps1
  • Start Calico for Windows services:start-calico.ps1
  • Stop Calico for Windows services: stop-calico.ps1

Update Calico services​

To change the parameters defined in config.ps1:

  • Run uninstall-calico.ps1 to remove Calico for Windows service configuration
  • Modify the configuration
  • Run install-calico.ps1to reinstall Calico for Windows.

Because config.ps1 is imported by the various component startup scripts, additional environment variables can be added, as documented in the Calico reference guide.

Update service wrapper configuration​

The nssm command supports changing a number of configuration options for the Calico services. For example, to adjust the maximum size of the Felix log file before it is rotated:

nssm set CalicoFelix AppRotateBytes 1048576

Uninstall Calico for Windows from Windows nodes​

The following steps removes Calico for Windows (for example to change configuration), but keeps the cluster running.

  1. Remove all pods from the Windows nodes.

  2. On each Windows node, run the uninstall script:

    C:\CalicoWindows\uninstall-calico.ps1
    note

    If you are uninstalling to change configuration, make sure that you run the uninstall script with the old configuration file.

Uninstall kubelet and kube-proxy services from Windows nodes​

The following steps uninstall kubelet/kube-proxy services if they were installed by running C:\CalicoWindows\kubernetes\install-kube-services.ps1.

  1. Remove all pods from the Windows nodes.

  2. On each Windows node, run the uninstall script:

    C:\CalicoWindows\kubernetes\uninstall-kube-services.ps1

  3. If desired, delete the C:\CalicoWindows directory.