Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Verify the digest of the image.  This is a best practice when using Grouper images


    1. Pull the image

      Code Block
      bin $ docker pull i2incommon/grouper:2.5.XX


    2. Make sure the digest is correct (from release notes page)

      Code Block
      [root@ip-172-30-3-152 ~]# docker image inspect i2incommon/grouper:2.5.XX | grep i2incommon/grouper@sha256
                  "i2incommon/grouper@sha256:b675bb410bf873xxxxxxxxxxxxxx5e58a3a42a8048381a33b79fd19"


  2. Make the start command in a script so you have it to run it later consistently



    Code Block
    grouperContainer $ vi grouperQsDockerRun.sh
    
    #!/bin/bash  (or whatever shell)
    # this is the run command from above that you diddocker run --detach --name grouper-qs \
      --publish 443:443 -e GROUPER_MORPHSTRING_ENCRYPT_KEY=******** \
      -e GROUPERSYSTEM_QUICKSTART_PASS=******** i2incommon/grouper:2.5.XX quickstart
    
    
    grouperContainer $ chmod +x grouperQsDockerRun.sh
    
    # remove the old container if you want to run it again, or stop, or whatevergrouperContainer 
    
    $ docker rm -f grouper-qsgrouperContainer 
    $ ./grouperQsDockerRun.sh
    
    (Optional) Check logs:
    
    grouperContainer $ docker logs grouper-qs
    
    (Optional) Shell in:
    
    grouperContainer $ docker exec -it grouper-qs /bin/bash



  3. (Optional) Mount your database files outside of Docker to persist your changes across container restarts.  Note, this is still not a robust database, it is only for non production use.

    Code Block
    $ mkdir hsqldb
    
    Change your start command to include a mount of this directory
    
    grouperContainer $ vi grouperQsDockerRun.sh
    
    Add this mount in your command
    
    --mount type=bind,src=/path/to/hsqldb,dst=/opt/hsqldb
    
    You might need to open up permissions on that directory:
    
    $ chmod 777 hsqldb
    
    Delete the current container
    
    $ docker rm -f grouper-qs
    
    Start it again
    
    $ ./grouperWsDockerRun.sh
    
    You will see database files in that dir on your host
    
    grouperContainer $ ls -latr hsqldb/
    total 6192
    drwxr-xr-x  22 mchyzer  staff      704 May  3 22:58 ..
    drwxr-xr-x   2 mchyzer  staff       64 May  3 22:58 grouperHSQL.tmp
    -rw-r--r--   1 mchyzer  staff     1536 May  3 22:58 grouperHSQL.script
    -rw-r--r--   1 mchyzer  staff       85 May  3 22:58 grouperHSQL.properties
    drwxrwxrwx   7 mchyzer  staff      224 May  3 22:58 .
    -rw-r--r--   1 mchyzer  staff       16 May  3 23:00 grouperHSQL.lck
    -rw-r--r--   1 mchyzer  staff  2854600 May  3 23:00 grouperHSQL.log
    
    
    



  4. Evolve to maturity level 0