vcl-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jftho...@apache.org
Subject svn commit: r1798272 - /vcl/site/trunk/content/docs/VCL25InstallGuide.mdtext
Date Fri, 09 Jun 2017 20:19:46 GMT
Author: jfthomps
Date: Fri Jun  9 20:19:46 2017
New Revision: 1798272

URL: http://svn.apache.org/viewvc?rev=1798272&view=rev
Log:
initial update to page; still need some more work

Modified:
    vcl/site/trunk/content/docs/VCL25InstallGuide.mdtext

Modified: vcl/site/trunk/content/docs/VCL25InstallGuide.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/docs/VCL25InstallGuide.mdtext?rev=1798272&r1=1798271&r2=1798272&view=diff
==============================================================================
--- vcl/site/trunk/content/docs/VCL25InstallGuide.mdtext (original)
+++ vcl/site/trunk/content/docs/VCL25InstallGuide.mdtext Fri Jun  9 20:19:46 2017
@@ -1,4 +1,4 @@
-Title: VCL 2.4.2 Installation Guide
+Title: VCL 2.5 Installation Guide
 Notice:    Licensed to the Apache Software Foundation (ASF) under one
            or more contributor license agreements.  See the NOTICE file
            distributed with this work for additional information
@@ -17,7 +17,7 @@ Notice:    Licensed to the Apache Softwa
            under the License.
 
 # Scripted Installation
-VCL 2.4.2 is the first release to include an installation script.  All you need to install
+VCL 2.5 is the first release to include an installation script.  All you need to install
 VCL is the script. It will download and validate the VCL software and then install it.
 The script can be used to install all three parts of VCL (database, web portal, and 
 management node) or to install each part individually.
@@ -27,11 +27,11 @@ management node) or to install each part
 Validate script:
 
     :::BashLexer
-    wget https://www.apache.org/dist/vcl/2.4.2/vcl-install.sh.sha1
+    wget https://www.apache.org/dist/vcl/2.5/vcl-install.sh.sha1
     sha1sum -c vcl-install.sh.sha1
     wget https://www.apache.org/dist/vcl/KEYS
     gpg --import KEYS
-    wget https://www.apache.org/dist/vcl/2.4.2/vcl-install.sh.asc
+    wget https://www.apache.org/dist/vcl/2.5/vcl-install.sh.asc
     gpg --verify vcl-install.sh.asc
 
 Running the installation script with no arguments will step you through installing all
@@ -80,12 +80,12 @@ VCL currently supports the use of MySQL
 
 1. Download and Extract the Apache VCL Source
     * If you have not already done so, follow the instructions on the [download](/downloads/download.cgi)
-page to download and verify apache-VCL-2.4.2.tar.bz2, and put it in /root
+page to download and verify apache-VCL-2.5.tar.bz2, and put it in /root
 
     * Extract the files:
 
             :::BashLexer
-            tar -jxvf apache-VCL-2.4.2.tar.bz2
+            tar -jxvf apache-VCL-2.5.tar.bz2
 
 2. Install MySQL Server or MariaDB Server
 
@@ -182,7 +182,7 @@ privileges on the database you just crea
 **mysql** directory within the Apache VCL source code
 
             :::BashLexer
-            mysql vcl < apache-VCL-2.4.2/mysql/vcl.sql
+            mysql vcl < apache-VCL-2.5/mysql/vcl.sql
 
    
 ----------
@@ -191,7 +191,7 @@ privileges on the database you just crea
 
 **Prerequisites**
 
-  - Apache VCL 2.4.2 had been downloaded
+  - Apache VCL 2.5 has been downloaded
   - VCL database has been installed and configured
 
 **Web Server:**
@@ -208,7 +208,6 @@ privileges on the database you just crea
 **Required PHP Modules:**
 
   * php
-  * php-gd
   * php-json (required if your PHP version is 5.2 or later)
   * php-mysql
   * php-openssl
@@ -226,13 +225,7 @@ privileges on the database you just crea
         For RHEL / CentOS 6 and 7
 
             :::BashLexer
-            yum install httpd mod_ssl php php-gd php-mysql php-xml php-xmlrpc php-ldap -y
-
-        For RHEL / CentOS 5
-       
-            :::BashLexer
-            yum install httpd mod_ssl php php-gd php-mysql php-xml php-xmlrpc php-ldap -y
-
+            yum install httpd mod_ssl php php-mysql php-xml php-xmlrpc php-ldap -y
 
     * Configure the web server daemon (httpd) to start automatically:
 
@@ -282,19 +275,19 @@ config file:
 
 2. **Install the VCL Frontend Web Code**
     * If you have not already done so, follow the instructions on the [download](/downloads/download.cgi)
-page to download and verify apache-VCL-2.4.2.tar.bz2, and put it in /root
+page to download and verify apache-VCL-2.5.tar.bz2, and put it in /root
 
     * Extract the files:
 
             :::BashLexer
-            tar -jxvf apache-VCL-2.4.2.tar.bz2
+            tar -jxvf apache-VCL-2.5.tar.bz2
 
     * Copy the **web** directory to a location under the web root of your web server and

 navigate to the destination **.ht-inc** subdirectory:
 
             :::BashLexer
-            cp -r apache-VCL-2.4.2/web/ /var/www/html/vcl-2.4.2
-            ln -s /var/www/html/vcl-2.4.2 /var/www/html/vcl
+            cp -r apache-VCL-2.5/web/ /var/www/html/vcl-2.5
+            ln -s /var/www/html/vcl-2.5 /var/www/html/vcl
             cd /var/www/html/vcl/.ht-inc
 
     * Copy secrets-default.php to secrets.php:
@@ -335,10 +328,17 @@ navigate to the destination **.ht-inc**
         * Review every entry under "Things in this section must be modified/reviewed". 
         Descriptions and pointers for each value are included within conf.php.
         
-    * Set the owner of the .ht-inc/maintenance directory to the web server user (normally
'apache'):
+    * Set the owner of the .ht-inc/maintenance and .ht-inc/cryptkey directories to the web
server user (normally 'apache'):
 	
             :::BashLexer
             chown apache maintenance
+            chown apache cryptkey
+
+    * If SELinux is enabled, run the following command to allow the web server to write to
maintenance and cryptkey
+	
+            :::BashLexer
+            chcon -t httpd_sys_rw_content_t maintenance
+            chcon -t httpd_sys_rw_content_t cryptkey
 
     * Open the testsetup.php page in a web browser:
         * If you set up your site to be https://my.server.org/vcl/ open https://my.server.org/vcl/testsetup.php
@@ -404,18 +404,16 @@ Configuration][3]
 The following management node installation instructions assume the instructions in these
 previous sections have been completed:
 
-* VCL 2.4.2 Database Installation
-* VCL 2.4.2 Web Code Installation
+* VCL 2.5 Database Installation
+* VCL 2.5 Web Code Installation
 
 **Supported Operating Systems:**
 
 The VCL management node daemon (vcld) has been developed to run on an operating system 
 based on Red Hat Enterprise Linux (RHEL). It has been tested on the following:
 
-* Red Hat Enterprise Linux 5.x
 * Red Hat Enterprise Linux 6.x
 * Red Hat Enterprise Linux 7.x
-* CentOS 5.x
 * CentOS 6.x
 * CentOS 7.x
 
@@ -425,6 +423,8 @@ The VCL management node daemon (vcld) re
 modules in order to run (see step 2 below for installation instructions). Note, there is

 overlap as some of the perl modules are available through the yum packager manager.
 
+============================= NEEDS UPDATING ============================
+
 * expat-devel - Libraries and include files to develop XML applications with expat
 * gcc - Various compilers (C, C++, Objective-C, Java, ...)
 * krb5-devel - Development files needed to compile Kerberos 5 programs
@@ -459,6 +459,8 @@ The VCL management node daemon (vcld) is
 5.8.x. The following Perl modules available from CPAN are also required (see step 2 
 below for installation instructions):
 
+============================= NEEDS UPDATING ============================
+
 * CPAN - provides a command interface (not a shell) to CPAN
 * DBI - Generic Database Interface
 * Digest::SHA1 - NIST SHA message digest algorithm
@@ -480,19 +482,19 @@ below for installation instructions):
 1. **Install the VCL Management Node Code - Perl Daemon**
     * If you have not already done so, follow the instructions on the 
 [download](/downloads/download.cgi) page to download and verify 
-apache-VCL-2.4.2.tar.bz2, and put it in /root
+apache-VCL-2.5.tar.bz2, and put it in /root
 
     * Extract the files:
 
             :::BashLexer
-            tar -jxvf apache-VCL-2.4.2.tar.bz2
+            tar -jxvf apache-VCL-2.5.tar.bz2
 
     * Copy the managementnode directory to the location where you want it to reside 
 (typically /usr/local):
 
             :::BashLexer
-            cp -r apache-VCL-2.4.2/managementnode /usr/local/vcl-2.4.2
-            ln -s /usr/local/vcl-2.4.2 /usr/local/vcl
+            cp -r apache-VCL-2.5/managementnode /usr/local/vcl-2.5
+            ln -s /usr/local/vcl-2.5 /usr/local/vcl
 
 2. **Install the Required Linux Packages & Perl Modules**
 
@@ -574,6 +576,8 @@ hosts or only for the root user. Consult
 
 5. **Install and Start the VCL Daemon (vcld) Service**
 
+=========================== ADD INFO ON systemd =========================
+
     * Copy the vcld service script to /etc/init.d and name it vcld:
 	
             :::BashLexer
@@ -620,7 +624,8 @@ password from xmlrpc_pass variable in th
         :::BashLexer
         Select 6. Set Local VCL User Account Password
         Select 2. vclsystem
-             
+
+========================== ADD INFO ON TESTING XMLRPC ==========================
 
 7. **Install & Configure the DHCP Service**
    
@@ -700,4 +705,4 @@ virtual computers
   [1]: http://www.phpmyadmin.net/
   [2]: http://www.mysql.com/
   [3]: installphpmyadmin
-  [4]: https://www.apache.org/dist/vcl/2.4.2/vcl-install.sh
\ No newline at end of file
+  [4]: https://www.apache.org/dist/vcl/2.5/vcl-install.sh
\ No newline at end of file



Mime
View raw message