SSooffttwwaarree IInnssttaallllaattiioonn GGuuiiddee uTCA edition...Software Installation Guide 2.4 3 5. Read the Open SSL license agreement carefully, select the I accept the terms

Software Installation Guide 2.4

i

SSooffttwwaarree

IInnssttaallllaattiioonn GGuuiiddee

μμTTCCAA EEddiittiioonn

ii

Revision history

Revision Date Comments

0.8 February 2013 New layout – ready for revision

0.9 February 2013 Screenshots updated to Windows 7

1.0 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 6.5

2.3 November 2014 Changed offline license validation IP address

Release 6.6

2.4 February 2015 Corrected bad links to the “Performing the installation” section in section 1.2.5 and 1.2.6


iii

Table of Contents

1 Installation on Windows 7 ............................................................................................... 1 1.1 Requirements for ADP Software Tools - TCA Edition ................................................................................. 1

1.1.1 System Requirements ........................................................................................................................ 1 1.1.2 Software Requirements ..................................................................................................................... 1

1.2 Installing/Modifying/Removing ADP Software Tools - TCA Edition ............................................................ 2 1.2.1 Software Updates .............................................................................................................................. 2 1.2.2 Firmware Updates ............................................................................................................................. 2 1.2.3 MBDK Software Lock ......................................................................................................................... 2 1.2.4 Performing the Installation ................................................................................................................ 2 1.2.5 Activating ADP Software Tools Online ............................................................................................... 3 1.2.6 Activating ADP Software Tools Offline .............................................................................................. 4 1.2.7 Removing ADP Software Tools .......................................................................................................... 7 1.2.8 Installing a New Version of ADP Software Tools ............................................................................... 8 1.2.9 Activating a New Software Component ............................................................................................ 9 1.2.10 Updating ADP Software Tools Offline ................................................................................................ 9

1.3 ADP Software Tools - TCA Edition Utilities ............................................................................................... 12 1.3.1 Updating MATLAB Paths .................................................................................................................. 12 1.3.2 Accessing the ADP Support Script ................................................................................................... 12 1.3.3 Accessing the ADP Software Tools Documentation ........................................................................ 12

2 Installation on Linux Fedora 20 ...................................................................................... 13 2.1 Requirements for ADP Software Tools - TCA Edition ............................................................................... 13

2.1.1 Host Computer ................................................................................................................................ 13 2.1.2 µTCA Chassis Host............................................................................................................................ 13

2.2 Installing ADP Software Tools - TCA Edition ............................................................................................. 13 2.2.1 Preparing the system ....................................................................................................................... 13 2.2.2 Performing the Installation .............................................................................................................. 14 2.2.3 Configuring the Environment .......................................................................................................... 14

2.3 Removing ADP Software Tools - TCA Edition ............................................................................................ 14

3 Installation on Linux Ubuntu 12.04.4 LTS........................................................................ 15 3.1 Requirements for ADP Software Tools - TCA Edition ............................................................................... 15

3.1.1 Host Computer ................................................................................................................................ 15 3.1.2 µTCA Chassis Host............................................................................................................................ 15

3.2 Installing ADP Software Tools - TCA Edition ............................................................................................. 15 3.2.1 Preparing the system ....................................................................................................................... 15 3.2.2 Performing the Installation .............................................................................................................. 16 3.2.3 Configuring the Environment .......................................................................................................... 16

3.3 Removing ADP Software Tools - TCA Edition ............................................................................................ 16


1

1 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.

1.1.1 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

1.1.2 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 Signal Processing Toolbox

o 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.

2

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

1.2.1 Software Updates

Periodically visit your product page at www.nutaq.com 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.

1.2.2 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.

1.2.3 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.

1.2.4 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.

http://www.nutaq.com/


3

5. 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 www.nutaq.com 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 15000.

8. 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.

1.2.5 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.


4

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.

1.2.6 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 http://68.169.41.127/act_server/offline/ 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.

http://68.169.41.127/act_server/offline/


5

8. 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.

6

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.


7

15. 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.

1.2.7 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 12.

5. If the system on which the removal is performed is not connected to the Internet, select the Offline mode option and click Next.

8

6. In the Offline activation dialog box, select the I need a license.ans file option and click Next.


7. Transfer the license.req file to a computer with an Internet access, and go to the http://68.169.41.127/act_server/offline/web address.


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.


The deactivation process starts.

12. When the deactivation is complete, click Finish. If you are prompted to restart your computer, please do so.

1.2.8 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 www.nutaq.com.

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.




9

1.2.9 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.

1.2.10 Updating ADP Software Tools Offline

1. Select the “I need a license.ans file” option and click Next.

10


2. Transfer the license.req file to a computer with an internet access and go to the http://68.169.41.127/act_server/offline/ web address.


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.


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.



11

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.

12

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

1.3.1 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.

1.3.2 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 email when contacting Nutaq’s support.

1.3.3 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 (www.adobe.com).

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.


13

2 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.


This chapter presents the requirements that must be met by the system on which the ADP Software Tools are installed.

2.1.1 Host Computer

Hardware

x86 or x86_x64 architecture

1GB RAM

Operating System

Fedora 20

2.1.2 µTCA Chassis Host

Hardware

16GB USB stick

Analog display

USB hub equipped with four ports or more

USB keyboard

USB mouse

USB optical disc drive

Operating System

Fedora 20

2.2 Installing ADP Software Tools - TCA Edition

2.2.1 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

14

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


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 3.14.3-200.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 3.14.3-200.fc20.x86_64 #1 SMP Fri Dec

3 12:19:41 UTC 2010 x86_64 x86_64 x86_64 GNU/Linux

2.2.3 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


15

3 Installation on Linux Ubuntu 12.04.4 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 12.04.4 operating system.

The Linux installation contains the tools and drivers necessary for Linux-based host development.


This chapter presents the requirements that must be met by the system on which the ADP Software Tools are installed.

3.1.1 Host Computer

Hardware

x86 or x86_x64 architecture

1GB RAM

Operating System

Ubuntu 12.04.4

3.1.2 µTCA Chassis Host

Hardware

16GB USB stick

Analog display

USB hub equipped with four ports or more

USB keyboard

USB mouse

USB optical disc drive

Operating System

Ubuntu 12.04.4

3.2 Installing ADP Software Tools - TCA Edition

3.2.1 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:

16

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


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:

64

3.2.3 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

Documents

SSooffttwwaarree IInnssttaallllaattiioonn GGuuiiddee uTCA edition...Software Installation Guide 2.4 3 5. Read the Open SSL license agreement carefully, select the I accept the terms