4. PxM Client for Windows interface

This chapter provides information on the PxM Client for Windows interface and menu options available, covering:

4.1. Logging on

To log on to the PxM Client:

  1. By default, the PxM Client Login window automatically appears on your desktop. To manually display the Login window, click the PxM icon on the taskbar PxM Client for windows or the PxM icon in the system tray Client Logged out icon.

    Windows Client Login Window

  2. Enter the login information:

    Field name Description
    Address: Enter the IP address or hostname of the PxM Virtual Appliance you want to connect to.
    Username/Password Depending on the configuration of your PxM Platform, either enter your PxM local account details or your existing external authentication details (Active Directory or RADIUS).
    Token code: If multi factor authentication has been configured within your PxM environment then your PxM Superadmin will provide you with a token code to enter. Only after successful verification of both the password and token code will you be logged into the PxM Platform.
  3. Click Login.

  4. You will be asked to confirm the PxM Virtual Appliance host key fingerprint which can be found on the Desktop Client Download web browser page.

    Client host key fingerprint window

  5. Once verified, click Yes. The Login window is closed and an PxM Client window opens.

  6. The PxM Client system tray icon will change from Client Logged out icon grey to Client Logged in icon blue when login has been successful.

    Note

    When you have successfully logged into the PxM Client, an Osirium.exe.config file is created which will store the address and username so you don’t have to type in this information each time you login.

    If you are logging into multiple PxM Virtual Appliances, the addresses will be listed in the drop down.

4.2. PxM Client Interface

Once successfully logged in, you will be presented with the PxM Client interface which will dynamtically update the device list you have access to.

Client Interface screenshot

From here you can connect to device tools or run device tasks. See Connecting to devices and running tasks.

To manage your PxM Client interface device list, right-click a device and select one of the following options.

Menu option Description
Pin Pinning allows you to place devices at the top of your PxM Client device list. This is useful when you have a lot of devices in the list but have a handful of devices which are accessed on a regular basis.
Collapse All Hides the tools and tasks available for each device.
Expand All Shows the tools and tasks available for each device.

The PxM Client interface window can also be resized by expanding the sides. Any resizes will be saved automatically.

4.3. PxM Client for Windows menu options

The following menu options are available when right-clicking the PxM Client icon on the system tray:

Menu option Description
Login Opens up the Login window. Left-clicking the PxM Client icon running in the taskbar and selecting Desktop Client will also open the Login window.
Logout Logs you out of the virtual appliance and disconnects all open device session connected through virtual appliance. The PxM Client icon will remain running in the System Tray but the icon will be grayed out.
Change Password Only locally authenticated PxM users have the ability to change their passwords.
Show Logs Opens up an File Explorer window were the PxM Client Trace.log files are stored on your workstation. This log can be useful to help diagnose problems you may be having with the PxM Client.
About

Displays the PxM Client versioning and copyright information.

Clicking on the Techout button generates and opens the techout file. The techout file contains diagnostic data which maybe useful to send to your SuperAdmin when you are having issues with your PxM Client.

Exit Logs you out of PxM Virtual Appliance and disconnects all open device session connected through virtual appliance. The PxM Client icon will also be closed and will not be visible in System Tray.