This appendix includes information Exterro product licenses, Virtual CodeMeter activation, Network License Server, and API Key configurations.

Exterro products require a licensing security device that communicates with the program to verify the existence of a current license.

You must install the security device software and drivers before you can manage licenses with License Manager. 

This section explains installing and using the CodeMeter Runtime software and the License Manager.

Exterro products require a licensing security device that communicates with the program to verify the existence of a current license. The device is a WIBU-SYSTEMS (Wibu) CodeMeter (CmStick). This USB device requires specific software to be installed prior to connecting the devices and running your Exterro products. 

You will need the WIBU-SYSTEMS CodeMeter Runtime software with a WIBU-SYSTEMS CodeMeter (CmStick), either the physical USB device, or the Virtual device.

Store the CmStick or dongle in a secure location when it is not in use.

Installing the CodeMeter Runtime Software

When you purchase a product, Exterro provides a USB CmStick with the product package. To use the CmStick, you must first install the CodeMeter Runtime software, either from the shipping disc or from the setup file downloaded from the Exterro website.

Note: The CodeMeter software is automatically installed as part of the FTK suite.

To download the CodeMeter installer from the Exterro website:

1. Go to the Exterro download page at: http://www.Exterro.com/product-download.
2. On the download page, click CodeMeter.
3. Click Download Page.
4. Click Download Now.
5. Save the installation file to your download directory or other temporary directory on your drive.

To install CodeMeter: 

1. Launch the installer from the download by doing the following:
   • Navigate to the CodeMeter installation folder (“\{F5F91CCC-5315-49F7-8849-AE1673C65222}”), and double-click the installation file.
2. Wait for the Preparing to Install processes to complete.
3. In the Welcome dialog, click Next.
4. Read and accept the License Agreement
5. Enter User Information.
6. Click Next.
7. Select the features you want to install.
8. Click Next > Install > Finish.
9. Click OK.
    

CodeMeter Error

If you are not using NLS for your security device configuration, after clicking No, you will see the following additional message.

To remedy, click OK, then install the correct CodeMeter Runtime software, and connect the CmStick or run License Manager to generate your Virtual CmStick. Then, restart FTK.

License Manager lets you manage product and license subscriptions using a security device or device packet file.

You can access the License Manager installer from the Web or from the FTK installer.

To download the License Manager installer from the Exterro website:

1. Go to the Exterro download page at: http://www.Exterro.com/product-download.
2. On the download page, click License Manager.
3. Click Download Page.
4. Click Download Now.
5. Save the installation file to your download directory or other temporary directory on your drive.

 To install License Manager: 

1. Navigate to the License Manager installation folder (“\{6F8C49D6-8EDC-4F06-9348-2E6EC0798963}”), and double-click the installation file.
2. Wait for the Preparing to Install processes to complete.
3. Click Next on the Welcome screen 
4. Read and accept the License Agreement.
5. Click Next.
6. Accept the default destination folder, or select a different one. 
7. Click Next.
8. In the Ready to Install the Program dialog, click Back to review or change any of the installation settings. When you are ready to continue, click Install.
9. Wait while the installation completes.
10. If you want to launch License Manager after completing the installation, mark the Launch AccessData License Manager check box.
11. Select the Launch AccessData License Manager check box to run the program upon finishing the setup. The next section describes how to run License Manager later.
12. Click Finish to finalize the installation and close the wizard.

To launch License Manager:

 When starting, License Manager reads licensing and subscription information from the installed and connected WIBU-SYSTEMS CodeMeter Stick, or Keylok dongle.

Note: If using a Keylok dongle, and License Manager either does not open or displays the message, “Device Not Found”

1. Verify the correct dongle driver is installed on your computer.
2. With the dongle connected, check in Windows Device Manager to make sure the device is recognized. If it has an error indicator, right click on the device and choose Uninstall.
3. Remove the dongle after the device has been uninstalled.
4. Reboot your computer.
5. After the reboot is complete, and all startup processes have finished running, connect the dongle.
6. Wait for Windows to run the Add New Hardware wizard. If you already have the right dongle drivers installed, do not browse the internet, choose, “No, not this time.”
7. Click Next to continue.
8. On the next options screen, choose, “Install the software automatically (Recommended)
9. Click Next to continue.
10. When the installation of the dongle device is complete, click Finish to close the wizard.
11. You still need the CodeMeter software installed, but will not need a CodeMeter Stick to run License Manager.

Note: If using a CodeMeter Stick, and License Manager either does not open or displays the message, “Device Not Found”.

    12. Make sure the CodeMeter Runtime 4.20b software is installed. It is available at www.Exterro.com/support.

• Click Downloads and browse to the product. 
• Click on the download link. You can Run the product from the Website, or Save the file locally and run it from your PC. 
• Once the CodeMeter Runtime software is installed and running, you will see a gray icon in your system tray. 

    13. Make sure the CodeMeter Stick is connected to the USB port.

If the CodeMeter Stick is not connected, License Manager still lets you to manage licenses using a security device packet file if you have exported and saved the file previously.

To open License Manager without a CodeMeter Stick installed:

License Manager displays the message, “Device not Found”.

Note: Although you can run License Manager using a packet file, Exterro products will not run with a packet file alone. You must have the CmStick or dongle connected to the computer to run Exterro products that require a license.

License Manager provides the tools necessary for managing Exterro product licenses on a WIBU-

SYSTEMS CodeMeter Stick security device, a Keylok dongle, a Virtual Dongle, or in a security device packet file. 

License Manager displays license information, allows you to add licenses to or remove existing licenses from a dongle or CmStick. License Manager, and can also be used to export a security device packet file. Packet files can be saved and reloaded into License Manager, or sent via email to Exterro support. 

In addition, you can use License Manager to check for product updates and in some cases download the latest product versions.

License Manager displays CodeMeter Stick information (including packet version and serial number) and licensing information for all Exterro products. The Purchase Licenses button connects directly to the Exterro website and allows you to browse the site for information about products you may wish to purchase. Contact Exterro by phone to speak with a Sales Representative for answers to product questions, and to purchase products and renew licenses and subscriptions.

The License Manager Interface

The License Manager interface consists of the following two tabs that organize the options in the License Manager window

• Installed Components 
• Licenses

Installed Components Tab

The Installed Components tab lists the Exterro programs installed on the machine. The Installed Components tab is displayed in the following figure.

The following information is displayed on the Installed Components tab:

The following buttons provide additional functionality from the Installed Components tab:

Use the Installed Components tab to manage your Exterro products and stay up to date on new releases.

Licenses Tab

The Licenses tab displays CodeMeter Stick information for the current security device packet file and licensing information for Exterro products available to the owner of the CodeMeter Stick, as displayed in the following figure.

The Licenses tab provides the following information:

License Manager Licenses Tab Features:

License Management Options:

The following license management actions can be performed using buttons found on the License tab:

Opening and Saving Dongle Packet Files

You can open or save dongle packet files using License Manager. When started, License Manager attempts to read licensing and subscription information from the dongle. If you do not have a dongle installed, License Manager lets you browse to open a dongle packet file. You must have already created and saved a dongle packet file to be able to browse to and open it.

To save a security device packet file:

1. Click the Licenses tab, then under License Packets, click Save to File. 
2. Browse to the desired folder and accept the default name of the .PKT file; then click Save.

To open a security device packet file:

1. Select the Licenses tab.
2. Under License Packets, click Open Packet File.
3. Browse for a dongle packet file to open. Select the file and click Open.

Adding and Removing Product Licenses

On a computer with an Internet connection, License Manager lets you add available product licenses to, or remove them from, a dongle.

To move a product license from one dongle to another dongle, first remove the product license from the first dongle. You must release that dongle, and connect the second dongle before continuing. When the second dongle is connected and recognized by Windows and License Manager, click on the Licenses tab to add the product license to the second dongle.

Removing a License

To remove (unassociate or unbind) a product license:

1. From the Licenses tab, mark the program license to remove. 
   • This action activates the Remove License button below the Program list box. 
2. Click Remove License to connect your machine to the Exterro License Server through the internet.
3. When you are prompted to confirm the removal of the selected licenses from the device, click Yes to continue, or No to cancel.
4. Several screens appear indicating the connection and activity on the License Server, and when the license removal is complete, the following screen appears.
5. Click OK to close the message box. 

Note:     Another internet browser screen appears from License Manager with a message that says, “The removal of your licenses from Security Device was successful!” You may close this box at any time.

Adding a License

To add a new or released license:

You will see the newly added license in the License Options list.

Adding and Removing Product Licenses Remotely

While License Manager requires an Internet connection to use some features, you can add or remove licenses from a dongle packet file for a dongle that resides on a computer, such as a forensic lab computer, that does not have an Internet connection. 

If you cannot connect to the Internet, the easiest way to move licenses from one dongle to another is to physically move the dongle to a computer with an Internet connection, add or remove product licenses as necessary using License Manager, and then physically move the dongle back to the original computer. However, if you cannot move the dongle—due to organization policies or a need for forensic soundness—then transfer the packet files and update files remotely.

Adding a License Remotely

To remotely add (associate or bind) a product license:

1. On the computer where the security device resides:

1. Run License Manager.
2. From the Licenses tab, click Reload from Device to read the dongle license information.
3. Click Save to File to save the dongle packet file to the local machine.

        2. Copy the dongle packet file to a computer with an Internet connection.

        3. On the computer with an Internet connection:

1. Remove any attached security device.
2. Launch License Manager. You will see a notification, “No security device found”.
3. Click OK.
4. An “Open” dialog box will display. Highlight the .PKT file, and click Open.
5. Click on the Licenses tab.
6. Click Add Existing License.
7. Complete the process to add a product license on the Website page.
8. Click Yes when the License Manager prompts, “Were you able to associate a new product with this dongle?”
9. When License Manager does not detect a dongle or the serial number of the dongle does not match the serial number in the dongle packet file, you are prompted to save the update file, [serial#].wibuCmRaU.
10. Save the update file to the local machine.

        4. After the update file is downloaded, copy the update file to the computer where the dongle resides:

        5. On the computer where the dongle resides:

1. Run the update file by double-clicking it. ([serial#].wibuCmRaU is an executable file.)
2. After an update file downloads and installs, click OK.
3. Run License Manager.
4. From the Licenses tab, click Reload from Device to verify the product license has been added to the dongle.
   

Removing a License Remotely

To remotely remove (unassociated, or unbind) a product license:

1. On the computer where the dongle resides:

1. Run License Manager.
2. From the Licenses tab, click Reload from Device to read the dongle license information.
3. Click Save to File to save the dongle packet file to the local machine.

        2. Copy the file to a computer with an Internet connection.

        3. On the computer with an Internet connection:

1. Launch License Manager. You will see a notification, “No security device found”.
2. Click OK.
3. An “Open” dialog box will display. Highlight the .PKT file, and click Open.
4. Click on the Licenses tab.
5. Mark the box for the product license you want to unassociate; then click Remove License.
6. When prompted to confirm the removal of the selected license from the dongle, click Yes.
7. When License Manager does not detect a dongle or the serial number of the dongle does not match the serial number in the dongle packet file, you are prompted save the update file.
8. Click Yes to save the update file to the local computer.
9. The Step 1 of 2 dialog details how to use the dongle packet file to remove the license from a dongle on another computer.
10. Save the update file to the local machine.

        4. After the update file is downloaded, copy the update file to the computer where the dongle resides.

        5. On the computer where the dongle resides:

1. Run the update file by double-clicking it. This runs the executable update file and copies the new information to the security device.
2. Run License Manager
3. On the Licenses tab, click Reload from Device in License Manager to read the security device and allow you to verify the product license is removed from the dongle.
4. Click Save to File to save the updated dongle packet file to the local machine.

Send a security device packet file only when specifically directed to do so by Exterro support.

To create a dongle packet file:

1. Run License Manager 
2. Click on the Licenses tab.
3. Click Load from Device.
4. Click Refresh Device if you need to get the latest info from AD’s license server.
5. Click Save to File, and note or specify the location for the saved file.
6. Attach the dongle packet file to an e-mail and send it to support@exterro.com 

A Virtual CodeMeter (VCM) allows the user to run licensed Exterro products without a physical CodeMeter device. A VCM can be created using AccessData License Manager, but requires the user to enter a Confirmation Code during the creation process.

• Contact your Exterro sales rep to order a VCM confirmation code.
• Install the CodeMeter Runtime 7.30 or newer verision. (available on the Wibu download page)
• Install the latest release of License Manager (available on the Exterro download page).
• The following steps are to be run on the system where you want to permanently attach the VCM. 

Note: Once created, the VCM cannot be moved to any other system.

To setup a virtual CodeMeter:

1. Unplug any Exterro dongles you currently have connected.
2. Launch License Manager.
3. Select Create A Local Virtual CMStick.
4. Click OK.
5. In the Confirmation Code Required dialog, enter your confirmation code.
6. Click OK.

AccessData License Manager will automatically synchronize with the License Server over the Internet. 

 Upon performing the above step, License Manager will create the VCM on the system. Once all the steps are performed, AccessData License Manager displays a serial number for the VCM on the Licenses tab and the VCM can now operate in a similar way to a hardware CodeMeter device.

You can setup a Virtual CodeMeter on a system that is not connected to the internet (offline). You must also have one machine that connects to the internet to perform certain steps. This section details what to do on which machine.

To perform these steps on the online system:

1. Unplug any Exterro dongles you currently have connected.
2. Launch License Manager.
3. Select Create Empty Virtual CMStick (offline).
4. Click OK.
5. The resulting dialog prompts you to save the *.wibucmrau file. Enter a name and path for the file, then click Save.
6. Transfer the *.wibucmrau to the Online system.

To perform these steps on the online system:

1. Unplug any Exterro dongles you currently have connected.
2. Launch License Manager.
3. Select Create Activation File (online).
4. Click OK.
5. In the Confirmation Code Required dialog, enter your confirmation code and click OK.

AccessData License Manager will automatically synchronize with the License Server over the internet. 

6. Data synchronized from the server will be written to the *.wibucmrau file. Click OK when the update completes.

7. Transfer *.wibucmrau back to the offline system.

To perform these steps on the offline system:

1. Unplug any Exterro dongles you currently have connected.
2. Launch License Manager.
3. Select Create Activate Virtual CMStick (offline).
4. Click OK.
5. The resulting dialog prompts you to browse to the location of the newly updated *.wibucmrau file. Locate the file, then click Open. License Manager creates the VCM on your system.
6. At this point, AccessData License Manager should now display a serial number for the VCM on the “Licenses” tab and the VCM can now operate in a similar way to a hardware CodeMeter device.

Q: How do I get a Virtual CodeMeter (VCM)?

A: Contact your Exterro product sales representative. They will provide you with a VCM confirmation code.

Q: How do VCMs work?

A: A VCM operates in almost exactly the same way as a hardware CodeMeter device, except that they exist as a file stored on the hard disk. During activation, the VCM file (named with a WBB extension) is tied to the hardware of the system using unique hardware identifiers. Those unique identifiers make VCMs non-portable. When AccessData License Manager is launched, it will automatically load the VCM and display its license information. From there, you can refresh, remove, add existing licenses, etc just the same you would with a hardware security device.

Q: Are VCMs supported on virtual machines (VM)?

A: No. Due to the fact that virtual machines are portable and VCMs are not, VCMs are not supported on virtual machines. Currently it is recommended to use Exterro Network License Service (NLS) to license systems running as virtual machines.  

Q: How can I “unplug” a VCM?

A: If you want to prevent License Manager from automatically loading the VCM you can "unplug" it by stopping the CodeMeter Runtime Service server and then moving (cut and paste) the WBB file to a new location (renaming the file does not suffice). By default the WBB file is located at:

32 bit systems:

C:\Program Files\CodeMeter\CmAct\

64 bit systems:

C:\Program Files (x86)\CodeMeter\CmAct\

Q: I have activated a VCM on my system, but now I need to activate it on a different system. What should I do?

A: Since a VCM is uniquely tied to the system on which it is activated, it cannot be moved to any other system. If you need to activate a VCM on a different system, you need to contact your Exterro Sales Representative.

Q: What if I need to reinstall Windows, format my drive, change my system's hardware, or back up my VCM in case of a disaster? Will the VCM still work?

A: The VCM can be backed up by simply copying the WBB file to a safe location. It can be restored by copying the WBB file to the CmAct folder. The VCM cannot be restored without a WBB file. If you do not have a backup of your WBB file, you will need to get a new confirmation code from your Exterro Sales Representative.

To generate an API authentication key, your CodeMeter License dongle must have the ADAPI sub-license (with current expiration date) applied as a license attribute of your AD FTK / Lab / Enterprise license. As long as this dongle is plugged into the machine when you launch the FTK.exe program, you will be able to generate API keys through the application. Typically, you will want to bind this key to the application administrator account so that the API key has access to all of the REST API calls.

How to generate an API key:

1. Insert the CodeMeter licensed for ADAPI to the Examiner system.
2. Launch FTK/Lab/Enterprise/QView

Note: QView requires users to obtain an API key using the Administration tab.

3. In the Case Management interface, select the Access API Key option from the Tools menu.

4. In the Access API Key Manager window, select the user account for whom you wish to generate an API key.

Note: Appropriate API related permissions will be granted to the selected user account once the API key is generated.

5. Click the Generate Key button.

6. The generated API key will populate in the key field.

To generate API key via FTK Central:

1. Navigate to FTK Central.
2. Follow the notation below, to access your API key.

<FTKCentralURL>/api/security/{userid}/getenterpriseapiguid

Note: Appropriate API related permissions will be granted to the selected user account once the API key is generated.