This document details the main tasks you will use within the Harlequin and ScreenPro LDK Ordering System.
What is LDK?
LDK is the system used by Global Graphics to manage copy protection for Harlequin RIPs, ScreenPro and other products. If you're using a product protected using LDK you will need to order Product Keys that can be activated to enable a product to run. A Product Key is a string generated by the ordering system at Global Graphics and supplied to you for use in activating an LDK license or an addition to an LDK license. It is comparable to the "activation code" or "serial number" used in activation processes for many other common computer operating systems and applications. Delivering the Product Key is equivalent to delivering the license. A Product Key always contains 36 characters and hyphens. For example: cfdd15d0-2737-4fe0-a58c-2604f9d232d9 When a user activates a Product Key for a new SL license it creates a new Protection Key on their machine. The Protection Key can be thought of as a container for the features in the license. Once activated, each activation can be identified using a Protection Key ID. The length of the Protection Key ID varies, but is shorter than 36 characters, and contains no hyphens. For example: 642071562632548406
What is the Harlequin and ScreenPro LDK ordering website?
This section provides a brief description of the LDK ordering website for Harlequin RIPs and ScreenPro.
Online ordering
The ordering system is based on a product catalog that is created for each customer. When you have agreed with GGSL what products should be available to you and you have nominated who should have access to the online Harlequin LDK ordering system you will have a 24/7 facility for placing all LDK license orders. If you do not already have access to the system, please contact your account manager to obtain access. The ordering system is a web browser-based application. You will be provided with a user name and password for each of the staff you nominate to have access. The ordering process is designed to be as intuitive as possible, but GGSL can offer training to your staff by webinar. The electronic delivery of activation codes for licenses, combined with ordering from the GGSL online system, allows almost instantaneous delivery 24/7, and allows a just-in time ordering process, with no, or at least minimal, inventory being held by you or by your distribution channel. The system allows you to view and search your orders. You can search for your orders and view details of licenses by entering a Product Key or Protection Key.
Access levels
The Harlequin and ScreenPro LDK ordering system uses role-based security; each user of the system may have one or more roles.
Access Level
Grants the right to
Orderer
Submit new orders. You must ensure that all of your staff with "Orderer" status have the right to place orders on your behalf.
Viewer
View and search your orders.
Support
View the details of any specific license by entering a Product Key or Protection Key ID.
Emergency Licenses
Order a small subset of time-limited products.
Emergency Replacement
Order a replacement license for an existing license preserving the security number and other license conditions (for example, in the event of a hardware failure).
Returns
Return orders subject to GGSL's Returns Policy.
LDK license types
The licensing system can be used to produce different types of license, each suited to a particular type of use.
Soft-lock type
This kind of license must be activated on a physical computer. Once activated it is tied to the computer but can be transferred to another computer using the process described in the Harlequin FAQ. Note: Soft-locks cannot be used on a virtual machine.
VM-lock type
This kind of license can be activated within a VM or a physical computer. Once activated the license cannot be transferred from the VM (or PC) to another. The licensing system is sensitive to attempts to clone the virtual machine.
Hard-lock type
This license can be used to program a USB hardware dongle. The license can be used on one computer at a time but because it is tied to the dongle the license moves with the dongle rather than any host computer. Note: The price for a hard-lock license does not include the cost of the dongle. It is intended that all production soft-lock, VM-lock licenses will be fulfilled almost instantaneously. If you hold stock of dongles, you will be able to program them immediately with Product Keys generated by the ordering system.
Login
Logging in
To begin visit https://ldk.globalgraphics.com/ with your web browser and login in with the credentials provided to you by GGSL.
Figure 4.1 The login page
After you successfully login your home page will be displayed. There are some consistent features that you will see throughout the application. Every page will have the same navigation along the top of the page. Click Home to return to the home page and Log Out to finish using the ordering system.
Figure 4.2 Home and Log Out
The ordering system features a navigation panel on the left-hand side of the page, which highlights the page you are visiting. Some of the navigation elements will only be visible if you have a specific role. This document describes the navigation elements.
Figure 4.3 The navigation panel
Buying a new RIP license
Note: This option is available to those authorized by you to place orders and have the Orderer role. The page allows authorized users to buy RIP licenses and license options and plugins.
Click the Buy a RIP link in the navigation panel and the page will display.
When you use the Buy a RIP page, you can use a filter to change or narrow down the list of available RIPs. When the page loads, the filter is set to All and the complete list of RIPs is displayed. Figure 5.1 Buying a RIP (when the page loads)
You can select the combo box and choose from All (the default), DemoandTime Limited, or Production categories; your selection will affect the list of RIPs in the lower combo box. Customers who have long product lists can use the filtering combo box to narrow their potential selections.
Figure 5.2 Part No. options drop-down list (displayed)
Add an order reference, a line reference (or both) and select a RIP option from the Part No. drop-down list. The RIP version field might include just the most recent version (typically for demo products) or a small selection of values.
Check that the Version, Concurrency, Activation and Quantity values are correct. Some products are defined in such a way that none of these values can be altered. Other products allow you to configure the values according to your needs.
The activation count defines the number of computers that the license can be activated on. A Product Key with multiple activations can be activated on one or more computers and each activation results in a different Protection Key ID. The concurrency of a license defines the number of instances of a product that can obtain a license to run from each activation. The maximum number of a product that can be run from a single RIP license is therefore the product of the activation count, multiplied by the concurrency.
Quantity is effectively the number of Product Keys.
As you order your RIP you can order additional plugins, layered options, and collections of products in bundles. To add further options click Add Option and select an item from the Options dropdown list. Options that are already included with your RIP will not be shown on the list.
If you have added an option in error, click the Delete button next to the option or change the selected value.
To add more RIPs to your order, use the Add Line button; use the Delete Line button to remove order lines that are not required.
When you have completed this page select Next to continue or Cancel Order to abandon.
The "Review Order" page is displayed:
Figure 5.3 The Buy a New RIP "Review Order" page
Review your order. Use the Edit Order button to modify the order or click the Place Order button to submit it.
The page will extend to display more information similar to the following example:
Figure 5.4 Details of your order expanded
Click "Place Order" to submit your order.
Note: The time it takes to process your order will vary with the complexity of the products you choose. If an error occurs while processing it will be displayed on the page. However, in normal circumstances the page will update having created entitlements for the items you ordered.
Figure 5.5 The order has been processed and results displayed
This page provides you with details of the Product Key for each item in your order, a summary of what you ordered and a link to a CSV file containing details of the order. You will also receive a copy of this file by e-mail. If you would like copies of this e- mail sent to other addresses (such as a group), please inform GGSL.
Activating your Product Key
Note: You must activate your Product Key before you can add more options or use the Harlequin RIP. The Harlequin RIP ships with an executable with a user interface (LDKTOOL) and a command-line tool (LDKUtil), which can be used to activate the Product Key. Instructions detailing how to use the LDK Tool are supplied with the tool. For more information see the page entitled: Technical Note Hqn091:
Enhancing your existing RIP
Enhancing your existing RIP means to add layered options, bundles, plugins or extensions to a RIP you are already running. Note: This option is available with the Orderer role.
Choose Enhance a RIP from the Ordering panel at the left side of the page. This displays the Supply Key page:
Figure 6.1 The Supply Key page
Add your reference for this order.
The key you would use for this page could be your original Product Key for your RIP, any key that you've previously acquired through enhancing or your Protection Key ID. For an explanation of LDK keys see the LDK FAQ document. !worddav55f60a72926e9e015c8bb18b052b7111.png|height=195,width=491!Figure 6.2 Entering your Protection Key ID or your Product Key.
Click Next. The system will retrieve the details of your RIP and any enhancements you have made previously and create a list of appropriate enhancement products for your RIP.
Figure 6.3 Details of the RIP have been retrieved; options can be selected
If you wish you can add an additional comment on each line of your order.
To add additional options, click the Add Option button; please ensure you select an option before adding another.
Click the Add Key to add another order line.
Figure 6.4 Additional Options have been added.
When your order is complete click Next to display the Order Review page.
Figure 6.5 Your order summary
Click the +Detail button to display more information about the products you've chosen. This is particularly useful if you've selected a bundle as the +Detail button will expand the bundle into individual part numbers. Click -Detail to hide the additional information.
Use the Edit Order button to amend the order; click Place Order to submit your order which will complete by displaying the Order Confirmation page. Your Product Key or keys will be displayed; a link to the CSV file which also contains details of your order is included. A copy of the CSV file is also e-mailed to you. Note: After you generate a key, activate it. !worddavdb2b8587ea1e0148f67bfa9ac2460484.png|height=340,width=449!Figure 6.6 The Order Confirmation page with fulfilment details
Extending a Time-Limited RIP license
If you have purchased a time limited-RIP it may be possible to use the Extend a Time Limited RIP option to extend the duration of its license. Not all Time Limited licenses can be extended in this way; currently a limited number of RIPs designed for leasing have been made available. If you follow this process, the LDK Ordering System will inform you if your RIP can be extended or not; alternatively, refer to your contract.
To get started, select the Extend a Time Limited RIP link in the Ordering panel.
Figure 7.1 Extend a Time Limited RIP
Note: This option is only available to those persons authorized to place orders. You will need a Protection Key ID to use this feature. To continue enter a reference for this order and your Protection Key ID, and then click Next.
Figure 7.2 Your order reference and Protection Key ID
Your Protection Key details are retrieved from the licensing server along with the details of the RIP and its related products:
Figure 7.3 The Review Items page
Select an extension period from the drop-down list; your order total will be recalculated.
Select Next to continue or Cancel to return to step 2.
Figure 7.4 The Review Order page
Your order is summarized on this page.
If you want to change the extension period, click the Edit button to return to the previous page. Selecting Cancel will return you to the start. Click the Place Order button to submit your order and generate the extension for your existing time limited license.
Your Product Key and order number is displayed along with details of your new expiry date. A CSV file containing your Product Key and the order details can be downloaded from the page using the Download CSV file link.
Figure 7.5 Your Product Key and new expiry dates
A copy of the file will be e-mailed to you.
Figure 7.6 Your order details will be emailed to you
Buying a standalone product
Some Global Graphics software products (such as ScreenPro and SetGold) can be used without a RIP; the Buying a Standalone product option allows you to purchase products such as these. Figure 8.1 The Buy a Standaloneproduct
To get started select the Buy a Standalone product option in the Ordering panel.
Note: This option is granted by the Ordering role. Figure 8.2 The Buy a Standalone product page
To continue enter your reference for this order and select a product from the drop-down menu.
Not all products allow concurrency and activations values to be changed but quantity, which is the number of licenses and Product Keys, is almost always editable.
Note: Concurrency and activations are normally fixed values for ScreenPro and SetGold; these values are not user editable. Figure 8.3 The completed order form When you are ready to place your order click the Place Order button. The order will be processed and one or more Product Keys generated. Your order number, product key and link for a CSV (Comma-separated Values) file summary of your order will be displayed. You will also receive an e-mail with details of your order including a CSV file with your Product Key(s). Figure 8.4 Summary for your order
Enhancing ScreenPro
You can enhance ScreenPro in a variety of ways. You might want to increase the number of Screeners or add a product like PrintFlat. If you have Orderer access, the Enhance ScreenPro link will be displayed in the navigation panel: Figure 9.1 Enhance ScreenPro link
Click Enhance ScreenPro.
Figure 9.2 Supply a Product Key or a Protection Key ID; supply an order reference
You will need your ScreenPro Product Key or your Protection Key ID and an order reference. In the following image a customer has supplied a Protection Key ID and clicked Next.
Details of the customer's existing license are displayed. In the section labeled Things you can order, products that are compatible with ScreenPro are displayed:
Figure 9.3 A Protection Key ID has been supplied and compatible products are available to order. Note: If you supply a Product Key the ordering system displays the contents of activated products in the Protection Key ID (and not just the Product Key).
The following image shows available products for the customer's current license. To add another product, click the Add another button.
Figure 9.4 Orderable products (the list may vary) Note: You must select at least one product before you can place the order. Figure 9.5 A product has been selected and the Review Order button is available
To progress the order, click the Review Order button; to cancel and return to the beginning of the process, click the Cancel Order button.
Figure 9.6 The Review Order screen
The Review Order screen provides a summary of your order. From here click the Cancel Order button to cancel your order, click Edit Order to resume editing it, or click Place Order to submit it.
Figure 9.7 Order placed, Product Key delivered
You will also receive an email with an attachment containing details of your order:
Figure 9.8 Details of your order will be emailed to you Note: After you generate a key, activate it.
Moving from HLS to LDK
The ordering system provides a facility for transitioning Harlequin Server RIP or MultiRIP licenses using HLS security to LDK security. These are relevant for moving from a license for version 10 or earlier, to a license for version 10 or later (version 10 can be used with both security systems). The upgrade path in the ordering system is not applicable for any system using HLS permit files (usually used when more than one RIP is used on a single computer). Please contact GGSL Sales-Admin if you wish to upgrade such a license. There are two methods for providing GGSL with enough information to generate an LDK license from your existing HLS license:
If you are moving a Harlequin Server RIP or MultiRIP from HLS to LDK, GGSL recommends that you use the GetDongleInfo tool, which is available when you install a new RIP. (See <installation folder>\ldk\getdongleinfo.exe.) Use GetDongleInfo to generate a .superpro file and then upload the file to us. See "Upload .superpro file walkthrough" below.
If, for some reason you cannot use GetDongleInfo, you should use your dongle serial and security numbers following the "Have Dongle walkthrough".
Upload .superpro file walkthrough
Choose the HLS to LDK link from the Ordering panel to display the following page:
Figure 10.1 The HLS to LDK Home page
Click the Select File button to open a File Explorer window, then navigate to your .superpro file:
Figure 10.2 Navigate to your .superpro file Note: Before generating the .superpro file, all of the passwords that they are entitled to must be installed.
Select the .superpro file and click Open. The system reads the contents of the file and tries to match the HLS products to LDK equivalents.
Figure 10.3 RIP details extracted from the .superpro file Note: It is not always possible to map an HLS product to an LDK product (for example where a product has no LDK equivalent). The ordering system will tell you about any products that cannot be transitioned.
You can add options to your new LDK license as you transition. In the following picture we've uploaded a .superpro file and used the Add Option button to choose a new bundle.
Figure 10.4 Adding options as you transition to LDK
To progress the order click Next; the Review Order page will be displayed:
Figure 10.5 The Review Order screen
Click the +Detail to view more information about the order and then use the -Detail option to hide the additional information (see Figure 12.5).
Click Edit Order to change your order; otherwise, if the order is correct select Place Order.
Your order is processed and your Product Key(s) and the RMA number for your Dongle return is displayed. A CSV file containing the order details can be downloaded from this page using the Download CSV file option, and a copy is e-mailed to you.
Figure 10.6 A RIP with additional simple imposition and TrapPro option
HLS to LDK walkthrough with dongle security and serial numbers
Use the following procedure if you are moving a Harlequin Server RIP or MultiRIP from HLS to LDK and you have been unable to generate a .superpro file for your Harlequin Host Renderer or MultiRIP.
Choose the HLS to LDK link from the Ordering panel to display the following page:
Figure 10.7 HLS to LDK home page Figure 10.8 Dongle serial and security numbers
Click Have Dongle.
Enter the serial and security numbers from your dongle and click Next. The system attempts to match the dongle information against the records held by GGSL. It then returns the details about your RIP's capabilities and any options or companion products associated with your RIP.
Figure 10.9 Selecting a RIP Note: If your RIP is not recognized and you have correctly entered the serial and security number, as shown on your dongle or displayed in the RIP user interface, please email the GGSL Sales-Administrator. Note: If the system successfully matches your entered combination of serial and security number, it is important that you note and compare the information from the records with what you know about your RIP. If the system does not report the options that you are entitled to on this page they will not be included in your new license. Similarly, the products offered to you on this page are based on the capabilities of your RIP according (but not limited) to such criteria as the resolution, version and whether or not it is a full RIP. Note: The Choose a RIP page (above) shows an LDK RIP and an added option (ColorPro). No options are included in the original (HLS) license.
Click Next.
Figure 10.10 Reviewing your order
Click +Detail to view more information about the order and then use the -Detail option to close the Detail window (see Figure 12.10 for an example).
Use the Edit Order button to change you order. Otherwise, if your order is correct use the Place Order button. When the order processing is complete the following page is displayed:
Figure 10.11 Your Product Key and order summary The page includes a link to a CSV file which you can download and includes details of your deliverables. The displayed Product Key represents the LDK license you have moved to. The RIP serial number is preserved and displayed along with any options bundled with your chosen RIP and any options you subsequently added. When you activate this key, you can confirm that the RIP has been correctly moved from HLS to LDK security by reviewing the license using the LDK Tool, included with any LDK capable RIP software. Figure 10.12 Your new LDK license
Dongle return
For information about dongle return see Disabled dongles.
Your orders
To view the details of the order, click the link in the first column (Order no). Information such as Product Keys, your reference, serial numbers and what you ordered is available.
Figure 11.1 Order detail for Order Number 314501 Your previously placed orders are available when you select the Your Orders link from the navigation panel. You can select to view a list of 10 or more orders per page. You can sort the orders by order number, date, who placed the order and the reference you gave. Additionally, you can search your orders for occurrences of text you enter in the search box. Figure 11.2 The Your Orders view
Disabled dongles
Depending on your contract, GGSL may require you to return your dongle after you transition your license to LDK. You should have been given an RMA (Return Material Authorization) when the license is successfully transitioned. Please include the RMA number in the returns package. Alternatively, it may be possible for you to use the DisableDongle tool. This is a software program that allows you to de-program the dongle in-place. It creates a certificate file as evidence that the dongle has been de-programmed; this file can be uploaded to Global Graphics in lieu of the physical dongle. Once a dongle has been deprogrammed, it cannot be used to enable a RIP to run. For more information on DisableDongle see the LDK FAQ documents or Technical Note Hqn091: LDK tools and utilities. Uploading your disabled dongle certificate Figure 12.1 Disabled Dongle link in the navigation]
Click the Disabled Dongle option from the navigation; a new page will load.
Figure 12.2 Disable Dongle page
Click the Select File button; this allows you to select the .txt file created with the Disable Dongle Tool. A file dialog is displayed that you can you use to navigate to your certificate.
Figure 12.3 Select the .txt file created with the Disabled Dongle Tool
3. Select the file and click Open. If the certificate is acceptable a summary is provided that confirms your valid certificate has been uploaded:
This completes the process. Note: If GGSL is not aware of the dongle or if the certificate is not valid, you will be notified after the file is uploaded. If the dongle has already been marked as destroyed, the ordering system will respond with:
Figure 12.7 The dongle is already disabled
Checking your LDK Product or Protection Keys
This section describes how you can get detailed information about your Product Key or Protection Key ID using the Check a Key page. Note:Only users with the support role have access to the Check a Key utility. If you use a Product Key, the Check a Key page provides information about any Protection Keys relating to that Product Key. Note:Product Keys that have been activated create or update Protection Keys. 1. Select the Check a Key link; the following page is displayed:
Figure 13.1 Entering a Product Key on the Check a Key page.
2. Enter your key into the empty field and click Check! The server will respond with more or less information depending on the activation state of your license. More information is available after you activate your Product Key:
Figure 13.2 Unactivated Key (image 1of 3)
Figure 13.3 Unactivated Key (image 2 of 3) Figure 13.4 Unactivated key (image 3 of 3)
Following activation the Check a Key page displays more information: Figure 13.5 Activated Product Key summary (image 1 of 4)
Figure 13.6 Activated license RIP and RIP features (image 2 of 4)
Figure 13.7 Activated license enabled options (image 3 of 4)
Figure 13.8 Returns History and Replacement History (image 4 of 4)
Replacing a license following a hardware failure
It is possible to replace an existing LDK license with an identical license if you suffer a hardware failure. We no longer increase the activation count of the original license, preferring to replace it instead. Note: If you have the EmerReplacement role you can create the replacement license yourself. If you do not have this role, please email the GGSL Sales-Administrator with details of the license you need to have replaced and the circumstances of the failure.
With the role a Replace link appears in the navigation area of the site:
Figure 14.1 Replace link
We ask you to supply as reference either a Product Key or a Protection Key ID and a brief description of why the license is to be replaced.
Figure 14.2 The replace form
Having completed the fields, click Next.
Figure 14.3 confirmation of your entitlement
The ordering system will take your Protection Key ID or to derive your Protection Key ID from a Product Key if you provide one. Your Protection Key ID tells us what products are contained in your license, and we list them before you replace the license. When you click Next we will replace your license and disable your old one. The new license (your Product Key) preserves all of the attributes of your previous license including security numbers, duration, concurrency and so on.
14.4 Your replacement license Product Key
You can view the order detail by clicking the link beside the Your Order No: label and you can download the CSV file by clicking on the (csv) link. This CSV file is also emailed to you.
Figure 14.5 Your replacement order details are summarized in a csv file
We will email you with the CSV file summarizing your order attached.
Figure 14.6 Your replacement order details are emailed to you
JavaScript errors detected
Please note, these errors can depend on your browser setup.
If this problem persists, please contact our support.
with your web browser and login in with the credentials provided to you by GGSL.
