Author: tfischer
Date: Thu Sep 23 08:50:08 2010
New Revision: 1000356
URL: http://svn.apache.org/viewvc?rev=1000356&view=rev
Log:
detail site deploy howto
Modified:
db/torque/torque4/trunk/torque-site/src/site/xdoc/developer-info/site-edit-deploy.xml
Modified:
db/torque/torque4/trunk/torque-site/src/site/xdoc/developer-info/site-edit-deploy.xml
URL:
http://svn.apache.org/viewvc/db/torque/torque4/trunk/torque-site/src/site/xdoc/developer-info/site-edit-deploy.xml?rev=1000356&r1=1000355&r2=1000356&view=diff
==============================================================================
---
db/torque/torque4/trunk/torque-site/src/site/xdoc/developer-info/site-edit-deploy.xml
(original)
+++
db/torque/torque4/trunk/torque-site/src/site/xdoc/developer-info/site-edit-deploy.xml
Thu Sep 23 08:50:08 2010
@@ -86,30 +86,63 @@
<section name="Deploying the site">
<p>
This is a step-by-step guide to deploy the whole site.
- The guide assumes that the necessary ssh properties and maven properties
- are set.
+ The guide assumes that putty on windows is used as ssh tool.
+ First, an entry for the site must be created in maven's setting.xml,
+ e.g.:
+ </p>
+ <source><![CDATA[
+ <server>
+ <id>apache.db.torque.site</id>
+ <username>tfischer</username>
+ <filePermissions>664</filePermissions>
+ <directoryPermissions>775</directoryPermissions>
+ <configuration>
+ <sshExecutable>C:/Programme/PuTTY/plink</sshExecutable>
+ <scpExecutable>C:/Programme/PuTTY/pscp</scpExecutable>
+ </configuration>
+ </server>]]>
+ </source>
+ <p>
+ Then an appropriate private key must be created using puttygen.
+ Save the key at a safe place locally, and paste the public key to the
+ ~/.ssh/authorized_keys2 file relative to your home directory
+ on people.apache.org.
+ </p>
+ <p>
+ Now you can begin to build and deploy the site:
</p>
<ul>
<li>
- It might be a good idea to create a tar.gz backup of the current
- state of the site in your home directory, in case anything goes
- wrong.
+ run "mvn clean post-site" in the torque-parent module.
+ </li>
+ <li>
+ check the site in torque-site/target/site
</li>
<li>
- run "mvn install" in the torque-parent module.
+ Start putty's pageant.
</li>
<li>
- run "mvn post-site" in the torque-parent module.
+ Load the private key you have generated previously into pageant.
</li>
<li>
- check the site in torque-site/target/site
+ It might be a good idea to create a tar.gz backup of the current
+ state of the site in your apache home directory, in case anything goes
+ wrong.
</li>
<li>
run mvn site:deploy in the torque-site module.
</li>
<li>
+ Wait till the site is rsynced to the apache web servers
+ (might take some hours). Alternatively, check
+ <a
href="http://www.apache.org/dev/project-site.html";>http://www.apache.org/dev/project-site.html</a>
+ for a proxy setting which allows to look at the newly deployed site
+ before the rsync happens,
+ but this might not work under all circumstances.
+ </li>
+ <li>
Empty the cache of your browser and check everything is ok on
- <a
href="http://db.apache.org/torque/";>http://db.apache.org/torque/</a>
+ <a
href="http://db.apache.org/torque/releases/torque-4.0/index.html";>http://db.apache.org/torque/releases/torque-4.0/index.html</a>
</li>
<li>
If you are satisfied with the new site and no-one complains during
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
