Post-install configuration

After the SDK is installed, finish the installation and configure your system to use the SDK. If you have installed the SDK on RHEL 5.1, you must make specific changes.

Preventing automatic updates from overwriting SDK components

If you are installing on an IBM^® BladeCenter QS20 or BladeCenter QS21, add the following clause to the /etc/yum.conf file in the [Main] section to prevent a YUM update from overwriting the SDK versions of these runtime RPMs:

exclude=blas kernel numactl oprofile

For PowerPC^® platforms the following clause needs to be added to the /etc/yum.conf file:

exclude=blas

In the future, the YUM update daemon might attempt to update SDK packages with a version not enhanced for the SDK. The exclude line will prevent this from occurring.

Note: If you exclude packages from regular updates, YUM will not automatically update it when new versions become available. If new versions containing security updates or bug fixes are released, you must manually update the RPM.

Installing the Linux^® Kernel

If you are installing Fedora 7 on BladeCenter^® hardware, the kernel must be manually installed. First, download the kernel from the Barcelona Supercomputing Center Web site. The kernel RPM URL is http://www.bsc.es/projects/deepcomputing/linuxoncell/cellsimulator/sdk3.0/kernel-2.6.22-5.20070920bsc.ppc64.rpm

Next, install the kernel by typing the following command:

# rpm -ivh --force kernel-2.6.22-5.20070920bsc.ppc64.rpm

You must reboot to activate the new kernel.

Installing required runtime libraries (RHEL 5.1 only)

For RHEL 5.1, additional libraries are needed to execute Cell BE applications. This step is not necessary for Fedora 7 because it is done automatically by the installation program. For RHEL 5.1 Power architecture and CBEA-compliant systems, install the runtime libraries for LIBSPE2 from the RHEL 5.1 supplementary CD. Type the following command:

# rpm -ivh libspe2-2.2*.rpm

For CBEA-compliant hardware such as the IBM BladeCenter QS20 and BladeCenter QS21, install the elfspe2 RPM from the RHEL 5.1 supplementary CD. Type the following command:

# rpm -ivh elfspe2-2.2*.rpm

After you install the elfspe2 RPM on an IBM BladeCenter QS20 or BladeCenter QS21, ensure that spufs (the SPU File System) is loaded correctly:

Create the /spu directory by typing the following command:
```
# mkdir -p /spu
```
Add the following line to /etc/fstab if it does not already exist:
```
spufs		/spu		spufs	defaults		0  0
```
spufs will now mount automatically at boot. To mount spufs immediately, type the following command:
```
# mount /spu
```

Note: The version of SELinux shipped with RHEL 5.1 might prevent spufs from mounting at boot. If spufs did not mount at boot, type the following command:

# mount /spu

Disable SELinux if you want spufs automatically mounted at boot.

Installing required development libraries (RHEL 5.1 only)

For RHEL 5.1, you should install additional libraries. This step is not necessary for Fedora 7 because it is done automatically by the installation program.

The versions of the libspe2-devel packages for PPC and PPC64 are needed for application development. These RPMs can be found on the RHEL 5.1 supplementary CD.

To install on X86 or X86_64 architecture systems, type the following command:

# rpm -ivh --force --nodeps --noscripts --ignorearch --root=/opt/cell/sysroot \
	libspe2-devel*.rpm

To install on PowerPC architecture or CBEA-compliant systems, type the following command:

# rpm --ivh libspe2-devel*.rpm

The PPC and PPC64 versions of the netbpm-devel packages are needed to compile the Julia demo example code (see /opt/cell/sdk/src/demos/julia_set). These RPMs are on the RHEL 5.1 supplementary CD. To install on X86 or X86_64 architecture systems, type the following command:

# rpm --ivh --force --nodeps --noscripts --ignorearch --root=/opt/cell/sysroot \
	netpbm-devel*.rpm

To install on PowerPC architecture or CBEA-compliant systems, type the following command:

# rpm --ivh netpbm-devel*.rpm

Restarting automatic updates

Start the YUM updates daemon by typing the following command as root:

# /etc/init.d/yum-updatesd start

Adding SDK components

After the SDK is installed, you can install optional packages. See Installing additional SDK components.

The Eclipse IDE

If you have installed the Eclipse IDE RPM, see Configuring the Eclipse IDE for instructions about how to complete the installation for the IDE.

Hybrid-x86 daemon configuration

If you installed the DaCS for Hybrid-x86 or the ALF for Hybrid-x86 component, see DaCS for Hybrid-x86 configuration.

Simulator Sysroot

If you have installed the Full-System Simulator and sysroot image on a Fedora 7 system, you should ensure that the sysroot image is updated by typing the following command:

# /opt/cell/cellsdk_sync_sdk_simulator install

See the Software Development Kit for Multicore Acceleration Version 3.0 Programmer's Guide for more information

The SPU-Isolation RPMs

If you have installed the SPU-Isolation RPMs on Fedora 7, you should build the isolation tool. See Building the SPU-Isolation component for more information about the cellsdk_sync_simulator script.