This chapter contains the following sections:
Introduction
Installation for Windows
Setting the Environment
Installation for UNIX Hosts
Setting the Environment
This chapter describes how you can install the TASKING Cross-Assembler for the XA on Windows 95/98/NT and several UNIX hosts.
Start Windows 95/98 or NT, if you have not already done so.
Insert the CD-ROM into the CD-ROM drive.
If the Auto insert notification option is enabled for your CD-ROM drive, the TASKING Welcome dialog box appears. Now skip to Step 5.
Select the Start button and select the Run... menu item.
On the command line type:
d:\setup
(substitute the correct drive letter if necessary) and press the <Return> or <Enter> key or click on the OK button.
The TASKING Welcome dialog box appears.
Select a product to install and click on Install a Product.
Follow the instructions that appear on your screen.
You can find your serial number on the Certificate
of Authenticity, delivered with the product.
After you have installed the software, you have to set some environment variables to make invocation of the tools easier. A list of all environment variables used by the tool chain is present in the section Environment Variables in the chapter Overview.
Make sure that your path is set to include all of the executables you have just installed. If you installed the software under C:\CXA, you can include the executable directory C:\CXA\BIN in your search path.
In EDE, select the EDE | Directories... menu item. Add one or more executable directory paths to the Executable Files Path field.
The environment variable TMPDIR can be used to specify a directory where programs can place temporary files. The linker uses the environment variable CXALIB to search for library files. An example of setting this variable is given below.
See also the section
Library Search Path in the chapter
Linker
.
Enter the following line when you use a Command Prompt window.
set CXALIB=c:\cxa\lib
Add the following line to your autoexec.bat file.
set CXALIB=c:\cxa\lib
1. Open the System Properties dialog.
You can do this by double-clicking on the System icon in the Control Panel (Start | Settings | Control Panel) or right-click on the My Computer icon on your desktop and select Properties.
2. Select the Environment tab.
3. In the Variable edit field enter:
CXALIB
4. In the Value edit field enter:
c:\cxa\lib
5. Click on the Set button, then click OK.
Login as a user.
Be sure you have read, write and execute permissions in the installation directory. Otherwise, login as root.
If you are a first time user decide where you want to install the product (By default it will be installed in /usr/local).
For CD-ROM install: insert the CD-ROM into the CD-ROM drive. Mount the CD-ROM on a directory, for example /cdrom. Be sure to use a ISO 9660 file system with Rock Ridge extensions enabled. See the manual page for mount on your UNIX platform for details.
Or:
For tape install: insert the tape into the tape unit and create a directory where the contents of the tape can be copied to. Consider the created directory as a temporary workspace that can be deleted after installation has succeeded. For example:
mkdir /tmp/instdir
For CD-ROM install: go to the directory on which the CD-ROM is mounted:
cd /cdrom
For tape install: copy the contents of the tape to the temporary workspace using the following commands:
cd /tmp/instdir tar xvf /dev/tape
where tape is the name of your tape device.
If you have received a tape with more than one product,
use the non-rewinding device for installing the products.
For HP tape is usually the name update.src.
For tape install: remove the installation tape from the device.
Run the installation script:
sh install
and follow the instructions appearing on your screen.
First a question appears about where to install the software. The default answer is /usr/local. On certain sites you may want to select another location.
On some hosts the installation script asks if you want to install SW000098, the Flexible License Manager (FLEXlm). If you do not already have FLEXlm on your system, you must install it; otherwise the product will not work on those hosts. See the Flexible License Manager (FLEXlm) appendix for more information.
If the script detects that the software has been installed before, the following messages appear on the screen:
*** WARNING *** SW012000 xxxx.xxxx already installed. Do you want to REINSTALL? [y,n]
Answering n (no) to this question causes installation to abort and the following message being displayed:
=> Installation stopped on user request <=
Answering y (yes) to this question causes installation to continue. And the final message will be:
Installation of SW012000 xxxx.xxxx completed.
For tape install: remove the temporary installation directory with the following commands:
cd /tmp rm -rf instdir
For hosts that need the FLEXlm license manager, each user must define an environment variable, LM_LICENSE_FILE, to identify the location of the license file. If the license file is present on the hosts on which the installed product will be used, you must set LM_LICENSE_FILE to the pathname of the license file if it differs from the default:
/usr/local/flexlm/licenses/license.dat
If you have more than one product using the FLEXlm license manager you can specify multiple license files to the LM_LICENSE_FILE environment variable by separating each pathname (lfpath) with a ':' :
setenv LM_LICENSE_FILE lfpath[:lfpath]...
If the license file is not available on these hosts, you must set LM_LICENSE_FILE to port@host; where host is the host name of the system which runs the FLEXlm license manager and port is the TCP/IP port number on which the license manager listens.
To obtain the port number, look in the license file at host for a line starting with "SERVER". The fourth field on this line specifies the TCP/IP port number on which the license server listens. For example:
setenv LM_LICENSE_FILE 7594@elliot
See the Flexible License Manager (FLEXlm) appendix for detailed information.
Logout.
If your product has the FLEXlm License Manager the following two files are present:
cxa/flexlm/ license.dat Tasking
The file license.dat is a template license file for this product. The file Tasking is the license daemon for TASKING products. Refer to the Flexible License Manager (FLEXlm) appendix for detailed information regarding license management.
After you have installed the software, you have to set some environment variables to make invocation of the tools easier. A list of all environment variables used by the toolchain is present in the section Environment Variables in the chapter Overview.
Make sure that your path is set to include all of the executables you have just installed.
The environment variable TMPDIR can be used to specify a directory where programs can place temporary files.