Manage-access-to-a-shared-app.md

+To share with other people, use the `awesim permission` subcommands. _Login to Glenn and do `module load ruby` if you haven't already._
+
+Run `awesim permission` to see a list of the subcommands available
+
+```
+$ awesim permission
+Commands:
+  awesim permission addgroup GROUP                 # give a GROUP access to this app
+  awesim permission adduser USER                   # give a USER access to this app
+  awesim permission blockgroup GROUP               # block a GROUP from accessing this app
+  awesim permission blockuser USER                 # block a USER from accessing this app
+  awesim permission help [COMMAND]                 # Describe subcommands or one specific subcommand
+  awesim permission list                           # list of users/groups that have permission to access t...
+  awesim permission remgroup GROUP                 # remove GROUP permissions from this app
+  awesim permission remuser USER                   # remove USER permissions from this app
+  awesim permission reset                          # reset permissions to default (mode: whitelist, user: ...
+  awesim permission setmode [whitelist|blacklist]  # set the app mode to WHITELIST or BLACKLIST
+
+```
+
+cd into the shared app directory and run `awesim permission list` to see the current permissions:
+
+```
+$ awesim permission list
+App is set to mode: WHITELIST
+
+WHITELIST
+  USERS:
+  -----------
+  efranz
+
+  GROUPS:
+  -----------
+  PZS0562
+  wiag
+
+BLACKLIST
+  USERS:
+  -----------
+
+  GROUPS:
+  -----------
+
+$ 
+```
+
+By default the app is shared with your primary group.
+You can give access to others by using the `awesim permission addgroup` command. To see a list of commands just run `awesim permission` without any arguments. Here I give access to the wiag group.
+
+```
+$ awesim permission addgroup wiag
+Adding to WHITELIST
+  GROUP: wiag
+$ awesim permission list
+App is set to mode: WHITELIST
+
+WHITELIST
+  USERS:
+  -----------
+  efranz
+
+  GROUPS:
+  -----------
+  PZS0562
+  wiag
+
+BLACKLIST
+  USERS:
+  -----------
+
+  GROUPS:
+  -----------
+
+$ 
+```
+
+Now everyone in the WIAG group can access the app.
\ No newline at end of file