portals-jetspeed-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From a..@apache.org
Subject svn commit: r514321 - /portals/jetspeed-2/trunk/xdocs/getting-started-installer.xml
Date Sun, 04 Mar 2007 01:48:17 GMT
Author: ate
Date: Sat Mar  3 17:48:16 2007
New Revision: 514321

URL: http://svn.apache.org/viewvc?view=rev&rev=514321
Log:
Some additions

Modified:
    portals/jetspeed-2/trunk/xdocs/getting-started-installer.xml

Modified: portals/jetspeed-2/trunk/xdocs/getting-started-installer.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/xdocs/getting-started-installer.xml?view=diff&rev=514321&r1=514320&r2=514321
==============================================================================
--- portals/jetspeed-2/trunk/xdocs/getting-started-installer.xml (original)
+++ portals/jetspeed-2/trunk/xdocs/getting-started-installer.xml Sat Mar  3 17:48:16 2007
@@ -1,59 +1,60 @@
-<?xml version="1.0"?>
-<!--
-	Copyright 2004 The Apache Software Foundation
-	
-	Licensed 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.
--->
-<document>
-	<properties>
-		<title>
-			Getting Started with Jetspeed 2 using the installer
-		</title>
-		<subtitle>Installing Jetspeed-2 with the installer</subtitle>
-		<authors>
-			<person name="David Le Strat" email="dlestrat@apache.org" />
-		</authors>
-	</properties>
-	<body>
-		<section name="Jetspeed-2 Installer">
-			<subsection name="Getting Started with the Installer">
-			<p>
-			Once you have <a href="download.html">downloaded</a> the installer.  Jetspeed-2
provides 2 installers:
-			<ul>
-			<li>The minimal installation, containing only the core portal and administrative
portlets: 
-			<a href="http://www.apache.org/dyn/closer.cgi/portals/jetspeed-2/binaries/jetspeed-2.1-installer.jar">Standard
(Minimal) Installer</a></li>
-			<li>An installer for installing Jetspeed-2 on a third party database: 
-			<a href="http://www.apache.org/dyn/closer.cgi/portals/jetspeed-2/binaries/jetspeed-2.1-demo-install.jar">Jetspeed
Demo Installer</a></li>
-			</ul>
-			</p>
-			<p>
+<?xml version="1.0"?>
+<!--
+	Copyright 2004 The Apache Software Foundation
+	
+	Licensed 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.
+-->
+<document>
+	<properties>
+		<title>
+			Getting Started with Jetspeed 2 using the installer
+		</title>
+		<subtitle>Installing Jetspeed-2 with the installer</subtitle>
+		<authors>
+			<person name="David Le Strat" email="dlestrat@apache.org" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Jetspeed-2 Installer">
+			<subsection name="Getting Started with the Installer">
+			<p>
+			Jetspeed 2.1 provides 2 installers:
+			<ul>
+			<li>The minimal installation, containing only the core portal and administrative
portlets: 
+			<a href="http://www.apache.org/dyn/closer.cgi/portals/jetspeed-2/binaries/jetspeed-2.1-installer.jar">Standard
(Minimal) Installer</a></li>
+			<li>An installer for installing Jetspeed-2 on a third party database: 
+			<a href="http://www.apache.org/dyn/closer.cgi/portals/jetspeed-2/binaries/jetspeed-2.1-demo-install.jar">Jetspeed
Demo Installer</a></li>
+			</ul>
+			</p>
+			<p>
 			To run the standard (minimal) installer:
-			</p>
-			<source>
+			</p>
+			<source>
 java -jar jetspeed-2.1-installer.jar
             </source>
-            <p>
+            <p>
 To run the Jetspeed Demo installer:
             </p>
-            <source>
-java -jar jetspeed-2.1-demo-installer.jar
-			</source>
+            <source>
+java -jar jetspeed-2.1-demo-installer.jar
+			</source>
 			<p>	
-			To run the installer interactively, pass in the <b><i>text</i></b>
parameter:
+			The installers are capable of running on headless (i.e. no gui) machines, and will detect
so automatically.<br/>
+			To force the installer in text mode manually, pass in the <b><i>text</i></b>
parameter:
 			</p>
 			<source>
 java -jar jetspeed-2.1-installer.jar text	
-            </source>
+            </source>
 		    </subsection>
 		    <subsection name="Database Selection">
 		    <p>
@@ -62,7 +63,7 @@
 			If you selected Derby, you can go with the default parameters provided. For all other
databases you must first create an area to hold the Jetspeed tables.
 			For some databases this <i>area</i> is called a <i>catalog</i>,
others call it a <i>schema</i>, while others call it a <i>database</i>.
Consult your
 			database documentation for details on how to create a catalog or schema to hold the Jetspeed
tables. Additionally, you may need to create a database user
-			to access the Jetspeed tables. Often is required to grant access to the schemas (catalogs)
for the given user.
+			to access the Jetspeed tables. Often it is required to grant access to the schemas (catalogs)
for the given user.
 			</p>
 			<p>Jetspeed supported database list:
 			<ul>
@@ -76,62 +77,66 @@
 			<li>Manual database setup </li>
 			</ul>
 			</p>
-			<p>If you choose the manual database setup, then the database scripts will not be
run. You can configure the database at a later time.
-			All database scripts are provided in the installation under the <i>database</i>
directory. For your specific database, look under the corresponding directory name.
-			During installation, you will be prompted for the following fields after chosing your
database types:
-			<ul>
-			<li>A username</li>
-			<li>A password</li>
-			<li>A JDBC connection string</li>
-			<li>A JDBC driver name</li>
-			<li>The location of a valid JDBC driver.  The installer will copy the driver to
the installed location in Tomcat.</li>
+			<p>If you choose the manual database setup, then the database scripts will not be
run and you will need to configure the database manually after the installation.
+			All database scripts are provided in the installation under the <i>database</i>
directory. For your specific database, look for the corresponding directory name.
+			During installation, you will be prompted for the following fields after chosing your
database types (except for Derby):
+			<ul>
+			<li>A username</li>
+			<li>A password</li>
+			<li>A JDBC connection string</li>
+			<li>A JDBC driver name</li>
+			<li>The location of a valid JDBC driver.  The installer will copy this driver to
the installed location in Tomcat.</li>
 			</ul>
-			Note that only the Derby database has exact values for the JDBC connection string and
location of the JDBC driver.
 			The connections strings are only partially completed in the well-known format of the particular
databaes.
 			Please take care to complete the values in your connection string for your database. The
driver name should be the right
-			driver class for your database at the time of the making of this installation. Please
ensure that a newer driver is not required. 
-			Note that the location of the JDBC driver must be selected. We have not provided the file
system path to the jar file.
-			You may want to check and see if newer versions of the driver are available.
+			driver class for your database at the time of the making of this installation. Please
ensure that a newer driver is not required for your database. 
+			Note also that the location of the JDBC driver must be selected. We have not provided
the file system path to the jar file but only the likely file name.
+			You may want to check and see if newer versions of the driver are available.
 			</p>
 			<p>
-			Once you have entered all of your parameters, the installer we test the database connection
before proceeding.
-			The installer will not continue until it gets a valid connection. Once the installer verifies
the database connection,
-			you are ready to proceed with installation process. Please take note of the location where
you are installing on your file system.
+			Once you have entered all of your parameters, the installer will test the database connection
before proceeding.
+			If the connection fails, please go back to the connection configuration setup and provide
the correct parameters.
+			If you choose to continue, the database scripts will not be run and you will need to configure
the database manually after the installation.
+			Once the installer verifies the database connection, you are ready to proceed with installation
process.
+			</p>
+			<p>
+			Please take note of the location where you are installing on your file system.<br/>
+			Also, on a Windows platform make sure to use a location path without spaces, e.g. <i>NOT</i>
under C:\Program Files.
 			</p>
 			</subsection>
-			<subsection name="Starting Jetspeed-2">
-			<p>
+			<subsection name="Starting Jetspeed-2">
+			<p>
 			Once you have completed a successful install, you are ready to start the Jetspeed Portal.
-			On linux, here is an example where you have installed to the default location:
-			</p>
+			On linux, here is an example where you have installed to the default location:
+			</p>
 			<source>
 cd ~/jetspeed-2.1/bin
-./startup.sh
-			</source>
-			<p>
-			On windows, here is an example where you have installed to the default location:
-			</p>
-   			<source>
+./startup.sh
+			</source>
+			<p>
+			On windows, here is an example where you have installed to the default location:
+			</p>
+   			<source>
    cd C:\Apache\Jetspeed-2.1\bin
    startup.bat
-   			</source>
+   			</source>
    			<p>
  			The very first invocation of the portal requires anywhere from 10 seconds to 30 seconds
for initial 
    			startup and final installation. After starting the server, start up a web browser 
    			and navigate to <a href='http://localhost:8080/jetspeed/portal'>http://localhost:8080/jetspeed/portal</a>
   			
-			</p>
-			</subsection>
-			<subsection name="Login to Jetspeed-2">
+			</p>
+			</subsection>
+			<subsection name="Login to Jetspeed-2">
 			<p>
 All preconfigured users have the same password as username (for example the <i>admin</i>
user has the password <i>admin</i>)
 If you installed with the Minimal installer, two test accounts are available:
 			</p>
 			<source>
 admin 	  -- System administrator, super user
-devmgr 	  -- Delegated security manager, can manage users with the "dev" (developer) role
		
+devmgr 	  -- Delegated security manager, can manage users with the "dev" (developer) role
		
 		   </source>
 		   <p>
-If you installed with the Full Demo installer, several test accounts are available:		   
+If you installed with the Demo installer, several additional test accounts are available:
	   
  			</p>
  			<source>
 admin 	  -- System administrator, super user
@@ -142,8 +147,8 @@
 subsite   -- Example of how to setup users with a primary subsite role fallback profiling
rules
 subsite2  -- Example of how to setup users with a secondary subsite role fallback profiling
rules
 devmgr 	  -- Delegated security manager, can manage users with the "dev" (developer) role
			
- 			</source>
-			</subsection>
+ 			</source>
+			</subsection>
 			<subsection name="Jetspeed Desktop">
 			<p>
 The Jetspeed Desktop is a client-side JSR-168 aggregation engine.
@@ -170,7 +175,10 @@
 jdbc.url=jdbc:mysql://localhost:3306/prod-2
 jdbc.driver.class=com.mysql.jdbc.Driver			
 			</source>
+			<p>If you are configuring a database for the first time after choosing Manual database
setup in the installer, or want to try out
+				a different type of database, make sure to copy the specific JDBC driver for the database
to the Tomcat shared/lib folder <i>before</i> running ant.<br/>
+			Note: for Derby, the needed driver is already placed there or available from the database/lib
directory of your installed Jetspeed portal.</p>
 			</subsection>
-		</section>
-	</body>
-</document>
+		</section>
+	</body>
+</document>



---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


Mime
View raw message