Loftware Enterprise SP v5.1 Release Notes
March 2024
Release Summary
Loftware Enterprise SP 5.1 is a minor release that includes new features, enhanced functionality, and numerous quality and performance improvements.
Loftware Spectrum Rebranding
With version 5.1, Loftware Spectrum has been rebranded to Loftware Enterprise SP for on-premise installations and Loftware Cloud Enterprise SP for cloud installations.
Loftware Print Agent (LPA) High Availability
The Loftware Print Agent (LPA) was a potential single point of failure for associated devices. If the LPA server was unavailable or down for any reason, printing stops for all the printers for that Remote Site. With Loftware Enterprise SP 5.1, LPA now supports the implementation of a second LPA for high availability purposes.
Linked Text Boxes
Loftware Enterprise SP 5.1 introduces the ability for label designers to link multiple text boxes together and allow text to flow from one text box to another. Linked text boxes allow the designer to optimize the available space within a label. Label designers can use this feature to give the appearance of wrapping text around other label objects, such as images and barcodes.
Support for New Loftware Integration for SAP BTP and S/4HANA Cloud
Loftware is introducing a new integration with SAP that will enable Loftware Labeling solutions to integrate with SAP BTP and S/4HANA Cloud OMS systems. In support of this new integration, Loftware Cloud Enterprise SP 5.1 introduces a new integration for SAP BTP and S4/HANA.
Loftware Cloud Enterprise SP Status for SAP Applications
Prior to 5.1, Loftware Cloud Enterprise SP customers with an SAP BC-XOM integration were required to open a port on their SAP system or use a VPN to receive status messages back to their SAP on-premise system. Loftware Cloud Enterprise SP 5.1 supports Loftware Integration Status for SAP Applications which enablesLoftware Cloud Enterprise SP and SAP on-premise customers using BC-XOM integrations to receive job status without requiring port openings or VPN connections.
User Interface (UI) Pagination Improvements
Loftware Enterprise SP 5.1 continues the pattern of adding pagination to views that present a large number of results to the user. Pagination limits the number of results displayed at any one time, which improves load time and the UI experience for users.
Technical Updates
Loftware Enterprise SP 5.1 includes the following technical updates:
- Support for PostgreSQL 15 and Red Hat Enterprise Linux 9 (RHEL 9)
- Serialized files are now signed and verified during import and export of documents as a security measure
- Output from the PDF driver is now locked to prevent updates per the licensing agreement with Monotype Fonts
- Oracle 12c is no longer supported
Installation Prerequisites
Loftware Spectrum 4.0 or later must be installed before upgrading to Loftware Enterprise SP 5.1. If you are on a version prior to Loftware Spectrum 4.0, then you cannot upgrade to Loftware Enterprise SP 5.1 directly — you must first upgrade to Spectrum 4.0.
If you are upgrading from a version prior to Spectrum 4.0, do the following:
- Upgrade to Loftware Spectrum 4.0. For more information, see "Upgrading Loftware Spectrum" in the 4.0 Loftware Spectrum Installation and Configuration Guide.
- Upgrade to Loftware Enterprise SP 5.1. For more information, see "Upgrading Loftware Enterprise SP" in the 5.1 Loftware Enterprise SP Installation and Configuration Guide.
Important: If you are upgrading to Loftware Enterprise SP 5.1, you must upgrade the Loftware Enterprise SP database in addition to the Loftware Enterprise SP application.
Spectrum Remote Print
If you are upgrading to Loftware Enterprise SP 5.1 from an earlier version and you are using Spectrum Remote Print with the Remote Print Agent (RPA), you must upgrade all RPAs to LPAs after upgrading to Loftware Enterprise SP 5.1.
Issue Details
The following tables detail the additions, changes, and known issues in this release.
Status Definitions
- Resolved: Loftware has fixed this issue.
- Open: Loftware has identified this issue.
- Known: Loftware has identified this as a user experience item or best practice to be aware of.
Resolved Issues
Status |
Description |
---|---|
Resolved |
When a Data Service with a Data Link was being called from a Business Rule an "Unable to create a connection pool for url” error is thrown. |
Resolved |
The scanned barcode result and the human-readable value for a barcode with check digit set to Mod 43 may be different if the number of characters is less than the Max Chars setting. |
Resolved |
When printing to a device configured for the Zebra Family Driver (ZPLII), custom commands do not work if the ‘Print Label As Image” option is checked. |
Resolved |
The Spectrum website was allowing redirection to another URL based on external input. |
Resolved |
When designing a label, if the Document DPI is set to 1200 and a code128, or code39, barcode has an x-dim between 6.4 and 9.6, the last few bars are being cut off. This occurs in Design view and on the printed label. |
Resolved |
Specific instructions for configuring the Loftware Print Agent using HTTPS were omitted. |
Resolved |
The documentation for Multi-site deployment neglected to state that HQ and the Facilities must be the same Spectrum version. |
Resolved |
There was a limitation that SuperAdmin was not allowed to change the passwords for MultiAdmin, JVMAdmin, and Integration User. |
Resolved |
When sending a System Message in System Administration, the message and bell icon was not displayed until a user signed out and back in. |
Resolved |
When using Bulk Device Import to update the Remote Site associated with a device, the device is not listed under the Remote Site until an update is made in the UI. |
Resolved |
After applying 4.7.1 PDF HF1 and printing to PDF, some images appear to be stacked on top of each other, even though they preview correctly. |
Resolved |
When two labels are open in Label Design, and the zoom is set to 200%, the barcodes appear smaller when switching between the two labels. |
Resolved |
When using the transfer utility, certain labels were failing with the error: "Text Box: java.lang.indexOutOfBoundsException: Index: 0, size: 0”. |
Resolved |
Several issues were addressed:
|
Resolved |
When using a Code39 barcode with a start/end code and human-readable text, Print Preview and Design Print failed to display the "**” between the text data. |
Resolved |
When printing serialized labels to a Zebra print engine on a print and apply line, random labels will be missing from the middle of the job. |
Resolved |
The Print Preview window prevents any interaction with the UI in the background. |
Resolved |
The HTTP Data Service is not reading repeated attributes the same way that a SOAP Data Service does. |
Resolved |
In Label Design, when the label is zoomed to 200% and an undo action is performed, label fields become distorted. |
Resolved |
Configuring an Oracle Integration with the "Use Secure Connection” set to true and also specify a Spectrum override URL, the resolved Spectrum URL sent to the Oracle system will not be "https//” if the JVM doesn’t have a Secure JVM Port defined. |
Resolved |
When configuring a QR Code on a Label, there is no ability to select a discrete symbol size. |
Resolved |
The GetLabelTemplates REST call will fail if there is a versioned label that has not been checked in at least once. |
Resolved |
When a job id is returned to Oracle via a Spectrum Oracle integration, it is in scientific notation. |
Resolved |
When a device belonging to a Remote Site has the "Fail Job on Connection Error” set to "Immediate”, the job does not fail as expected if the LPA client is connected, but the device ping fails. |
Open Issues
Status |
Description |
---|---|
Open |
When installing the Loftware Spectrum database into Oracle, you may see the following message in the installation log file. This message can be ignored and will not affect your Spectrum environment. WARNING: possible data loss in character set conversions |
Open |
When installing or upgrading a facility database in Spectrum, ensure that the name of the folder that you create does not include a space character. Including a space causes the install or upgrade to fail. |
Open |
When installing a facility database in Spectrum, you may see the following message in the installation log file. This message can be ignored and does not affect the installation. <In error box> ls_schemas failed. Exiting installer… |
Open |
After upgrading, the account that Spectrum runs under will be set to the local system account. If you made changes to this account prior to the upgrade, then you will need to reset the account. |
Open |
After upgrading, if the encrypt tag is in use for the password field in the jdbc.properties file for the Loftware DaVinci solution, then you must remove it and restart Spectrum in order to launch Loftware DaVinci from Spectrum. |
Open |
When upgrading, only the contents of the <SPECTRUM_HOME>\product\lib folder are preserved. All other folders and contents thereof, including PDF files associated with jobs sent to the default PDF device (default location: <SPECTRUM_HOME>\product\webapps\ ROOT\pdfs) and third-party JDBC drivers are removed during the upgrade process. Before upgrading, it is recommended that you copy all files that you want to retain after the upgrade to a location outside of <SPECTRUM_HOME>. After completing the upgrade process, copy the files back to their original folder. Also, if a third-party JDBC driver was previously installed, follow the steps in the "Add a JDBC Driver" section in the Loftware Enterprise SP User Guide (online Help). |
Open |
If you are using a PostgreSQL database on Windows, there are database tasks that are required to be run on a schedule which create and populate archive tables and refresh materialized views. To ensure that these tasks are run regardless of the user that is signed in, do the following: In the Windows "Task Scheduler" utility, a user can configure the tasks to run regardless of whether the initiating user is signed in or not:
|
Open |
After upgrading, if you are using Distributed Services you will need to activate and restart the services related to Barcode Wizard and DaVinci Compare objects on all Spectrum Application Servers. Failure to do so will result in the following error dialog: Unable to find service instance for service id: XXXXX The services to activate and restart include the following. Barcode Wizard folder:
DaVinci Compare folder:
To activate and restart the services, do the following:
|
Open |
When using the Server > Loftware device with a NiceLabel driver, if a printer connected to the Loftware Print Agent changes DPI, then the new DPI is not updated. A new Server > Loftware device will need to be created in Spectrum to see the updated DPI setting. |
Open |
When printing an EAN13 barcode using the Avery Dennison MPCL driver, it is recommended that the barcode be imaged to ensure the XDIM setting is honored. |
Open |
It is recommended that you clear your browser cache prior to signing in after upgrading. |
Open |
If you are using Distributed Services and need to remove a Spectrum Application Server, you must restore your Spectrum environment to a backup version before the Spectrum Application Server was added. |
Open |
If you are using Distributed Services, the option to automatically configure devices is unavailable. |
Open |
If you are using Distributed Services, the option to automatically configure servers is unavailable. |
Open |
When using a variable layer in Label Design, note that the Horizontal Alignment and Vertical Alignment controls do not work as expected. |
Open |
In Business Rule Configurator, using the Relative Path option for a data service can result in an error. It works correctly when the Relative Path option is not selected. |
Open |
In Print, using the keyboard shortcut F9 to initiate printing to the default printer does not work. |
Open |
After enabling GDPR with AES encryption, some user data viewed in Spectrum Business Intelligence will be displayed encrypted. |
Open |
When using Import from Label Design or Object Promotion, the property for the Icon reference of an application object is not preserved. |
Open |
When using Object Promotion with a Business Rule, Reserved Keys are not processed as expected and will result with an "Object not found" message. |
Open |
After creating a data service with parameters, the data type of a parameter is read only and cannot be changed. Once a parameter is created, you will need to delete and recreate the parameter in order to change the type. |
Open |
In the Core Services panel of Service Management, the Object Sync Service, Transaction Sync Service, and Multisite Management Service display a status of Unknown unless a multi-site deployment of Spectrum is licensed and configured. |
Open |
When opening folders with more than 500 objects, the Spectrum user interface may become unresponsive. It is recommended to organize objects in multiple folders. |
Open |
Certain device models display the Connection tab when configuring Label Specific Options (LSOs). This tab should not be shown and may cause the connection options to be overridden. |
Open |
Previewing a label to a printer that has an LSO or DSO that has the text box overflow set to Allow Overrun will fail if there is an actual overrun in the label. |
Open |
Using the arrow keys repeatedly to adjust the position of an object in Label Design may cause it to adjust the vertical or horizontal position as well. This causes the object to move in a diagonal pattern. |
Open |
When importing a CSV file into a Cross Reference table within Spectrum and an error occurs, the error will be reported as occurring on row 1 regardless of the row the error occurred on. |
Open |
A Data Service which previously used a Data Link, but was subsequently removed, will fail Object Promotion referencing the removed Data Link. To resolve the issue:
|
Open |
Customers that deploy Spectrum in their private cloud on AWS Linux 2, or RHEL9 could see the following error in the Spectrum.log: "Java.lang.error: Probable fatal error: No fonts found.” This can be resolved by running the following command: "yum install fontconfig -y” It can also be installed from https://www.freedesktop.org/wiki/Software/fontconfig |
Open |
When the Print Label as Image option is checked in the Advanced tab in the device settings and custom commands are entered, there may be a case where not all the custom commands are sent to the printer. |
Known Issues
Status |
Description |
---|---|
Known |
If you are upgrading from Spectrum 5.0 or earlier, are using an SAP BC-XOM integration, and are using the Loftware Spectrum Command Line Interpreter (CLI), Loftware recommends that you replace the Loftware Spectrum CLI with Loftware Integration Command Line Interpreter (CLI) for SAP Applications version 3.0. For more information, see Getting Started with Loftware Integration Command Line Interpreter (CLI) for SAP Applications. |
Known |
If your Loftware database is in Oracle, you must install Spectrum 5.0 before upgrading to Loftware Enterprise SP 5.1. If you are using a version earlier than Spectrum 5.0, you cannot upgrade directly to Loftware Enterprise SP 5.1. Instead, you must first upgrade to Spectrum 5.0. To upgrade from a version earlier than Spectrum 5.0, follow these steps:
|
Known |
Ensure that all jobs have completed before stopping a File Drop integration. If the integration cannot be restarted, a restart of the Loftware Spectrum service is required. |
Known |
Starting with Spectrum 4.0, applications are run in an HTML5-based interface. This requires that the forms that are used by your application must use a font that is licensed as installable. The following fonts are available with Spectrum for use on a form:
If you have upgraded from a version prior to Spectrum 4.0 and you have a form that is using a font that is not listed above, then Arial will be selected by default. If you would like to use a different font, then you can use the Spectrum Font Management capability to add a new font for use on a form. See the "Use Fonts in Forms” section in the Loftware Enterprise SP User Guide (online Help). |
Known |
If you have upgraded to Spectrum 5.0 and are using Applications, note the following: Because the default color of buttons has changed, if a button was added to a form and was created using the default fill color, then it will continue to display the previous blue color. If you add a new button, it will display in the new default blue color. These are the default colors of the button. The button fill color can be changed by the user. The same does not hold true for other control types that appear in forms. For example, check boxes and drop-downs that existed prior to the color changes will now appear with the new default blue color. The colors used for these controls cannot be changed by the user. |
Known |
When upgrading Spectrum, or applying a hotfix which replaces a server.war file, and the "\webapps\spectrum-server\web-inf\classes\beans.xml” file has been customized, the instructions should state that a backup of the beans.xml needs to be captured prior to the upgrade. Once the upgrade is complete, a comparison of the beans.xml backup and the current bean.xml file should be done and any deltas should be brought to the attention of Technical Support or PSG for verification before implementing the new beans.xml file. |
Known |
Spectrum 5.0 includes a Tomcat upgrade which results in a mime type change for extension "js" where application/javascript is obsolete and replaced with text/javascript. Tomcat uses this mapping to set the Content-Type header of the response for a requested resource based on its file extension. |
More Information
For information about how to use Loftware Enterprise SP, see the Getting Started with Loftware Enterprise SP guide included in your release package or click Help from within Loftware Enterprise SP to see the Loftware Enterprise SP User Guide.
For specific questions regarding this release, please contact the Loftware Product Management team at ProductManagement@loftware.com.