civicrm-confdump/README.md

15 lines
1.4 KiB
Markdown
Raw Normal View History

- Needs working local CiviCRM from caat-crm-installer
2022-02-25 08:50:14 +00:00
- Install pre-dependencies for MySQL client https://pypi.org/project/mysqlclient/ (on dpkg based linux: `sudo apt install python3-dev default-libmysqlclient-dev build-essential`)
- In confdump path, `virtualenv confdump.venv`
- Load the virtualenv `. confdump.venv/bin/activate`
2022-02-25 08:50:14 +00:00
- Install requirements `pip install -r requirements.txt`
- `cp example.env .env`
- Edit `.env` and add creds for the production, test or development server you'll retrieve the data from.
2022-03-23 17:53:50 +00:00
- Execute dump to retrieve base data: `env $(cat .env) python ./confdump.py dump -o mydata INSTANCEPATH` where INSTANCEPATH is something like https://crm.dev.caat.org.uk/.
2022-02-25 08:50:14 +00:00
- **IMPORTANT!!** - If you sourced the data from live, you must delete the `.env` file or delete the creds from inside it. If you leave them in it will negate the whole purpose of having this conf dump utility, which is to provide a way of creating a local site without any sensitive data.
2022-03-23 17:55:17 +00:00
- If your civicrm is in a docker container, load data into running local instance with: `python confdump.py mysql -i mydata/ -p 63306`
2022-02-25 08:50:14 +00:00
- Otherwise use `confdump.py mysql -i mydata/ --host=<host> --db=<db> --user=<user> --password=<password>`
- Clear the cache in CiviCRM:
* DOCKER: `make shell`, and then inside the shell `cd /app; ./vendor/bin/drush cc all`
* NORMAL: `cd web; vendor/bin/drush cc all`