Skip to content

Deployment and Maintenance / Upgrade and Restart

This article mainly introduces how to upgrade and restart DataFlux Func.

1. Upgrade the System

The current version of DataFlux Func does not require any additional special operations during the upgrade. Simply follow the normal installation steps using the new version.

The installation script will automatically recognize the already installed DataFlux Func and complete a series of operations such as stopping the service, replacing the image, and restarting.

In addition, after the initial installation of DataFlux Func, the installation directory will be written to the /etc/dataflux-func file. Therefore, during the upgrade, the installation script can automatically find the previous installation directory, and all user data will be retained.

You can use cat /etc/dataflux-func in the command line to view the currently recorded installation directory.

For detailed installation documentation, please refer to Deployment and Maintenance / Installation Guide / Single Node Deployment

1.2 Automatically Update Docker Version

Different versions of DataFlux Func may come with different versions of Docker:

DataFlux Func Version Included Docker Version
5.1.0 and later 24.0.9
3.4.0 ~ 5.0.5 23.0.6
3.3.3 and earlier 20.10.8

Therefore, when upgrading the DataFlux Func version, the automatic installation script will detect the current Docker version and prompt whether to reinstall Docker:

Text Only
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
The current version of the DataFlux Func prefers another version of Docker
  Current Docker (docker --version):
    -> 20.10.8
  DataFlux Func prefers:
    -> 23.0.6

Reinstalling Docker will stop the docker service and shut down all running containers, this will make all your service unavailable!

Do you want to reinstall the Docker 23.0.6 (current: 20.10.8) ?
  -> abort    : Stop and do nothing
  -> skip     : Skip reinstalling Docker, use current version of Docker and continue to install DataFlux Func
  -> reinstall: Reinstall Docker and install DataFlux Func
Your choice:

Users can input the specific operation they need:

Input Description
abort Abort the installation, do nothing
skip Do not update Docker, directly upgrade DataFlux Func
reinstall Reinstall the new version of Docker, then upgrade DataFlux Func

If the Docker on the host machine was not automatically installed by the DataFlux Func installation package, please upgrade Docker manually, do not use the one-click installation package to reinstall.

If the host machine's Docker is running services other than DataFlux Func, please confirm whether reinstalling Docker will affect the business.

After the user selects reinstall, there will be a 10-second wait for the user to press CTRL + C to interrupt the Docker reinstallation:

Text Only
1
2
3
Your choice: reinstall
[Reinstall Docker and install DataFlux Func]
You have 10 second to interrupt this action by pressing CTRL + C

2. Restart the System

When a restart is needed, please follow these steps:

  1. Use the docker stack rm dataflux-func command to stop DataFlux Func (this step may take some time).
  2. Use docker ps to confirm that all containers have exited.
  3. Use docker stack deploy dataflux-func -c {installation directory}/docker-stack.yaml --resolve-image never to restart all services.

Since the image files in the installation package are already imported locally, adding the --resolve-image never parameter can prevent Docker from performing unnecessary image checks when starting the containers.

If it's too troublesome, you can also reinstall DataFlux Func using the original installation package to complete the 'restart'.