2.6 KiB
2.6 KiB
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/