Start/Exit RP Prism
Employee usernames and passwords are copied to the Prism server during initialization. To launch RP Prism, you must enter a valid username/password. The user must be assigned to an employee group. Use the Prism Proxy shortcut to log in. Windows 10 users must use the right-click "Run as Administrator" option launch Prism.
- Double-click the Proxy icon for your device. Note: Windows 10 users, use the right-click "Run as Administrator" option. A web browser will launch and display the Prism login screen.
- Enter your username and password and touch or click the Login button. Prism loads and launches. Default username = sysadmin; Default password = sysadmin
- By default, the main menu of the POS module is displayed. Select New Transaction to start a new transaction.
- To navigate to a different area, touch or click the Retail Pro button and then select the desired area from the Prism Menu.
Exit Prism
1. Touch or click the Retail Pro button.
2. Select the Logout option from the Prism menu.
The server to which you are connecting is displayed in the lower-left corner of the login dialog.
Auto Logout, Force Logout Preferences
RP Prism includes two preferences that can be used to automatically log out employees:
| Preference | Description |
|---|---|
| Automatically Lock Workstation | Employees > General If selected, workstations for the store will be locked after the specified number of minutes without activity. By default, the lockout period is set to 15, meaning that if there is no activity on a workstation for 15 minutes, the workstation will be locked. When the lockout time is reached, a prompt is displayed in the Retail Pro screen. To unlock the workstation, a user must log in with a valid Retail Pro username/password combination. You must refresh (reload) your browser for the change to take effect. If the same user logs in to the prompt, the user will be in the same location as when the lockout took effect. If a different user logs in, the user will be returned to the RP Prism Point of Sale home screen. |
| Force Logout |
Transactions > General |
Licensing Considerations
- Use the Logout button to log out of Prism. This ensures the seat license is returned to the pool.
- If you open a new tab and log in to Prism on that new tab, another seat license is consumed. To have a separate tab open without taking an additional seat requires using the DUPLICATE TAB function in the browser (not the NEW TAB function). When using the DUPLICATE TAB function, both tabs share the same user session. Please note that if you have two tabs sharing a session and log out of tab A then tab B will get logged out behind the scenes. The next time you go to use tab B your requests will fail.
- If you click the Refresh button on the web browser, you will be logged out (instead, use F5 to refresh)
- No user may enter the Prism web client with an unseated session. The web client logs the user out when it detects an unseated session.
About Access Tokens
What is an Access Token?
When a user logs into Retail Pro Prism and provides a username and password, that information is packaged up with the workstation name and is used to create a "user session" on the Retail Pro Prism server. This user session includes the user's information such as preferences, permissions and other data. This information is loaded into memory when the user logs in, and it is cleared from memory when the user logs out. To identify that session and differentiate it from other sessions, Retail Pro Prism generates an access "token". This access token in Retail Pro Prism is a long, unique number similar to "5D05333773CB46528E45FBA500658CB2." The login process generates this access token number and provides it to the Retail Pro Prism client that has logged in.
All subsequent requests to the Retail Pro Prism server (from the Retail Pro Prism client) require that an access token be provided in the header of the request as the Auth-Session. If you were to look at the request header(s) from the web client, you would see something similar to "Auth-Session: 5D05333773CB46528E45FBA500658CB2."
When the Retail Pro Prism server gets a request form the client, one of the first things the server does is use the access token to locate the user session and passes that information to the server that is processing the request. Without the user session, the server would not be able to verify permissions, change workflow based on preferences, or even allow simply data access.
What is the issue that can occur with the Access Token?
If for whatever reason the server is "reset" (stopped / restarted / crashed and restarted / etc...), all the user sessions (and in turn the access tokens) are lost from memory. This can cause problems related to failed communication between the Retail Pro Prism client and the Retail Pro Prism server. Unknown to the client, the access token is now invalid, and this will cause all requests to the Retail Pro Prism server to fail.
Please Note: Access Token(s) will become invalid when the Retail Pro Prism server performs a complete backup. This is because a complete backup requires the database services to be stopped while copying files. The database services are restarted once the complete backup is finished.
One symptom of this issue - is when day-to-day replication has unexpectedly stopped. When you begin to troubleshoot, you will notice that each workstation (that is communicating with the server) has a consumer count = 0.
In the xxxx log, you will find authorization errors. At the same time, you may notice that the licensing logs indicate that everything is healthy. This can occur if the server has been "reset", without the workstations subsequently being reset.
What can I do if I experience this issue?
In this example, the workstations must be reset, one-by-one, and after they reboot they will be able to connect successfully as they will acquire new and valid auth-session tokens. As the workstations reconnect, you will see the consumer counts change from 0 to 1. Shortly after that, the day-to-day replication process will begin processing again.