60 lines
2.6 KiB
Markdown
60 lines
2.6 KiB
Markdown
Compass
|
|
=======
|
|
|
|
A Deoployment Automation System. See Wiki page at https://wiki.openstack.org/wiki/Compass.
|
|
|
|
How to install Compass?
|
|
-----------------------
|
|
1. Run `git clone https://github.com/huawei-cloud/compass`
|
|
2. Run `cd compass` to the Compass project directory.
|
|
3. Run `./install/install.sh` to setup compass environment. Please note that before you execute `install.sh`, you may setup your environment variables in `install/install.conf`, explanations and examples of those variables can be found in `install.conf`.
|
|
4. Run `source /etc/profile` to setup compass profile.
|
|
5. Run `./bin/refresh.sh` to initialize database.
|
|
6. 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 running `service compassd status`?
|
|
|
|
1. Simply remove celery pid file (`/var/run/celery.pid`).
|
|
2. Try running `export C_FORCE_ROOT=1`
|
|
3. Restart Compass daemon.
|
|
|
|
* How to restart compass service?
|
|
1. Run `service compassd restart`
|
|
2. Run `service httpd restart` to restart web service.
|
|
|
|
* How to check if the compass services run properly?
|
|
1. Run `service compassd status` to check compass services status.
|
|
2. Run `service httpd status` to check web service status.
|
|
|
|
* How to troubleshoot if `compassd` can not start the services?
|
|
1. Try to remove /var/run/celeryd.pid to release the celeryd lock
|
|
2. 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?
|
|
1. `/var/log/compass/compass.log` is the compass web log.
|
|
2. `/var/log/compass/celery.log` is the celery log
|
|
3. The redirected celeryd stdout/stderr is at `/tmp/celeryd.log`.
|
|
4. The redirected progress_update.py stdout/stderr is at `/tmp/progress_update.log`
|
|
5. The web server (httpd) log files are under `/var/log/httpd/`.
|
|
|
|
* Where to find the compass config file?
|
|
1. the compass setting file is at /etc/compass/setting.
|
|
2. the default global config file for installing distributed system is at /etc/compass/setting
|
|
3. 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/`
|