Creating Session Scripts

WorkSpaces Applications provides on-instance session scripts on both Windows- and Linux-based streaming instances. For more information about session scripts, see Use Session Scripts to Manage Your Amazon WorkSpaces Applications Users' Streaming Experience.

Session scripts are specified within an WorkSpaces Applications image. To locate the session scripts configuration file on a Linux instance, navigate to /opt/appstream/SessionScripts/config.json. The following code is a sample config.json file that specifies a session start script named “test-session-start” and a session end script named “test-session-stop” together with their runtime parameters. Make sure that the scripts referenced in config.json have run permissions and a command interpreter is defined (for example, #!/bin/bash).

{
     "SessionStart": {
          "Executables": [
               {
                    "Context": "system",
                    "Filename": "/opt/appstream/SessionScripts/test-session-start",
                    "Arguments": "arg1",
                    "S3LogEnabled": true
               }
          ],
          "WaitingTime": 30
     },
     "SessionTermination": {
          "Executables": [
               { 
                    "Context": "system",
                    "Filename": "/opt/appstream/SessionScripts/test-session-stop", 
                    "Arguments": "arg2", 
                    "S3LogEnabled": true
               }
          ],
          "WaitingTime": 30
     }
}