
Duplicate installations of packages in system python environment will take precedance by default and make unforseeable issues, so we declare to use packages in virutalenv first and then system packages. Change-Id: I29a56ffad33dfabec3ea73a84dbdc8e943ca8153 Closes-bug: #1354625 Cherry-pick from review.openstack.org/#/c/113052/
Compass
A Deoployment Automation System. See Wiki page at https://wiki.openstack.org/wiki/Compass.
How to install Compass?
- Run
git clone https://github.com/huawei-cloud/compass
- Run
cd compass
to the Compass project directory. - Run
./install/install.sh
to setup compass environment. Please note that before you executeinstall.sh
, you may setup your environment variables ininstall/install.conf
, explanations and examples of those variables can be found ininstall.conf
. - Run
source /etc/profile
to setup compass profile. - Run
./bin/refresh.sh
to initialize database. - Run
service compassd start
to start compass daemon services.
FAQ
- Why doesn't celery start? What should I do if I get
celery died but pid file exists
message after runningservice compassd status
?
- Simply remove celery pid file (
/var/run/celery.pid
). - Try running
export C_FORCE_ROOT=1
- Restart Compass daemon.
- How to restart compass service?
- Run
service compassd restart
- Run
service httpd restart
to restart web service.
- How to check if the compass services run properly?
- Run
service compassd status
to check compass services status. - Run
service httpd status
to check web service status.
-
How to troubleshoot if
compassd
can not start the services?- Try to remove /var/run/celeryd.pid to release the celeryd lock
- Try to remove /var/run/progress_update.pid to release the progress_update lock.
-
How to use compass to install distributed systems?
Access http://<server_ip>/ods/ods.html. In the current version, we only support OpenStack deployment with a simplified configuration. Follow the simple wizard from the Web UI.
-
How to run unittest?
COMPASS_SETTING=<your own compass setting> python -m discover -s compass/tests
-
Where to find the log file?
/var/log/compass/compass.log
is the compass web log./var/log/compass/celery.log
is the celery log- The redirected celeryd stdout/stderr is at
/tmp/celeryd.log
. - The redirected progress_update.py stdout/stderr is at
/tmp/progress_update.log
- The web server (httpd) log files are under
/var/log/httpd/
.
-
Where to find the compass config file?
- the compass setting file is at /etc/compass/setting.
- the default global config file for installing distributed system is at /etc/compass/setting
- the default celery config file is at /etc/compass/celeryconfig
-
Where is the default database file? It is at
/opt/compass/db/app.db
-
Where is the utility scripts for compass? It is at
/opt/compass/bin/
Description
Languages
Python
84.1%
RAML
7.7%
Shell
5.6%
Jinja
2.3%
JavaScript
0.2%