Difference between pages "Tutorials/Installation Help" and "Building License Installation - 4.0"

From ROBOTC API Guide
< Tutorials(Difference between pages)
Jump to: navigation, search
(Invalid Registration Code (Error Code 69))
 
 
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
+
=== Building License Installation - ROBOTC 4.0 ===
<yambe:breadcrumb self="Installation Help">Tutorials|Tutorials</yambe:breadcrumb>
+
{|
<br />
+
|-
 
+
|There is a special type of ROBOTC license called a Building License . These licenses do not require an online activation but rather have a unique building license file that must be installed with the software in order for ROBOTC to work properly. The building license file is stored on the ROBOTC Customer Service server and can be accessed by the end user at any time. To do so, you will need to:
{{toc}}
+
|-
<br />
+
|
 
+
* Download the latest version of ROBOTC
== Error 42 IPM Issues ==
+
* Install ROBOTC
{|width="740px"
+
* Download the building license file from the ROBOTC Customer Service page
 +
* Install and activate the building license file
 +
* Run ROBOTC as an administrator
 +
|-
 +
|<br />
 
|-
 
|-
|'''"Error 42 (IPM)"''' when launching ROBOTC after installing ROBOTC<br />
 
[[File:Error_42_IPM.gif]]
 
 
 
=== Solution ===
 
 
This error is caused when Windows XP or Windows VISTA does not have the appropriate rights to initialize the activation software. To fix this issue, you will need to run the application "As an Administrator." Once you have followed these steps once, you can use ROBOTC as a normal user (without Administrative Privileges) without issue.
 
 
 
==== Windows VISTA ====
 
[[File:Run_As_Administrator.gif]]<br />
 
Step 1: Right Click on the ROBOTC icon. Select "Run as Administrator"<br />
 
 
 
[[File:User_Account_Control.gif]]<br />
 
Step 2: Windows VISTA will prompt you to give Administrative Access to this application. Select "Allow" to continue.
 
 
ROBOTC should now open to the Licensing Screen. You will not have to repeat these steps again to use ROBOTC in the future.
 
 
 
==== Windows XP ====
 
[[File:Run_As_Dialog-XP.gif]]<br />
 
Step 1: Right Click on the ROBOTC icon. Select "Run as..."<br />
 
 
 
[[File:Run_As_User_Dialog_XP.gif]]<br />
 
Step 2. At the "Run As" dialog, select the "Following User" dialog and enter the user name and password of a user with administrative rights.
 
 
ROBOTC should now open to the Licensing Screen. You will not have to repeat these steps again to use ROBOTC in the future.
 
 
|}
 
|}
<br />
 
  
== Side-By-Side Error ==
+
=== Download the latest version of ROBOTC ==
{|width="740px"
+
{|
 +
|Before we start programming in ROBOTC, we need to first download and install the client. This can be done by navigating to ROBOTC's website ( http://www.robotc.net) and selecting the 'Downloads' tab.
 
|-
 
|-
|'''"Application Failed to Start: Side-by-Side" Error''' - ROBOTC will not open<br />
+
|1) From the ROBOTC website, select the individual robotics platform you wish to program on. If you want to use multiple platforms or accidentally download the wrong version, you can manually activate and choose another platform thorugh the ROBOTC program. When you get to the correct platform page, click on the 'Download ROBOTC for X version x.xx' to start the download process:  
[[File:Side_by_Side_Config_Error.gif]]
+
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Download_Firefox.png]]
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Download_IE.png]]
 +
|-
 +
|<br />
 +
|-
 +
|2) At this point click the 'Save' button to start downloading ROBOTC. You may get a warning pop-up from either Windows, your antivirus program, or both. This is to warn you that some programs downloaded from the internet can be malicious and to use care before running them; click allow to start the download.
 +
|-
 +
|<br />
 +
|}
  
 +
== Installing and Uninstalling ROBOTC ==
  
=== Solution ===
+
=== Installing ===
 +
{|
 +
|1) Once the program is done downloading, navigate to the Downloads folder on your computer and start the ROBOTC installer. You may have to right click on the installer and select the "Run as Administrator" depending on individual computer restrictions; ROBOTC must be installed with administrator privileges.
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Normal.png]]
 +
|-
 +
|<br />
 +
|-
  
If you have installed ROBOTC and tried to move the ROBOTC folder to another computer, you will recieve this error. This error is caused because the runtime engines ROBOTC is based off of need to be installed along with the application. If the runtime engines are not installed, you will recieve a "Side-by-Side configuration is incorrect" error.
+
|-
 
+
|2) Before you can proceed, you must read over and accept the End User License Agreement. If you agree to the End User Agreement, check the "I accept" and then the "Next" button to continue the installation.
This issue will also be caused if you are using ROBOTC from a network location without running the "Network Dependencies" on the computer attempting to use ROBOTC.
+
|-
 
+
|<br />
To fix this issue, you can do two things:
+
|-
#Re-install the latest version of ROBOTC
+
|[[File:Install_End_User.png]]
#Install the Network Dependencies pack which is found from the download section of the ROBOTC.net website.
+
|-
 +
|<br />
 +
|-
 +
|3) Next, select where you would like ROBOTC to install to. The default location is C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment.
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Select_Directory.png]]
 +
|-
 +
|<br />
 +
|-
 +
|4) The installer will ask you to confirm your settings. If everything looks correct, click "Install" to being the installation process. The installer will then begin copying files from the installer to your computer. Please wait until this is complete.<br />
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Install_Progress.png]]
 +
|-
 +
|<br />
 +
|-
 +
|5) The installer will inform you of when the installation is complete. Click the "Finish" button to complete your install.<br />
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Complete.png]]
 +
|-
 +
|<br />
 +
|-
 +
|6) Right-Click on the ROBOTC icon and select "Run as Administrator" to run ROBOTC as an administrator (assuming the user account has administrator privileges). You will only need to do this one time.<br />
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Run_Admin.png]]
 +
|-
 +
|<br />
 +
|-
 +
|Depending on which platform you are installing, ROBOTC may also install additional drivers unique to each platform. If for any reason the drivers are not downloaded and installed properly they can be downloaded and installed manually from the [http://www.robotc.net/download/ ROBOTC website.]
 
|}
 
|}
<br />
 
  
== Unable to Save File Error ==
 
{|width="740px"
 
|-
 
|'''"Unable to Save File" Error''' - ROBOTC will not install<br />
 
[[File:Cannot Install Network Install.gif]]
 
  
  
=== Solution ===
 
  
If the ROBOTC installer is "Unable to save file", this error means that ROBOTC does not have permission to write to a temporary installation directory inside of the Windows folder. The installer needs to opened with Administrator privileges.
+
{|
 
+
|'''1)''' Navigate to the [https://secure.softwarekey.com/solo/customers/Default.aspx ROBOTC Customer Service page] and log in using your Customer ID and Password (this information will be sent to you in a confirmation email after purchasing a ROBOTC Building License).
 
+
==== Windows VISTA ====
+
[[File:Run_as_admin_vista.gif]]<br />
+
Step 1: Right Click on the Installer icon. Select "Run as adminisrator".<br />
+
 
+
 
+
[[File:User_Account_Control.gif]]<br />
+
Step 2: Windows VISTA will prompt you to give Administrative Access to this application. Select "Allow" to continue.
+
 
+
Step 3: Follow the directions on the installer. ROBOTC should install successfully now.
+
 
+
 
+
==== Windows XP ====
+
[[File:run_as_admin_xp.gif]]<br />
+
Step 1: Right Click on the ROBOTC icon. Select "Run as..."<br />
+
 
+
 
+
[[File:Run_As_User_Dialog_XP.gif]]<br />
+
Step 2. At the "Run As" dialog, select the "Following User" dialog and enter the user name and password of a user with administrative rights.
+
 
+
Step 3: Follow the directions on the installer. ROBOTC should install successfully now.
+
|}
+
<br />
+
 
+
== Other Activation Issues ==
+
=== Could Not Communicate With License Server (Error Code 2) ===
+
{|width="740px"
+
 
|-
 
|-
|[[File:error2-nointernet.gif]]<br />
+
|<br />
''Error #2''<br />
+
'''Cause:''' Could Not Communicate With License Server<br />
+
'''Solution:''' Connect to the internet to the computer you are trying to activate, or follow these instructions on using the "Activate by Web."
+
|}
+
<br />
+
 
+
=== No Activations Left for this License (Error Code 7) ===
+
{|width="740px"
+
 
|-
 
|-
|[[File:error7-outoflicenses.gif]]<br />
+
|[[File:Building License Login.png]]<br />
''Error #7''<br />
+
'''Cause:''' The License ID you are trying to activate with has been activated on too many computers.<br />
+
'''Solution:''' Contact ROBOTC Support at support@robotc.net
+
|}
+
<br />
+
 
+
=== Firewall or Trouble Communicating with License Server (Error Code 13) ===
+
{|width="740px"
+
 
|-
 
|-
|[[File:No Internet Connection.gif]]<br />
+
|<br />
''Error #13''<br />
+
'''Cause:''' The license password is invalid or could not communicate with server.<br />
+
'''Solution:''' Check the LicenseID and Password. Connect to the internet to the computer you are trying to activate, or follow these instructions on using the "Activate by Web."
+
|}
+
<br />
+
 
+
=== Invalid Registration Code (Error Code 69) ===
+
{|width="740px"
+
 
|-
 
|-
|[[File:error69-bad_manual_activation.gif]]<br />
+
|'''2)''' Select the "Licenses and Activations" icon to view all of the licenses tied to that Customer ID.
''Error #69''<br />
+
'''Cause:''' Invalid "Web Activation" Registration Code.<br />
+
'''Solution:''' Make sure you have typed the generated code correctly, or follow the instructions on using the "Activate by Web" again.  
+
|}
+
<br />
+
 
+
=== Invalid License ID or Password (Error Code 100) ===
+
{|width="740px"
+
 
|-
 
|-
|[[File:error100-badlicense.gif]]<br />
+
|<br />
''Error #100''<br />
+
|-
'''Cause:''' Invalid "Web Activation" Registration Code.<br />
+
|[[File:Building License Select.png]]<br />
'''Solution:''' Make sure you have typed the generated code correctly, or follow the instructions on using the "Activate by Web" again.  
+
|-
|}
+
|<br />
<br />
+
|-
 
+
|'''3)''' Select the correct Building License File from the list of available licenses (in this example, a ROBOTC for VEX Robotics 4.0 Building License file).
=== All Other Errors ===
+
|-
{|width="740px"
+
|<br />
 +
|-
 +
|[[File:Building License Select2.png]]<br />
 +
|-
 +
|<br />
 +
|-
 +
|'''4)''' Click the 'Download License File' button to download the license file to your computer.
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Building License Download.png]]<br />
 +
|-
 +
|<br />
 +
|-
 +
|To activate ROBOTC with a building license, download and run the installer as normal. Once the program is installed, copy the building license file into the ROBOTC directory (typically C:/Program Files (x86)/Robomatter Inc/ROBOTC Developement Environment).  
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Building_License_Location.png]]
 +
|-
 +
|One of the advantages of building licenses is that they help make automated installs easy. To roll out ROBOTC to multiple computers using a building license, make sure the base image has ROBOTC installed and the building license files in the correct directory. As long as those two conditions are met, ROBOTC should be active on each computer the image is rolled out to with no futher action required.
 +
|-
 +
|<br />
 +
|-
 +
|There is, however, an exception. If ROBOTC is being run from a centralized network, each computer that needs to access ROBOTC must also install a Network Dependencies package (available from the ROBOTC downloads page). The building license file must also be properly installed on the network in order for networked computers to access ROBOTC.
 
|-
 
|-
|'''All Other Errors:''' Contact support@robotc.net
 
 
|}
 
|}
<br />
 

Revision as of 15:38, 14 May 2014

Building License Installation - ROBOTC 4.0

There is a special type of ROBOTC license called a Building License . These licenses do not require an online activation but rather have a unique building license file that must be installed with the software in order for ROBOTC to work properly. The building license file is stored on the ROBOTC Customer Service server and can be accessed by the end user at any time. To do so, you will need to:
  • Download the latest version of ROBOTC
  • Install ROBOTC
  • Download the building license file from the ROBOTC Customer Service page
  • Install and activate the building license file
  • Run ROBOTC as an administrator

= Download the latest version of ROBOTC

Before we start programming in ROBOTC, we need to first download and install the client. This can be done by navigating to ROBOTC's website ( http://www.robotc.net) and selecting the 'Downloads' tab.
1) From the ROBOTC website, select the individual robotics platform you wish to program on. If you want to use multiple platforms or accidentally download the wrong version, you can manually activate and choose another platform thorugh the ROBOTC program. When you get to the correct platform page, click on the 'Download ROBOTC for X version x.xx' to start the download process:

Install Download Firefox.png

Install Download IE.png

2) At this point click the 'Save' button to start downloading ROBOTC. You may get a warning pop-up from either Windows, your antivirus program, or both. This is to warn you that some programs downloaded from the internet can be malicious and to use care before running them; click allow to start the download.

Installing and Uninstalling ROBOTC

Installing

1) Once the program is done downloading, navigate to the Downloads folder on your computer and start the ROBOTC installer. You may have to right click on the installer and select the "Run as Administrator" depending on individual computer restrictions; ROBOTC must be installed with administrator privileges.

Install Normal.png

2) Before you can proceed, you must read over and accept the End User License Agreement. If you agree to the End User Agreement, check the "I accept" and then the "Next" button to continue the installation.

Install End User.png

3) Next, select where you would like ROBOTC to install to. The default location is C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment.

Install Select Directory.png

4) The installer will ask you to confirm your settings. If everything looks correct, click "Install" to being the installation process. The installer will then begin copying files from the installer to your computer. Please wait until this is complete.

Install Install Progress.png

5) The installer will inform you of when the installation is complete. Click the "Finish" button to complete your install.

Install Complete.png

6) Right-Click on the ROBOTC icon and select "Run as Administrator" to run ROBOTC as an administrator (assuming the user account has administrator privileges). You will only need to do this one time.

Install Run Admin.png

Depending on which platform you are installing, ROBOTC may also install additional drivers unique to each platform. If for any reason the drivers are not downloaded and installed properly they can be downloaded and installed manually from the ROBOTC website.



1) Navigate to the ROBOTC Customer Service page and log in using your Customer ID and Password (this information will be sent to you in a confirmation email after purchasing a ROBOTC Building License).

Building License Login.png

2) Select the "Licenses and Activations" icon to view all of the licenses tied to that Customer ID.

Building License Select.png

3) Select the correct Building License File from the list of available licenses (in this example, a ROBOTC for VEX Robotics 4.0 Building License file).

Building License Select2.png

4) Click the 'Download License File' button to download the license file to your computer.

Building License Download.png

To activate ROBOTC with a building license, download and run the installer as normal. Once the program is installed, copy the building license file into the ROBOTC directory (typically C:/Program Files (x86)/Robomatter Inc/ROBOTC Developement Environment).

Building License Location.png
One of the advantages of building licenses is that they help make automated installs easy. To roll out ROBOTC to multiple computers using a building license, make sure the base image has ROBOTC installed and the building license files in the correct directory. As long as those two conditions are met, ROBOTC should be active on each computer the image is rolled out to with no futher action required.

There is, however, an exception. If ROBOTC is being run from a centralized network, each computer that needs to access ROBOTC must also install a Network Dependencies package (available from the ROBOTC downloads page). The building license file must also be properly installed on the network in order for networked computers to access ROBOTC.