Instruction Manual for KEBA models including: Licensing Runtime License, Software, Licensing Runtime License Software
KEBA Software Licensing | KEBA
File Info : application/pdf, 20 Pages, 213.54KB
DocumentDocumentLicensing Runtime license Operating instructions V 1.01 Translation of the original instructions Document: V 1.01 Document No.: Pages: 20 © KEBA 2021 Specifications are subject to change due to further technical developments. Details presented may be subject to correction. All rights reserved. KEBA Industrial Automation GmbH Reindlstraße 51, 4040 Linz, Austria +43 732 7090-0, +43 732 7309-10, keba@keba.com For information about KEBA and our subsidiaries please look at www.keba.com. Runtime license Record of Revision Record of Revision Version 1.00 1.01 Date 01-2019 10-2021 Change in chapter Description Changed by - Newly created hasl Several Updated to new company structure, updated device replacement hasl Operating instructions V1.01 3 © KEBA 2021 Runtime license 4 Operating instructions V1.01 © KEBA 2021 Runtime license Table of contents Table of contents 1 Trial license................................................................................................................. 7 1.1 Activation of a trial license (single user license) .............................................. 7 1.2 Activation of a trial license (runtime license).................................................... 7 2 Activating a runtime license (software on the device) ........................................... 8 3 Device replacement (runtime license)...................................................................... 14 4 License status and license overview ....................................................................... 18 Index ............................................................................................................................ 19 Operating instructions V1.01 5 © KEBA 2021 Table of contents Runtime license 6 Operating instructions V1.01 © KEBA 2021 Runtime license Trial license 1 Trial license By default, all products are delivered with a trial license. This license expires after 30 days. Within this period, all product functions can be used in their full scope. After this time has expired, use is no longer possible, or only possible to a limited extent. For full use, a new, valid license is required, which can be requested from KEBA. A trial license can only be used once. Even if the product is uninstalled and then reinstalled, use without a valid license is no longer possible. 1.1 Activation of a trial license (single user license) When using a product on a PC, no activation of the trial license is necessary. Once the product has been installed, the trial license is automatically activated and the product can be used for 30 days from the time of installation. 1.2 Activation of a trial license (runtime license) When using a device, the trial license must be activated manually. Otherwise, the product cannot be used or can only be used incompletely. Activation is only possible via the access "DevAdmin". Information Before activation, the date and time must be set correctly on the device! Otherwise, the license may become invalid immediately when the date is updated. To activate the trial licence proceed as follows: 1) Start "DevAdmin" 2) Establish a connection to the desired device. 3) Switch to tab Licensing Activation. 4) Click on Activate trial license. The trial license has been activated and the product is fully usable for 30 days. Operating instructions V1.01 7 © KEBA 2021 Activating a runtime license (software on the device) Runtime license 2 Activating a runtime license (software on the device) The following options are available for activating a license on the device: Online activation directly on device Offline activation using device Online activation using "DevAdmin" Offline activation using "DevAdmin" Online activation directly on device For online activation, the device on which the software to be licensed is installed must have an Internet connection and a display. A FAT32-formatted USB stick (max. 128 GB) is also required. To prepare the USB stick, proceed as follows: 1) Plug the USB stick into a PC. 2) Create the directory "licensing" in the root directory of the USB stick. 3) Create empty file with the name <Ticketcode>.ticket.xml in the "li- censing" directory. 4) Create file with the name config.lua with the entry autoMode = true. 5) Pull off the USB stick. The USB stick is now prepared. Depending on the device, the display is a display menu or a 7-segment display. Device with display menu Proceed as follows to activate the license: 1) Plug the USB stick into the device to be licensed. 2) The device recognizes the file on the USB stick and automatically starts licensing. Information If the entry autoMode = true has not been set, the query "Start online licensing?" appears on the display. Confirm the query with ENTER. After successful activation of the license, the message "New licenses activated" appears on the display. The USB stick can be removed. Device with 7-segment display The device must be in OsReady, STOP or RUN state. Proceed as follows to activate the license: 1) Plug the USB stick into the device to be licensed. 8 Operating instructions V1.01 © KEBA 2021 Runtime license Activating a runtime license (software on the device) 2) The device recognizes the file on the USB stick and automatically starts licensing. The following icon is displayed: Licensing has been performed successfully. The device returns to the original operating state. The USB stick can be removed. Offline activation using device If the device on which the software to be licensed is installed does not have an Internet connection, only offline activation is possible. To do so, a FAT32formatted USB stick (max. 128 GB) and another PC with an Internet connection are required. Proceed as follows to activate the license: 1) Plug the USB stick into the device. 2) Navigate to Licensing Offline activation Generate request in the display menu. The file <Seriennummer des Geräts>_request.xml is stored on the USB stick in the "licensing-offline" directory. 3) Confirm the message with the confirmation button. 4) Remove the USB stick. Switching to the PC: 1) Plug the USB stick into the PC. 2) Open "WebDepot" by entering the link listed on the license ticket into an Internet browser. 3) Enter the ticket code and click on Next. 4) If necessary, select the license for the desired product. 5) Click on Next and Bulk activation for PLC 6) Select the file <Seriennummer des Geräts>_request.xml from the "licensing-offline" directory of the USB stick. Operating instructions V1.01 9 © KEBA 2021 Activating a runtime license (software on the device) 7) Click on Upload Request And Continue Now. 8) Click on <Seriennummer>_<Gerätename>. Runtime license 9) Save the file under the name <Seriennummer des Geräts>_request.xml in the "licensing-offline" directory of the USB stick. The name must not be changed. 10) Remove the USB stick. Information The current page in "WebDepot" must not be closed! Switching to the device: 1) Connect the USB stick. 2) Navigate to Licensing Offline activation Activate license in the display menu. The file <Seriennummer>_receipt.xml from the USB stick is read out and saved to the USB stick again. 3) Confirm the message ("OK") with the confirmation button. 4) Remove the USB stick. Switching to the PC: 1) Connect the USB stick. 2) Click on Upload Receipt. 3) Select the file <Seriennummer>_receipt.xml from the "licensing-offline" directory of the USB stick. 4) Click on Upload Receipt Now. The license has been successfully activated. Online activation using "DevAdmin" For this online activation, a PC with an Internet connection is required. The device on which the software to be licensed is installed does not require an Internet connection, but it must be connected to the PC via a network connection. Proceed as follows to activate the license: 10 Operating instructions V1.01 © KEBA 2021 Runtime license Activating a runtime license (software on the device) 1) Establish a connection between the PC and the device using DevAdmin. 2) Click on Licensing Activation. 3) Enter the ticket code. 4) Click on Start online activation. The license was successfully activated on the device. Offline activation using "Dev-Admin" If neither the device on which the software to be licensed is installed nor the PC on which the device is connected via the network (offline PC) have an Internet connection, only offline activation is possible. To do this, a FAT32-formatted USB stick (max. 128 GB) and another PC with an Internet connection (online PC) are required. Between offline-PC and online-PC no network connection is necessary. The device to be licensed is connected to a PC without an Internet connection (offline PC) using DevAdmin. Proceed as follows to activate the license: 1) Insert the USB stick into the offline PC. 2) Establish a connection between the offline PC and the device using DevAdmin. 3) Click on Licensing Activation. 4) Click on Dowload license request file. 5) Save the file <Seriennummer>_<Gerätename>.xml to the USB stick. The name must not be changed. 6) Remove the USB stick. Switch to the online PC: Operating instructions V1.01 11 © KEBA 2021 Activating a runtime license (software on the device) Runtime license 1) Connect the USB stick. 2) Open "WebDepot" by entering the link listed on the license ticket into an Internet browser. 3) Enter the ticket code and click on Next. 4) Click on Bulk Update for PLC. 5) Save the file <Seriennummer>_<Gerätename>.xml from the USB stick directory. 6) Click on Upload request and continue now. 7) Save the file <Seriennummer>_<Gerätename>.xml to the USB stick. The name must not be changed. 8) Remove the USB stick. Information The current page in "WebDepot" must not be closed! Switching to the offline PC: 1) Connect the USB stick. 2) Select the file <Seriennummer>_<Gerätename>.xml from the USB stick directory and click on Update license and download receipt. 3) Confirm the message Upload successful with OK. 4) Save the file <Seriennummer>_receipt.xml to the USB stick. The name must not be changed. 5) Remove the USB stick. Switching to the online PC: 1) Connect the USB stick. 2) Select the file <Seriennummer>_receipt.xml on the USB stick and click on Upload Receipt Now. 12 Operating instructions V1.01 © KEBA 2021 Runtime license Activating a runtime license (software on the device) 3) Confirm the dialog with OK. The license has been successfully activated. Operating instructions V1.01 13 © KEBA 2021 Device replacement (runtime license) Runtime license 3 Device replacement (runtime license) The following options are available in which a license that has already been activated can be transferred to a new device: Offline exchange of a memory card Online exchange of a memory card Online restore of a license using DevAdmin Offline restore of a license using DevAdmin The original license runs on the new device for an additional 14 days. The license can only be used 2 x on a new device. Information Only activated unlimited licenses can be transferred. If there is already an activated license on the new device, it will not be overwritten by the restore. Offline exchange of a memory card In this application case, the memory card of a defective device was inserted into a new device. For this application case, a FAT32-formatted USB stick (max. 128 GB) and a PC with an Internet connection are required. The device must have a display. During the licensing process, the web browser with "WebDepot" open must not be closed. In order to transfer the license from the old device to the new device, proceed as follows: 1) Insert the USB stick into the new device. 2) Navigate to Licensing Offline Restore Generate Request in the display menu and confirm using the confirmation button. The file <Serial number of the device>_request.xml was saved to the USB stick. The name must not be changed. 3) Remove the USB stick. Switching to the PC: 1) Connect the USB stick. 2) Open "WebDepot" by entering the link listed on the license ticket into an Internet browser. 3) Enter the ticket code and click on Next. 4) Click on Hardware change for PLC. 5) Click on Upload Request and select the file <Serial number of the device>_request.xml from the licensing-offline directory of the USB stick. 14 Operating instructions V1.01 © KEBA 2021 Runtime license Device replacement (runtime license) 6) Click on Upload Request And Continue Now and on <Serial number of the device>_<Device>. 7) Save the file in the licensing-offline directory of the USB stick. 8) Remove the USB stick. Switching to the device: 1) Connect the USB stick 2) Navigate to Licensing Offline Restore Restore license in the display menu and confirm using the confirmation button. The message "Restore license executed" appears on the display. The file <Serial number of the device>_receipt.xml was saved to the USB stick. The name must not be changed. 3) Remove the USB stick. Switching to the PC: 1) Connect the USB stick. 2) Click on Upload Receipt. 3) Select the file <Serial number of the device>_receipt.xml from USB stick directory license-offline. 4) Click on Upload Receipt Now. The license has been successfully activated on the new device. Online exchange of a memory card In this application case, the memory card of a defective device was inserted into a new device. For this application case, the device must have an Internet connection and a display. In order to transfer the license from the old device to the new device, proceed as follows: 1) Navigate to Licensing Online Restore Restore License in the display menu and confirm using the confirmation button. The license can be installed on the new device. See 2 Activating a runtime license (software on the device). Online restore of a license using DevAdmin In this application case, the memory card of a defective device was inserted into a new device. For restoring a license online, there is a PC with an Internet connection in the network of the device and it is running. The device to be licensed is also running. 1) Establish a connection between the PC and the device using DevAdmin. 2) Click on Licensing Activation. 3) Click on Start online restore. Operating instructions V1.01 15 © KEBA 2021 Device replacement (runtime license) Runtime license 4) Confirm the dialog with OK. The entered license is available for licensing again and can be used as described in Chap. "Licensing software on a device". Offline restore of a license using DevAdmin In this application case, the memory card of a defective device was inserted into a new device. This restore method is used for devices without an Internet connection. For this method, a FAT32-formatted USB stick (max. 128 GB) and an Internet-capable PC are required (online PC). During the restore process, the web browser with the "WebDepot" open (online PC) and the web browser with DevAdmin open (offline PC) must not be closed. 1) Insert the USB stick into the offline PC. 2) Establish a connection between the offline PC and the device using DevAdmin. 3) Click on Licensing Activation. 4) Click on Download license request file. 5) Save the file <Serial number of the device>_request.xml to the USB stick. The name must not be changed. 6) Remove the USB stick. Switching to the online PC: 1) Connect the USB stick. 2) Open "WebDepot" by entering the link listed on the license ticket into an Internet browser. 3) Enter the ticket code and click on Next. 4) Click on Hardware change for PLC. 5) Select the file <Serial number of the device>_request.xml from the directory of the USB stick. 6) Click on Upload request and continue now. 16 Operating instructions V1.01 © KEBA 2021 Runtime license Device replacement (runtime license) 7) Click on <Serial number>_<Device name>.xml and save the file to the USB stick. 8) Remove the USB stick. Switching to the offline PC: 1) Connect the USB stick. 2) Select the file <Serial number of the device>_request.xml from the directory of the USB stick. 3) Click on Update license and download receipt. 4) Save the file <Serial number of the device>_receipt.xml to the USB stick. The name must not be changed. 5) Remove the USB stick. Switching to the online PC: 1) Connect the USB stick. 2) Select the file <Serial number of the device>_receipt.xml from the directory of the USB stick. 3) Click on Upload Receipt Now. 4) Confirm the dialog with OK. The entered license has been successfully transferred to a new device. Operating instructions V1.01 17 © KEBA 2021 License status and license overview Runtime license 4 License status and license overview Single-user licences The status of a software license can be queried by clicking the icon in the task bar. Furthermore, a licensing overview can be called up using the link to the WebAdmin. In the License monitor tab, the license number and the number of assigned and available licenses are displayed. A license overview of all licenses and corresponding validity periods is located in the Container tab. Runtime licenses In order to query the status of a hardware license (runtime license), the device has to be accessed via "DevAdmin". In the Licensing Overview tab, an overview of all licenses and their validity periods as well as the license type is shown. 18 Operating instructions V1.01 © KEBA 2021 Runtime license Index Index Operating instructions V1.01 19 © KEBA 2021 Index Runtime license 20 Operating instructions V1.01 © KEBA 2021