Software Installation Guide 2.4

Transcription

1 Software Installation Guide 2.4 Software Installation Guide μtca Edition i

2 Revision history Revision Date Comments 0.8 February 2013 New layout ready for revision 0.9 February 2013 Screenshots updated to Windows March 2013 Linguistic revision 2.0 May 2014 Add Fedora and Ubuntu procedure 2.1 May 2014 Reformatted the document 2.2 June 2014 Changed chapter 3 name to match other chapter names Release November 2014 Changed offline license validation IP address Release February 2015 Corrected bad links to the Performing the installation section in section and ii

3 Software Installation Guide 2.4 Table of Contents 1 Installation on Windows Requirements for ADP Software Tools - TCA Edition System Requirements Software Requirements Installing/Modifying/Removing ADP Software Tools - TCA Edition Software Updates Firmware Updates MBDK Software Lock Performing the Installation Activating ADP Software Tools Online Activating ADP Software Tools Offline Removing ADP Software Tools Installing a New Version of ADP Software Tools Activating a New Software Component Updating ADP Software Tools Offline ADP Software Tools - TCA Edition Utilities Updating MATLAB Paths Accessing the ADP Support Script Accessing the ADP Software Tools Documentation Installation on Linux Fedora Requirements for ADP Software Tools - TCA Edition Host Computer µtca Chassis Host Installing ADP Software Tools - TCA Edition Preparing the system Performing the Installation Configuring the Environment Removing ADP Software Tools - TCA Edition Installation on Linux Ubuntu LTS Requirements for ADP Software Tools - TCA Edition Host Computer µtca Chassis Host Installing ADP Software Tools - TCA Edition Preparing the system Performing the Installation Configuring the Environment Removing ADP Software Tools - TCA Edition iii

4

5 Software Installation Guide Installation on Windows 7 This chapter describes how to install, configure, and update Nutaq s ADP Software Tools - TCA Edition on a computer running the Windows 7 operating system. A system properly set up to work with the Nutaq development tools allows FPGA and host development for the Perseus platform. For operating details, please refer to the documentation library accompanying the product. 1.1 Requirements for ADP Software Tools - TCA Edition This chapter presents the requirements that must be met by the system in order to use ADP Software Tools System Requirements Hardware A PC with the following characteristics: Processor of 64 bits ( 64), 1 GHz or faster 10 GB of RAM (64 bits) or more Free HDD space 50 GB or more Operating System Windows 7, 64 bits Software Requirements Only the software versions presented below are supported. Essential BSDK Development Software ISE Design Suite 13.4 Embedded Edition or System Edition (essential for FPGA development) TFTP software Essential MBDK Development Software MATLAB R2011B (64-bit installation) o o Signal Processing Toolbox MATLAB Simulink Xilinx ISE Design Suite 13.4 System Edition (essential for FPGA development) o Xilinx System Generator 13.4 Note: Model-based design software is only essential to those who purchase the Nutaq model-based design kit (MBDK). Optional Development Software The following software is only necessary for host BSDK development on Windows 7. 1

6 Microsoft Visual Studio 2008 with Service Pack 1 Before installing Nutaq software, you must install all non-nutaq software. Refer to the documentation relative to each third party installation for details. Important: If you are using MBDK, install MATLAB before Xilinx ISE Design Suite 13.4 System Edition. WARNING Nutaq software cannot function when MATLAB is installed in a folder containing the space character, for example, Program Files. 1.2 Installing/Modifying/Removing ADP Software Tools - TCA Edition Software Updates Periodically visit your product page at to verify whether there are updates for Nutaq software. Note: If you are unsure of the software version you are using, check the release note of the installation or the documentation on the CD-ROM that came with the product Firmware Updates Every time an installation of a new version of the Nutaq ADP Software Tools is performed, and before proceeding with anything involving a Perseus hardware, we recommend to verify that the Linux firmware contained in the flash memory of the Perseus is compatible and to update it if needed. Please refer to the Perseus Firmware Update document for details about the firmware update operation MBDK Software Lock The model-based part of Nutaq ADP Software Tools is protected by a locking mechanism. To move the original installation to a different computer, the ADP Software Tools installed on the original computer must first be completely removed. Only then, an installation on another computer can take place. Note: A licence can be used up to three times Performing the Installation 1. If using the CD-ROM accompanying a purchased product to perform the installation, insert it in the optical drive of the computer. The installation wizard starts. Go to step 3. Note: If the installation wizard does not start automatically, double-click the application file (.exe) in the root folder of the Nutaq software and documentation CD-ROM. 2. If using an installation application downloaded from Nutaq s Web site to perform the installation, double-click the application file (.exe) that was saved on the computer. 3. Click Next. 4. In the License agreement dialog box, carefully read the Nutaq license agreement, select the I accept the terms of the license agreement option, and click Next. 2

7 Software Installation Guide Read the Open SSL license agreement carefully, select the I accept the terms of the license agreement option, and click Next. 6. In the Information dialog box, type your name, the name of the organization, the software license number, and click Next. Note: To get a license number, visit and fill a support request form, specifying the need for a license number. 7. If the installation is performed on a system connected to the Internet, select the Online activation option, click Next, and then proceed to the Activating the ADP Software Tools Online section. Note: You may have to ask the network administrator to unlock the communication port If the installation is performed on a system that is not connected to the Internet, select the Offline activation option, click Next, and then proceed to the Activating the ADP Software Tools Offline section Activating ADP Software Tools Online When the Online activation option has been selected in the Performing the Installation section, a request is sent to the Nutaq activation server and a prompt appears asking to confirm that the installation is to be performed on the current system. 3

8 Note: The license is linked to the system where it is installed. Take special care to perform the installation of the software on the correct system before proceeding. Click Yes and proceed to step 7 of the Activating the ADP Software Tools Offline section Activating ADP Software Tools Offline When the Offline activation option has been selected in the Performing the Installation section, a prompt appears asking to confirm that the installation is to be performed on the current system. Note: The license is linked to the system where it is installed. Take special care to perform the installation of the software on the correct system before proceeding. 1. Click Yes. 2. Select the I need a license.ans file option and click Next. A license.req file is created on the computer desktop. 3. Transfer the license.req file created on the desktop to a computer with an Internet access and go to the web address. 4. Click the Browse button, select the license.req file, and click Upload to server. 5. Click Download and save the license.ans file to the computer. 6. Transfer the license.ans file to the system where the ADP Software Tools are to be installed. 7. In the Select a license file dialog box, click the Browse button to select the license.ans file and click Next. 4

9 Software Installation Guide In the Software selection dialog box, check the boxes of all the features to install, and click Next. The installation wizard verifies if the third-party software requirements are met on the system. WARNING Nutaq software tools are installed even if third-party software requirements are not met. However, if one or more requirements are not met, ADP Software Tools may not perform as expected. It is recommended to correct any issues before proceeding. 9. Click Next. 10. In the Specify installation folder dialog box, verify that the correct folder is selected and click Next. 5

10 11. In the Optional configurations dialog box, check the Configure MATLAB box to manage automatic configuration of MATLAB for use with the ADP Software Tools. Checking or clearing the box will enable or disable the automatic configuration. 12. Click Next. 13. In the Installation overview dialog box, confirm the modifications that will be performed on the system and click Next. 14. Click Install. The installation process starts. 6

11 Software Installation Guide When the installation is complete, click Finish. If prompted to restart the computer, please do so. The installation of ADP Software Tools is now complete Removing ADP Software Tools Before updating or moving ADP Software Tools to a different computer, It must first be removed from the computer on which it is currently installed. To remove the ADP Software Tools, perform the following steps: 1. Run the installer. OR In Control Panel> Programs and Features, click ADP Software Tools - MicroTCA Edition. 2. In the dialog that opens, select the Move/Remove option and click Next. 3. On the dialog box asking to confirm the complete removal of the software, click Yes. 4. If the system on which the removal is performed is connected to the Internet, select the Online mode option, click Next, and then proceed to step If the system on which the removal is performed is not connected to the Internet, select the Offline mode option and click Next. 7

12 6. In the Offline activation dialog box, select the I need a license.ans file option and click Next. A license.req file is created on the computer desktop. 7. Transfer the license.req file to a computer with an Internet access, and go to the address. 8. Click the Browse button, select the license.req file, and click Upload to server. 9. Click Download, and then save the license.ans file to the computer. 10. Transfer the license.ans file to the system where the ADP Software Tools are to be removed. 11. In the Select a license file dialog box, click the Browse button to select the license.ans file and click Next. The deactivation process starts. 12. When the deactivation is complete, click Finish. If you are prompted to restart your computer, please do so Installing a New Version of ADP Software Tools Make sure that you follow the procedure presented in the Removing the ADP Software Tools section before proceeding with the next steps. To install a new version of ADP Software Tools: 1. Download the latest ADP Software Tools update from the product page on the Nutaq Web site at 2. If necessary, transfer the application file that you have downloaded to the system where you want ADP Software Tools installed. 3. Double-click the application file and then proceed to step 3 in the Performing the Installation section. 8

13 Software Installation Guide Activating a New Software Component This procedure must be performed whenever you buy new software components for your tools. 1. In the Control Panel dialog box, click Add or Remove Programs. 2. In the Add or Remove Programs dialog box, select ADP Software Tools - μtca Edition and click Change. 3. In the dialog box that opens, select the Update option, and click Next. 4. If the system where you are updating ADP Software Tools is not connected to the internet, select the Offline mode option, click Next, and then proceed to the Updating the ADP Software Tools Offline section. 5. If the system where you are updating ADP Software Tools is connected to the internet, select the Online mode option, click Next, and then proceed to step 7 in the Updating the ADP Software Tools Offline section Updating ADP Software Tools Offline 1. Select the I need a license.ans file option and click Next. 9

14 A license.req file is created on the computer desktop. 2. Transfer the license.req file to a computer with an internet access and go to the web address. 3. Click the Browse button, select the license.req file, and click Upload to server. 4. Click Download and save the license.ans file to your computer. 5. Transfer the license.ans file to the system where you want to update ADP Software Tools. 6. In the Select a license file dialog box, click the Browse button to select the license.ans file and click Next. 7. In the Software selection dialog box, in the list, select the check box of all the features you want to install, and click Next. 10

15 Software Installation Guide 2.4 The installation wizard verifies whether your system meets third-party software requirements. WARNING ADP Software Tools is updated even if you do not meet third-party software requirements. However, if one or more requirements are not met, ADP Software Tools may not perform as expected. It is recommended to correct any issues before proceeding. 8. Click Next. 9. In the Installation overview dialog box, confirm the modifications to be made to the system and click Next. The update process starts. 11

16 10. When the update is complete, click Finish. If prompted to restart the computer, please do so. The removal of ADP Software Tools is now complete. 1.3 ADP Software Tools - TCA Edition Utilities Updating MATLAB Paths 1. Close all MATLAB applications. 2. To start the MATLAB update script, on the Windows Start menu, point to All Programs> Nutaq> ADP6 MicroTCA Edition, and click Setup MATLAB. This automatically starts MATLAB and adds paths and plug-ins necessary to ADP Software Tools. A log file is automatically created in the ADPROOT directory Accessing the ADP Support Script Nutaq ADP Software Tools come with a support script that automatically creates a log containing information useful to Nutaq s technical support personnel. To access the support script: On the Windows Start menu, point to point to All Programs> Nutaq> ADP6 MicroTCA Edition, and click Launch support script. The result is a zip file located in the ADPROOT \folder. Attach this zip file to the when contacting Nutaq s support Accessing the ADP Software Tools Documentation ADP Software Tools come with a library of documents that is installed on the hard disk of the computer when you install Nutaq software. All the documents are in PDF format. Adobe Reader must be installed on the computer to view them. You can download the latest Adobe Reader from the Adobe Systems Web site ( To access the documentation: On the Windows Start menu, point to All Programs> Nutaq> ADP6 MicroTCA Edition, and click Documentation. Windows Explorer opens the folder containing the documentation. 12

17 Software Installation Guide Installation on Linux Fedora 20 This chapter describes how to install Nutaq s ADP Software Tools - TCA Edition on a remote computer or on a TCA CPU blade running the Fedora 20 operating system. The Linux installation contains the tools and drivers necessary for Linux-based host development. 2.1 Requirements for ADP Software Tools - TCA Edition This chapter presents the requirements that must be met by the system on which the ADP Software Tools are installed Host Computer Hardware x86 or x86_x64 architecture 1 GB RAM Operating System Fedora µtca Chassis Host Hardware 16 GB USB stick Analog display USB hub equipped with four ports or more USB keyboard USB mouse USB optical disc drive Operating System Fedora Installing ADP Software Tools - TCA Edition Preparing the system 1. Make sure the user account used has administrator rights and can use the command sudo. 2. Update the system prior to the installation using the user interface tools or through a terminal with the command: sudo yum update 13

18 3. Install the standard development packages on the system using the user interface tools or through terminal with the commands: sudo yum groupinstall development-libs development-tools sudo yum install libpcap-devel sudo yum install libtool Performing the Installation Use one of the following commands to install the package depending on the architecture of the platform: sudo rpm -Uhv nutaq-adp{x}-microtca-sdk-w.x.y.z.fc17.i686.rpm sudo rpm -Uhv nutaq-adp{x}-microtca-sdk-w.x.y.z.fc17.x86_64.rpm The uname a command can be used to query the architecture of a system. Using this command will yield in one of the two following results: For an i686 system: Linux localhost.localdomain fc20.i686 #1 SMP Fri Dec 3 12:35:42 UTC 2010 i686 i686 i386 GNU/Linux For a x86_64 system: Linux localhost.localdomain fc20.x86_64 #1 SMP Fri Dec 3 12:19:41 UTC 2010 x86_64 x86_64 x86_64 GNU/Linux Configuring the Environment 1. Modify the installation folder owner with: sudo chown -R {username} //opt/nutaq 2. Modify the installation folder group with: sudo chgrp -R {username} //opt/nutaq 3. Modify the installation folder permissions with: sudo chmod -R +x //opt/nutaq 4. Modify the cache folder permissions with: sudo chown -R {username} //var/cache 2.3 Removing ADP Software Tools - TCA Edition To uninstall ADP Software tools, simply execute the following command as super user in a terminal: sudo rpm -e nutaq-adp6-micritca-sdk 14

19 Software Installation Guide Installation on Linux Ubuntu LTS This chapter describes how to install Nutaq s ADP Software Tools - TCA Edition on a remote computer or on a TCA CPU blade running the Ubuntu operating system. The Linux installation contains the tools and drivers necessary for Linux-based host development. 3.1 Requirements for ADP Software Tools - TCA Edition This chapter presents the requirements that must be met by the system on which the ADP Software Tools are installed Host Computer Hardware x86 or x86_x64 architecture 1 GB RAM Operating System Ubuntu µtca Chassis Host Hardware 16 GB USB stick Analog display USB hub equipped with four ports or more USB keyboard USB mouse USB optical disc drive Operating System Ubuntu Installing ADP Software Tools - TCA Edition Preparing the system 1. Make sure the user account used has administrator rights and can use the command sudo. 2. Update the system prior to the installation using the user interface tools or through a terminal with the command: 15

20 sudo apt-get upgrade 3. Install the standard development packages on the system using the user interface tools or through terminal with the commands: sudo apt-get install build-essential sudo apt-get install libpcap-dev sudo apt-get install libtool Performing the Installation Use one of the following commands to install the package depending on the architecture of the platform: sudo dpkg -i nutaq-adp{x}-microtca-sdk-w.x.y.z.i686.deb sudo dpkg -i nutaq-adp{x}-microtca-sdk-w.x.y.z.x86_64.deb The getconf LONG_BIT command can be used to query the architecture of a system. Using this command will yield in one of the two following results: For an i686 system: 32 For a x86_64 system: Configuring the Environment 1. Modify the installation folder owner with: sudo chown -R {username} //opt/nutaq 2. Modify the installation folder group with: sudo chgrp -R {username} //opt/nutaq 3. Modify the installation folder permissions with: sudo chmod -R +x //opt/nutaq 4. Modify the cache folder permissions with: sudo chown -R {username} //var/cache 3.3 Removing ADP Software Tools - TCA Edition To uninstall ADP Software tools simply run the command: sudo dpkg --purge nutaq-adp6-micritca-sdk 16