Upgrading the Enforcer

Upgrading from versions lower than 4.x

As of version 4.x the config builder was added. The config builder adds default values to properties that are not implicitly specified. This change requires the user to import the configuration in the init_worker_by_lua_block and access_by_lua_block blocks inside nginx.conf:

1. Modify init_worker_by_lua_block
Lua

   1
   init_worker_by_lua_block {
   2
       local pxconfig = require("px.pxconfig")
   3
       require ("px.utils.pxtimer").application(pxconfig)
   4
   }

2. Modify access_by_lua_block
Lua

   1
   access_by_lua_block {
   2
       local config = require('px.pxconfig')
   3
       require("px.pxnginx").application(config)
   4
   }

3. Modify header_filter_by_lua_block
Lua

   1
   header_filter_by_lua_block {
   2
       require("px.pxnginx").finalize()
   3
   }

Upgrading from versions above 4.x

To upgrade to the latest Enforcer version, re-install the Enforcer according to your OS.