4.7.0 Release Notes

Red Hat Mobile Application Platform 4.7

For Red Hat Mobile Application Platform 4.7

Red Hat Customer Content Services

Abstract

This document provides a high-level description of known issues, fixed issues and new features in RHMAP 4.7.0.

Chapter 1. Release Announcement

1.1. Node.js 8 and 10

With this release, Node.js 8 and 10 are supported by Red Hat Mobile Application Platform 4.7. Red Hat recommends that you upgrade to either Node.js 8 or 10.

Note

To use Node.js 8 or 10, update fh-mbaas-api to 9.0.4 or later. For more information, see Upgrading Node.js for Cloud Apps and MBaaS services using RHMAP Studio.

1.2. Template removal

A number of Templates were removed from RHMAP 4.7, however the following Templates are still available in RHMAP 4.7:

  • iOS Hello World Project.
  • Android Hello World Project.
  • Cordova Hello World Project.
  • Empty Project.
  • Forms Project.
Note

Each of the Templates have an associated Cloud App apart from the Empty Project Template.

Chapter 2. Deprecation Notice

2.1. Node.js 6

Support for Node.js 6 is scheduled to be removed from RHMAP in a release scheduled for early 2019.

2.2. Build Service

The existing RHMAP Build Service (‘Build Farm’) is deprecated. Building client binaries directly from RHMAP will no longer be supported by Red Hat in an upcoming release of RHMAP.

Build Farm documentation has been removed from RHMAP 4.7. There are links to existing Buildfarm documentation where it was necessary to retain the integrity of the documentation.

Chapter 3. Known Issues

3.1. Issue when Deploying to Multiple Environments

An issue exists where Cloud App deployments might fail if deployed to multiple environments that are configured to use different MBaaS targets.

If you encounter this issue:

  1. Navigate to the Deploy Screen.
  2. Make sure the Clean Stage checkbox is enabled.
  3. Click Deploy Cloud App.

3.2. Issue with Mail Notifications relating to Form submissions

If your OpenShift cluster is behind an outbound HTTP proxy, mail notifications relating to form submissions fail.

To work around this issue, configure your firewall as follows:

  1. Determine the SMTP_SERVER and SMTP_PORT environment variables in the millicore deployment configuration of the RHMAP Core project:

    oc env dc/millicore --list -n rhmap-core | grep SMTP_SERVER

    oc env dc/millicore --list -n rhmap-core | grep SMTP_PORT

  2. Add a firewall rule to allow outbound traffic from the OpenShift cluster to the IP address and port determined in Step 1.

3.3. Issue with Forms Using Check Boxes

If you click submit on a draft or review form, sometimes a check box selection error is displayed, despite the correct selection of check boxes.

To work around this issue:

  1. Open the submission from the Review menu.
  2. Unselect the previously selected check boxes, leaving unselected check boxes unchanged.
  3. Click Submit.

3.4. $fh.db Issue

$fh.db is a Cloud API that supports CRUDL (create, read, update, delete, list). However there is an issue with the list operation if you are using a 8.x version of fh-mbaas-api earlier than version 8.0.3. Red Hat recommends that you update fh-mbaas-api to 9.0.4 or later. For more information, see Upgrading Node.js for Cloud Apps and MBaaS services using RHMAP Studio.

3.5. Issues When Filtering Data Using the _id column

The Data Browser allows you create filters to query data. However, if you create a filter using the _id column, incorrect results are displayed. There is no workaround for this issue.

3.6. Upgrading Swift SDK for XCode

If you want to develop apps for iOS with Swift using XCode 8.3 or later, you must upgrade the iOS Swift SDK in order to build those apps using RHMAP. To download the latest SDK, see fh-ios-swift-sdk.

3.7. Studio Unresponsive

Very large files or repos may cause your browser to become unresponsive when accessing the Studio editor.

3.8. Sorting of Items in Studio

The lists for Projects and Environments in the Studio are not sorted based on creation time. There is no workaround for this issue at the moment. Studio allows you to sort items, for example, you can view a list of Projects sorted by last update. However, only the current page is sorted, if you click the next page, the sorting is lost. There is no workaround for this issue at the moment.

3.9. Form-based Email Notifications

RHMAP includes a feature that allows you to create a form that triggers an email after each submission. One of the email options is to include the app name, however the emails sent from RHMAP do not include the app name. There is no known workaround for this issue at this time.

3.10. Error Messages If an MBaaS is Unavailable

If you perform an action that applies to all environments, but one or more environments is associated with an MBaaS that is currently unavailable, you may see messages that are unhelpful. For example, if you delete a form for a project that is associated with an environment MBaaS that is unstable might result in a 401 error. To work around this problem, ensure all MBaaS instances are available.

3.11. Export Button

The Data Browser Export button is incorrectly presented to user as being disabled. However, clicking the button will export data.

3.12. Jenkinsfile in Templates

Every Client App template includes a Jenkinsfile in the root directory of the template repo. This file is intended for the self-managed Build Farm and does not provide any functionality for hosted RHMAP.

3.13. Data Browser Export

If you try to export BSON data as described in the Server-side Developer Guide, the export fails. To workaround this issue, export data as JSON or CSV.

If you try to export data from the Data Browser, the export may fail due to a database version issue. To workaround this issue, upgrade the database and try again.

To upgrade the database:

  1. In the Data Browser section of the Cloud App page in Studio, click the Upgrade Database button in the top right corner, and confirm by clicking Upgrade Now. Wait until the upgrade process finishes.
  2. Redeploy the Cloud App by clicking Deploy Cloud App in the Deploy section.

3.14. Data Browser Import

If you try to import data as described in Server Side Developer’s Guide, the import fails. There is no workaround for this issue at the moment.

3.15. Deleting Projects

If you enter a name containing special characters when creating a project, and you later decide to delete that project, you are prompted to enter the HTML entity code instead of the special character. For example, if you create a project named Tom’s App, and you choose to delete it, you are prompted to enter the following:

Tom's App

To delete the project, enter the text, including the HTML entity code, as prompted.

3.16. Sync Framework Storage Issues

If you are using the Sync Framework, note that there is a known issue with iOS apps that use webkit-sqlite for storage. After the app is running for longer than a few minutes, you might encounter storage failures. Use indexDB for storage instead.

Chapter 4. Upgrading Node.js for Cloud Apps and MBaaS services using RHMAP Studio

This procedure describes how to upgrade the Node.js version in a Cloud App and MBaaS service using RHMAP Studio.

Prerequisites

  • Access to RHMAP Studio.
  • RHMAP Studio login credentials.

Procedure

  1. Log in to RHMAP Studio.
  2. Navigate to the Editor screen for your Cloud App or MBaaS service in RHMAP Studio.
  3. Click package.json to display the contents.
  4. Update the fh-mbaas-api value to 9.0.4.
  5. Click File, then Save.
  6. Test the Cloud App or MBaaS service before deploying to Production.

    Note

    When deploying a Cloud App or MBaaS service, select Node.js 8 or Node.js 10 from the Choose a Runtime dropdown in RHMAP Studio.

Additional resources

  • For more information about deploying, see Deploy.

Legal Notice

Copyright © 2018 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.