5.1 is an update within IIZI 5: applications, servers and iiziRun stay on the 5.x line, and most installations update without a change. The steps below are the exceptions, in the order you meet them.
Before the update: the server
The database settings of the configuration file
The database directory, host, port, auto-create and auto-start of the server's configuration file are used from 5.1 on, whenever the command line does not give them; 5.0 ignored them. Check them before the update: a server whose file names another database than the one it runs on will use the file's. The launchers of the installation give the database directory and port on their command line, as before, and the command line still wins.
One name per settings entry
Port configurations, server environments, mail senders and Let's Encrypt domains share one name space. If two of them share a name – a port configuration and an environment both called main, say – rename one before the update: a configuration file with such a pair is refused at load, and the server ends with exit code 9.
Exit code 9
A server that fails to start on its configuration ends with exit code 9 instead of 0, and so does a server started with an invalid -app ID (one that holds a character other than A-Z, a-z, 0-9, dot and underscore, or does not begin with a letter). A supervisor that restarts on any non-zero code should treat 9 as “fix the configuration”.
Log readers
- Session IDs are 32 hexadecimal characters and appear masked in every log line (
FE4D...441A-1). - On Windows the start line ends with the Windows release and build (
... on Windows 11 25H2 (build 26200.7171) amd64): a script that reads the version from the start line up to the end of the line must stop at the first blank. - The banner at start is one “Program info” INFO entry, in server.log as well as on the terminal.
ClientAddressResolverand the proxy and binding checks moved packages: their two warnings keep their text, but the class name in front of each log line changes.- The IP2Location history file is
ip2location-events.jsonl.
A reverse proxy's access log
A reverse proxy that logs full request addresses writes each reconnection's session ID and secret token (reconnect and rt in the address) into its access log. Leave the query string out of that log, or keep the log confidential.
Every mail sender now gives up after 10 seconds for the connection and 15 seconds for a reply or a write. A mail host that needs more than 15 seconds for one reply needs the sender's timeout set. Mail to the reserved test domains is refused when it is queued, unless the relay runs on the server's own computer.
After the update: the server
A Windows service and the secrets store
To give a Windows service its own secrets store in %ProgramData%\iizi\secrets, install the service again with the new is.bat: an update keeps the service programs it finds in bin\ntservice. The values of an existing secrets store are not moved; set them again with the secrets tool, which uses the service's store by default.
Style sheets and Node.js
To minify style sheets with lightningcss, set the environment variable NODE_HOME of the server to a Node.js installation and install lightningcss globally for that Node. Without them, a built-in minifier does the work and the server writes one WARNING that says which requirement is missing.
The Server Monitor
iiziGo's Server Monitor reaches a development server from the same computer only: name the server localhost in the view. For a development server on another computer, start it with -Diizi.allow.monitor.remote=true, on a trusted network only.
The VirtualSpace Viewer
A production server no longer serves the VirtualSpace Viewer. On a development server it shows no administrator's session unless the server's Java is started with -Diizi.allow.vsviewer.admin=true.
Accounts and sign-in
- Accounts disabled by failed sign-ins in 5.0 stay disabled: enable them in ServerAdmin. From 5.1 on, failed sign-ins lock an account for a while instead.
- Strong sign-in is off until you set it. Once set, a value above what the server supports stops the server at start with exit code 9.
- Published user files, such as profile pictures, have new addresses; an application or a page that stored an old
/$$ud/address gets 404 and must ask for the file's address again. - The Push API: a caller of the HTTP Basic sign-in should honor status 429 and its
Retry-Afterheader.
Applications
Buttons
A button's text no longer wraps by default. Where a label should wrap over several lines, set the button's Text wrap to “Multiple lines” in iiziGo, or call setTextWrap; “Ellipsis” cuts a long label and shows the full text as a tooltip.
Grid layout and dialogs
The Grid layout keeps every component inside its container: a grabbing column without a Minimum width can now shrink to 0, so give such a column a Minimum width where its content must stay visible. A dialog larger than the window is limited to 90 % of it and scrolls inside. Look at panels with grabbing columns and large dialogs once after the update.
Module names
A Module project whose name holds #, % or $ could not be served and is now refused by the server; iiziGo marks such a project with a warning. Rename it.
Java code
- Import
ClientAddressResolverfromcom.iizix.server.web, and rebuild. - Use
com.iizix.server.geoandcom.iizix.server.geo.ip2locationinstead ofco.mindus.ip2location, which is no longer exported. - Remove reads of
SystemConfig.isWinNext. UIComp.getStyles(false)can answer null.
Removed components and their replacements
| Removed | What to use instead |
|---|---|
Dojo's rich text editor (dijit/Editor, dijit/_editor, dojox/editor) | Your own copy of the editor in the application's JavaScript; iiziGo's text editor of the Text Table editor is unchanged. |
The Calendar list and Calendar event components, dojox/calendar | Never in a released palette. Remove such a component from a panel; the message at load names the panel and how to repair it. |
Currency support (dojo/currency, CurrencyTextBox) and the non-Gregorian CLDR calendars | Your own copy in the application's JavaScript. |
dojox/dnd, dojox/gfx3d and the 3D charts, the dojox ColorPicker | Your own copy; UIChart draws two-dimensional charts. |
The claro theme files, dijit/icons, dijit-all.js | The IIZI, Graphite and Contrast themes; claro was no longer a choice in 5.0. |
SystemConfig.isWinNext | Nothing: it was always false. |
iiziGo
- Update iiziGo with Help > Check for Updates, or install the complete setup of 5.1.
- The saved open or closed state of the panel preference sections is reset once.
- A
.iiziRunfile loses its obsoletelogin_userandlogin_passwordmembers the next time iiziGo saves it. - “Ignore UI focus” is saved as one of three choices from the next save of the file on.
- The tab or page shown in the Panel Editor is no longer saved as the panel's opening page: check the opening page in the Property Editor of panels whose first page matters.
- Rebuild a Customized iiziRun with iiziGo 5.1 to move it to cordova-ios 8.2.0.