...
Welcome
Before we start
ACS ACS (ALMA Common Software) is a framework for implementing a distributed container/component software machine. You can use it to develop and run custom components with some desired functionality. In these tutorial series we will explore its ACS main features, from and for someone new to this tool, in order to gain familiarity with the framework. Hopefully we will find some interesting ways of using ACS, coding simple experimental components. ACS may seem big and complex at first, but we will code our way out of this image, in a condensed approach.
For a general overview of ACS and it's main concepts, tools and subsystems we recommend to look at this document.
To work with ACS we will install it inside a Docker container based in a CentOS Stream 8 image, in an Ubuntu 20.04 machine. Some commands may change in order to run ACS in other machines, so if you need assistance you can reach any member of the ALMA software development team.
Installation
| View file | ||||
|---|---|---|---|---|
|
Troubleshooting
If you have any issues installing ACS or its components try the following.
While installing external products
| Code Block | ||||
|---|---|---|---|---|
| ||||
> make all
WARNING: Do not close this terminal: some build might fail!
Target directory already exist.
2021-11-29T18:18:55 buildTclTk [3m10.381s] [ OK ]
2021-11-29T18:22:05 buildTAO [0m2.881s] [==> FAILED]
2021-11-29T18:22:08 buildMaven [0m0.005s] [==> FAILED]
2021-11-29T18:22:08 buildJavaDependencies [0m0.006s] [==> FAILED]
2021-11-29T18:22:08 buildExternalDependencies [0m0.025s] [==> FAILED]
2021-11-29T18:22:08 buildAnt [0m0.004s] [==> FAILED]
2021-11-29T18:22:08 buildJacorb ==== Building JacORB from: /Repos/ExtProd/INSTALL/../PRODUCTS into: /
jacorb: Env Variable JACORB_HOME no set. Review your deployment
[0m0.006s] [==> FAILED]
2021-11-29T18:22:08 buildPython [0m0.016s] [ OK ]
2021-11-29T18:22:08 buildPyModules [0m0.007s] [==> FAILED]
2021-11-29T18:22:08 buildOmniORB [0m22.676s] [ OK ]
2021-11-29T18:22:31 buildEclipse [9m54.753s] [ OK ]
2021-11-29T18:32:25 buildSwig [0m25.429s] [ OK ]
2021-11-29T18:32:51 buildBoost [0m20.637s] [ OK ]
WARNING: Now log out and login again to make sure that
the environment is re-evaluated!
__oOo__
2021-11-29T18:33:11 buildTools script has finished
. . . 'all' done |
Some components might fail during this process. There are logs for each component in /Repos/ExtProd/INSTALL which you can check for diagnostics. Check permissions for directories /external/docker, /external/docker/alma, /external/docker/home in your machine, the owner and group should be your user (not root).
While building ACS
| Code Block | ||||
|---|---|---|---|---|
| ||||
> make build
Evaluating current ACS TAG from https://bitbucket.alma.cl/scm/asw/acs.git
REPO tag is: master
############ Clean Build Log File: build.log #################
############ Check directory tree for modules #################
############ Prepare installation areas #################
### ==> FAILED! |
You can try to build ACS in another terminal, or reset the local repo and build again:
...
| language | bash |
|---|
...
Before running the tutorial examples and exercises you will have to install ACS. In the next section we provide instructions to install ACS in a docker container.
References: