Additional Notes for Linux OS

Introduction

This document is the user’s guide of Rhapsody Developer for Ada on Linux os.

Installation Notes

GNAT Installation

Apex Installation

Manually rebuilding the behavior services for Apex

If you are using Atego ApexAda Developer compiler, only NewFWK95 is available. The new behavior services should be installed in a view of a subsystem.

As the FWK needs booch components and Rhpanim, some views must also be created for them. A script helps doing this:

<RhapsodyInstallDir>/Sodius/apexForRiA.sh
[Apex_model_path][Apex_view_name]

This script is launched during install of Rhapsody. But it can be used to create other views of the FWK. It needs 2 parameters :

• Apex_model_path : an Apex model path to create the view
• Apex_view_name : name of the Apex view.

If no parameters are passed, then the default Apex model will be used and the name of the view will be “view”.

This script will create view in the following subsystems :

<RhapsodyInstallDir>/Share/LangAda95/aom_new_95/aom_new_95.ss

<RhapsodyInstallDir>/Share/LangAda95/src/RiA_Framework.ss

And if <RhapsodyInstallDir>/Share/LangAda95/booch_ada_95 exists:

<RhapsodyInstallDir>/Share/LangAda95/booch_ada_95/Booch.ss

Example :

<RhapsodyInstallDir>/Sodius/apexForRiA.sh
      /Home/Atego/Apex/base/ada/model.ss/i386_linux2.ada95.portable.4.4.0.rel i386_linux2.ada95.portable.4.4.0

If you need to update the FWK, you should open the FWK model /Share/LangAda95/Ada_FWK/Ada_FWK.rpy with Rhapsody, and create manually a new configuration:

• Change the directory of the component Oxf:

  

• Create a new configuration called Apex

• Set the path as followed:

  

• Delete manually all the ada files which are in the view (not the view itself)
• Regenerate the model for Apex configuration.

If the subsystem doesn’t exist, the compilation may not work, because some imports are missing. To create them, run the script /sodius/apexForRiA.sh.

If you want to create a new view with an updated FWK, you should update files of GNAT_win_32 configuration. For that, GNAT_win_32 configuration should be updated:

• Change the path:

  

• Set the property Ada_CG:Apex:compiler to “GNAT”:

  

• Regenerate the model for GNAT_Win_32 configuration

Run the script /sodius/apexForRiA.sh with correct parameters to create the new view. (the script uses the files generated for GNAT_Win_32 configuration in folder (LangAda95/src/RiA_Framework/Gnat_win_32)

Manually rebuilding the animation C libraries

Rebuilding for Atego ApexAda Developer compiler

• The build is done using the native GCC compiler of Linux.
• If you are using Atego ApexAda Developer compiler, you might have to follow these steps :
• Open a shell terminal.
• Go to the <RhapsodyInstallDir>/Share/LangC directory.

Type: make -f adaLinuxbuild.mak

The following files will be generated in the directory <RhapsodyInAdaInstallDir>/Share/LangC/lib :

• adaLinuxaomanim.a
• adaLinuxomcomappl.a
• adaLinuxoxfinst.a

Install Booch components

In some case code generator creates some dependencies to Booch components. Rhapsody doesn’t install Booch Components files. User must do it manually, by following the procedure above.

• Install Booch Components 95
• Get the files from the following URL for example:
• http://sourceforge.net/projects/booch95/files/
• Unzip the files
• Copy the folder “src” into <Rhapsody_install_folder>\Share\LangAda95\Booch_ada_95\src

Install Booch Components 83

• Get the files from the following URL for example:
• http://www.adapower.com/original_booch/original_booch.html
• Unzip the files
• Copy the folder “src” into <Rhapsody_install_folder>\Share\LangAda83\Booch_ada_83\src

If you are using Atego ApexAda Developer compiler, a subsystem and a view must be created to be able to create a dependency between the Rhapsody project and Booch Components. The script <RhapsodyInstallation>/Sodius/apexForRiA.sh is able to create this view. A script like that can be also used.

ApexPath=""      # define the path of Apex
rhpInstallDir="" # define the path of install of Rhapsody
rhpShareBooch="" # define the path where the src folder of Booch Components is located
modelName=""     # define the Apex model used to create a view. Usually ""
viewName=""      # usually use "view"

subsystemName="$rhpInstallDir/Share/LangAda95/Booch_ada_95/Booch.ss"
if [ -d \$subsystemName ]
then
        echo "*** subsystem \$subsystemName already exists"
else
        $ApexPath/apexinit -batch create_subsystem $subsystemName
fi

viewBooch=$subsystemName/$viewName

if [ -d $viewBooch.rel ]
then
        echo "*** view $viewBooch.rel already exists"
else
        $ApexPath/apexinit -batch create_release -model $modelName $viewBooch
        $ApexPath/apexinit -batch migrate $rhpShareBooch/src/*.ad* -into $viewBooch.rel
        $ApexPath/apexinit -batch code $viewBooch.rel
        #\$ApexPath/apexinit -batch remodel -release_kind frozen \$viewBooch.rel
fi

Generating code for Apex

Rhapsody with Apex limitations