You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by el...@apache.org on 2014/10/07 08:52:15 UTC
svn commit: r1629812 - in
/directory/site/trunk/content/fortress/quick-start/apacheds:
apacheds.mdtext guidelines.mdtext prerequisites.mdtext section-I.mdtext
Author: elecharny
Date: Tue Oct 7 06:52:15 2014
New Revision: 1629812
URL: http://svn.apache.org/r1629812
Log:
Added teh first ApacheDS pagesé
Added:
directory/site/trunk/content/fortress/quick-start/apacheds/apacheds.mdtext
directory/site/trunk/content/fortress/quick-start/apacheds/guidelines.mdtext
directory/site/trunk/content/fortress/quick-start/apacheds/prerequisites.mdtext
directory/site/trunk/content/fortress/quick-start/apacheds/section-I.mdtext
Added: directory/site/trunk/content/fortress/quick-start/apacheds/apacheds.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/fortress/quick-start/apacheds/apacheds.mdtext?rev=1629812&view=auto
==============================================================================
--- directory/site/trunk/content/fortress/quick-start/apacheds/apacheds.mdtext (added)
+++ directory/site/trunk/content/fortress/quick-start/apacheds/apacheds.mdtext Tue Oct 7 06:52:15 2014
@@ -0,0 +1,42 @@
+Title: Quick start guide for ApacheDS
+NavUp: ../../user-guide.html
+NavUpText: User Guide
+NavNext: prerequisites.html
+NavNextText: System Prerequisites
+Notice: 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.
+
+These instructions are intended for new users who want to quickly learn how to install and test Apache Fortress and ApacheDS IAM software.
+
+Follow the steps and ApacheDS will be installed, configured, loaded, and ready to use by [Section IV](section-IV.html). EnMasse Policy Server demo starts in [Section VIII](section-VIII.html)
+
+### Table of contents
+
+* [System Prerequisites](prerequisites.html)
+* [Guidelines and Tips for first-time users](guidelines.html)
+* [Section I - Instructions to extract and configure Fortress Builder Package](section-I.html)
+* [Section II - Instructions to run the Fortress Ant Build](section-II.html)
+* [Section III - Instructions to configure ApacheDS and load with seed data](section-III.html)
+* [Section IV - Instructions to regression test Fortress and ApacheDS](section-IV.html)
+* [Section V - Instructions to run the Fortress Command Line Interpreter (CLI) utility](section-V.html)
+* [Section VI - Instructions to run Fortress Console](section-VI.html)
+* [Section VII - Instructions to generate and view Javadoc](section-VII.html)
+* [Section VIII - Instructions to install EnMasse Policy Server Demo (CLI)](section-VIII.html)
+* [Section IX - Instructions to regression test EnMasse Policy server](section-IX.html)
+* [Section X - More Utilities](section-X.html)
+
+
Added: directory/site/trunk/content/fortress/quick-start/apacheds/guidelines.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/fortress/quick-start/apacheds/guidelines.mdtext?rev=1629812&view=auto
==============================================================================
--- directory/site/trunk/content/fortress/quick-start/apacheds/guidelines.mdtext (added)
+++ directory/site/trunk/content/fortress/quick-start/apacheds/guidelines.mdtext Tue Oct 7 06:52:15 2014
@@ -0,0 +1,33 @@
+Title: Guidelines and Tips for first-time users
+NavPrev: apacheds.html
+NavPrevText: Quickstart ApacheDS - Table of contents
+NavUp: apacheds.html
+NavUpText: Quickstart ApacheDS - Table of contents
+NavNext: section-I.html
+NavNextText: Section I - Instructions to extract and configure Fortress Builder Package
+Notice: 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.
+
+# Guidelines and Tips for first-time users
+
+
+In the document that follows, when you read \[version\] or [platform] substitute with current package info. For example - if the downloaded package version is 1.0.0 and platform is 'Debian Silver i386', the instructions show fortressBuilder-\[platform\]-\[version\].jar your file name would be fortressBuilder-Debian-Silver-i386-1.0.0.zip
+
+Is your target machine windows? Go to [README-QUICKSTART-WINDOWS](../windows/windows.html).
+
+The source code for this project is located here ./src.
+
Added: directory/site/trunk/content/fortress/quick-start/apacheds/prerequisites.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/fortress/quick-start/apacheds/prerequisites.mdtext?rev=1629812&view=auto
==============================================================================
--- directory/site/trunk/content/fortress/quick-start/apacheds/prerequisites.mdtext (added)
+++ directory/site/trunk/content/fortress/quick-start/apacheds/prerequisites.mdtext Tue Oct 7 06:52:15 2014
@@ -0,0 +1,38 @@
+Title: System Prequesites
+NavPrev: apacheds.html
+NavPrevText: Quickstart ApacheDS - Table of contents
+NavUp: apacheds.html
+NavUpText: Quickstart ApacheDS - Table of contents
+NavNext: guidelines.html
+NavNextText: Guidelines and Tips for first-time users
+Notice: 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.
+
+# System Prerequisites
+
+* Internet access to retrieve binary dependencies from online Maven repo.
+* Java SDK Version 7 or beyond installed to target environment
+* Redhat or Ubuntu server machine
+* 1GB RAM
+* 20GB HD
+* ApacheDS pre-installed
+
+NOTE: The Fortress build.xml may run without connection to Internet if:
+
+* The binary dependencies have previously been downloaded to FORTRESS_HOME/lib folder
+* Local mode has been enabled on target machine. Local mode can be enabled by adding this property to build.properties: _local.mode=true_
+
Added: directory/site/trunk/content/fortress/quick-start/apacheds/section-I.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/fortress/quick-start/apacheds/section-I.mdtext?rev=1629812&view=auto
==============================================================================
--- directory/site/trunk/content/fortress/quick-start/apacheds/section-I.mdtext (added)
+++ directory/site/trunk/content/fortress/quick-start/apacheds/section-I.mdtext Tue Oct 7 06:52:15 2014
@@ -0,0 +1,72 @@
+Title: Section I - Instructions to extract and configure Fortress Builder Package
+NavPrev: guidelines.html
+NavPrevText: Guidelines and Tips for first-time users
+NavUp: apacheds.html
+NavUpText: Quickstart Apacheds - Table of contents
+NavNext: section-II.html
+NavNextText: Section II - Instructions to run the Fortress Ant Build
+Notice: 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.
+
+## Section I - Instructions to extract and configure Fortress Builder Package to Target System
+
+### Step 1
+
+Copy fortressBuilder-\[platform\]-\[version\].zip to hard drive on target server env.
+
+### Step 2
+
+Extract the zip. The location for archive can vary according to requirements. The location of package will be referred to as FORTRESS_HOME later on.
+
+### Step 3
+
+Enable permission for the binaries to execute. From FORTRESS_HOME root folder, enter the following command from a system prompt:
+
+ chmod a+x -Rf *
+
+<CENTER>
+ <IMG src="../../images/Screenshot1-chmod.png" alt="Screenshot" width="766" height="58"/>
+</CENTER>
+
+### Step 4
+
+Edit file named 'build.properties' and insert LDAP configuration parameters:
+
+ ldap.server.type=apacheds
+
+ # These parameters point fortress to LDAP host:
+ ldap.host=localhost
+ ldap.port=10389
+
+ # These are used to construct suffix for DIT, i.e. dc=example,dc=com.
+ suffix.name=example
+ suffix.dc=com
+
+ # These are the connection parameters used for LDAP service account:
+ root.dn=uid=admin,ou=system
+
+ # Used to load OpenLDAP admin root password in slapd.conf and was encrypted using 'slappasswd' command:
+ # This ApacheDS admin root password's value is 'secret', is bound for fortress.properties and was encrypted
+ # using 'encrypt' target in build.xml:
+ cfg.root.pw=W7T0G9hylKZQ4K+DF8gfgA==
+
+ # If encryption of LDAP &/or HTTP service account passwords (e.g. cfg.root.pw,
+ # cfg.log.root.pw and http.pw params) is required, this field must be set.
+ # If encryption of service accounts not needed, leave this value blank, and set the password values for
+ # cfg.root.pw, cfg.log.root.pw and http.pw to be their clear text value.
+ # Use any arbitrary value here but must be same as key used to encrypt.
+ crypto.prop=abcd12345