Umlaut Installation - Revision history

Jrochkind at 16:20, 19 June 2012

2012-06-19T16:20:00Z

2010-02-08T15:55:37Z

marc requirement

2009-07-08T18:11:19Z

‎5. Configure SFX API to be used

2009-07-08T18:10:41Z

‎5. Configure SFX API to be used

2009-07-08T18:05:08Z

‎5. Configure SFX API to be used

2009-07-08T17:58:12Z

2009-07-01T19:31:00Z

‎4. Install Umlaut

2009-05-19T01:12:39Z

‎5. Install Umlaut's gem dependencies

2009-05-18T23:53:31Z

‎redhat

2009-05-18T23:52:46Z

‎redhat

← Older revision		Revision as of 16:20, 19 June 2012
Line 1:		Line 1:
	[[Category:Umlaut]]		[[Category:Umlaut]]
		+
		+	=WARNING: This is Outdated Documentation!!!!=
		+
		+	'''THIS IS OUTDATED DOCUMENTATION''' See new Umlaut documentation at http://github.com/team-umlaut/umlaut/wiki
		+	---------

	To install Umlaut		To install Umlaut

@@ Line 6: / Line 6: @@
 == 1. Make sure you have a modern Ruby ==
-Install a 1.8.x version of ruby, ruby 1.9 is still considered experimental. The Rails web page says "We recommend Ruby 1.8.7 for use with Rails. Ruby 1.8.6, 1.8.5, 1.8.4 and 1.8.2 are still usable too, but version 1.8.3 is not." (http://rubyonrails.org/download)   Try installing Ruby with your package manager of choice. If not, try installing from source, eg
+Install a 1.8.x version of ruby, ruby 1.9 is still considered experimental. The Rails web page says "We recommend Ruby 1.8.7 for use with Rails. Ruby 1.8.6, 1.8.5, 1.8.4 and 1.8.2 are still usable too, but version 1.8.3 is not."
 # [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.7.tar.gz]

@@ Line 134: / Line 134: @@
 == 5. Configure SFX API to be used ==
-On the SFX server that umlaut will be using as a datasource, make sure that the sfx api is turned on in the web-based admin tool (http://sfx.xxx.xxx.edu/sfxadmin/instance-name). This option can be found under the '''SFX API''' in the Menu Configuration Tool.  Make sure that the '''Include availability info in text format''' option and  '''Include availability info in structured XML format''' is checked.  Once these options have been checked, the sfx web server instance needs to be restarted.
+On the SFX server that umlaut will be using as a datasource, make sure that the sfx api is turned on in the web-based admin tool (http://sfx.xxx.xxx.edu/sfxadmin/instance-name). This option can be found under the '''SFX API''' in the Menu Configuration Tool.  Make sure that the '''Include availability info in text format''' and  '''Include availability info in structured XML format''' options are checked.  Once these options have been checked, the sfx web server instance needs to be restarted.
 == Now You Need to Setup Umlaut ==
 Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

@@ Line 134: / Line 134: @@
 == 5. Configure SFX API to be used ==
-On the SFX server that unlaut will be using as a datasource, make sure that the sfx api is turned on in the web-based admin tool (http://sfx.xxx.xxx.edu/sfxadmin/instance-name). This option can be found under the '''SFX API''' in the Menu Configuration Tool.  Make sure that the '''Include availability info in text format''' option and  '''Include availability info in structured XML format''' is checked.  Once these options have been checked, the sfx web server instance needs to be restarted.
+On the SFX server that umlaut will be using as a datasource, make sure that the sfx api is turned on in the web-based admin tool (http://sfx.xxx.xxx.edu/sfxadmin/instance-name). This option can be found under the '''SFX API''' in the Menu Configuration Tool.  Make sure that the '''Include availability info in text format''' option and  '''Include availability info in structured XML format''' is checked.  Once these options have been checked, the sfx web server instance needs to be restarted.
 == Now You Need to Setup Umlaut ==
 Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

@@ Line 134: / Line 134: @@
 == 5. Configure SFX API to be used ==
-this is a test
+On the SFX server that unlaut will be using as a datasource, make sure that the sfx api is turned on in the web-based admin tool (http://sfx.xxx.xxx.edu/sfxadmin/instance-name). This option can be found under the '''SFX API''' in the Menu Configuration Tool.  Make sure that the '''Include availability info in text format''' option and  '''Include availability info in structured XML format''' is checked.  Once these options have been checked, the sfx web server instance needs to be restarted.
 == Now You Need to Setup Umlaut ==
 Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

@@ Line 40: / Line 40: @@
 Right now, the best (only) way to install Umlaut is from it's SVN store.
-For a read-only checkout:
+For a read-only checkout of Umlaut 2.10.0 (If there is a more recent version, hopefully I'll remember to update it here, or ask me, or look around in the svn repo. 1 July 09):
 <pre>
-svn checkout http://umlaut.rubyforge.org/svn/trunk/  ./Umlaut
+svn checkout http://umlaut.rubyforge.org/svn/tags/2.10.0  ./Umlaut
 </pre>
@@ Line 51: / Line 51: @@
 <pre>
-svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
+svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/tags/2.10.0 ./Umlaut
 </pre>
 Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins.  You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn;  enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

← Older revision		Revision as of 01:12, 19 May 2009
Line 77:		Line 77:

	sudo gem install json -v 1.1.3		sudo gem install json -v 1.1.3
		+
		+	=== marc ===
		+
		+	A rubygem necessary for the generate script. Provides a ruby library for processing Machine Readable Cataloging (MARC) bibliographic data.
		+
		+	sudo gem install marc

	=== mysql ===		=== mysql ===

@@ Line 90: / Line 90: @@
 ===== redhat =====
 On a RedHat machine, this works:
   sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config
 ===== ubuntu =====

← Older revision		Revision as of 23:52, 18 May 2009
Line 94:		Line 94:

	sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config		sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config
		+
		+	on RedHat and CentOS machines, you will also need to have the mysql-devel package installed.

	===== ubuntu =====		===== ubuntu =====