Installation of VuFind on CentOS7 June 24, 2020


Download 1.64 Mb.
Pdf ko'rish
Sana07.09.2020
Hajmi1.64 Mb.
#128768
Bog'liq
installation (1)


Installation of VuFind on CentOS7 

June 24, 2020

 

1 | 

P a g e


 

 

Installation of VuFind on CentOS7 

1.  The installation documentation  will  help  guide  you  through  the  process  of  installing  the  following 

prerequisites and setting up VuFind 5.0+ on CentOS7 operating system. 

a.  Apache Server 2.2.12+ 

b.  PHP 7.0.8+ 

c.  MySQL 5.5+ 

d.  Java JDK 1.8+ 

 

2.  CentOS7 puts you in a graphical desktop by default – to enter all the commands described below, you 



will need to go to a command prompt, which you can access by selecting “Terminal”. 

3.  If you are logged in as a user account, you can switch to root user account by entering: 



su root 

You will be prompted for the system's root password. Root access can be dangerous, so be sure to exit 

out of the root account as soon as you are done with the necessary work! 

 

4.  Make sure you have the latest patches installed. 



yum update 

It is a good idea to reboot after installing updates. 

5.  Install  Apache  HTTP  Server:  Now  install  the  Apache  web  server.  This  will  facilitate  communication 

between VuFind and web browsers 



yum install httpd 

systemctl start httpd  

systemctl enable httpd 

systemctl status httpd 

6.  Allow HTTP and HTTPS ports from Firewall:  

 

sudo firewall-cmd --zone=public --permanent --add-port=80/tcp --add-port=443/tcp 

sudo firewall-cmd –reload 

sudo firewall-cmd --info-zone public 

 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

2 | 

P a g e


 

 

7.  Install  MySQL/MariaDB:  VuFind  uses  the  MySQL  database  for  storing  user  comments, tags  and  other 



information. You should install this component next. 

yum 


install

 mariadb-server 

Once MySQL/MariaDB is installed, you should start it up: 

systemctl start mariadb 

systemctl enable mariadb 

systemctl status mariadb 

8.  For security reasons, it's also a good idea to set a root  password for the database; this command will 

guide you through the process. 

/

usr


/

bin


/

mysql_secure_installation 

 

9.  Install PHP:  To install PHP 7, you must install and enable EPEL and Remi repository on your CentOS 7 



system.  Next,  you  need  to  install yum-utils,  a  collection  of  useful  programs  for  managing  yum 

repositories and packages. It has tools that basically extend yum’s default  features.  It can be  used for 

managing (enabling or disabling) yum repositories as well as packages without any manual configuration 

and so much more. One of the programs provided by yum-utils is yum-config-manager, which you can 

use to enable Remi repository as the default repository for installing different PHP versions as shown. 

 

yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-



7.noarch.rpm 

yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm 

yum install yum-utils 

yum-config-manager --enable remi-php73 

 

Most  of  VuFind  is  written  using  the  PHP  language.  We  must  install  this  next,  being  sure  to  enable 



modules for key technologies used by VuFind (MySQL, LDAP, etc.) 

 

yum 



install

 php php-devel php-intl php-ldap php-mysqli php-xsl php-gd php-

mbstring php-mcrypt php-json php-soap 


Installation of VuFind on CentOS7 

June 24, 2020

 

3 | 

P a g e


 

 

 



 

10. System will ask for confirmation of packages to be installed. You will need to give ‘Y’. All depended 

packages will be installed along with desired packages. 

 

 



Installation of VuFind on CentOS7 

June 24, 2020

 

4 | 

P a g e


 

 

 



 

11. Install the Java JDK: Next install JDK (the Java Development Kit) on the server – VuFind's searching back-

end and MARC indexing tools rely on Java. Note that some VuFind components may be able to run using 

only the JRE (Java Runtime Environment), but the JDK is strongly recommended, and required for proper 

MARC indexing after release 3.1. 

yum 


install

 java-


*

-openjdk-devel 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

5 | 

P a g e


 

 

 



 

 

 



Installation of VuFind on CentOS7 

June 24, 2020

 

6 | 

P a g e


 

 

 



 

12. Download  VuFind:  All  the  prerequisites  are  in  place,  so  now  for  the  fun  part  –  downloading  and 

installing VuFind itself! 

yum install wget 

cd /tmp 

wget https://github.com/vufind-org/vufind/releases/download/v6.1.1/vufind-

6.1.1.tar.gz 

tar xzvf vufind-6.1.1.tar.gz 

mv vufind-6.1.1 /usr/local/vufind 

 

 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

7 | 

P a g e


 

 

 



 

 

 



 

 

 



 

Installation of VuFind on CentOS7 

June 24, 2020

 

8 | 

P a g e


 

 

 



 

 

 



13. Install  VuFind:  The  groundwork  is  set, so you  can  now  run  VuFind's  install  script  to  set  up  your  basic 

configuration. You can accept the defaults for now – you can run the installer again later if you need to 

make changes. 

cd

 



/

usr


/

local


/

vufind 


php install.php 

 

 



 

Installation of VuFind on CentOS7 

June 24, 2020

 

9 | 

P a g e


 

 

 



 

14. Appropriate security permissions need to be set up so Apache can access the VuFind code. The chcon 

line  sets  file  permissions  so  Apache  is  allowed  to  load  the  files.  The  first  setsebool  command  allows 

Apache  to  communicate  with  itself  internally,  which  is  necessary  to  access  the  search  back-end.  The 

second  setsebool  command  allows  Apache  to  send  email,  which  is  necessary  for  VuFind's  message-

sending functions. 

chcon 

-R

 unconfined_u:object_r:httpd_sys_content_t:s0 



/

usr


/

local


/

vufind


/

 

setsebool 



-P

 

httpd_can_network_relay



=

1

 



setsebool 

-P

 



httpd_can_sendmail

=

1



 

 

 



 

15. It is also necessary to make a few directories writeable by Apache so VuFind can generate cache files 

and base configurations: 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

10 | 

P a g e


 

 

chown

 

-R

 apache:apache 



/

usr


/

local


/

vufind


/

local


/

cache 


chcon 

-R

 unconfined_u:object_r:httpd_sys_rw_content_t:s0 



/

usr


/

local


/

vufind


/

local


/

cache 


chown

 

-R



 apache:apache 

/

usr



/

local


/

vufind


/

local


/

config 


chcon 

-R

 unconfined_u:object_r:httpd_sys_rw_content_t:s0 



/

usr


/

local


/

vufind


/

local


/

config 


 

 

 



16. If you plan to use VuFind's command line tools, you also need a separate cache for that: 

mkdir

 

/



usr

/

local



/

vufind


/

local


/

cache


/

cli 


chmod

 

777



 

/

usr



/

local


/

vufind


/

local


/

cache


/

cli 


 

 

17. Link VuFind to Apache: Apache needs to have some extra VuFind settings loaded. Run these commands 



to set the appropriate security context for VuFind's configuration and then link it with Apache. 

chcon system_u:object_r:httpd_config_t:s0 

/

usr


/

local


/

vufind


/

local


/

httpd-vufind.conf 



ln

 

-s



 

/

usr



/

local


/

vufind


/

local


/

httpd-vufind.conf 

/

etc


/

httpd


/

conf.d


/

vufind.conf 

 

 

Apache needs to be restarted so the changes can take effect: 



apachectl restart

 

 



Installation of VuFind on CentOS7 

June 24, 2020

 

11 | 

P a g e


 

 

18. Set  Up  Environment  Variables:  Some  environment  variables  need  to  be  set  so  that  VuFind-related 



scripts  can  find  required  resources.  If  you  plan  on  running  VuFind  under  a  specific  user  account,  you 

should set these only for that user. If you want to make the settings global for all accounts (the easiest, 

but  not  necessarily  the  best,  approach),  just  run  this  code  to  create  a  script  in  the  /etc/profile.d 

directory: 

echo

 

export



 

VUFIND_HOME

=

"/usr/local/vufind"



 

>

 



/

etc


/

profile.d

/

vufind.sh 



echo

 

export



 

VUFIND_LOCAL_DIR

=

"/usr/local/vufind/local"



 

>> 


/

etc


/

profile.d

/

vufind.sh 



echo

 

export



 

VUFIND_LOCAL_MODULES

=

"nlist"


 

>>

 



/

etc


/

profile.d

/

vufind.sh 



After creating this file, unless you log out and back into your account first, you must manually load it for 

the changes to take effect immediately. 

source

 

/



etc

/

profile.d



/

vufind.sh 

 

 

19. Start Solr: To start VuFind's Solr index: 



cd

 

/



usr

/

local



/

vufind


/

 

.



/

solr.sh -force start 

 

20. Configure VuFind: Open a web browser, and browse to this URL: 



http://your-server-name/vufind/Install/Home 

 

If installation was successful, you should now see an Auto Configure screen. Some items on the list will 



be marked “Failed” with “Fix” links next to them. Click on each Fix link in turn and follow the on-screen 

instructions. After an issue is successfully resolved, you can click the “Auto Configure” breadcrumb to go 

back to the main list and proceed to the next problem. 


Installation of VuFind on CentOS7 

June 24, 2020

 

12 | 

P a g e


 

 

Notes:  To  set  up  VuFind's  database,  you will  need to  have  the  root  password  you  set  when  installing 

MySQL. 

 

 



 

Installation of VuFind on CentOS7 

June 24, 2020

 

13 | 

P a g e


 

 

 



 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

14 | 

P a g e


 

 

 



 

 

 



 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

15 | 

P a g e


 

 

 



 

21. Locking  Down  Configurations:  Once  all  configuration  issues  are  successfully  resolved,  you  will  see  a 

“Disable  Auto  Configuration”  link  on  the “Auto  Configure”  page.  Click  this  to  prevent  future  access  to 

the  install  script.  If  you  need  access  again  in  the  future,  you  can  re-enable  it  by  manually  editing 

your config.ini file.   

 

 



After disabling auto configuration, you should also disable Apache's ability to write to your configuration 

directory: 

chown -R root:root /usr/local/vufind/local/config 


Installation of VuFind on CentOS7 

June 24, 2020

 

16 | 

P a g e


 

 

chcon -R unconfined_u:object_r:httpd_sys_content_t:s0 /usr/local/vufind/local/config 



 

 

22. Importing Records into VuFind: 

 

 


Installation of VuFind on CentOS7 

June 24, 2020

 

17 | 

P a g e


 

 

 



 

 

 



 

 

Download 1.64 Mb.

Do'stlaringiz bilan baham:




Ma'lumotlar bazasi mualliflik huquqi bilan himoyalangan ©fayllar.org 2024
ma'muriyatiga murojaat qiling