Introduction
This confluence page is a summary of what is expected at this point. On day 3 we will have 30 minutes to catch up and then we will follow to the next steps of the development of our fist component!
Summary
Preparing your environment
The first steps you would need to do is to checkout the repository to a convenient location. As an example, we will use ~/Repos directory:
> mkdir -p ~/Repos > cd ~/Repos
We retrieve the repository
> git clone https://bitbucket.alma.cl/scm/acsws/awv.git
We make sure we have an INTROOT:
> echo $INTROOT
If this is empty, please make sure you it is defined and pointing to something useful. For instance ~/introot:
> export INTROOT=~/introot
Check that this directory exists and has the right directory structure:
> file $INTROOT /home/almamgr/introot: directory
If the file doesn't exist, create the directory structure:
> getTemplateForDirectory INTROOT $INTROOT
Check the contents:
> ls -1 $INTROOT ALARMS app-defaults bin bitmaps CDT config ERRORS idl include lib LOGS man responsible rtai sounds Sources templates vw
Now, make sure this INTROOT variable gets automatically loaded to your environment, by adding it to your .bashrc
... #End of original content export INTROOT=~/introot source /alma/ACS-2020JUN/ACSSW/config/.acs/.bash_profile.acs
This is to ensure, the libraries, executables and other files installed to the INTROOT are available for compilation and runtime. After this point close all your consoles and start with new ones in order for them to be properly configured.
Fill the INTROOT with the interface data
Go to the repository directory:
> cd ~/Repos/awv/ICD/src > make all install
Check you have some key files in your INTROOT:
Prepare your module
Go to the repository and add your module to the directory structure. For instance I will choose the following name for the Telescope implementation in Java:
> cd ~/Repos/awv > getTemplateForDirectory MODROOT_WS jTelescope
Check the contents of the directory are correct:
> ls -1 jTelescope/ bin ChangeLog config doc idl include lib LOGS man object rtai src test
Right now the directory ~/Repos/awv should look something like:
> ls -1 ~/Repos/awv/ EXTERNAL ICD ITS jTelescope
To put an example, once it is integrated with other groups' modules, it could see similar to:
> ls -1 ~/Repos/awv/ EXTERNAL ICD ITS jTelescope pyScheduling cppInstruments pyConsole jDatabase ...
Bear in mind that there's some freedom with the name convention and these names are purely referential.
Pushing to Git
The person that was appointed in your group to work for ITS (Integration and Testing System) needs to upload your module (and during the workshop, the updates), to Git. First commit!
cd ~/Repos/awv git pull git add jTelescope/src/Makefile git commit -m "First commit for jTelescope module" git push
That way, other people in your team, and the integration team, can see the changes you've been working on during the workshop.
Testing Environment
You can prepare your testing environment to save some time later on:
> cd ~/Repos/awv/jTelescope/test > cp ../src/Makefile . > cp -r ~/Repos/awv/ITS/test/SIM/CDB CDB
This will give you an environment to tweak later on for testing your component's interaction with other components. You can test everything is alright in the following way:
> export ACS_CDB=~/Repos/awv/jTelescope/test > acsStart > acsStartContainer -py pySimContainer