Global Bookmarks

System administrators can create a global suggestions file for FastX available to all users on the system.  This file allows system administrators to preconfigure the commands that their users can launch.

Creating Suggestions

  1. Log in as an Admin
  2. Click on Admin > System Configuration > Sessions > Bookmarks
  3. Add Bookmarks. You can also add images to your bookmark

 

bookmarks

Bookmarks will appear when starting a new session

 

Screen Shot 2016-03-31 at 12.34.19 PM

 

Hiding the Command Field

Admins can also hide the command field

  1. Log in as an Admin
  2. Click on Admin > System Configuration > Theme

Screen Shot 2016-01-25 at 9.29.35 AM

 

The Command Field will be hidden.

Screen Shot 2016-01-25 at 9.30.30 AM

 

Security Note: 

Hiding the Command field does NOT prevent users from launching sessions.  It is a UI feature only.  To enforce the sessions from being launched, set the configure the command.allow file to only allow suggestions.

Manual Configuration

The suggestions file is located at /usr/lib/fastx2/config/suggestions.json

The suggestions file is a json array of suggestion objects. Each object has the following parameters

  • id — unique string defining the suggestion
  • name — Display Name to show the user
  • command — Command to launch
  • geometry — widthxheight || rootless
  • icon — base64 encoded icon file  (128×128)

Here is an example suggestions file containing 3 objects


[
     {"id":"1","name":"GNOME","command":"gnome-session","geometry":"1024x768"},
     {"id":"2","name":"XFCE","command":"startxfce4","geometry":"1024x768"},
     {"id":"3","name":"xterm","command":"xterm -ls","geometry":"rootless"}
]

Testing

No results will be displayed if the JSON file is invalid.

Use this JSON validator to verify that your JSON file is in the correct format