X-Git-Url: https://dev.e-taxonomy.eu/gitweb/cdmlib.git/blobdiff_plain/ecd7f65ed7e1242db711a298bf8059d428109ba0..21dd08ab9eecc0e796e4f68f898d52d72951a369:/README.txt
diff --git a/README.txt b/README.txt
index 0fe5979e87..5a3d10740f 100644
--- a/README.txt
+++ b/README.txt
@@ -1 +1,51 @@
-Please see http://wp5.e-taxonomy.eu/cdmlib/getting-started.html on instructions how to set up your development environment.
\ No newline at end of file
+Please see http://wp5.e-taxonomy.eu/cdmlib/getting-started.html on instructions how to set up your development environment.
+
+
+If you do not have access to wp5.e-taxonomy.eu you can skip the following section.
+
+For deployment of files via maven, we are using the scpexe url scheme which effectively uses an external ssh command.
+Because we are using public/private key authentication on wp5.e-taxonomy.eu this is much easier to configure, test and debug.
+
+If you are deploying from Unix or have Cygwin installed you won't need any additional configuration in your settings.xml file as everything will be taken from the environment. However, if your username in the remote system is different from local you will have to create the entry in your settings.xml stating the username on the remote system:
+
+
+
+
+ wp5.e-taxonomy.eu
+ your username in the remote system
+
+
+
+
+If your private key is protected with a pass phrase you may want to also add the following option:
+
+
+
+
+ ....
+ some_passphrase
+
+
+
+
+Or you start the ssh-agent in advance. If you are using Cygwin you can add the following lines to your ~./.bashrc in order to optionally start the ssh-agent:
+
+#
+# Start the ssh-agent
+#
+echo "Start ssh-agent and add private ssh key? [y/n]"
+read START_SSH_AGENT
+
+if [ $START_SSH_AGENT = "y" -o $START_SSH_AGENT = "Y" ]; then
+ eval `ssh-agent -s`
+ ssh-add
+fi
+
+
+Instructions on how to set this up for Windows can be found here: http://maven.apache.org/plugins/maven-deploy-plugin/examples/deploy-ssh-external.html
+
+
+A dialog may pop up saying that a mapping for antrun and maybe others are missing.
+Just install all connectors that are available. The problem with antrun will then be solved by importing
+cdmlib/lifecycle-mapping-metadata.xml in the preferences under Maven->Lifecycle Mappings->Change mapping file location
+