Installing Your Classic Reference Distribution
To install the downloaded reference distribution:
- Either log in as root (on a Linux host) or open a Cygwin Bash shell (on a Windows host).
- Change to the directory where you saved the installation image.
- Enter commands similar to the following to uncompress the archive and extract its contents:
# tar -zvxf <archive_file> # cd timesys-<toolchain>-<board_name>-basic--std5-<build_num>-install
For example:
# tar -zvxf timesys-armv5l-mx21ads-basic--std5-7-install.tgz # cd timesys-armv5l-mx21ads-basic--std5-7-install
- Check the release_notes.txt file in the /docs directory for last-minute installation
or configuration updates.
- Execute the install script in the top directory of the uncompressed archive, specifying
the “./” prefix to ensure that you are running the installation script located in
the current directory:
# ./install
- The TimeSys end user license agreement (EULA) is then displayed. Press the space bar to page through the entire EULA. You must agree to the EULA by typing yes to continue the installation.
- The installation script then prints a message that gives copyright and trademark information
for the distribution. Press Enter to continue.
- This step differs, depending on whether you are installing a 6.1 or 6.2 distribution. A summary
of the installable products is displayed. For either version, a full installation includes a
toolchain, a kernel, and at least one RFS. TimeSys also recommends installing the
Embedded Development Utilities for your host.
- For 6.1 distributions, type the numbers, separated by commas, corresponding to the items
that you want to install. For a Linux-hosted installation, type 2, 3, 4, and 5. For a
Windows-hosted installation, type 1, 3, 4, and 6. Then, enter a at
the prompt to accept these products.
- For 6.2 distributions, the products to be installed are displayed by default with an asterisk. Enter a at the prompt to accept these products. To install a set of products other than the default, enter the number for each of the items that you want to change, separated by commas.
- For 6.1 distributions, type the numbers, separated by commas, corresponding to the items
that you want to install. For a Linux-hosted installation, type 2, 3, 4, and 5. For a
Windows-hosted installation, type 1, 3, 4, and 6. Then, enter a at
the prompt to accept these products.
- Next, the installation script describes the default installation paths for the selected components.
Press Enter to accept the default paths and start the installation.
To change any of the component locations, type y at the prompt, and the script will prompt you to enter a different path.
The installation script exits after it copies the files into the appropriate directories, and you are returned to the shell prompt.
Note
When installing a distribution for some boards on a Windows host, you might see two additional EULAs to which you must type yes in order to continue the installation.
To use the toolchain, you must add the following directories to your PATH using the export command:
# export PATH=/opt/timesys/toolchains/<toolchain>-linux/bin:/opt/timesys/bin:$PATH
The kernel is provided as a bootable image in the RFS, which is installed as:
/opt/timesys/linux/<distribution_version>/<toolchain>-std/rfs/boot/<kernel_image>
You will need the RFS path when you set up DHCP, as described in Configuring a DHCP Server for Linux and in Configuring a DHCP Server for Windows.
If you want to rebuild the kernel, you will need the path to the kernel source files. For more information about the path to the kernel source, refer to Obtaining Kernel Source Files.
Installation Log
A log file is created automatically by the installer in the /tmp directory as <board_name>.log. You may specify a different log file by using the -l option:
# ./install -l /tmp/my_log_file.txt
Keep this log file, because it contains a record of the installation paths and other information which might be useful for debugging installation problems. If you encounter problems while installing a distribution, please attach the installation log file to your error report.
