| FreeIPA WebUI Test Day | |
|---|---|
| |
| Date | 2025-12-02 and 2025-12-03 |
| Time | 03:30 to 19:00 UTC both days |
| Website | QA/Test Days |
| Matrix | #test-day:fedoraproject.org(other clients|?) |
| Mailing list | test |
If you come to this page after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find, and add your results to the results section. If this page is more than a month old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.
What to test?[edit]
This Test Day will focus on FreeIPA Modern WebUI.
Who's available[edit]
The following cast of characters will be available testing, workarounds, bug fixes, and general discussion:
- Development:
- [EMEA]: Erik Belko (ebelko), Carla Martinez (carlmart), David Hanina (dhanina), Veronika Miticka (vmiticka)
- [NA/LATAM]: Rafael Jeffman (rjeffman)
- [APAC]: Sudhir Menon (sumenon)
- Quality - Lukáš Růžička (lruzicka), Kamil Paral (kparal), Adam Williamson (adamw), Petr Sklenar (psklenar)
You can chat with us on Matrix. See the infobox on top of the page to learn where to join.
If you are Red Hatter and prefer Slack, you can also join and ask us in #fedora-test-day-freeipa-webui channel.
Prerequisite for Test Day[edit]
- A virtual machine of your choice (we recommend Boxes) or a bare metal machine
- An installation of Fedora 43 (any Edition or Spin). Make sure to fully update your system.
- If installing a fresh system, please grab your copy from: https://www.fedoraproject.org. The workstation edition is good enough.
- Make sure you have no important data on that system. Things might go wrong -- don't do this on your production machine!
Install[edit]
Install procedure for Fedora 43
Enable the COPR repository for FreeIPA nightly builds. (This will automatically use the Fedora 43 repository when run on Fedora 43)
sudo dnf copr enable -y @freeipa/freeipa-master-nightly
Optionally, enable the dependencies repository (recommended if you encounter missing dependencies)
sudo dnf copr enable -y @freeipa/freeipa-master
Install FreeIPA server rpms with DNS support
sudo dnf install -y freeipa-server freeipa-server-dns
Run the FreeIPA server installation (this will automatically deploy FreeIPA with the Modern WebUI), we recommend reading through and testing the WebUI with various deployments:
sudo ipa-server-install
For the most simple installation you can simply run:
hostnamectl set-hostname "server.ipa.demo" sudo ipa-server-install -U -n dom-server.ipa.demo -r DOM-IPA.DEMO -p Secret123 -a Secret123 --auto-forwarders --setup-dns --setup-kra
After installation completes, you can access the FreeIPA Modern WebUI by navigating to:
https://localhost/ipa/modern-ui
In case you want to connect from your host machine into the VM , you need to obtain the ip address (ip a) of the VM and add an entry into your /etc/hosts file:
${IP_ADDRESS} hostname
In our example:
${IP_ADDRESS} dom-server.ipa.demo
This will also change the url to:
https://dom-server.ipa.demo/ipa/modern-ui
The default admin credentials are as follows:
username: admin
password: Secret123
The FreeIPA Modern WebUI will be automatically available for you to explore.
Note: This uses the master-nightly builds which are unofficial and provided as-is. They can break at any time, so use at your own risk.
Alternative option: Pre-deployed Instances[edit]
While we recommend following the installation instructions above to deploy FreeIPA on your own machine for the best learning experience, pre-configured instances are available for convenience:
Red Hat internal[edit]
Please feel free to reach out on the Slack channel if you’d like access to one of the machines.
How to test?[edit]
Visit the results page and click on the column title links to see the tests that need to be run: most column titles are links to a specific test case. Follow the instructions there, then enter your results by clicking the Enter result button for the test.
Please also try to experiment and explore and perform tasks not mentioned in any of the pre-defined test cases.
Reporting bugs[edit]
All new bugs should be reported into the upstream bug tracker.
We would love to hear your opinions about the UI and UX. We've set up GitHub discussions space specifically for you to share your UX feedback and new ideas.
Please note that just mentioning your problem into the comments section on the results page is not very helpful. Very often those problems only happen in specific circumstances, or with specific steps taken. We need the logs and screenshots, and we need to be able to ask you followup questions. Please file bug reports, it's much more useful than a short comment. Thank you!
When filing the bug, it's very helpful to include:
- exact steps you've performed (and whether you can reproduce it again)
- screenshots or videos of the WebUI
- your system description, FreeIPA deployment
- browser information
If you are unsure about exactly how to file the report or what other information to include, just ask us.
Any bug report is better than no bug report, if you're wondering whether something is a bug or due to inexperience with the application, consider it a bug!
Please make sure to link to the bug when submitting your test result, thanks!
Test Results[edit]
Test results will be exported here once the test day is over. See How to test? section for information how to submit results and see the live results.
