Uploaded image for project: 'OpenAM'
  1. OpenAM
  2. OPENAM-11813

Amster documentation needs improving

    Details

    • Type: Improvement
    • Status: Resolved
    • Priority: Major
    • Resolution: Won't Do
    • Affects Version/s: 14.0.0
    • Fix Version/s: None
    • Component/s: documentation
    • Labels:
    • Support Ticket IDs:

      Description

      I have been trying to figure out how to construct an Amster command in order to update a single field so I could update a KB article. It has taken a lot of trial and error and in the end, the thing that moved me forward the most was the example given in the :help update command that showed the --body part enclosed in single quotes.

      Few things in particular to note:

      • I did not find the schema information helpful in the Entity guide for Updates. If you do a Read first, you get the correct format.
      • There are no examples in the Entity guide to get you started. I noticed Andrew encountered similar usability issues: OPENAM-10909
      • I found it hard to work out which entity I needed to read/update. The Global Services Configuration section in the Reference guide gives the amster type ID, which is good but they don't all exactly correlate with an entity ID (plus it would be good to call them entity IDs). But the Reference section in Authentication and Single Sign-On Guide for authentication modules and core authentication attributes only gives ssoadm service & attribute names, which are different eg To enable the Use Stateless Sessions option, you use the iPlanetAMAuthService and openam-auth-stateless-sessions property with ssoadm but in Amster it is Authentication and statelessSessionsEnabled - I only found this by grepping the export for stateless! 

      We are starting to get customers asking how to do things using Amster so this is likely to become a ticket generator. I have meanwhile put together a KB article on using Amster to update properties.

       

      Note: It would be extremely helpful to give both ssoadm and Amster details in the reference guides until ssoadm is removed from the product.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              dom Dom Reed
            • Votes:
              1 Vote for this issue
              Watchers:
              6 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: