Uploaded image for project: 'RH-SSO'
  1. RH-SSO
  2. RHSSO-827

Improving RH SSO Quickstarts READMEs

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Done
    • Icon: Major Major
    • RH-SSO-7.1.0.GA
    • RH-SSO-7.1.0.CR1
    • Quickstarts
    • None

      Recently, I was testing the RH SSO quickstarts and during the deploying QS one by one, I discovered some issues in a particular READMEs. Some of them are just a minor details, so think of it as recommendations of improving QS READMEs.

      • When I was trying to deploy quickstarts, sometimes some of them produced an "Could not find resource/Unexpected response from server" type of errors during this process (especially auhz QSs). To avoid this, RH SSO had to be started with "-Dkeycloak.profile=preview" argument, so I think, it should be mentioned more explicitly.
      • According to user-storage-simple README, this QS should be deployed via maven command:mvn clean install wildfly:deploy, and resulting app should runs on port 8080. But according to base README of QSs, on this port actually runs EAP, not RH SSO, which runs on 8180 and on which should be the app deployed. As a workaround I was able to deployed this QS via following: mvn clean install wildfly:deploy -Dwildfly.port=10090.
      • In app-authz-jee-servlet QS on line no. 103 is written:"...by changing the `Only Alice Logic` logic." Related to a previous content of README, I think that there is a typo and there should be mentioned following:"...by changing the `Only Alice Policy` logic."
      • In base README, there is bunch of useful information, assumptions to successful building and deploying QSs. In app-jee-html5 QS, there is an assumption of creating the 'user' role to get proper behaviour of an example. Similarly, in app-profile-saml-jee-jsp, there is an assumption of proper installation of SAML adapters.
        I think, that for clarity purposes, it would be appropriate to shortly mention that in these "children" QSs (through some link to particular assumptions in base README, maybe).

              pzaoral Peter Zaoral (Inactive)
              pzaoral Peter Zaoral (Inactive)
              Votes:
              1 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved: