# CGI Studio Installation

Unzip the delivered zip file to the desired installation root directory. The installation root directory &lt;installation-path&gt;/CGI-Studio\_&lt;version\_number&gt;\_&lt;package\_type&gt; is further referenced in this document as &lt;cgi-studio-root&gt;.

---

#### HASP License Activation  


<p class="callout info">Note that the HASP license applies only to the Enterprise Edition.</p>

For a **Dongle** or **client-side Network License**, the following installations steps are required:

1. Execute instlic.cmd after unziping hasp\_installer.zip delivered within &lt;cgi-studio-root&gt;/cgi\_studio\_3psw/bin/HASP. This will install the HASP License software driver.
2. Insert the dongle to a USB port.
3. Invoke SceneComposer or other protected software from the CGI Studio installation directory to prove a successful HASP installation.

<p class="callout info">In Windows 10 environments, the license driver is automatically installed by simply inserting the dongle on a USB port the first time.   
Local admin rights are required to install the HASP driver.  
</p>

For a **Software License** (time-limited trial license), please perform the following installation steps:

1. Execute instlic.cmd delivered by CGI Studio Customer Support. This will install the HASP License software driver.
2. Access http://localhost:1947 via your browser and select 'Update/Attach' in the left menu
3. Click 'Browse ..." and select the according .v2c file, which has been sent to you by customer support; confirm with 'Apply File' button.
4. Invoke SceneComposer or other protected software from the CGI Studio installation directory. The software license will be active for a certain period of time as agreed in your specific license agreement.

<p class="callout info">Take care to call HASP installation files from a local directory. There are known issues related to installing licenses from a network drive.</p>

For HASP license server installation and configuration for floating licenses of CGI Studio.

- check the information available in the <span style="color: rgb(230,126,35);">[CGI Studio FAQ](https://forum.cgistudio.at/viewtopic.php?f=28&t=2622)</span> in the Candera Lighthouse.
- or contact Candera support

---

#### Running SceneComposer and Player  


Refer to [<span style="color: rgb(230,126,35);">Starting SceneComposer</span>](https://doc316en.candera.eu/link/8#bkmrk-page-title) for options as how to start SceneComposer.

To load a SceneComposer asset in the Player demo application on Windows host simulation, execute

- &lt;cgi-studio-root&gt;/bin/Player/CGIPanel.exe

For instructions as how to build an own version of the Player demo application, please refer to section CGI Studio Build System.

---

#### HASP License Updates  


<p class="callout info">Note that the HASP license applies only to the Enterprise Edition.</p>

To perform an upgrade of your dongle or network license, the following steps are required:

**1. Create a HASP C2V file and send to Candera GmbH**

- Execute licenseupdate.exe delivered by CGI Studio Customer Support on a PC having HASP driver installed.
- Connect one dongle to the machine.
- Press the "Collect Information" button in the HASP license update tool.
- In case the HASP license update tool asks for a license, select "HASP HL license" (HL stands for hardware license).
- Save the file with current date and dongle name. Example: "20160131\_Max\_H00052.c2v"
- Connect the next dongle and proceed like above.

**2. Apply HASP V2C file received from Candera GmbH**

- Execute licenseupdate.exe delivered by CGI Studio Customer Support.
- Connect one dongle to the machine.
- Press the button "..." and select the received V2C file for the connected dongle.   
    Example: "HaspUpdate\_20130131\_20230131\_Max\_H00052.v2c"
- Press the button "Apply Update"
- Connect the next dongle and proceed like above.

<p class="callout info">In some cases, it is required to format the dongle for updating the license.  
 When you apply an update file that formats the dongle, a new c2v file is generated by the license-update-tool.   
 This new c2v file needs to be transmitted to [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html) GmbH again.   
 [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html) GmbH will return another update v2c file. After applying this file, the final license is installed. </p>

---

#### Running CGI Studio Android Evaluation Package on Target  


The release contains two ready-made Android installer packages with file extension APK (which stands for Android Package Kit) named:

- CourierSampleApp.apk - found in cgi\_studio\_apps\\References\\Android\\CourierSampleApp
- CGIPlayerLauncher.apk - found in: cgi\_studio\_apps\\References\\Android\\AndroidCgiPlayerLauncher

<p class="callout info">There's no need to individually compile binaries for your Android device. An Android installer package can be run by copying it to the device and opening it with a local file manager.</p>

The CourierSampleApp application is used to run the specific CGI-Studio Asset, generated from the Solution file found in: cgi\_studio\_courier\_apps\\src\\CourierSampleApp\\SCSolution\\Android.   
It should be generated as "AssetLibCff\_CourierSampleApp.bin" and placed in the /sdcard location in the target device.

The CGIPlayerLauncher application is a generic player application that will play a number of CGI-Studio Sample Assets.   
Those can be placed in /sdcard and in any subfolder below /sdcard and can conveniently be run from a selection list after starting the CGIPlayerLauncher application.

---