Systems Manager Overview

The Systems Manager is your hub for viewing and maintaining the system and installation records we have for your organisation and allows you to obtain license keys for each of your QuantityWare systems.

NEW FOR PORTAL V4

  • When you add a new BCP or BCG system via the Systems Manager, a BCP/BCG license key is instantly generated as soon as you save your changes.

License Rules

To support the automated generation of license keys, the following rules have been put in place:

  • License key expiries are directly linked to the current “agreement validity expiry”, which is:
    • For test agreements, the end date of the test agreement
    • For productive agreements, the end date of the last paid-for yearly/quarterly period
      • When the invoice for the next period of your agreement is paid, any previously added systems will automatically have license keys generated / extended accordingly
  • SAP Installation numbers are selected from a pre-approved list
    • This reduces the chance of error when adding new systems, and helps speed up system addition
    • You can request new SAP Installations via the Systems Manager (see Requesting a New Installation below)
  • You may only add systems up to the system limit
    • This is set based on the scale of your QuantityWare agreement
    • You can request system limit increases if required

Adding Flexibility

Both license expiries above are usually the responsibility of your organisation’s financial representatives. However, to provide some flexibility to your organisation’s technical contacts, the following exceptions have been put in place:

  • If licenses are about to expire on a test agreement, technical contacts may request a test agreement extension via a special button in the Systems Manager
  • If configured for your organisation and if licenses are about to expire on a productive agreement, we allow a one-off 31 day “emergency extension” of all productive licenses. This can be performed with a single click in the Systems Manager
  • Special 28-day “trial licenses” can be generated for software that you don’t currently have licensed – for example, for BCG if you currently have a license for BCP
    • These allow you to try out our alternative software solutions alongside your currently licensed software
    • Once generated, you can request extensions of these trial licenses using the “Request Trial License Extension” button within each system’s details

Accessing the Systems Manager

You can access the Systems Manager as follows:

  • Click “Customer” in the navigation menu
  • Select “Systems Manager”

The Systems Manager will load. The Systems Manager and split into three tabs (the “Systems” tab is shown to the right):

  • Summary – View an overview of your organisation’s licenses and installations, the agreement/contract status and the licensed software. Warnings for any expiring/expired licenses and agreement issues will be displayed here clearly.
  • Systems – View your list of systems and view the license keys of any BCP / BCG systems. Add new systems and request license extensions (for “trial” systems and when on a test agreement/contract only)
  • Installations – View the list of approved Installations for your organisation, delete unused installations and request additional installations

Adding a New System

If you have appropriate access, and your system limit has not yet been hit (if it has, see Requesting a Systems Limit Increase below), you can add new systems and receive license keys using the Systems Manager.

To add a new system within the Systems Manager:

  • Click the “Systems” tab
  • Click the “+ Add System” button (at the bottom of the existing systems list)

The new system’s details will be displayed, with a default name and software selected (see right):

  • Enter a system name (this will help you identify it when viewing the Systems Manager in future)
  • Select a Product (BCP, BCG, CTP or CTG) if the default does not match your requirement

New Trial System?

  • If, after changing the Product, you see a “New Trial System?” note, this is because your current agreement/contract with QuantityWare does not cover that product.
  • Before proceeding, please view the Trial Licenses section below.

  • Choose an environment from the list
  • Select the system’s Installation from the list

Installation not in List?

  • Only those installations that QuantityWare have approved will appear in the list.
  • If you need to add your system to a new installation, you’ll need to request the installation first.
  • You can’t add the new system until this is done.
  • Click the “Cancel” button for this system, then scroll up to the “Installations” tab and follow the instructions in the Requesting a New Installation section below.

  • Enter the system’s 3-character SID
  • Repeat the above steps each system you wish to add
  • Click “Save Changes” in the Action Bar

The system details you entered will be validated and, if successful, the Portal will add the systems to its records and generate any BCP or BCG licenses requested.

After a few moments, the page will reload, and a note will be shown to state that the license generation (if applicable) was successful. To view your new licenses, follow the instructions in the View License Details section below.

How do I install a BCS product?

  • To view instructions on how to install BCS products on your system(s), click the link in the “License Installation Instructions” link on the summary tab.

Viewing a License Key

To view the license key and license details for an existing system within the Systems Manager:

  • Click the “Systems” tab
  • Click the relevant system (anywhere on the system record)

The system’s record will expand to display the system details and license details.

The license key, expiry date and status are shown to right of the system details (see right).

  • Optionally, click the “Copy to Clipboard” link to copy the license key to your device’s clipboard

Licenses keys are only required for BCP and BCG systems. CTG and CTP systems do not require a license key, so the message to the right is displayed when the system details are shown:

License Status

Each system record will display a status icon, which will describe the status of your license to help you easily identify systems with expiring / expired license keys, those with trial license keys etc. All statuses are shown below:

Valid BCP/BCG licenseValid “trial” BCP/BCG license
Expiring BCP/BCG license (within next 100 days)New system (will be added on save)
Expired BCP/BCG licenseSystem flagged to archive (on save)
CTP/CTG system

Archiving a System

To archive a system within the Systems Manager:

  • Click the “Systems” tab
  • Click the relevant system (anywhere on the system record)
  • Click the “Archive” button

The system will be marked as “To Archive”. If you didn’t mean to archive the system, click the “Restore” button now – the archival won’t take place until you click “Save Changes”.

  • Repeat the above steps or each system you wish to archive
  • Click “Save Changes” in the Action Bar

Each system you requested to be archived will be archived immediately.

Requesting a New Installation

Starting with Portal v4.0.0, license keys are generated instantly when a system is added via the Systems Manager. To ensure this process is reliable and to reduce the chance of errors, you can only add systems and generated license keys to those installations made available in a pre-defined list. You can add installations to this list by requesting installations using the process below.

To request one or more new installations within the Systems Manager:

  • Click the “Installations” tab
  • Click “+ New Installation”

A new blank installation will be added to the Installations list, along with a “Reasons for additional installation(s)” text field.

  • Enter your installation number
  • Enter a description of your installation
  • Repeat the above steps for each installation you require
  • Enter a description of your new installation(s) and why these are required. This will help QuantityWare understand your requirement and allow us to make sure your current agreement scale / complexity level is accurate, prior to granting your new installation(s).
  • Click “Save Changes”

Your new installations will be validated and, if there are no issues, a ticket will be automatically raised with the QuantityWare team requesting your changes.

After a few moments the page will refresh, and you’ll see a message to confirm that your request has been sent, along with a link to the Ticket itself (should you wish to add any further comments). Additionally, you will receive an email to confirm that your ticket has been raised with the QuantityWare team. You can view the ticket at any time via the SupportCentre.

The QuantityWare team may have queries relating to your request. If they do, they will reply to your ticket and you’ll receive an email notification. You can reply to the ticket via the SupportCentre to respond to any queries.

After any queries are resolved, the QuantityWare team will confirm their decisions regarding each requested installation. You’ll receive a confirmation email explaining the decision(s), and each installation that was approved will now be available within the Systems Manager, listed in the Installations tab and may have new systems added against it – and licenses generated as required.

Deleting an Installation

You can only delete installations if they are not currently in use by any of the systems for your organisation. Deleting an installation will make it no longer available to any of the systems you add for your organisation, so only delete those you are sure you will no longer require.

To delete an available installation within the Systems Manager:

  • Click the “Installation” tab
  • Click the “Delete” button for each Installation you wish to remove
  • Click “Save Changes” in the Action Bar

Productive License Extensions

Since Portal v4.0.0, the expiry dates of license keys are directly linked to the “agreement validity expiry”, which is:

  • For test agreements, the end date of the test agreement
  • For productive agreements, the end date of the last paid-for yearly/quarterly period

The reason for license key expiry is usually the responsibility of your organisation’s financial or agreement representatives. i.e. the expiration date of usage agreements defines the expiration date of license keys.

However, to provide some flexibility to your organisation’s technical contacts, the following functions have been put in place:

  • If licenses are about to expire on a test agreement, technical contacts may request a test agreement extension
  • If configured for your organisation and if licenses are about to expire on a productive agreement, technical contacts may perform a one-off 31 day “emergency extension” of all productive licenses.

Details of both methods are shown below:

Requesting a Test Agreement Extension

When testing QuantityWare software, sometimes the testing can take longer than the 28 days that our test license keys are valid for. As the technical team at your organisation often lead the testing process, we offer the flexibility for technical contacts to request an extension of the test agreement and corresponding license keys.

When viewing the Systems Manager for a customer with a test agreement, you will a message like that on the right on the “Summary” tab:

In the above case, to request a test agreement extension via the Systems Manager:

  • Click the “Request Extension” within the “Test Agreement” notice

This will automatically create a draft “Test Agreement Extension” ticket, which will list all existing systems for your organisation (see right).

By default, the requested expiry is set to 28 days from today’s date.

  • Modify the “Requested Expiry” date as required
  • Optionally, add any supporting documentation using the attachment upload interface in the “Attachments” tab
  • Enter the reason for your extension request. You should specify as much detail as possible as more detail will help QuantityWare process your request quickly and reduces the chance of further questions prior to implementation of your request.
  • Click “Submit Ticket” in the Action Bar

Your request will be validated and, if there are no issues, the ticket will be submitted to the QuantityWare team.

The QuantityWare team may have queries relating to your request. If they do, they will reply to your ticket and you’ll receive an email notification. You can reply to the ticket via the SupportCentre to respond to any queries.

After any queries are resolved, the QuantityWare team will confirm their decision. You’ll receive a confirmation email explaining the decision, and if your request is approved your agreement will be extended and your license keys will be extended also. All contacts with the technical role will receive an email that the updated license keys are available within the Systems Manager.

Performing an Emergency Productive License Key Extension

If configured for your organisation and if licenses are about to expire on a productive agreement, technical contacts may perform a one-off 31 day “emergency extension” of all productive licenses.

If configured and the licenses are about to expire, you will a message like that on the right on the Systems Manager “Summary” tab:

If you’ve already performed a one-off emergency extension for the current expiry, you will not be able to make another (you’ll see a note stating that you’ve already made the emergency extension).

If you see the message to the right, then to perform an emergency extension within the Systems Manager:

  • Click “Customer” in the navigation menu
  • Select “Systems Manager”
  • Click the “Extend Licenses” within the “Invalid Agreement” notice

The portal will extend all productive licenses on your system to the emergency extension date.

After a few moments, the page will reload, and a note will be shown to state that the emergency license extension was successful. To view your new licenses, follow the instructions in the View License Details section below.

Trial Licenses

If your organisation has a productive license agreement/contract with QuantityWare, this is for one of the following QuantityWare products:

  • BCP (Bulk Calculations – Petroleum)
  • BCG (Bulk Calculations – Gas)
  • BCS (Bulk Calculations Solution, which covers both BCP and BCG)

If you have a BCS license, you may add systems and obtain productive licenses for both the BCP and BCG software. If you have a BCP or BCG license only, then you may only add systems and obtain productive licenses for the BCP or BCG software respectively.

However, we offer a way for you to “try out” our alternative software solutions alongside your currently licensed software. This is performed via a “Trial License” of the non-licensed software.

Trial License Characteristics

  • Trial licenses expire 28 days after generation
  • Trial license key expiry dates are not linked to your agreement’s validity expiry, so do not automatically extend whenever your agreement validity is extended
  • If your organisation chooses to purchase the software you are trying out, and the agreement/contract is modified to support this, any trial licenses for your organisation will be immediately converted to standard productive licenses and extended to the current agreement validity expiry.

Obtaining a Trial License

To obtain a 28-day trial license, just follow the standard steps to add a new system (see Adding a New System above) but select the software that you do not currently have a license for (e.g. if you have a license for BCG, select BCP).

The only difference in process will be that your environment choices are limited to Development and Sandbox / Test.

Extending a Trial License

Trial licenses may be extended on request, as follows:

  • Click “Customer” in the navigation menu
  • Select “Systems Manager”
  • Click the “Systems” tab
  • Click the relevant trial system (anywhere on the system record)

The trial system’s record will expand to display the system details and trial license details.

  • Click the “Request Trial License Extension” button

This will automatically create a draft “Trial License Extension” ticket, which will list all existing trial systems for your organisation (see right).

By default:

  • The “Requested Trial License Extension” will be set to 28 days from now
  • The system you selected in the Systems Manager will be selected for extension.
  • Optionally, modify the “Requested Trial License Extension” date
  • Optionally, select any other trial licenses you wish to extend
  • Optionally, add any supporting documentation using the attachment upload interface in the “Attachments” tab
  • Enter the reason for your extension request. You should specify as much detail as possible as more detail will help QuantityWare process your request quickly and reduces the chance of further questions prior to implementation of your request.
  • Click “Submit Ticket” in the Action Bar

Your request will be validated and, if there are no issues, the ticket will be submitted to the QuantityWare team.

The QuantityWare team may have queries relating to your request. If they do, they will reply to your ticket and you’ll receive an email notification. You can reply to the ticket via the SupportCentre to respond to any queries.

After any queries are resolved, the QuantityWare team will confirm their decision. You’ll receive a confirmation email explaining the decision, and if your request is approved each trial system will have a new, extended trial license key generated. All contacts with the technical role will receive an email that the new license keys are available within the Systems Manager.

Requesting a System Limit Increase

To prevent misuse of the license key generation system, the Portal initially limits the maximum number of system records that can be added for each customer. This is set to a level that matches the “scale” of your organisation’s agreement/contract with QuantityWare and should offer more than enough flexibility to ensure all required systems can be added to the Portal.

If, however, you hit the system limit but need to add further systems, you may request a system limit increase by either raising a ticket with the “System Limit Change” category via the SupportCentre, or via the Systems Manager as below:

  • Click the “Systems” tab
  • Click “Request System Limit Increase” / “Request an Increase” below your list of existing systems

This will automatically create a draft “Systems Limit Change” ticket, which will display your current limit and the requested limit (see right).

By default, the requested limit is set to one greater than the current limit.

  • Modify the “Requested Systems Limit” as required
  • Enter the reason for your limit change request. You should specify as much detail as possible as more detail will help QuantityWare process your request quickly and reduces the chance of further questions prior to implementation of your request.
  • Click “Submit Ticket” in the Action Bar

Your request will be validated and, if there are no issues, the ticket will be raised.

The QuantityWare team may have queries relating to your request. If they do, they will reply to your ticket and you’ll receive an email notification. You can reply to the ticket via the SupportCentre to respond to any queries.

After any queries are resolved, the QuantityWare team will confirm their decision. You’ll receive a confirmation email explaining the decision, and if your request is approved your system limit will be increased as requested.

Back to Service Portal Guide