{"id":489,"date":"2018-03-09T19:53:12","date_gmt":"2018-03-09T19:53:12","guid":{"rendered":"https:\/\/www.web-workers.ch\/?p=489"},"modified":"2018-06-11T22:29:40","modified_gmt":"2018-06-11T22:29:40","slug":"how-to-install-lucee-5-2-on-centos-7-x64-with-apache2-4-6","status":"publish","type":"post","link":"https:\/\/www.web-workers.ch\/index.php\/2018\/03\/09\/how-to-install-lucee-5-2-on-centos-7-x64-with-apache2-4-6\/","title":{"rendered":"How to install Lucee 5.2 on CentOS 7 x64 with Apache\/2.4.6"},"content":{"rendered":"

Lucee is a light-weight dynamic scripting language for the JVM that enables the rapid development of simple to highly sophisticated web applications. Lucee is made for the web; it simplifies common tasks for this environment.<\/p>\n

Lucee Server is a CFML engine. It allows you to write powerful web-based systems and deploy them to a variety of platforms. Lucee Server is written in Java and runs in a Java Servlet Container. When you download and install Lucee Server, you get a Servlet Container plus the Lucee code. But you don’t need to worry about that: you access Lucee Server features using CFML, a fast, easy-to-use language that you’ll learn in no time at all. Just write CFML files – typically one per page on your site – and then request them through the browser. Lucee Server will compile your work the first time you request that page. Lucee Server comes bundled with a lot of services that you’ll find useful in building your apps – session management, database connectivity, ORM, search engine, mail, scheduling, fast caches, subsystems for accessing disks, remote servers, Amazon services, support for REST, XML, JSON and much more. At the core of Lucee Server is the Lucee Server Administrator – a web application that lets you configure and maintain your own Lucee applications.<\/p>\n

OS Installation<\/h3>\n
    \n
  1. Download: CentOS-7-x86_64-DVD-1708.iso from CentOS website<\/a><\/li>\n
  2. Install CentOS 7 x64 1708 with minimal selection\n

    \"\"<\/a>
    Select ‘Minimal Install’ but enable Debugging Tools, Compatibility Libraries and Development Tools<\/figcaption><\/figure><\/li>\n<\/ol>\n

    Hint: Make sure you have a working internet connection before you proceed to the next step.<\/p>\n

    OS Preparation<\/h3>\n

    Hint: We expect your server is protected by firewalls, proxies and is configured within a protected environment. In any case, read the ‘best practice guide<\/a>‘ to protect your Lucee equipment.<\/p>\n

    Work remotely<\/h5>\n
      \n
    1. Disable firewalld
      \n# systemctl disable firewalld
      \n# systemctl stop firewalld<\/code><\/li>\n<\/ol>\n
      Install required software<\/h5>\n
        \n
      1. Remove Postfix and install Sendmail
        \n# yum -y remove postfix
        \n# yum -y install sendmail*<\/code><\/li>\n
      2. Install Apache
        \n# yum -y install httpd*<\/code><\/li>\n
      3. Install MariaDB
        \n# yum -y install mariadb*<\/code><\/li>\n
      4. Install deltarpm
        \n# yum -y install deltarpm<\/code><\/li>\n
      5. Install wget and dos2unix
        \n# yum -y install wget
        \n# yum -y install dos2unix<\/code><\/li>\n
      6. Update your system
        \n# yum -y update<\/code><\/li>\n
      7. Install Webmin
        \n# yum -y install perl-Net-SSLeay<\/code># yum -y install perl-Encode-Detect
        \n# rpm -ihv https:\/\/netix.dl.sourceforge.net\/project\/webadmin\/webmin\/1.880\/webmin-1.880-1.noarch.rpm<\/code><\/li>\n<\/ol>\n
        Service configuration<\/h5>\n
          \n
        1. Disable SELinux by configuring SELINUX=disabled
          \n# cat \/etc\/selinux\/config
          \n# This file controls the state of SELinux on the system.
          \n# SELINUX= can take one of these three values:
          \n# enforcing - SELinux security policy is enforced.
          \n# permissive - SELinux prints warnings instead of enforcing.
          \n# disabled - No SELinux policy is loaded.
          \nSELINUX=disabled
          \n# SELINUXTYPE= can take one of three two values:
          \n# targeted - Targeted processes are protected,
          \n# minimum - Modification of targeted policy. Only selected processes are protected.
          \n# mls - Multi Level Security protection.
          \nSELINUXTYPE=targeted<\/code><\/li>\n
        2. Start and enable Webmin
          \n# systemctl start webmin
          \n# systemctl enable webmin<\/code><\/li>\n
        3. Start and enable MariaDB
          \n# systemctl start mariadb
          \n# systemctl enable mariadb<\/code><\/li>\n
        4. Start and enable Apache
          \n# systemctl start httpd
          \n# systemctl enable httpd<\/code><\/li>\n
        5. Start and enable Sendmail
          \n# systemctl start sendmail
          \n# systemctl enable sendmail<\/code><\/li>\n
        6. Reboot your server
          \n# shutdown -r now<\/code><\/li>\n<\/ol>\n

          Lucee Installation<\/h3>\n
            \n
          1. Check the latest version
            \nGoto http:\/\/download.lucee.org\/?type=releases<\/a> to check which file you need to download.
            \nWe select\u00a0            Linux (64b)<\/a>\u00a0within this instructions because we are looking for the installer for x64 Linux.<\/li>\n
          2. Download the installer
            \n# cd \/root
            \n# wget http:\/\/cdn.lucee.org\/lucee-5.2.6.059-pl0-linux-x64-installer.run<\/code><\/li>\n
          3. Make the installer executable and execute the installer
            \n# chmod +x lucee-5.2.6.059-pl0-linux-x64-installer.run
            \n# .\/lucee-5.2.6.059-pl0-linux-x64-installer.run
            \n----------------------------------------------------------------------------
            \nWelcome to the Lucee Installer.
            \n----------------------------------------------------------------------------
            \nPlease read the following License Agreement. You must accept the terms of this
            \nagreement before continuing with the installation.
            \nPress [Enter] to continue:
            \nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
            \nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
            \nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
            \nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
            \nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
            \nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
            \nLucee Server is Copyright (c) 2018 by the Lucee Association Switzerland, and is
            \ndistributed<\/span><\/span><\/span><\/span><\/span> under the LGPL v2 License:
            \nhttp:\/\/www.opensource.org\/licenses\/lgpl-2.1.php
            \nThe Apache Tomcat Server is Copyright (c) 1999-2018 by the Apache Software
            \nFoundation and is distributed under the Apache License version 2:
            \nhttp:\/\/www.apache.org\/licenses\/
            \nThe Java JRE is Copyright (c) 1993-2018 by Oracle and\/or its affiliates, and is
            \nreleased under the Oracle License:
            \nhttp:\/\/www.oracle.com\/technetwork\/java\/javase\/terms\/license\/index.html
            \nPress [Enter] to continue:
            \nDo you accept this license? [y\/n]: y
            \n----------------------------------------------------------------------------
            \nPlease specify the directory where Lucee will be installed.
            \nInstallation Directory [\/opt\/lucee]:\u00a0\/opt\/lucee
            \n----------------------------------------------------------------------------
            \nLucee Password
            \nPlease enter in the default passwords for the Lucee Server Administrator and the
            \nLucee Web Administrators.
            \nLucee Password : 123456
            \nLucee Password (confirm) : 123456
            \n----------------------------------------------------------------------------
            \nTomcat Ports
            \nTomcat needs to reserve \"ports\" on your computer in order to serve various types
            \nof requests. You can customize those ports using the fields below. If you are
            \nunsure, the default values provided below are perfectly safe to use.
            \nTomcat Web Server Port: [8888]: 8888
            \nTomcat Shutdown Port: [8005]: 8005
            \nTomcat AJP Port: [8009]: 8009
            \n----------------------------------------------------------------------------
            \nTomcat System User
            \nEnter in the System User Account that Tomcat will run under. Running as \"root\"
            \nor \"Administrator\" on Windows will avoid system permission problems, while
            \nrunning as a non-root user will add an additional layer of security. If you
            \nchoose to run as a non-root user, we recommend using a easily identifiable
            \nusername like \"lucee\" or \"cfml\".
            \n[root]:\u00a0root
            \n----------------------------------------------------------------------------
            \nStart At Boot?
            \nDo you want Lucee to start up automatically whenever the system boots up?
            \nYes, Start Lucee at Boot Time [Y\/n]: y
            \n----------------------------------------------------------------------------
            \nInstall Apache Connector?
            \nThis option will install mod_proxy_http so that you can utilize Apache as a web
            \nserver in front of your Lucee installation. This option is recommended if you're
            \nusing Apache.
            \nYes, Install Apache Connector [Y\/n]: y
            \n----------------------------------------------------------------------------
            \nInstall modcfml?<\/p>\n

            creating new hosts in Tomcat whenever you add a new host to your web server.
            \nTo learn more about mod_cfml, visit its website at modcfml.org. This option is
            \nrecommended for most environments.
            \nYes, Install mod_cfml [Y\/n]: y
            \n----------------------------------------------------------------------------
            \nApache Control Script Location
            \nPlease enter the location of your apache control script. The default location
            \nfor this script is \"\/usr\/sbin\/apachectl\".
            \nApache Control Script Location [\/usr\/sbin\/apachectl]:\u00a0\/usr\/sbin\/apachectl
            \n----------------------------------------------------------------------------
            \nApache Modules Directory
            \nPlease enter the directory that apache stores it's modules in. By default, this
            \ndirectory is located at \"\/usr\/lib\/httpd\/modules\/\" for RHEL\/CentOS, and
            \n\"\/usr\/lib\/apache2\/modules\/\" for Ubuntu. For 64-bit systems, try changing the
            \n\"lib\" directory to \"lib64\".
            \nApache Modules Directory [\/usr\/lib64\/httpd\/modules]:\u00a0\/usr\/lib64\/httpd\/modules
            \n----------------------------------------------------------------------------
            \nApache Configuration File
            \nThe Apache configuration file controls how Apache processes incoming requests.
            \nThe default location of the Apache configuration file is
            \n\"\/etc\/httpd\/conf\/httpd.conf\" on RHEL\/CentOS and \"\/etc\/apache2\/apache2.conf\" on
            \nUbuntu.
            \nApache Configuration File [\/etc\/httpd\/conf\/httpd.conf]:\u00a0\/etc\/httpd\/conf\/httpd.conf
            \n----------------------------------------------------------------------------
            \nApache Logs Directory
            \nPlease enter the directory that Apache stores it's log files in. By default,
            \nthis directory is located at \"\/var\/log\/httpd\/\" for RHEL\/CentOS, and
            \n\"\/var\/log\/apache2\/\" for Ubuntu.
            \nApache Logs Directory [\/var\/log\/httpd]:\u00a0\/var\/log\/httpd
            \n----------------------------------------------------------------------------
            \nSetup is now ready to begin installing Lucee on your computer.
            \nDo you want to continue? [Y\/n]: y
            \n----------------------------------------------------------------------------
            \nPlease wait while Setup installs Lucee on your computer.
            \nInstalling
            \n0% ______________ 50% ______________ 100%
            \n########################################
            \n----------------------------------------------------------------------------
            \nSetup has finished installing Lucee on your computer.<\/code><\/li>\n

          4. Download service wrapper and mark it executable# wget https:\/\/raw.githubusercontent.com\/lucee\/Lucee4\/master\/build\/installer\/os\/linux\/sys\/service_config.sh
            \n# chmod +x service_config.sh<\/code><\/li>\n
          5. Install service wrapper
            \n# .\/service_config.sh --install --path \/opt\/lucee\/lucee_ctl
            \n## Installing Lucee Service ##
            \n* [INFO]: Detected RedHat-based build.
            \n* [INFO]: Checking for 'chkconfig' executable in the PATH...[FOUND]
            \n## Installation Complete ##
            \n<\/code><\/li>\n
          6. Restart Lucee and enable the service
            \n# \/etc\/init.d\/lucee_ctl restart
            \n# chkconfig lucee_ctl on<\/code><\/li>\n
          7. Check if you have WEB-INF directory within \/var\/www\/html
            \n# ls -ltrah \/var\/www\/html
            \ntotal 0
            \ndrwxr-xr-x. 4 root root 33 Mar 9 18:51 ..
            \ndrwxr-xr-x. 3 root root 21 Mar 9 20:16 .<\/code>Normally the directory is empty at this point.<\/li>\n
          8. Try to open a URL within a browser ending with .cfm, for example http:\/\/\/test.cfm. You will see following errormessage:
            \n
            \"\"<\/a>
            Make sure the Message displayed (Page \/test.cfm [\/var\/www\/html\/test.cfm]) is referring to your Apache root-directory.<\/figcaption><\/figure><\/li>\n
          9. Check that you have a WEB-INF directory within \/var\/www\/html _now_.
            \n# ls -ltrah \/var\/www\/html
            \ntotal 0
            \ndrwxr-xr-x. 4 root root 33 Mar 9 18:51 ..
            \ndrwxr-xr-x. 3 root root 21 Mar 9 20:16 .
            \ndrwxr-xr-x 3 root root 36 Mar 9 20:16 WEB-INF<\/code><\/li>\n
          10. Add proxy.conf to \/etc\/httpd\/conf.d
            \nCreate a new file\u00a0\/etc\/httpd\/conf.d\/proxy.conf
            \n# touch \/etc\/httpd\/conf.d\/proxy.conf<\/code>and add following content to it (make sure the URL within this file is referring to your Tomcat AJP Port. the one you have specified during the installation):
            \n# cat \/etc\/httpd\/conf.d\/proxy.conf
            \n<Proxy *>
            \nAllow from 127.0.0.1
            \n<\/proxy>
            \nProxyPreserveHost On
            \nProxyPassMatch ^\/(.+\\.cf[cm])(\/.*)?$ ajp:\/\/127.0.0.1:8009\/$1$2
            \nProxyPassMatch ^\/(.+\\.cfchart)(\/.*)?$ ajp:\/\/127.0.0.1:8009\/$1$2
            \nProxyPassMatch ^\/(.+\\.cfml)(\/.*)?$ ajp:\/\/127.0.0.1:8009\/$1$2
            \nProxyPassReverse \/ ajp:\/\/127.0.0.1:8009\/<\/code><\/li>\n
          11. Restart Apache and Lucee
            \n# systemctl restart httpd
            \n# service lucee_ctl restart<\/code><\/li>\n<\/ol>\n

            Test Lucee<\/h3>\n
              \n
            1. Make sure Apache is running fine by opening http:\/\/<youripaddress>
              \n              \"\"<\/a><\/li>\n
            2. Make sure Lucee is running fine by opening http:\/\/<youripaddress>:8888\n

              \"\"<\/a>
              Hint: In case you receive an errormessage, please restart the Lucee service and try immediately again.<\/figcaption><\/figure><\/li>\n
            3. Download the following testfiles.zip, unpack it and upload it to your server into \/var\/www\/html
              \n              –> Download ‘testfiles.zip’<\/a><\/li>\n
            4. Open http:\/\/<youripaddress>\/test.cfm to check if the files are rendered correctly.<\/li>\n<\/ol>\n

              Configure Lucee<\/h3>\n
                \n
              1. Point your browser to http:\/\/<youripaddress>:8888\/lucee\/admin\/server.cfm and login with the password you have specified during the installation process.<\/li>\n<\/ol>\n

                Have fun \ud83d\ude42<\/p>\n","protected":false},"excerpt":{"rendered":"

                Lucee is a light-weight dynamic scripting language for the JVM that enables the rapid development of simple to highly sophisticated web applications. Lucee is made for the web; it simplifies […]<\/p>\n","protected":false},"author":1,"featured_media":492,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[14,4,6],"tags":[54,63,61,35,34,68,46,69,43,49,75,89,52,33,87,41,98,44,48,100,29,102,42,93,28,103],"class_list":["post-489","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-coding","category-linux","category-security","tag-access","tag-ad","tag-address","tag-apache","tag-centos","tag-esx","tag-file","tag-firewall","tag-http","tag-https","tag-ie","tag-ipad","tag-log","tag-lucee","tag-oracle","tag-php","tag-postfix","tag-root","tag-script","tag-sendmail","tag-server","tag-update","tag-url","tag-webmin","tag-windows","tag-yum"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.web-workers.ch\/wp-content\/uploads\/2018\/03\/lucee3.png?fit=698%2C400&ssl=1","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8sxjX-7T","jetpack-related-posts":[],"jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/posts\/489","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/comments?post=489"}],"version-history":[{"count":28,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/posts\/489\/revisions"}],"predecessor-version":[{"id":640,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/posts\/489\/revisions\/640"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/media\/492"}],"wp:attachment":[{"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/media?parent=489"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/categories?post=489"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.web-workers.ch\/index.php\/wp-json\/wp\/v2\/tags?post=489"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}