From: Olivier Lamy Date: Sat, 24 Nov 2012 08:19:14 +0000 (+0000) Subject: add link to configuration file reference X-Git-Tag: archiva-1.4-M4~583 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=2bd1d088ff6639400e7e669aa159ba4c345e6ee9;p=archiva.git add link to configuration file reference git-svn-id: https://svn.apache.org/repos/asf/archiva/trunk@1413144 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/archiva-docs/src/site/apt/adminguide/configuration-files.apt b/archiva-docs/src/site/apt/adminguide/configuration-files.apt deleted file mode 100644 index 9c5cee597..000000000 --- a/archiva-docs/src/site/apt/adminguide/configuration-files.apt +++ /dev/null @@ -1,86 +0,0 @@ - ------ - Configuration Files of Apache Archiva - ------ - ------ - 2011-09-16 - ------ - -~~ Licensed to the Apache Software Foundation (ASF) under one -~~ or more contributor license agreements. See the NOTICE file -~~ distributed with this work for additional information -~~ regarding copyright ownership. The ASF licenses this file -~~ to you under the Apache License, Version 2.0 (the -~~ "License"); you may not use this file except in compliance -~~ with the License. You may obtain a copy of the License at -~~ -~~ http://www.apache.org/licenses/LICENSE-2.0 -~~ -~~ Unless required by applicable law or agreed to in writing, -~~ software distributed under the License is distributed on an -~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -~~ KIND, either express or implied. See the License for the -~~ specific language governing permissions and limitations -~~ under the License. - -Configuration Files of Apache Archiva - - While Archiva is primarily configured via the graphical administration interface, it stores all configuration in XML configuration - files that can be hand edited and used for backup and migration. - - The following files compose the configuration for Archiva: - - * <<>> - this is the primary Archiva configuration file - - * <<>> - this configures the security as described in the {{{./security.html} security configuration documentation}} - - This section will focus on the <<>> file. - -* The Archiva configuration file - - The Archiva configuration file is stored in one of two locations: - - * The application server configuration directory (see {{{./standalone.html} installing Archiva standalone}} for more information) - - * The user home directory (<<<~/.m2/archiva.xml>>>). - - [] - - When modified in the GUI, the file is written back to the location it was initially read from, with the home directory taking priority if both exist. When using a - standalone installation, it is highly recommended that a configuration file is only maintained in one of the locations. - - The following shows a basic configuration file: - -+----+ - - 2 - - - ${appserver.base}/repositories/internal - 30 - internal - Archiva Managed Internal Repository - - - - - http://repo1.maven.org/maven2 - central - Central Repository - - - - - internal - central - - always - fix - never - no - - - - -+----+ - - ~~TODO: need a full reference diff --git a/archiva-docs/src/site/apt/adminguide/configuration-files.apt.vm b/archiva-docs/src/site/apt/adminguide/configuration-files.apt.vm new file mode 100644 index 000000000..7b7fe8e55 --- /dev/null +++ b/archiva-docs/src/site/apt/adminguide/configuration-files.apt.vm @@ -0,0 +1,88 @@ + ------ + Configuration Files of Apache Archiva + ------ + ------ + 2012-11-24 + ------ + +~~ Licensed to the Apache Software Foundation (ASF) under one +~~ or more contributor license agreements. See the NOTICE file +~~ distributed with this work for additional information +~~ regarding copyright ownership. The ASF licenses this file +~~ to you under the Apache License, Version 2.0 (the +~~ "License"); you may not use this file except in compliance +~~ with the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, +~~ software distributed under the License is distributed on an +~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +~~ KIND, either express or implied. See the License for the +~~ specific language governing permissions and limitations +~~ under the License. + +Configuration Files of Apache Archiva + + While Archiva is primarily configured via the graphical administration interface, it stores all configuration in XML configuration + files that can be hand edited and used for backup and migration. + + The following files compose the configuration for Archiva: + + * <<>> - this is the primary Archiva configuration file + + * <<>> - this configures the security as described in the {{{./security.html} security configuration documentation}} + + This section will focus on the <<>> file. + +* The Archiva configuration file + + The Archiva configuration file is stored in one of two locations: + + * The application server configuration directory (see {{{./standalone.html} installing Archiva standalone}} for more information) + + * The user home directory (<<<~/.m2/archiva.xml>>>). + + [] + + When modified in the GUI, the file is written back to the location it was initially read from, with the home directory taking priority if both exist. When using a + standalone installation, it is highly recommended that a configuration file is only maintained in one of the locations. + + For a complete reference of the configuration file see: {{{http://archiva.apache.org/ref/${project.version}/archiva-base/archiva-configuration/configuration.html}Reference}} + + The following shows a basic configuration file: + ++----+ + + 2 + + + ${appserver.base}/repositories/internal + 30 + internal + Archiva Managed Internal Repository + + + + + http://repo1.maven.org/maven2 + central + Central Repository + + + + + internal + central + + always + fix + never + no + + + + ++----+ + + ~~TODO: need a full reference