73
edits
(Add tips on managing Docker containers and increasing disk space under AWS) |
(Add URL for fetching CKAN version and installed extensions) |
||
(4 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
More information on deploying/administering CKAN (like adding/removing extensions and editing the theme), may be found in [https://github.com/WPRDC/ckan-docker/wiki the wiki of the GitHub repo for our fork of the CKAN Docker repo]. | |||
== Checking CKAN configuration == | |||
* Check CKAN version and installed extensions: [https://data.wprdc.org/api/3/action/status_show https://data.wprdc.org/api/3/action/status_show] | |||
== Changes that can be made through the frontend == | == Changes that can be made through the frontend == | ||
There's a lot of documentation on publishing data on our CKAN portal [https://github.com/WPRDC/data-guide/tree/master/docs here]. | There's a lot of documentation on publishing data on our CKAN portal [https://github.com/WPRDC/data-guide/tree/master/docs here]. | ||
Line 51: | Line 57: | ||
* Activate the virtual environment that lets you run <code>paster</code> commands: <code>> . /usr/lib/ckan/default/bin/activate</code> | * Activate the virtual environment that lets you run <code>paster</code> commands: <code>> . /usr/lib/ckan/default/bin/activate</code> | ||
=== Managing the Docker containers | === Managing the Docker containers === | ||
<code> > cd docker-ckan | |||
> docker ps | > docker ps | ||
</code> | |||
should return a list of running containers, which should include the following container names: | |||
should return a list of running containers, which should include the following container names: <code>datapusher-plus</code>, <code>ckan</code>, <code>solr</code>, and <code>redis</code>. | |||
Use | Use | ||
<code>> sudo docker-compose logs --tail=100 ckan</code> | |||
to show the last 100 lines of the log for the | to show the last 100 lines of the log for the <code>ckan</code> Docker instance. | ||
=== Adding/changing departments of publishers === | === Adding/changing departments of publishers === | ||
Line 69: | Line 77: | ||
The extra tricky part about this one is that [https://github.com/WPRDC/ckanext-wprdctheme our GitHub repository that includes this JSON file] is installed in a different directory: <code>/usr/lib/ckan/default/src/ckanext-wprdctheme/</code> but changes to the files in that directory (and subdirectories) do nothing. | The extra tricky part about this one is that [https://github.com/WPRDC/ckanext-wprdctheme our GitHub repository that includes this JSON file] is installed in a different directory: <code>/usr/lib/ckan/default/src/ckanext-wprdctheme/</code> but changes to the files in that directory (and subdirectories) do nothing. | ||
== Dealing with inadequate disk space === | === Dealing with inadequate disk space === | ||
Once, we were seeing OSError: write error in the CKAN Docker logs and had to increase disk space to make CKAN function again. | Once, we were seeing OSError: write error in the CKAN Docker logs and had to increase disk space to make CKAN function again. | ||
Steve on increasing volume size on AWS: | Steve on increasing volume size on AWS: | ||
> if you ever have to increase a volume, here’s what i followed to make the filesystem use the new space: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recognize-expanded-volume-linux.html | > if you ever have to increase a volume, here’s what i followed to make the filesystem use the new space: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recognize-expanded-volume-linux.html | ||
that server was a Xen instance | that server was a <code>Xen</code> instance | ||
== Other changes == | == Other changes == | ||
Line 83: | Line 91: | ||
In additional to adding the users to the organizations through the CKAN front-end, you also have to add them to groups, using this URL: [http://wprdc.org/group-adder/] | In additional to adding the users to the organizations through the CKAN front-end, you also have to add them to groups, using this URL: [http://wprdc.org/group-adder/] | ||
[[Category:Onboarding]] | [[Category:Onboarding]] [[Category:CKAN]] |