Repository: airavata-docs Updated Branches: refs/heads/master 1b4410fe6 -> 493bc25aa
Added stesp to upgrade Airavata Project: http://git-wip-us.apache.org/repos/asf/airavata-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/airavata-docs/commit/493bc25a Tree: http://git-wip-us.apache.org/repos/asf/airavata-docs/tree/493bc25a Diff: http://git-wip-us.apache.org/repos/asf/airavata-docs/diff/493bc25a Branch: refs/heads/master Commit: 493bc25aa37c21f3c6b81d8c89c74012a5cd2399 Parents: 1b4410f Author: Eroma Abeysinghe <eroma.abeysin...@gmail.com> Authored: Fri May 13 12:14:21 2016 -0400 Committer: Eroma Abeysinghe <eroma.abeysin...@gmail.com> Committed: Fri May 13 12:14:21 2016 -0400 ---------------------------------------------------------------------- Airavata-Upgrades.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/airavata-docs/blob/493bc25a/Airavata-Upgrades.md ---------------------------------------------------------------------- diff --git a/Airavata-Upgrades.md b/Airavata-Upgrades.md index ea04b17..ec2712c 100644 --- a/Airavata-Upgrades.md +++ b/Airavata-Upgrades.md @@ -1 +1,37 @@ ## Airavata Code Upgrade + +### Updating Airavata Codebase +1. In order to update Airavata with latest master code; go to the folder (Created in installation; LocalAiravata) initially created to clone Airavata. +2. Within your local folder navigate to folder 'airavata' and execute <pre><code>git pull </code></pre> +Hint: If you are in the wrong folder you would probably get message <pre><code>'fatal: Not a git repository (or any of the parent directories): .git'</code></pre> +3. Now build the code +<pre><code> mvn clean install</code></pre> +Hint: To avoid the 'tests on install' run <pre><code>mvn clean install -Dmaven.test.skip=true</code></pre> +4. Once the build is success, stop the running Airavata server. You can either stop the java server using +<pre><code>kill -9 <process ID></code></pre> +OR<br> +Navigate to bin folder where airavata server exists (LocalAiravata/apache-airavata-server-0.15-SNAPSHOT/bin). and stop the server +<pre><code>./airavata-server.sh stop -force</code></pre> +5. For references, back up the currently existing release +<pre><code>mv apache-airavata-server-0.15-SNAPSHOT apache-airavata-server-0.15-SNAPSHOT-bk</code></pre> +6. Copy the new release to your local folder (LocalAiravata) +<pre><code>cp /<path to created folder>/LocalAiravata/airavata/distribution/target/apache-airavata-server-0.16-SNAPSHOT-bin.tar.gz .</code></pre> +7. Un-tar the copied new release +<pre><code>tar -xvf apache-airavata-server-0.16-SNAPSHOT-bin.tar.gz</code></pre> +8. Navigate to the new bin folder and back up airavata-server.properties and gfac-config.yaml files. +8. Copy your previously used airavata-server.properties from the backed up release to bin folder (This is the easiest way to get the properties file updated. If you prefer, you can change the new file manually. ☺) +<pre><code>/<your local path>/LocalAiravata/LocalAiravata/apache-airavata-server-0.16-SNAPSHOT-bk/bin/airavata-server.properties .</code></pre> +9. Copy your previously used gfac-config.yaml from the backed up release +<pre><code>cp /<your local path>/LocalAiravata/apache-airavata-server-0.16-SNAPSHOT-bk/bin/gfac-config.yaml .</code></pre> +10. Now compare with the new airavata-server.properties and gfac-config.yaml and make necessary changes in the copied files. +11. Check the path correctness of credential store keystore in airavata-server.properties file. +<pre><code>credential.store.keystore.url=/<your local path>/LocalAiravata/airavata_sym.jks</code></pre> +12. Go to lib folder and copy mySQL jar (mysql-connector-java-5.1.38-bin.jar) from old backed up lib to the new lib +<pre><code> cp /home/airavata/LocalAiravata/apache-airavata-server-0.16-SNAPSHOT-bk/lib/mysql-connector-java-5.1.38-bin.jar .</code></pre> +13. Now restart airavata server in bin folder +<pre><code>./airavata-server.sh start</code></pre> + + + + +