Skip to content

Deployment and Maintenance / Upgrade and Restart

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

1. Upgrade the System

For the current version of DataFlux Func, no special operations are required during upgrade. Simply follow the normal installation steps using the new version.

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

Furthermore, after the initial installation of DataFlux Func, the installation directory is written to the /etc/dataflux-func file. Therefore, during upgrade, the installation script can also automatically locate the previous installation directory, and all user data will be preserved.

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 and Deployment / Standalone Deployment

1.2 Automatic Update of Docker Version

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

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 wish to perform:

Input Description
abort Abort the installation, do nothing.
skip Do not update Docker, proceed directly with upgrading 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 by yourself, do not use the one-click installation package to reinstall it

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

After the user selects reinstall, there will be a 10-second wait period 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 command docker stack rm dataflux-func 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 containers.

If you find it troublesome, you can also use the original installation package to reinstall DataFlux Func to accomplish a 'restart'.