Editing CommunityData:Etherpad (section)

== Backing up Etherpads (optional/deprecated) ==

{{notice|This is entirely optional and is probably no longer necessary since we moved to our own Etherpad server.}}

Etherpads should not be treated as long term storage. Although we have no plan to purge things from our own server, there's no promise that they will be kept across upgrades and server migrations either. As a result, we have a system to backup our Etherpads. It runs once a days and keeps a backup copy each day. We can use the backups to go back to any old copy of any Etherpad so you can safely blow away old text and know you will be able to get the archived text back if you need it.

That said, we need to register every Etherpad that we want backed up first. To do that, we need to first check out <code>cdsc-etherpads</code> repository from the [[CommunityData:Git|group Git repository]] with a line in your terminal like:

<syntaxhighlight lang='bash'>
git clone git@code.communitydata.science:cdsc-etherpads
</syntaxhighlight>

If you get a permission denied errors, follow the instructions on [[CommunityData:Git]] to get setup to use the CDSC git repository.

To start backing up a new Git repository, you should add a new line to the bottom of <code>ETHERPAD_URLS</code>. The lines should look like:

<syntaxhighlight lang='bash'>
http://etherpad.communitydata.science/p/cdsc_cabal_meeting-20380119 # meeting notes from the winter 2038 cabal meeting
</syntaxhighlight>

As you can see, comments following <code>#</code> are supported in the file. They are not required.

The complete workflow should look like:

<syntaxhighlight lang='bash'>
git clone git@code.communitydata.science:cdsc-etherpads
cd cdsc-etherpads
vim ETHERPAD_URLS # or whatever your preferred editor is!
##### EDIT TO ADD NEW URL #######
git add ETHERPAD_URLS
git commit -m 'added new cabal URL'
git push
</syntaxhighlight>