diff options
Diffstat (limited to 'archiva-site/src/site')
-rw-r--r-- | archiva-site/src/site/apt/guides/getting-started.apt | 73 | ||||
-rw-r--r-- | archiva-site/src/site/apt/guides/maven-configuration.apt | 18 | ||||
-rw-r--r-- | archiva-site/src/site/xdoc/hacking/index.xml | 2 |
3 files changed, 21 insertions, 72 deletions
diff --git a/archiva-site/src/site/apt/guides/getting-started.apt b/archiva-site/src/site/apt/guides/getting-started.apt index d01cdbdc2..f8d6c42b6 100644 --- a/archiva-site/src/site/apt/guides/getting-started.apt +++ b/archiva-site/src/site/apt/guides/getting-started.apt @@ -26,41 +26,21 @@ ~~ NOTE: For help with the syntax of this file, see: ~~ http://maven.apache.org/guides/mini/guide-apt-format.html -To checkout the latest code - - Using Subversion, either checkout from {{http://svn.apache.org/repos/asf/maven/archiva/trunk/}} or to get all of Maven 2, checkout from {{http://svn.apache.org/repos/asf/maven/trunks/}}. - -To build - - If this is the first time, and if you've not pulled this down for some other reason then it will save time to do the following first: - - * Download the 1.0 connector zip from: {{http://java.sun.com/j2ee/connector/download.html}} - - * Unpack the zip to get the jar - - * Run: mvn install:install-file -DgroupId=javax.resource -DartifactId=connector -Dversion=1.0 -Dpackaging=jar -Dfile=connector.jar - - * Download the 1.0.1B jta zip from: {{http://java.sun.com/products/jta/}} - - * Install it: mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=jta-1_0_1B-classes.zip - - Otherwise: - - * Build Archiva: mvn install - +To deploy Archiva on Plexus -To test-deploy Archiva on the embedded Jetty + Plexus is a container developed as a part of Maven. It provides a very simple way to get started with Archiva: - * cd archiva-web/archiva-webapp + * Unpack the archiva-plexus-runtime/target/archiva-bin.tar.gz archive into a directory of your choice. - * mvn jetty:run + * Start with: ./bin/plexus.sh start or a platform specific version. + * A Derby exception "Schema 'SA' does not exist" occurs, but is not of concern. -To deploy Archiva to Tomcat 5.5 +To deploy Archiva on Tomcat 5.5 * Create a directory in tomcat called archiva, at the same level as bin, conf, logs and the others. - * Copy the war file from archiva/archiva-webapp/target into the new directory + * Copy the war file from apps/archiva/lib into the new directory * Create a conf/Catalina/localhost/archiva.xml file with the following data: @@ -92,9 +72,11 @@ To deploy Archiva to Tomcat 5.5 instead, or see {{{http://issues.apache.org/bugzilla/show_bug.cgi?id=40668} Bug 40668}} for a workaround. - * Copy $HOME/.m2/org/apache/derby/derby/10.1.3.1/derby-10.1.3.1.jar (or from the remote repository) into the tomcat common/lib + * Copy $HOME/.m2/org/apache/derby/derby/10.1.3.1/derby-10.1.3.1.jar (or from the remote repository) into the Tomcat + common/lib - * To deal with a current bug, you'll also need to add the following to your ${catalina.home}/conf/web.xml in the relevant section (search for jspx): + * To deal with a current bug, you'll also need to add the following to your ${catalina.home}/conf/web.xml in the + relevant section (search for jspx): +-------------------------------------------------------------------------+ <servlet-mapping> @@ -103,38 +85,21 @@ To deploy Archiva to Tomcat 5.5 </servlet-mapping> +-------------------------------------------------------------------------+ - When you first start Archiva, you will see an Exception that schema SA does not exist - however it doesn't appear to cause a problem. If you use a username other than 'sa', such as 'archiva', then you seem to get the same error but Tomcat fails to start the context and you have to shutdown and restart again. - - -To deploy Archiva on Plexus - - Plexus is a container developed as a part of Maven. It provides a very simple way to get started with Archiva: - - * Unpack the archiva-plexus-runtime/target/archiva-bin.tar.gz archive into a directory of your choice. - - * Start with: ./bin/plexus.sh start or a platform specific version. - - * A Derby exception "Schema 'SA' does not exist" occurs, but is not of concern. - + When you first start Archiva, you will see an Exception that schema SA does not exist - however it doesn't appear to + cause a problem. If you use a username other than 'sa', such as 'archiva', then you seem to get the same error but + Tomcat fails to start the context and you have to shutdown and restart again. Setting up your Archiva instance - * Goto {{http://localhost:9091/}} if on the embedded Jetty, {{http://localhost:8080/archiva/}} if on Tomcat or {{http://localhost:8080/archiva/}} if on Plexus. + * Goto {{http://localhost:8080/archiva/}} - * On the first page - setup your administration user. The password requires a numerical character and must not be longer than 8 chars. You'll then need to log in. User 'admin' as the username and the password you've entered. + * On the first page - setup your administration user. The password requires a numerical character and must not be + longer than 8 chars. You'll then need to log in. User 'admin' as the username and the password you've entered. * On the second page - setup your first repository. It can be both an m1 and an m2 repository. - * On the third page - setup your indexing. Mostly this means choosing a directory to put the index in. It'll re-index every hour. - - A useful repository to setup when exploring is your local Maven repository. - -+-------------------------------------------------------------------------+ - Identifier: LOCAL - Name: Maven2 Local Repository - Location: $HOME/.m2/repository -+-------------------------------------------------------------------------+ - + * On the third page - setup your indexing. Mostly this means choosing a directory to put the index in. It'll + re-index every hour. Updating Archiva within a Tomcat diff --git a/archiva-site/src/site/apt/guides/maven-configuration.apt b/archiva-site/src/site/apt/guides/maven-configuration.apt index e4b868b73..672ea2e51 100644 --- a/archiva-site/src/site/apt/guides/maven-configuration.apt +++ b/archiva-site/src/site/apt/guides/maven-configuration.apt @@ -93,22 +93,6 @@ Configuring Maven-2 to use an Archiva repository </repository> +-------------------------------------------------------------------------+ - You can also copy this for a proxied repository, but make sure to change /repository/ to /proxy/ and to change from the "URL Name" to the "Repository Identifier". This should look much like this: - -+-------------------------------------------------------------------------+ - <repository> - <id>maven-release</id> - <url>URL-TO-ARCHIVA/proxy/REPOSITORY-ID</url> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>false</enabled> - </snapshots> - </repository> -+-------------------------------------------------------------------------+ - - * Configuring Maven-2 to deploy to an Archiva repository [[1]] Create a user in Archiva to use for deployment @@ -165,7 +149,7 @@ Configuring Maven-2 to use an Archiva repository <extension> <groupId>org.apache.maven.wagon</groupId> <artifactId>wagon-webdav</artifactId> - <version>1.0-beta-1</version> + <version>1.0-beta-2</version> </extension> </extensions> </build> diff --git a/archiva-site/src/site/xdoc/hacking/index.xml b/archiva-site/src/site/xdoc/hacking/index.xml index 7628e6676..1ea54c7f6 100644 --- a/archiva-site/src/site/xdoc/hacking/index.xml +++ b/archiva-site/src/site/xdoc/hacking/index.xml @@ -288,7 +288,7 @@ libwrapper.so run.sh wrapper wrapper.conf </ul> <li>Types of Repositories</li> <ul> - <li>Local / Managed</li> + <li>Managed</li> <ul> <li>file://... URLs only</li> <li>Indexed</li> |