Skip to content

5.4.0

Choose a tag to compare

@edmozley edmozley released this 15 Nov 19:52
· 156 commits to main since this release

What this release is about

Fixes data loss on Docker. On a Docker install without a docker-compose.override.yml, every rebuild (docker compose up -d --build) deleted files FreeITSM stores: documents attached to tickets, notes, assets and articles, screen recordings, course content, logos, pictures on forms and more. This release keeps them all on volumes. Before you update a Docker install, copy those folders out first - the update is itself a rebuild. System → Setup and Debug Tools D013 list the folders; the steps are under Upgrading below. Every Docker install before 5.4.0 is affected.

Beyond that: Files gets a recycle bin, every date and time box in FreeITSM now shows and accepts your chosen date and time format with a calendar in your language, and installs that look after many companies get search boxes wherever a company is picked. People, tickets, contracts and projects can have a location, and companies and people can have custom fields. Nothing is removed; run Database Verification.

Security

  • Asset holders could be changed across companies through the REST API. An API key limited to some companies, with the asset assignments permission, could add or remove the people and analysts holding an asset in another company, by the asset's number - and looking a person up by email could name somebody in another company. The screens in FreeITSM itself were not affected. Holder changes now check the asset's company and the person's, as every other change to an asset does. Write-up: Asset holders could be changed across companies through the REST API. Affects every release with the REST API asset assignments; upgrading is all that is needed.
  • Deleting or moving a folder in Files did not check what was inside it. Someone with Modify on a folder could delete or move it even when it held a subfolder that had been kept from them, taking that subfolder with it. Deleting or moving a folder now needs Modify on everything inside it, however deep - as in Windows - and the message never names a folder the person cannot see. Write-up: Deleting or moving a folder did not check what was inside it. Affects every release with Files (3.4.0 to 5.3.0); upgrading is all that is needed.

New features

  • A recycle bin in Files - built by @cloudcogsio. Deleted files and folders wait on the desktop's Recycle bin: Restore, look inside, Delete permanently or Empty. Files → Settings → Recycle bin sets how long they are kept before a background job deletes them for good; nothing is deleted automatically until you save it, and anything already in the bin then gets the full period. A folder holding something its deleter could not delete by hand is never deleted automatically - System → Maintenance → Deleted folders kept lists those, with what to do.
  • Your date and time format, everywhere you type one. Every date, date-and-time and time box shows and accepts the format chosen in System → Date and time formats, with a calendar in your language - not the browser's own US-style box. Weeks start on Monday unless you choose Sunday, for everyone or just yourself. Phones and tablets keep their own picker.
  • Searchable company lists. For installs with many companies: once a company list is longer than a number you set (System → Companies → Company lists, 15 to start with), it becomes a box you type in to search, showing 10 at a time - when moving a ticket, task, change or asset, creating one, and on the System screens. The company switcher at the top, the right-click Move to company menus and the lists of company tickboxes get a search box too. Nothing changes with one company.
  • Locations on people, tickets, contracts and projects, from System → Locations. A new ticket takes its requester's location. System → Maintenance → Locations in use shows everything that points at a location and moves or clears it in one go; a location in use can no longer be deleted by accident.
  • Custom fields on companies and people - System → Custom fields - text, numbers, dates, yes/no, dropdowns and more, answered in the company dialog and the person editor, and read and written through the REST API.
  • Catalogue items with a picture, a short description and a price on the portal, with Your requests listing every request and its status, and a way to cancel one still waiting for approval.
  • Fold the Tickets folder column away. Press [ or the « at its top, or choose Click to open or Show on hover in Preferences → Display → Left panels.
  • A form lookup limited to one kind of CMDB object - Only objects of this kind - so a list kept once in the CMDB (job positions, say) is picked from on every form.
  • Cluster Shared Volumes on Assets → Servers - built by @Dr4inder - with a warning when a Hyper-V collector stops reporting.
  • Microsoft 365 in System → Integrations - built by @vsc55 - Entra ID and Intune in one place.
  • Debug Tools D020 shows an administrator exactly why someone cannot delete or move a folder in Files.
  • REST API: a task's related records, as a ticket's, and every operation in the OpenAPI document now names the permission it needs.

Improvements

  • Dialogs look more polished - a tinted header and footer, rounder corners, a softer shadow.
  • Under All companies, Assets → People shows every company you can reach, not only the last one picked.
  • Greek: First Time Fix has a shorter name that fits the ticket; German: the person's Office is no longer called the same as Location.
  • Files, Forms, Tickets, Workflows and System - their new screens and help are translated into Danish, German, Greek, Spanish, French, Indonesian, Polish and Ukrainian, and the company switcher's words are translated for the first time.

Fixes

  • The New starter onboarding fan-out workflow raised only its IT ticket - its HR and Facilities steps got the IT ticket back. Each step now raises its own.
  • On the portal, a form could show a search box that only ever said "No matches" - a lookup customers may not use - and block the request if it was required. Such questions are now left off the portal.
  • In workspace mode, a ticket's linked tasks were missing from its Links tab.
  • Label fonts and form pictures could be fetched straight from their folder on nginx; they now always go through the checks.

Upgrading

Docker installs without a docker-compose.override.yml: before updating, copy these folders out of the container - the update is a rebuild, and this is the last time a rebuild can lose them. The folders are uploads, recordings, lms/content, contracts/rfp-builder/uploads, system/uploads/branding, system/uploads/label-fonts, war-room/attachments and forms/images; System → Setup and Debug Tools D013 list them with the commands, and the steps are in Updating a Docker install to 5.4.0. From this release on they are kept on volumes.

  1. Pull the new code, or rebuild the Docker image.
  2. Sign in as an administrator and run System → Database Verification.
  3. Hard-refresh your browser (Ctrl-F5).

To have deleted files and folders removed automatically, set a period in Files → Settings → Recycle bin; until then the bin keeps everything.

Rollback

Safe - nothing was removed from the database, so you can go back to 5.3.0. (On Docker, keep the new volumes: 5.3.0's compose file does not mount them all.)