Lab Console

In the Lab console, you can access devices, apps and browsers. You can interact with a device remotely and conduct exploratory testing. For details, see open a device remotely. You can also open a cloud browser for manual testing. For details, see Browser lab.

Administrators use the console for configuring Digital Lab settings and for managing users, workspaces, apps, and devices. For details on how to configure Digital Lab, see Admin Tasks.

In this topic:

Access the Digital Lab console

Digital Lab users can have either administrator or user roles. Existing administrators define the roles when creating new users. The menus displayed in the Lab console depend on the role of the logged-in user.

• Menus visible to users: Device lab , Apps, and Browser lab. The Device lab and Apps screens display a consolidated view of the devices or apps from all the workspaces to which the user has access. For details, see Manage devices and Manage apps. The Browser lab is only displayed when this integration is enabled, and a valid license is installed. For details, see Browser lab.
• Administrators can view workspaces, users, and can see all the available assets. For details, see Admin Tasks. In addition, the Dashboard menu is visible to administrators.

When accessing the lab console without a testing tool, the displayed language is determined by the browser language.

To access the lab console:

You can access the lab console in one of the following ways:

UFT Digital Lab console (on-premises deployment)	Go to: http/s://<Digital Lab server IP address>:<server port> and log in with your credentials. If you enter a wrong password three consecutive times, Digital Lab locks you out. The default lockout time is 15 minutes. Browser cookies must be enabled to work with Digital Lab. Secure connection only (HTTPS): When using the default self-signed certificate, the browser displays a warning or error when you first access the Digital Lab server over SSL. For web browsers to trust the SSL certificate presented by the server, it must be a certificate that was issued by a recognized Certificate Authority (CA). Although a self-signed certificate allows you to encrypt data, the warning informs you that the certificate was self-signed by the server, and not by a CA. To access the server, you need to trust the self-signed SSL certificate.
UFT Digital Lab Managed SaaS	Go to the UFT Digital Lab Managed SaaS URL provided to you, and log in with your credentials. For first time login of the admin user, use the admin user credentials provided to you. Once logged in, you can add additional users and administrators.
ValueEdge Digital Lab	Access the lab console from Functional Test in the left panel of the ValueEdge menu, or bookmark the ValueEdge Digital Lab URL.

Back to top

Workspaces

Workspaces are individual work areas within your lab. Your administrator can create workspaces to segregate or share applications and devices between specific groups of users. Each individual workspace has its own devices, apps, and users. Devices and apps in the shared assets, are available to all users.

When you open the lab, you can view the devices and apps in the workspaces to which you have access, as well as shared assets. If you already logged in once, you are connected to the last session's workspace. Admin users have an additional page, Connectors with a list of the installed connectors. Select All in the masthead to view all devices and apps to which you have access.

To enable the Workspace filter to list a specific workspace, select the workspace name in the masthead, or alternatively select All for the filter to list all workspaces to which you have access. You can then filter by workspace as needed.

For a non-admin user: If you attempt to log in, and the workspace to which you had been assigned was removed, the login page indicates that you are not assigned to any workspaces and provides a link to the admin's email.

Back to top

Viewing system information and logs

Administrators can access Digital Lab version information, download log files, and obtain usage reports from the Digital Lab server. Hover on the Help button for a menu with these options:

Option	Description
System Info	Shows the Digital Lab version and build number, Linux edition/ Windows version, and the installed memory (RAM) on the server machine.
Download Connector	Links to the AppDelivery Marketplace page with the Digital Lab connectors.
Collect Logs	Zips the log files created and downloads them using your browser. You can select the logs to download (server and/or connector). For connector logs, you can also select specific connectors. ValueEdge Digital Lab: Admins can download logs of installed connectors only. You can include all logs in the download, or only the latest logs. Latest includes the two latest logs of each log type. For example, if there are 3 service log files, only service.log and service-1.log are included. When shared spaces are enabled, server logs are not included and can only be downloaded by the Operator. For details, see Shared space management. Non-admin users can select Collect Appium Logs to download a zip file containing the Appium logs.
Collect Usage Data	Relevant only for UFT Digital Lab. Downloads a zip file containing resource usage information. For details, see Data Usage Collection. This option is only available for Trial, Enterprise, and Ultimate license types. Note: When using Digital Lab as a managed service provided by an MSP or when shared spaces are enabled, only operators are able to view the system logs. For details, see Shared spaces.

The menu options for workspace admin and regular users include the Help Center, What's New, version information, contact Admin, and an option to download the Appium logs using the Collect Appium Logs option.

While the default email for admin is admin@default.com, the admin can set the email address in the General settings section of the Administration settings.

Back to top

Data Usage Collection

Data usage collection can help you:

• import data usage files to Excel or other services, to generate meaningful reports.
• integrate with BI (Business Intelligence) tools such as Tableau.

When you select Collect Usage Data, your machine downloads UFTM_usageData<date>.zip which contains the following CSV files:

File	Description
job.csv	General information about the job execution, such as job ID, start/end times, DevTunneled, workspace names, device information, and app information. DevTunneled indicates whether the device was tunneled using Dev Access.
reservations.csv	Start and end times for each reservation with the associated connectors and devices, as well as the actual duration of the reservation. This is useful because although there may have been a reservation for a device, this does not mean that the device was used. DevTunneled indicates whether the device was tunneled using Dev Access.
application.csv	App name, app ID, upload ID, workspace, upload start and end times, and the upload duration.
device.csv	Device ID, name, model, manufacturer, connection and disconnection times, connector name, DevTunneled, and workspace. DevTunneled indicates whether the device was tunneled using Dev Access.
user.csv	Device ID, user name, login and logout information, workspaces, and jobs created.

Examples of typical scenarios

Expand the sections below for examples of data processed in Excel representing a typical scenario.

The data usage duration is determined from the General Administrator settings, where you set the duration time in days.

Back to top

Troubleshooting

Why can't I see all my apps and devices?

• Check the filter panel to see which options are selected. Only items that fit the filter conditions are displayed. To display all items, select all the filter options and clear the search field of any text that you have entered.
• If the filter is active, make sure that you are not hiding your device's OS version number. Click Clear to clear all active filter selections.
  
  
• Make sure that you have access to the devices you need. Your administrator manages the workspaces and determines which devices are available to you.

Back to top

Why can't I log in?

If your user name is not associated with any workspaces, you are not able to log in. This could happen if your admin deleted your workspace. Ask your Digital Lab admin to check whether you are assigned to a workspace.

See also:

• User account actions and access key management
• Manage apps
• Manage devices
• Browser lab
• Admin Tasks