Page History
Advanced Features Related to Solution Import from Servoy Admin Page
Maintenance Mode
Maintenance mode is a special mode of operating Servoy Server. While Servoy Server is The Servoy Application Server can be set into the so-called 'Maintenance mode'. When in maintenance mode, no new cliets clients can connect to it. This is useful when performing certain administrative tasks, like solution imports.
In order to put Servoy Server into maintenance mode, you need to access the Servoy Server Admin Page. There you will find a button which says "Enter Maintenance Mode". If you push that button you will be asked to confirm that you really want to put Servoy Server into maintenance mode. If you confirm, then the Server will enter maintenance mode.
While in maintenance mode, the above mentioned button will have its text changed to "Exit Maintenance Mode". If you push the button, you will be again asked for confirmation. If you confirm the action, then the Server will be brought out of maintenance mode.
You can put the Server into maintenance mode, or bring it out of maintenance mode programatically, using the maintenance
plugin. Please refer to the maintenance
plugin API documentation for details about how to do that.
Solution Import Hooks
During solution import from the Servoy Admin Page, modules with certain name patterns are handled in a special way. Modules whose names start with "before_import" are handled as pre-import hooks. Their onOpen
event handlers are executed before the solution is actually imported. Similarly, modules whose names start with "after_import" are handled as post-import hooks. Their onOpen
event handles are executed after the solution is actually imported.
If you have several modules that start with "before_import" or "after_import", they will be all handled in this way, but no handling order is guaranteed. It is recommended that you have at most one pre-import and at most one post-import hook in your exported solutions.
During the execution of the onOpen
event handlers from the pre-import and post-import hooks, any output printed with application.output
will be redirected to the import log, which you can see in the Servoy Admin Page.
A simple example
Suppose you have a solution called "import_sample_01", with two modules called "before_import_01" and "after_import_01". The "before_import_01" module has the following onOpen
event handler:
...
function onBeforeImportSolutionOpen()
{
application.output("Method executed before solution import.");
}
The "after_import_01" module has the following onOpen
event handler:
...
function onAfterImportSolutionOpen()
{
application.output("Method executed after solution import.");
}
If you export this solution together with its two modules, and then you import it throught the Servoy Admin Page, in the import log you should see the lines
No Format |
---|
[info] Executing pre-import hook module 'before_import_01'.
[info] Method executed before solution import.
|
before any message related to the actual solution import, and also you should see the lines
No Format |
---|
[info] Executing post-import hook module 'after_import_01'.
[info] Method executed after solution import.
|
after all messages related to the actual solution import.
What else can you do? The maintenance
plugin.
The pre-import and post-import hooks were introduced for allowing you to automatically perform administrative tasks on the server while importing solutions:
- Send messages to connected clients, or even kill connected clients.
- Put the server into maintenance mode for the duration of the solution import.
- Perform operations on databases.
These operations can be performed through the maintenance
plugin, which is available since version 4.2 of Servoy. The maintenance
plugin was designed specifically for being used with solution import hooks. Please consult the its API documentation for specific details about available functions.
A typical scenario of using the solution import hooks is the following:
...
the Servoy Application Server.
The Servoy Application Server can be put into maintenance mode manually through the 'Enter Maintenance Mode' button on the Servoy Server Home page of the Servoy Admin page or programatically using the maintenance plugin inside an solution import hook.
Maintenance mode can be used when performing maintenance on the Servoy Application Server, like importing new solutions. While solutions can be imported and activated without going into maintenance mode first, when the nature of the changes would mean that existing and/or new clients might go into error, for example due to removing tables, the maintenance mode can prevent new clients connecting.
After the Servoy Application Server has been put in maintenance mode, existing clients can be disconnected, either through the Servoy Admin page or programatically through the Maintenance plugin.
See the Maintenance plugin for more information.