[Bug 2134985] Re: ceph-mgr-dashboard renders blank page due to missing JavaScript files in package 19.2.3
Matthew Ruffell
2134985 at bugs.launchpad.net
Tue Jan 6 05:52:49 UTC 2026
** Description changed:
- Summary:
- The ceph-mgr-dashboard fails to load the user interface after upgrading the ceph package to version 19.2.3-0ubuntu0.24.04.1 on Ubuntu 24.04 LTS.
+ [Impact]
- Instead of the login screen, the browser renders a completely blank
- white page. The browser console confirms that the server returns 404 Not
- Found errors for critical JavaScript files required to render the
- application.
+ The ceph-mgr-dashboard fails to load the user interface after upgrading the ceph
+ package to version 19.2.3-0ubuntu0.24.04.1 on Ubuntu 24.04 LTS.
- This appears to be a regression in the packaging or build process for
- 19.2.3, where the compiled frontend artifacts (JavaScript bundles) were
- not correctly included in the final .deb package in
+ Instead of the login screen, the browser renders a completely blank white page.
+ The browser console confirms that the server returns 404 Not Found errors for
+ critical JavaScript files required to render the application.
+
+ This is a regression in 19.2.3, where the compiled frontend artifacts
+ (JavaScript bundles) were not correctly included in the final .deb package in
/usr/share/ceph/mgr/dashboard/frontend/dist/.
- Affected Package:
- * ceph-mgr-dashboard
- * Version: 19.2.3-0ubuntu0.24.04.1
- * Release: Ubuntu 24.04.3 LTS (Noble Numbat)
+ This is because the JavaScript bundles were added to the d/clean file during the
+ 19.2.3 release process. We are going to revert that change, back to the d/clean
+ file from 19.2.1.
- Steps to Reproduce:
- 1. On a system running Ubuntu 24.04, install or upgrade to the affected version:
- sudo apt install ceph-mgr-dashboard=19.2.3-0ubuntu0.24.04.1
+ [Testcase]
- 2. Enable the dashboard module:
- ceph mgr module enable dashboard
+ You first need a ceph cluster already deployed and running. We will be talking
+ to its mgr service from the reproducer system.
- 3. Navigate to the dashboard URL in a web browser:
- http://<mgr-ip>:8080/
+ Once that ceph cluster is deployed and operational:
+
+ $ sudo apt update
+ $ sudo apt install ceph cephadm ceph-mgr-dashboard
+
+ Bootstrap a ceph cluster on the VM:
+
+ $ sudo cephadm bootstrap --mon-ip <ceph-cluster-ip> --single-host-
+ defaults
+
+ After installation is done, the process will show the credentials needed for the
+ dashboard. We can then log into it to make sure it's working.
+
+ $ sudo ceph mgr module enable dashboard
+
+ Then navigate to the dashboard in a webbrowser, and use the credentials from
+ the previous command.
+
+ http://<vm-ip>:8080 or http://<vm-ip>:8443
Expected Result:
The Ceph Dashboard login page should load successfully.
Actual Result:
* The browser displays a blank white page.
- * Browser Console/Network Tab: Requests for .js files (e.g., main.js, runtime.js, or similar chunks) return 404 Not Found.
+ * Browser Console/Network Tab: Requests for .js files (e.g., main.js,
+ runtime.js, or similar chunks) return 404 Not Found.
- Scope and Root Cause:
- It is highly probable that this error affects all new Ubuntu packages derived from this source, as the debian/clean file has been modified in all of them. This suggests the aggressive cleaning or exclusion of build artifacts is a systemic issue introduced by the recent packaging changes.
+ Alternatively, you can also just check to see if the files are present:
- Development Branch Status:
- This packaging issue is also present in the ubuntu/devel branch. A Merge Proposal has already been created to fix the underlying build/clean logic in the packaging source.
+ $ sudo apt install ceph-mgr-dashboard
+ $ ls -l /usr/share/ceph/mgr/dashboard/frontend/dist/*/*.js
- System Information:
- Description: Ubuntu 24.04.3 LTS
- Release: 24.04
+ There are test packages available in the following ppa:
- Package Policy:
- ceph-mgr-dashboard:
- Installed: 19.2.3-0ubuntu0.24.04.1
- Candidate: 19.2.3-0ubuntu0.24.04.1
- Version table:
- *** 19.2.3-0ubuntu0.24.04.1 500
- 500 http://archive.ubuntu.com/ubuntu noble-updates/universe amd64 Packages
- 100 /var/lib/dpkg/status
- 19.2.0-0ubuntu0.24.04.2 500
- 500 http://security.ubuntu.com/ubuntu noble-security/universe amd64 Packages
- 19.2.0~git20240301.4c76c50-0ubuntu6 500
- 500 http://archive.ubuntu.com/ubuntu noble/universe amd64 Packages
- No LSB modules are available.
- Description: Ubuntu 24.04.3 LTS
- Release: 24.04
+ https://launchpad.net/~mruffell/+archive/ubuntu/lp2134985-updates
- Evidence:
- Listing the directory /usr/share/ceph/mgr/dashboard/frontend/dist/ shows missing JavaScript assets compared to previous working versions.
+ If you install the test packages, the JavaScript files will be present and the
+ dashboard will function as normal.
- The following command can be used to confirm the missing files (returns empty list on affected systems):
- ls -l /usr/share/ceph/mgr/dashboard/frontend/dist/*/*.js | head -n 100
+ [Where problems can occur]
+
+ We are reverting d/clean back to its state in 19.2.1, that is, removing all the
+ items added in the 19.2.3 SRU.
+
+ These were added for not-really-convincing reasons, and should just be
+ dropped.
+
+ The biggest difference is re-adding the JavaScript files back, so ceph dashboard
+ can function again.
+
+ There are other files, namely the btrfs testsuite and ceph QA yaml files. These
+ are not used during build and are not present in final packaging, and likely
+ will not cause any regressions to end users.
+
+ If a regression were to occur, users could copy back files from previous
+ packages, or will likely need to rollback until a fix is ready.
+
+ [Other info]
+
+ Luciano has summed up the uses of the other files in comment #21.
** Changed in: ceph (Ubuntu Noble)
Assignee: (unassigned) => Matthew Ruffell (mruffell)
** Changed in: ceph (Ubuntu Questing)
Assignee: (unassigned) => Matthew Ruffell (mruffell)
** Changed in: ceph (Ubuntu Resolute)
Assignee: (unassigned) => Matthew Ruffell (mruffell)
** Changed in: ceph (Ubuntu Plucky)
Status: Confirmed => Won't Fix
** Changed in: ceph (Ubuntu Noble)
Status: Confirmed => In Progress
** Changed in: ceph (Ubuntu Questing)
Status: Confirmed => In Progress
** Changed in: ceph (Ubuntu Resolute)
Status: Confirmed => In Progress
--
You received this bug notification because you are a member of Ubuntu
OpenStack, which is subscribed to ceph in Ubuntu.
https://bugs.launchpad.net/bugs/2134985
Title:
ceph-mgr-dashboard renders blank page due to missing JavaScript files
in package 19.2.3
Status in ceph package in Ubuntu:
In Progress
Status in ceph source package in Noble:
In Progress
Status in ceph source package in Plucky:
Won't Fix
Status in ceph source package in Questing:
In Progress
Status in ceph source package in Resolute:
In Progress
Bug description:
[Impact]
The ceph-mgr-dashboard fails to load the user interface after upgrading the ceph
package to version 19.2.3-0ubuntu0.24.04.1 on Ubuntu 24.04 LTS.
Instead of the login screen, the browser renders a completely blank white page.
The browser console confirms that the server returns 404 Not Found errors for
critical JavaScript files required to render the application.
This is a regression in 19.2.3, where the compiled frontend artifacts
(JavaScript bundles) were not correctly included in the final .deb package in
/usr/share/ceph/mgr/dashboard/frontend/dist/.
This is because the JavaScript bundles were added to the d/clean file during the
19.2.3 release process. We are going to revert that change, back to the d/clean
file from 19.2.1.
[Testcase]
You first need a ceph cluster already deployed and running. We will be talking
to its mgr service from the reproducer system.
Once that ceph cluster is deployed and operational:
$ sudo apt update
$ sudo apt install ceph cephadm ceph-mgr-dashboard
Bootstrap a ceph cluster on the VM:
$ sudo cephadm bootstrap --mon-ip <ceph-cluster-ip> --single-host-
defaults
After installation is done, the process will show the credentials needed for the
dashboard. We can then log into it to make sure it's working.
$ sudo ceph mgr module enable dashboard
Then navigate to the dashboard in a webbrowser, and use the credentials from
the previous command.
http://<vm-ip>:8080 or http://<vm-ip>:8443
Expected Result:
The Ceph Dashboard login page should load successfully.
Actual Result:
* The browser displays a blank white page.
* Browser Console/Network Tab: Requests for .js files (e.g., main.js,
runtime.js, or similar chunks) return 404 Not Found.
Alternatively, you can also just check to see if the files are
present:
$ sudo apt install ceph-mgr-dashboard
$ ls -l /usr/share/ceph/mgr/dashboard/frontend/dist/*/*.js
There are test packages available in the following ppa:
https://launchpad.net/~mruffell/+archive/ubuntu/lp2134985-updates
If you install the test packages, the JavaScript files will be present and the
dashboard will function as normal.
[Where problems can occur]
We are reverting d/clean back to its state in 19.2.1, that is, removing all the
items added in the 19.2.3 SRU.
These were added for not-really-convincing reasons, and should just be
dropped.
The biggest difference is re-adding the JavaScript files back, so ceph dashboard
can function again.
There are other files, namely the btrfs testsuite and ceph QA yaml files. These
are not used during build and are not present in final packaging, and likely
will not cause any regressions to end users.
If a regression were to occur, users could copy back files from previous
packages, or will likely need to rollback until a fix is ready.
[Other info]
Luciano has summed up the uses of the other files in comment #21.
To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ceph/+bug/2134985/+subscriptions
More information about the Ubuntu-openstack-bugs
mailing list