ApacheConfigMigration - Revision history

Tmb: /* Apache Configuration in 3.1 */

2013-07-18T09:14:33Z

Apache Configuration in 3.1

← Older revision		Revision as of 09:14, 18 July 2013
Line 17:		Line 17:
	└── var		└── var
	├── auto-apache.conf		├── auto-apache.conf
	~~├──~~ auto-secure.conf		└── auto-secure.conf
	~~└── entities.dtd~~

	''Note auto-secure.conf will only be present if using SSL		''Note auto-secure.conf will only be present if using SSL

Tmb at 08:57, 18 July 2013

2013-07-18T08:57:54Z

← Older revision		Revision as of 08:57, 18 July 2013
Line 22:		Line 22:
	''Note auto-secure.conf will only be present if using SSL		''Note auto-secure.conf will only be present if using SSL

	===File Overview===		===File Overview (3.1)===

	'''cfg/apache.conf		'''cfg/apache.conf
Line 53:		Line 53:
	* Repository-specific SSL configuration (note no VirtualHost)		* Repository-specific SSL configuration (note no VirtualHost)

	===Loading into Apache===		===Loading into Apache (3.1)===

	'''Example 1 - Debian/Ubuntu		'''Example 1 - Debian/Ubuntu
Line 107:		Line 107:
	'''Note apache_ssl* files will only be present if using SSL.		'''Note apache_ssl* files will only be present if using SSL.

	===File Overview===		===File Overview (3.2+)===

	'''cfg/apache.conf		'''cfg/apache.conf
Line 128:		Line 128:
	* Repository-specific SSL configuration (note no VirtualHost)		* Repository-specific SSL configuration (note no VirtualHost)

	===Loading into Apache===		===Loading into Apache (3.2+)===

	'''Example 1 - Debian/Ubuntu		'''Example 1 - Debian/Ubuntu

Tmb: /* Loading into Apache */

2013-07-18T08:57:10Z

Loading into Apache

← Older revision		Revision as of 08:57, 18 July 2013
Line 81:		Line 81:
	...		...
	Include /opt/eprints3/cfg/apache.conf		Include /opt/eprints3/cfg/apache.conf

			''Note if EPrints is installed from RPM, check /etc/httpd/conf.d/eprints.conf

	SSL - load the repository-specific SSL configuration from inside an SSL VirtualHost:		SSL - load the repository-specific SSL configuration from inside an SSL VirtualHost:

Tmb: /* Loading into Apache */

2013-07-18T08:56:27Z

Loading into Apache

← Older revision		Revision as of 08:56, 18 July 2013
Line 156:		Line 156:
	...		...
	Include /opt/eprints3/cfg/apache.conf		Include /opt/eprints3/cfg/apache.conf

			''Note if EPrints is installed from RPM, check /etc/httpd/conf.d/eprints.conf

	SSL - load the repository-specific SSL configuration from inside an SSL VirtualHost:		SSL - load the repository-specific SSL configuration from inside an SSL VirtualHost:

Tmb: /* Loading into Apache */

2013-07-18T08:42:19Z

Loading into Apache

← Older revision		Revision as of 08:42, 18 July 2013
Line 146:		Line 146:
	</IfModule>		</IfModule>
	$ a2ensite default-ssl		$ a2ensite default-ssl

			''Note: this assumes a single SSL repository or multiple SSL repositories sharing the same <tt>securehost</tt> - for multiple repositories with different <tt>securehost</tt> settings each reposity-specific SSL configuration file may need to be loaded in a separate VirtualHost.

	'''Example 2 - RedHat/CentOS		'''Example 2 - RedHat/CentOS
Line 163:		Line 165:
	Include /opt/eprints3/cfg/apache_ssl.conf		Include /opt/eprints3/cfg/apache_ssl.conf
	</VirtualHost>		</VirtualHost>

			''Note: this assumes a single SSL repository or multiple SSL repositories sharing the same <tt>securehost</tt> - for multiple repositories with different <tt>securehost</tt> settings each reposity-specific SSL configuration file may need to be loaded in a separate VirtualHost.

	==Migrating apache configuration from 3.1 to 3.2+==		==Migrating apache configuration from 3.1 to 3.2+==

Tmb: /* Apache Configuration in 3.1 */

2013-07-18T08:40:00Z

Apache Configuration in 3.1

← Older revision		Revision as of 08:40, 18 July 2013
Line 91:		Line 91:
	</VirtualHost>		</VirtualHost>

	==Apache Configuration in 3.1==		==Apache Configuration in 3.2+==

	From 3.2 onwards things were simplified - there are fewer configuration files in a single location. The configuration files are shorter as much of the processing was moved into the EPrints::Apache::Rewrite module.		From 3.2 onwards things were simplified - there are fewer configuration files in a single location. The configuration files are shorter as much of the processing was moved into the EPrints::Apache::Rewrite module.

Tmb: /* Loading into Apache */

2013-07-18T08:39:04Z

Loading into Apache

← Older revision		Revision as of 08:39, 18 July 2013
Line 126:		Line 126:
	* Repository-specific SSL configuration (note no VirtualHost)		* Repository-specific SSL configuration (note no VirtualHost)

	==Loading into Apache==		===Loading into Apache===

	'''Example 1 - Debian/Ubuntu		'''Example 1 - Debian/Ubuntu

Tmb: /* Loading into Apache */

2013-07-18T08:38:55Z

Loading into Apache

← Older revision		Revision as of 08:38, 18 July 2013
Line 53:		Line 53:
	* Repository-specific SSL configuration (note no VirtualHost)		* Repository-specific SSL configuration (note no VirtualHost)

	==Loading into Apache==		===Loading into Apache===

	'''Example 1 - Debian/Ubuntu		'''Example 1 - Debian/Ubuntu

Tmb: /* Migrating apache configuration from 3.1 to 3.2+ */

2013-07-18T08:38:07Z

Migrating apache configuration from 3.1 to 3.2+

← Older revision		Revision as of 08:38, 18 July 2013
Line 169:		Line 169:

	# Back up the 3.1 apache configuration files		# Back up the 3.1 apache configuration files
	# Check for any custom directives added to 3.1 apache config files, in particular <tt>cfg/apache.conf</tt>, <tt>archives/<ARCHIVEID>/cfg/apache~~.conf</tt> and <tt>archives/<ARCHIVEID>/cfg/apachevhost~~.conf</tt>		# Check for any custom directives added to 3.1 apache config files, in particular <tt>cfg/apache.conf</tt> and <tt>archives/<ARCHIVEID>/cfg/apache.conf</tt>
	# Run <tt>bin/generate_apacheconf --system --replace</tt> - this will generate the new apache configuration files as above		# Run <tt>bin/generate_apacheconf --system --replace</tt> - this will generate the new apache configuration files as above
	# If using SSL change the top level apache SSL configuration file to load <tt>/opt/eprints3/cfg/apache_ssl.conf</tt> instead of <tt>/opt/eprints3/archives/<ARCHIVEID>/var/auto-secure.conf</tt>		# If using SSL change the top level apache SSL configuration file to load <tt>/opt/eprints3/cfg/apache_ssl.conf</tt> instead of <tt>/opt/eprints3/archives/<ARCHIVEID>/var/auto-secure.conf</tt>

Tmb: /* Migrating apache configuration from 3.1 to 3.2+ */

2013-07-18T08:37:04Z

Migrating apache configuration from 3.1 to 3.2+

← Older revision		Revision as of 08:37, 18 July 2013
Line 169:		Line 169:

	# Back up the 3.1 apache configuration files		# Back up the 3.1 apache configuration files
	# Check for any custom directives added to 3.1 apache config files, in particular cfg/apache.conf, archives/<ARCHIVEID>/cfg/apache.conf and archives/<ARCHIVEID>/cfg/apachevhost.conf		# Check for any custom directives added to 3.1 apache config files, in particular <tt>cfg/apache.conf</tt>, <tt>archives/<ARCHIVEID>/cfg/apache.conf</tt> and <tt>archives/<ARCHIVEID>/cfg/apachevhost.conf</tt>
	# Run <tt>bin/generate_apacheconf --system --replace</tt> - this will generate the new apache configuration files as above		# Run <tt>bin/generate_apacheconf --system --replace</tt> - this will generate the new apache configuration files as above
	# If using SSL change the top level apache SSL configuration file to load /opt/eprints3/cfg/apache_ssl.conf instead of /opt/eprints3/archives/<ARCHIVEID>/var/auto-secure.conf		# If using SSL change the top level apache SSL configuration file to load <tt>/opt/eprints3/cfg/apache_ssl.conf</tt> instead of <tt>/opt/eprints3/archives/<ARCHIVEID>/var/auto-secure.conf</tt>
	# Merge custom directives back in as appropriate (noting that custom directives may be lost if generate_apacheconf is run with the --system or --replace option)		# Merge custom directives back in as appropriate (noting that custom directives may be lost if generate_apacheconf is run with the --system or --replace option)
	# Restart apache		# Restart apache
	# After successful testing, the following 3.1 configuration files can be removed:		# After successful testing, the following 3.1 configuration files can be removed:
	## var/auto-apache.conf
	## var/auto-apache-includes.conf		var/auto-apache.conf
	## archives/<ARCHIVEID>/cfg/apache.conf		var/auto-apache-includes.conf
	## archives/<ARCHIVEID>/var/auto-apache.conf		archives/<ARCHIVEID>/cfg/apache.conf
	## archives/<ARCHIVEID>/var/auto-secure.conf		archives/<ARCHIVEID>/var/auto-apache.conf
			archives/<ARCHIVEID>/var/auto-secure.conf