Editing How to use EPrints with HTTPS (section)

== Configuration ==
Below is a list of variable names described in these instructions and example values of what they might be in a real-world configuration.
{| border="1" cellpadding="10" cellspacing="0"
!Variable
!Example
|-
|EPRINTS_PATH
|/opt/eprints3
|-
|YOUR-REPOSITORY-DOMAIN
|example.eprints.org
|-
|REPOID
|example
|-
|}

To start setting up your existing archive to work under HTTPS, you must first edit <code>EPRINTS_PATH/archives/REPOID/cfg/cfg.d/10_core.pl</code>. Initially it will probably look something like the configuration directly below,  which is the basic <code>10_core.pl</code> configuration file after you have run <code>EPRINTS_PATH/bin/epadmin create</code> to set up your archive.  Alternatively you could run <code>/opt/eprints3/bin/epadmin config_core REPOID</code> that will prompt you for the following information. It is suggested that you make a backup of the <code>10_core.pl</code> file regardless before proceeding.

 $c->{host} = 'YOUR-REPOSITORY-DOMAIN';
 $c->{port} = 80;
 $c->{aliases} = [];
 $c->{securehost} = &#39;&#39;;
 $c->{secureport} = 443;
 $c->{http_root} = undef;

Update the file to define the secure host and modify ports as needed.  If your Apache web server is not using the standard ports (80,443) you can adjust the <code>port</code> and <code>secureport</code> parameters in the config file accordingly.

 $c->{host} = 'YOUR-REPOSITORY-DOMAIN';
 $c->{port} = 80;
 $c->{aliases} = [];
 $c->{securehost} = $c->{host};
 $c->{secureport} = 443;
 $c->{http_root} = undef;

Now, you need to create the directory <code>EPRINTS_PATH/archives/REPOID/ssl/</code> and then edit the file <code>REPOID/ssl/securevhost.conf</code>.  This file should look something like below.  If you are installing EPrints on Debian/Ubuntu based systems you will need to create a symlink <code>logs</code> in <code>/etc/apache2/</code> to point at <code>/var/log/apache2/</code>. 
{{Securevhost.conf}}

It is advised that you keep the SSL key, certificate and chain files in the same directory as <code>securevhost.conf</code>, as this will make it easy if you need to migrate you EPrints repository to a new server in the future.