# Workstation

## Installation

Flopsar Workstation is a GUI client of the Flopsar environment.

Installation is straightforward, just copy the `flopsar-workstation-X.Y.Z.zip` file to your machine and uncompress it. Next, run a workstation script from `bin` directory.

{% hint style="warning" %}
You should have your Java environment set before you try to run the workstation application.
{% endhint %}

## Accessing Flopsar Environment

When you start the workstation a login window should appear. You can either access a remote Flopsar sever or a local Flopsar database storage.

### Remote Access

If you want to access a remote Flopsar server fill out the form below and press `CONNECT` button. If you run the workstation for the first time, the `Connection ID` combo box is empty. In order to connect to your manager instance, you must specify some connection identifier (a label) and input the manager socket address in the form `host:port`. You must also provide your credentials and then press the `CONNECT` button.

![Remote Access](https://3024459036-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LpN7wUQHQSd7nz09yOW%2F-LwI7f9FRLMVP8On_CoA%2F-LwI93KzZQ3PGjUdVEVt%2FScreenshot%202019-12-17%20at%2010.17.41.png?alt=media\&token=e4f91821-d989-41d9-87eb-8e73b1e0f9ea)

{% hint style="success" %}
Default credentials when using Flopsar Internal Authentication are as follows: the username is **admin** and the password is **flopsar**.
{% endhint %}

### Local Access

In order to access a local Flopsar database, click `SWITCH TO LOCAL` link and fill out the form below:

![Local Database Access](https://3024459036-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LpN7wUQHQSd7nz09yOW%2F-LwI7f9FRLMVP8On_CoA%2F-LwI8z0bZymYD2WMUufW%2FScreenshot%202019-12-17%20at%2010.17.48.png?alt=media\&token=25fb3495-6f6e-4970-b635-d2a0fa2cfe66)

You have two options to choose from:

`Storage` : points to the database storage directory

`Archive File` : points to the archive file (either dump or ordinary archive file). In this case, the archive file will be extracted and then accessed. Next time you access the storage you just need to select `Storage` option and point to the extracted directory.

## Settings

`Workstation` stores its settings locally, on the machine it runs on. It makes use of [Java Preferences API](http://docs.oracle.com/javase/7/docs/technotes/guides/preferences/) to store its configuration. The physical location of the settings depends on a platform the workstation runs on. When you exit the application, it stores its current settings.

### General

![General Preferences](https://3024459036-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LpN7wUQHQSd7nz09yOW%2F-LwOfs1vcTuTU0abdTDA%2F-LwOj8iXrZcbdNSRabcY%2Fpref_general.png?alt=media\&token=7f2dd252-5662-4691-9415-d67542c29a7e)

By default, all the workstation logs are stored in a user home directory. This can be changed in the preferences window above, where you can set both the logger level and the location of the logs. 

You can also check if there is a new Flopsar version available. In order to check it, just press the `Check now` button. If you select `Check automatically`, then whenever you start the workstation, it will check for updates automatically.

### Connections

Your manager connections information is also stored in the settings. You can either edit or delete these connections in the preferences window below.

![](https://3024459036-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LpN7wUQHQSd7nz09yOW%2F-LwOjjiQu2JGaOoIVRRy%2F-LwOkHdf2NbME7pqWAjz%2Fperf_conns.png?alt=media\&token=da33db85-ffef-4497-9b2f-4d45d2c4ef14)

### Permissions

This view presents a list of all [permissions](https://docs.flopsar.com/3.0/administrator-guide/authentication-and-authorization#permissions). A green circle denotes if the corresponding permission is granted.

![List of user's permissions](https://3024459036-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LpN7wUQHQSd7nz09yOW%2F-LyTAtNKNg4rXa0hl3Ic%2F-LyTD6d66sTGJj36p1iM%2FScreenshot%202020-01-13%20at%2010.24.32.png?alt=media\&token=26148e5b-0069-4d88-82a4-2f1c90f62df8)

####  Permissions Implications

The following features are hidden or disabled when permissions are not granted:

***Configure Agents***

* Green plus button is not visible in the [Attached Agents](https://docs.flopsar.com/3.0/agents-configurations#attaching-agents) tab of the active configuration view.
* `Profile` submenu of the context menu is disabled in: 
  * [root call execution stack view](https://docs.flopsar.com/3.0/execution-stack-interpretation#context-menu)
  * [root call stack spectrum view](https://docs.flopsar.com/3.0/execution-stack-interpretation#context-menu-1)

***View Parameters***

* Parameters details are not displayed. 
* Characters `******` are displayed in the [parameters column](https://docs.flopsar.com/3.0/data-browsing#browse-result-view). 

***View Online Data***

* [Monitoring tab](https://docs.flopsar.com/3.0/online-monitoring#settings) is not visible in the preferences window.

***Query Agents***

* [Properties](https://docs.flopsar.com/3.0/agents-status#jvm-properties), [Packages](https://docs.flopsar.com/3.0/agents-status#jvm-packages), [Class Loaders](https://docs.flopsar.com/3.0/agents-status#jvm-class-loaders), [Agent Logs](https://docs.flopsar.com/3.0/agents-status#agent-logs) and [State](https://docs.flopsar.com/3.0/agents-status#jvm-state) tabs are not visible.
* [Threads dump](https://docs.flopsar.com/3.0/online-monitoring#agents) button is not visible.