About the Admin Panel
This page explains the features in the Admin Panel, which you can access by clicking your username and selecting Admin.
You’ll only be able to access these features if you’re a PW platform administrator.
In much of the user guide, we say “user workspaces” to talk about a user’s account on the platform. Please note that this term is synonymous with “user container,” which we use on this page.
Platform Settings
When you navigate to the Admin Panel, you’ll see Platform Settings by default. This tab displays essential information about your organization’s version of the platform.
You can also manage Maintenace Mode from this tab. While this mode is enabled, only admins will be able to start and stop resources.
To enable Maintenance Mode, click the checkbox next to it. Click Save platform settings. Your changes will be applied immediately.
The platform will remain in maintenance mode until you deactivate it.
Users
This tab displays all of your users’ information, including:
- username
- email address
- API key
- active status
- container image
- account creation date
Use the Username field to search for users.
Use the Active dropdown menu to display users that are active, inactive, or either. This option is set to Either by default.
Use the Limit dropdown menu to narrow the listed users to 10, 20, 50, 100, or All. This option is set to 50 by default.
Editing User Information
In the Users tab, click on the username you’d like to edit.
On the next page, you can edit several of the user’s parameters.
The first section contains information about the user’s account, container, and access to the platform.
Identity
Here, you can edit a user’s Username or Email. Altering either of these parameters will change the user’s login credentials.
Settings
Here, you can control a user’s access to the platform.
User Host
This field identifies the user host, which is the part of the platform where account resources are provisioned.
We recommend contacting us before you make changes to this parameter.
User Container
This option identifies which service will be used to deploy a user’s container.
Use the bubbles to select Docker or k8s (Kubernetes).
We recommend contacting us before you make changes to this parameter.
MFA Enabled
Use the bubbles to select whether the user will use multi-factor authentication.
Select No if a user doesn’t need multi-factor authentication.
Select MyProxy if you work with a governmental agency, such as a public university or a research organization. Generally, MyProxy is preferred for these types of institutions.
Select Duo if you work with a company or organization that is not affiliated with the government. Duo is a Cisco service that is more popular with other types of institutions.
We recommend contacting us before you make changes to this parameter.
User Container Image Name
This field identifies which IDE service we use to house a user’s container. Currently, we use Theia for all user containers.
We recommend contacting us before you make changes to this parameter.
User Container Image Version
This field identifies which image version a user’s container is running. By default, this field is set to Latest.
We recommend contacting us before you make changes to this parameter.
User Organization
Use this dropdown menu to assign the user to an organization.
Attributes
Here, you can control whether a user is an Admin or Active by selecting their respective checkboxes.
A user with Admin enabled will be able to access the Admin Panel and all of its settings. This option does not affect the group setting org:admin
. For more information, please see About Roles.
A user with Active enabled will be able to log in to the platform with their username and password. Unchecking Active will disable a user’s access to the platform.
Actions
Click the Update User container button to migrate a user’s container to the latest image.
Click the Kill user container button to restart a user’s container.
Click the Remove from teams button to remove a user from all of their assigned groups.
If you change any of the parameters above, click Save before leaving the page. Your changes will be applied immediately.
Set Password
Here, you can reset a user's login credentials.
If you change this parameter, click Save before leaving the page. Your change will be applied immediately.
Contact Info
Here, you can change a user’s contact information, including their display name, platform URL, and geographical location.
This information is only visible to platform admins and does not affect a user’s login credentials.
If you change these parameters, click Save before leaving the page. Your changes will be applied immediately.
Setting User Images
In the Users tab, select users with their checkboxes. Click Set Image.
A dialog box will appear. Enter the Image Name and the image Version.
Click Apply mass-update. Your changes will be applied immediately.
Updating User Images
In the Users tab, select users with their checkboxes. Click Update in-place.
A dialog box will appear. Confirm that you’ve selected the users you want to update.
Click Apply mass-update. Your changes will be applied immediately.
Groups
This tab displays information for all of your groups, including:
- name
- organization
- number of members
- allocation amount
- percentage of allocation used
- state
- creation date
- ID number
All the functions in Managing Groups can be completed from this tab as well.
Keys
The Keys tab shows information for all of your cloud account keys, including their name, which organization owns the key, the creation date, and the key ID.
You can manage your cloud account keys in this tab. If you click the name of a key, you can edit its Name and Description on the next page. Click Save after making any changes.
You can also permanently delete the key from the platform by clicking the Delete button. Please note that if you’ve used a key to provision infrastructure, you won’t be able to delete that key until you’ve deprovisioned the infrastructure.
If you need to add a key to the platform, please see Adding a Cloud Account.
Instances
This tab displays information for all of your instances, including:
- CSP
- organization that owns the key
- region
- instance ID
- creation date
- instance name, if any
- instance type
- private IP
- public IP
- cloud state
- estimated cloud state time
- PW state
Please note that the instance list is wider than most monitors, so the included screenshot does not show all of the fields listed above. To see more information about your instances, scroll to the bottom of the page and use the horizontal scroll bar to show more columns.
You can configure your instance types on the platform by organizations. For more information, please see Configuring Instance Types.
Containers
This tab displays information for all of your user containers, including:
- container name
- user
- container image
- image version
- current image version on the platform
- creation date
- type (Docker or Kubernetes)
Killing User Containers
In the Containers tab, select users with their checkboxes. Click Kill containers.
A dialog box will appear. Confirm that you’ve selected the containers you want kill.
Click Apply mass-update. Your changes will be applied immediately.
Reports
This tab displays information for your reports, including:
- type of report
- email address that receives reports
- who the report monitors
- frequency
- creator
- creation date
Creating Reports
In the Reports tab, click + Add New Report.
On the next page, you can edit the parameters listed below.
Use the Type dropdown menu to select the type of report you want to generate:
- summary
- project
- monthly
- user
- application
Use the Who field to enter the username who the report will monitor.
Use the Email field to enter the report recipient’s email address.
Use the Frequency bubbles to select how frequently the report will be generated:
- daily
- weekly
- monthly
- event (once, at the time of creation)
- test (once, at the time of creation)
- disable (end reports for the time being)