Getting Started

OneSite Patch automates even the most complex enterprise patching processes, allowing IT and security teams to precisely mirror their patching strategies and tailor processes for specific device groups.

OneSite Patch is powered by Adaptiva. Adaptiva is committed to providing the best tools for our customers to achieve their security outcomes.

Prerequisites

Before using any Adaptiva OneSite Products, you must set up your OneSite environment. See the OneSite Platform Site Planning and Installation Guide for details. For more information on the supported operating systems, see Supported Operating Systems, Software, Drivers, and BIOS.

The Adaptiva Server and Adaptiva Client software installations support all OneSite products. After you add license keys for your licensed products, you are ready to access the power of OneSite in your environment.

Supported Browsers

Adaptiva OneSite supports the following browsers:

• Google Chrome

• Microsoft Edge

• Mozilla Firefox^*^

• Safari

Important

Do not use Microsoft Internet Explorer.

* If you receive an Admin Portal login error when using Mozilla Firefox, see Resolve the Mozilla Firefox Active Directory Login Issue KB article.

Logs for Server

Access Server logs by navigating to > Logs in the Admin Portal, or by navigating to the following location:

<path>\Adaptiva\Adaptiva Server\Logs

Note

OneSite Patch SaaS tenant logs can only be accessed by navigating to > Logs in the Admin Portal.

The following options are available on the Logs page:

• Download All Server Logs: Downloads all Server logs, including component and workflow logs.

• Download Server Error Logs: Downloads Adaptiva Server error logs.

• Clear Web Logs: Clears all Admin Portal runtime information and errors recorded by the browser session.

• Download Web Logs: Downloads all Admin Portal runtime information and errors recorded by the browser session.

Customer Support

When you need information beyond what this documentation or our Knowledge Base provides, enter a support ticket and request help from Adaptiva Customer Support (support account required).

Adaptiva OneSite Admin Portal

OneSite Patch uses the Admin Portal for configuration and management.

Use the Admin Portal to set up your environment, create policies, add administrators, and more. Global settings include groups, security, and administrators.

Log in to the Admin Portal

During the Adaptiva OneSite installation, the administrator creates a SuperAdmin account using either a native Adaptiva login, OIDC-enabled account, SAML-enabled account, or a Windows Active Directory account (recommended).

Tip

You can create an OIDC-enabled or SAML-enabled account after server activation and component configuration.

1. Enter the Fully Qualified Domain Name (FQDN) for the Adaptiva Server followed by the port (optional) into the browser address bar:

   https://<FQDN>:[port]

   If necessary, confirm the port details with the administrator who defined the port during the software installation. If the server is already using port 80, for example, the website may use port 9678.

2. Press Enter. The Admin Portal login dialog opens.

1. Log in using one of the following methods:

   • Enter a native Login ID (email address) and password, and then select Log in.

   • Select Login with Active Directory (recommended).

   • Select Login with <OIDC Entry>. OIDC-enabled accounts can be configured after server activation and component configuration.

   • Select Login with <SAML Entry>. SAML-enabled accounts can be configured after server activation and component configuration.

   Tip

   If you are using Mozilla Firefox, see Resolve the Mozilla Firefox Active Directory Login Issue KB article.

After successfully logging in, the Adaptiva OneSite Admin Portal Home page appears.

Licensing Adaptiva Products

Adaptiva OneSite Products requiresrequire a license for each active client. The license key contains the licensed company name and client count. The Adaptiva Server periodically counts all active, healthy, reporting clients as licensed clients.

You may enter the license key when installing the Server, or enter the license key using the Admin Portal after completing the installation. If you are starting the Admin Portal for the first time or your key has expired, select Manage Licenses to add or replace the license.

Add a License Key

If you entered your license key during installation, you do not need to reenter it.

1. Select Manage Licenses at the upper-right of the Admin Portal dashboard.

2. Select Add Key, and enter your license key.

1. Select OK to return to the Product Licensing workspace.

2. Wait for the licensing process to complete. For any user-generated changes, OneSite sends a status update when it has enabled the installed solution.

Target Collections for the Licensed Product

After entering a license key, select a Target Collection for the licensed product.

Caution

Use care when selecting Use All Clients. Earlier versions of the installed OneSite Patch version do not support this feature, and selecting it can corrupt the patch environment. Adaptiva recommends upgrading to the latest version of the product.

1. Select the OneSite Patch product name in the Product Licensing list.

2. Select + Browse under Target Collections. This opens the Select Group dialog.

3. Select one or more Groups from the All Groups table.

4. Select OK on the lower-left corner to return to the Product Licensing workspace.

OneSite PatchPatch Management Dashboard

Use the Patch Dashboard, available from the Admin Portal, to manage your patching strategies, review patching status, and more.

Access the OneSite PatchPatch Management Dashboard

Open the dashboard from the Admin Portal using one of the following methods:

• Select Patch ManagementOneSite Patch near the top of the page.

• Select Go to Patch ManagementOneSite Patch under Licensed Products.