×

Supercharge your Proficy solution! Download a free trial of Proficy Operations Hub, CSense analytics, and more. Explore our Proficy 2024 releases!

Home
License Client
Command-Line Operations
Cleaning Licenses from a Non-Configurable Software Key
You can remove licenses from a non-configurable software key using the command line or a batch file. This action is known as “cleaning” licenses.

Important Product Information
Quick Start
Types of Licensing
Architecture Guide
License Client
- License Client Overview
  Use the License Client to activate, review, and update licenses on a client device or a GE USB hardware key. The License Client can retrieve licenses from the GE Cloud License Server, a Local License Server on your intranet, or a GE USB hardware key.
- Installing the License Client
  You must install the License Client on all client devices that require GE software licenses.
- Removing Existing Legacy Licenses
  Before migrating to cloud-based licensing, you must remove your existing licenses.
- Upgrading Legacy Licenses
  If you received an upgrade file for a legacy license, you can use that file to update the legacy license instead of the License Client.
- Viewing the Audit Log
  The ProficyLicenseClient_Audit.log file provides details about operations performed on the License Client.
- Viewing Licenses
  The View Licenses tab displays information about licenses on this computer. You can display license information for all products or a particular product.
- Activating Licenses
- Returning Licenses
- Completing Offline Processes
- Advanced Tab Functions
  Use the Advanced tab to refresh and clean licenses, update application settings, and download the latest License Client to a computer.
- Command-Line Operations
  - Installing the License Client
    You can install the License Client using the command line.
  - Unistalling the License Client
    You can uninstall the License Client using the command line.
  - Activating Licenses from the GE Cloud Server
  - Activating Licenses from the Local License Server
    You can activate licenses from the Local License Server using the command line or a batch file.
  - Activating Licenses for a Non-Configurable Software Key
    You can activate licenses for a non-configurable software key using the command line or a batch file.
  - Returning Licenses to GE Cloud Server or Local License Server
    You can return licenses to the GE Cloud Server or the Local License Server using the command line or a batch file.
  - Cleaning Licenses on the GE Cloud Server or Local License Server
    You can remove licenses from the GE Cloud Server or the Local License Server using the command line or a batch file. This action is known as “cleaning" licenses.
  - Cleaning Licenses from a Non-Configurable Software Key
    You can remove licenses from a non-configurable software key using the command line or a batch file. This action is known as “cleaning” licenses.
  - Adding Sentinel Dependency
    You can add Sentinel Service dependency using the command line to ensure that the Sentinel Service and Common Licensing start up in the correct order.
  - Removing Sentinel Dependency
    You can remove Sentinel Service dependency using the command line.
  - Adding Wibu Dependency
    You can add Wibu Service dependency using the command line to ensure that the Wibu Service and Common Licensing start up in the correct order.
  - Removing Wibu Dependency
    You can remove Wibu Service dependency using the command line.
  - Creating a License Report
    You can create a License Report in text or HTML format to show all licenses on a device, including the customer name, license number, expiration date, license version, license source, and license type.
  - Command Return Codes
    Batch file commands return success or error codes at completion.
Local License Server
USB keys
FAQs and Troubleshooting

Cleaning Licenses from a Non-Configurable Software Key

You can remove licenses from a non-configurable software key using the command line or a batch file. This action is known as “cleaning” licenses.

Before you begin

Verify the License Client is not running concurrently.

About this task

Cleaning is irreversible and removes all existing licenses from your computer. The command-line option does note display any additional warnings.
You can activate licenses after the cleaning process completes.

Procedure

To clean licenses from the DOS command line:
1. Open a command-line interpreter window with Administrator privileges.
2. Navigate to "C:\Program Files (x86)\Proficy\Proficy Common\Proficy Common Licensing\ProficyLicenseViewer"
3. Clean licenses by entering "Start/wait ProficyLicenseWizard.exe -CleanNonConfigSWKey".
The following response appears:
```
"License(s)  were
          removed successfully."
```
Note: If there is an error executing the command, a message appears. See the Proficy License Client log file for more details.
To clean licenses using a batch file, enter your commands in the following format in your batch file:
```
echo  off
Start/wait  ProficyLicenseWizard.exe -CleanNonConfigSWKey
if  errorlevel 1 (
   echo The command failed. Error code=%errorlevel%
  exit /b %errorlevel%
)
echo  Success
```
The command returns 0 when successful, or one of the error codes defined in the command return code table.