Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation enhancement for OneClick Installer #1186

Open
ReneOro97 opened this issue Jan 24, 2024 · 0 comments
Open

Documentation enhancement for OneClick Installer #1186

ReneOro97 opened this issue Jan 24, 2024 · 0 comments
Labels
Documentation Update Update to documentation with no functional impact

Comments

@ReneOro97
Copy link

Reference link

OneClick Installer Procedure: https://ibm-mas.github.io/ansible-devops/playbooks/oneclick-core/#oneclick-install-for-mas-core

Summary

After finishing up the installation for MAS with Ansible Playbook (ibm.mas_devops.oneclick_core), MAS was installed successful on cluster and I was provided with Admin Dashboard URL and the credentials. However, trying to access to it, results in a page load hanging.
The issue seems to be similar as the one described in this IBM Support link:
https://www.ibm.com/support/pages/ibm-maximo-application-suite-initial-setup-page-does-not-load
Only difference is that since the OneClick Installer already configures all prerequisites, I'm prompted directly to the admin dashboard.
I was able to sort the issue by following the steps described in the[ IBM Support site|https://www.ibm.com/support/pages/ibm-maximo-application-suite-initial-setup-page-does-not-load] with the only difference that for the api link, I had to remove the "apps" section.
Instead of https://api/.<instance_name>.apps..com/ should be https://api/.<instance_name>..com.

Recommended changes:

A possible enhancement to the documentation for OneClick Installer docs could include either the steps for sorting this issue or the IBM Support reference link.

A similar approach is also documented in https://www.ibm.com/docs/en/mas-cd/continuous-delivery?topic=configuring-setting-up-maximo-application-suite:

Enable login for Maximo Application Suite self-signed certificates.
If you are using self-signed certificates in a development or test environment, you must manually enable login by using either of the following methods:
Download the certificates from the cluster and add them to your local certificate manager.
In your browser, go to the Maximo Application Suite API URL: https://api.<mas_domain>/ and then accept the certificate security risks. After you accept the risks, an AIUC01999E error is displayed. This message is expected. You can now continue with the setup process.

But could be useful to add a similar note in the OneClick Installer to specify that whenever using self certificates you should go to the MAS API to accept the security risk.

@durera durera added the Documentation Update Update to documentation with no functional impact label Jan 25, 2024
rene-oromtz added a commit to rene-oromtz/ansible-devops that referenced this issue Jan 25, 2024
Added additional tip for enabling login with self-certificates
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Update Update to documentation with no functional impact
Projects
None yet
Development

No branches or pull requests

2 participants