KNOWNHOST WIKI

User Tools

Site Tools


cms:install-xenforo-manually

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

cms:install-xenforo-manually [2016/12/25 23:33]
mscherf created for #137
cms:install-xenforo-manually [2017/11/10 16:32] (current)
Daniel P.
Line 9: Line 9:
   - You may also want to [[control-panels:​cpanel-whm:​getting-started#​creating_a_website|create]] an additional [[https://​documentation.cpanel.net/​display/​ALD/​FTP+Accounts|ftp]] or [[https://​documentation.cpanel.net/​display/​ALD/​Web+Disk#​WebDisk-CreateanadditionalWebDiskaccount|webdav]] account within that, restricted to the directory the site will be located in,((eg, ''​%%public_html%%''​ or a subdirectory thereof; in our example this will be the ''​%%forums%%''​ directory)) especially if you will want to give a developer ftp and/or webdav access to the site files without giving them access to the whole cPanel account.   - You may also want to [[control-panels:​cpanel-whm:​getting-started#​creating_a_website|create]] an additional [[https://​documentation.cpanel.net/​display/​ALD/​FTP+Accounts|ftp]] or [[https://​documentation.cpanel.net/​display/​ALD/​Web+Disk#​WebDisk-CreateanadditionalWebDiskaccount|webdav]] account within that, restricted to the directory the site will be located in,((eg, ''​%%public_html%%''​ or a subdirectory thereof; in our example this will be the ''​%%forums%%''​ directory)) especially if you will want to give a developer ftp and/or webdav access to the site files without giving them access to the whole cPanel account.
     - In this example we will be creating an ftp account, restricted to our ''​%%forums%%''​ folder, and connecting over ftps using [[software:​how-can-i-configure-filezilla-to-upload-files-via-sftp|FileZilla]]. Once you have created the new cPanel account for the site, [[control-panels:​cpanel-whm:​getting-started#​logging_into_cpanel|log into cPanel]] as the new user and go to "FTP Accounts"​ in the "​Files"​ section.     - In this example we will be creating an ftp account, restricted to our ''​%%forums%%''​ folder, and connecting over ftps using [[software:​how-can-i-configure-filezilla-to-upload-files-via-sftp|FileZilla]]. Once you have created the new cPanel account for the site, [[control-panels:​cpanel-whm:​getting-started#​logging_into_cpanel|log into cPanel]] as the new user and go to "FTP Accounts"​ in the "​Files"​ section.
-      * {{:​cms:​xenforofindftpaccounts.png?​300|}}+      * {{:​cms:​xenforofindftpaccounts.png?​direct&300|}}
     - Enter in a username and password for the account, and the directory you will want to restrict the ftp account to. Make sure to choose a strong [[security:​misc:​how-can-i-generate-a-secure-random-password|password]]! If you are using pure-ftpd you can also choose to put a disk quota on the ftp account'​s folder. Once you have entered in the needed details, click "​Create FTP Account"​.     - Enter in a username and password for the account, and the directory you will want to restrict the ftp account to. Make sure to choose a strong [[security:​misc:​how-can-i-generate-a-secure-random-password|password]]! If you are using pure-ftpd you can also choose to put a disk quota on the ftp account'​s folder. Once you have entered in the needed details, click "​Create FTP Account"​.
-      * {{:​cms:​xenforocreateftpaccount.png?​300|}}+      * {{:​cms:​xenforocreateftpaccount.png?​direct&300|}}
     - Once the ftp account has been created, open your FTP client and [[software:​how-can-i-configure-filezilla-to-upload-files-via-sftp|connect]] to the server using the new ftp account. Since in our example we are not using the cPanel account itself to connect, but rather, a smaller ftp account inside of that, so we will not be able to use [[general:​what-is-the-difference-between-ftp-and-sftp|sftp]],​ but we //can// still use ftps.     - Once the ftp account has been created, open your FTP client and [[software:​how-can-i-configure-filezilla-to-upload-files-via-sftp|connect]] to the server using the new ftp account. Since in our example we are not using the cPanel account itself to connect, but rather, a smaller ftp account inside of that, so we will not be able to use [[general:​what-is-the-difference-between-ftp-and-sftp|sftp]],​ but we //can// still use ftps.
-      * {{:​cms:​xenforoconnectftps.png?​300|}}+      * {{:​cms:​xenforoconnectftps.png?​direct&300|}}
     - Since when we created this ftp account we restricted it to the directory we want to put the site in, we are already automatically in the correct directory when we log into the site.     - Since when we created this ftp account we restricted it to the directory we want to put the site in, we are already automatically in the correct directory when we log into the site.
   - If you are using the test script, you will need to unzip it. How to do this will vary by the OS installed in your computer. Once it is unzipped, you can upload the php script ''​%%xenforo_requirements.php%%''​ into your server. In FileZilla you can do this either by drag-and-drop,​ or by right-clicking the file and choosing "​Upload"​.   - If you are using the test script, you will need to unzip it. How to do this will vary by the OS installed in your computer. Once it is unzipped, you can upload the php script ''​%%xenforo_requirements.php%%''​ into your server. In FileZilla you can do this either by drag-and-drop,​ or by right-clicking the file and choosing "​Upload"​.
-    * {{:​cms:​xenforouploadtestscript.png?​300|}}+    * {{:​cms:​xenforouploadtestscript.png?​direct&300|}}
     - Since this is a small script, it is not likely to take very long to upload.((unless you have a very slow connection)) Once it has completed, you can navigate in your web browser to view the page the script is served on.((If the site's domain does not yet resolve, you will need to make sure it has been added to the hosts file, as mentioned earlier.)) In our example, the ftp account we are using is restricted to the folder ''​%%forums%%''​ so that is where we will find it.     - Since this is a small script, it is not likely to take very long to upload.((unless you have a very slow connection)) Once it has completed, you can navigate in your web browser to view the page the script is served on.((If the site's domain does not yet resolve, you will need to make sure it has been added to the hosts file, as mentioned earlier.)) In our example, the ftp account we are using is restricted to the folder ''​%%forums%%''​ so that is where we will find it.
-      * {{:​cms:​xenforoviewtestscript.png?​300|}}+      * {{:​cms:​xenforoviewtestscript.png?​direct&300|}}
     - As the test script mentions, XenForo also requires MySQL 5.0 or older. Unless your server is //very// old, you won't need to worry about this. If you are not sure, you can check in WHM at "Home >> Software >> MariaDB/​MySQL Upgrade"​ or similar. If you are not sure or need help upgrading, please feel free to [[support:​how-do-i-submit-a-ticket|open a Support Ticket]].     - As the test script mentions, XenForo also requires MySQL 5.0 or older. Unless your server is //very// old, you won't need to worry about this. If you are not sure, you can check in WHM at "Home >> Software >> MariaDB/​MySQL Upgrade"​ or similar. If you are not sure or need help upgrading, please feel free to [[support:​how-do-i-submit-a-ticket|open a Support Ticket]].
     - If the server is missing any php modules that XenForo needs, the page might look more like this. These modules can usually be installed via [[https://​documentation.cpanel.net/​display/​EA4/​How+to+Locate+and+Install+a+PHP+Version+or+Extension#​HowtoLocateandInstallaPHPVersionorExtension-InstallaPHPmoduleorextension|EasyApache]]. If you need help installing the php modules, please feel free to [[support:​how-do-i-submit-a-ticket|open a Support Ticket]].     - If the server is missing any php modules that XenForo needs, the page might look more like this. These modules can usually be installed via [[https://​documentation.cpanel.net/​display/​EA4/​How+to+Locate+and+Install+a+PHP+Version+or+Extension#​HowtoLocateandInstallaPHPVersionorExtension-InstallaPHPmoduleorextension|EasyApache]]. If you need help installing the php modules, please feel free to [[support:​how-do-i-submit-a-ticket|open a Support Ticket]].
-      * {{:​cms:​xenforotestscriptfail.png?​300|}}+      * {{:​cms:​xenforotestscriptfail.png?​direct&300|}}
     - Once you have verified that the test script has succeeded, it is recommended to remove the test script. In FileZilla, this can be done by right-clicking the filename and choosing "​Delete"​.     - Once you have verified that the test script has succeeded, it is recommended to remove the test script. In FileZilla, this can be done by right-clicking the filename and choosing "​Delete"​.
-      * {{:​cms:​xenfororemovetestscript.png?​300|}}+      * {{:​cms:​xenfororemovetestscript.png?​direct&300|}}
   - After removing the test script from the server,((or if you are not using the test script)) we next upload the installation files.   - After removing the test script from the server,((or if you are not using the test script)) we next upload the installation files.
     - First, we unzip the installation archive. After this, there should now be a folder "​upload"​ where you unzipped it. It is the files inside this folder that we will be uploading. In FileZilla, you can enter the folder by double-clicking on it, or by right-clicking it and choosing "Enter directory"​.     - First, we unzip the installation archive. After this, there should now be a folder "​upload"​ where you unzipped it. It is the files inside this folder that we will be uploading. In FileZilla, you can enter the folder by double-clicking on it, or by right-clicking it and choosing "Enter directory"​.
-      * {{:​cms:​xenforouploadfolder.png?​300|}}+      * {{:​cms:​xenforouploadfolder.png?​direct&300|}}
     - Once inside the "​upload"​ directory, select all contents of that directory((for example with Ctrl+A; or by clicking the top one, scrolling to the bottom of hte list, holding Shift, then clicking the bottom one)) then copy all the files up to the server.((either by drag-and-dropping them across, or by right-clicking and choosing "​Upload"​)) Make sure the folder ''​%%..%%''​ is **not** one of the folders selected while doing this.     - Once inside the "​upload"​ directory, select all contents of that directory((for example with Ctrl+A; or by clicking the top one, scrolling to the bottom of hte list, holding Shift, then clicking the bottom one)) then copy all the files up to the server.((either by drag-and-dropping them across, or by right-clicking and choosing "​Upload"​)) Make sure the folder ''​%%..%%''​ is **not** one of the folders selected while doing this.
-      * {{:​cms:​xenforouploadthefiles.png?​300|}}+      * {{:​cms:​xenforouploadthefiles.png?​direct&300|}}
     - The official instructions recommend chmodding in the server folders ''​%%data%%''​ and ''​%%internal_data%%''​ to permissions ''​%%0777%%'',​ but if the site is using a php/apache configuration with suphp-like permissions,​((eg,​ suphp, mod_ruid2, php-fpm, or fcgi)) this shouldn'​t be necessary.     - The official instructions recommend chmodding in the server folders ''​%%data%%''​ and ''​%%internal_data%%''​ to permissions ''​%%0777%%'',​ but if the site is using a php/apache configuration with suphp-like permissions,​((eg,​ suphp, mod_ruid2, php-fpm, or fcgi)) this shouldn'​t be necessary.
   - Next, it is necessary to create a database and database user for the site to use. If you are not familiar with the process, it is recommended to use the cPanel [[https://​documentation.cpanel.net/​display/​ALD/​MySQL+Database+Wizard|Database Wizard]]   - Next, it is necessary to create a database and database user for the site to use. If you are not familiar with the process, it is recommended to use the cPanel [[https://​documentation.cpanel.net/​display/​ALD/​MySQL+Database+Wizard|Database Wizard]]
     - The Database Wizard can be found in the "​Databases"​ section of cPanel:     - The Database Wizard can be found in the "​Databases"​ section of cPanel:
-      * {{:​cms:​xenforofinddatabasewizard.png?​300|}}+      * {{:​cms:​xenforofinddatabasewizard.png?​direct&300|}}
     - Pick a name for the database. If Database Prefixing is enabled in the server, cPanel will automatically preppend the first eight letters of the cPanel username and an underscore. Although you won't need to type in that part, be sure to make note of the full databasename,​ since you will need it momentarily.     - Pick a name for the database. If Database Prefixing is enabled in the server, cPanel will automatically preppend the first eight letters of the cPanel username and an underscore. Although you won't need to type in that part, be sure to make note of the full databasename,​ since you will need it momentarily.
-      * {{:​cms:​xenforodatabasewizarddatabasename.png?​300|}}+      * {{:​cms:​xenforodatabasewizarddatabasename.png?​direct&300|}}
     - Next, a mysql user will need to be created. As with the database name, the mysql username may be longer than the part you type in yourself. Make sure to make note of the full database name. Also make sure to [[security:​misc:​how-can-i-generate-a-secure-random-password|choose a strong password]] for the mysql user.     - Next, a mysql user will need to be created. As with the database name, the mysql username may be longer than the part you type in yourself. Make sure to make note of the full database name. Also make sure to [[security:​misc:​how-can-i-generate-a-secure-random-password|choose a strong password]] for the mysql user.
-      * {{:​cms:​xenforodatabasewizardcreateuser.png?​300|}}+      * {{:​cms:​xenforodatabasewizardcreateuser.png?​direct&300|}}
     - Then it is necessary to choose which privileges to give the new mysql user in the new database. For this purpose "All Privileges"​ should work:     - Then it is necessary to choose which privileges to give the new mysql user in the new database. For this purpose "All Privileges"​ should work:
-      * {{:​cms:​xenforodatabasewizardgrants.png?​300|}}+      * {{:​cms:​xenforodatabasewizardgrants.png?​direct&300|}}
   - Once the files have all been uploaded, and the database and mysql user have been created, navigate in your web browser to the "​install"​ directory and follow the on-screen instructions. In our example, due to the folder we chose to place it in, the url will be like ''​%%http://​domain.tld/​forums/​install/​%%''​. Remember to replace ''​%%domain.tld%%''​ with your domain, and any other needed url substitutions.   - Once the files have all been uploaded, and the database and mysql user have been created, navigate in your web browser to the "​install"​ directory and follow the on-screen instructions. In our example, due to the folder we chose to place it in, the url will be like ''​%%http://​domain.tld/​forums/​install/​%%''​. Remember to replace ''​%%domain.tld%%''​ with your domain, and any other needed url substitutions.
-    * {{:​cms:​xenforoinstallwelcome.png?​300|}}+    * {{:​cms:​xenforoinstallwelcome.png?​direct&300|}}
     - You will need to enter in the mysql credentials you just created.     - You will need to enter in the mysql credentials you just created.
-      * {{:​cms:​xenforoinstalldbinfo.png?​300|}}+      * {{:​cms:​xenforoinstalldbinfo.png?​direct&300|}}
     - Although the [[https://​xenforo.com/​help/​installation/​|official instructions]] say you are likely to need to download the config file and reupload it manually, if you are using a php/apache configuration that uses suphp-like permissions,​ this is unlikely to be needed.     - Although the [[https://​xenforo.com/​help/​installation/​|official instructions]] say you are likely to need to download the config file and reupload it manually, if you are using a php/apache configuration that uses suphp-like permissions,​ this is unlikely to be needed.
-      * {{:​cms:​xenforoinstallconfigcomplete.png?​300|}}+      * {{:​cms:​xenforoinstallconfigcomplete.png?​direct&300|}}
     - Continue reading and following the prompts. During the "​Install"​ stage, xenforo will create the database tables, which will take several seconds. After that, you can create the first forum administrator,​ with any chosen username and contact address.((Make sure to use a real email address, unlike the one in the screenshot.)) Be sure to [[security:​misc:​how-can-i-generate-a-secure-random-password|choose a strong password]]!     - Continue reading and following the prompts. During the "​Install"​ stage, xenforo will create the database tables, which will take several seconds. After that, you can create the first forum administrator,​ with any chosen username and contact address.((Make sure to use a real email address, unlike the one in the screenshot.)) Be sure to [[security:​misc:​how-can-i-generate-a-secure-random-password|choose a strong password]]!
-      * {{:​cms:​xenforoinstallcreateadmin.png?​300|}}+      * {{:​cms:​xenforoinstallcreateadmin.png?​direct&300|}}
     - A title, url, contact email address, and home page url will be prefilled based on xenforo'​s guesses based on things you have already entered in. You are likely to want to edit the Board Title and possibly the Home Page URL. If you leave Home Page URL blank, you will not have a "​Home"​ link in the navigation.     - A title, url, contact email address, and home page url will be prefilled based on xenforo'​s guesses based on things you have already entered in. You are likely to want to edit the Board Title and possibly the Home Page URL. If you leave Home Page URL blank, you will not have a "​Home"​ link in the navigation.
-      * {{:​cms:​xenforoinstallinitialsettings.png?​300|}}+      * {{:​cms:​xenforoinstallinitialsettings.png?​direct&300|}}
   - It is a good idea at the end to do the Post-Installation Checks. You can use the "Enter your control panel" button at the end of the installation process to be redirected to the admin login area, or go to the admin url directly. Enter in the admin username and password you just created, and click the "Log in" button.   - It is a good idea at the end to do the Post-Installation Checks. You can use the "Enter your control panel" button at the end of the installation process to be redirected to the admin login area, or go to the admin url directly. Enter in the admin username and password you just created, and click the "Log in" button.
-    * {{:​cms:​xenforoinstalllogin.png?​300|}}+    * {{:​cms:​xenforoinstalllogin.png?​direct&300|}}
     - Click "​Tools"​ near the top:     - Click "​Tools"​ near the top:
-      * {{:​cms:​xenforofindtools.png?​300|}}+      * {{:​cms:​xenforofindtools.png?​direct&300|}}
     - Then you can use the "File Health Check" at the left to make sure the correct files exist and that, for the files checked, they have the correct contents.     - Then you can use the "File Health Check" at the left to make sure the correct files exist and that, for the files checked, they have the correct contents.
-      * {{:​cms:​xenforofindfilehealthcheck.png?​300|}}+      * {{:​cms:​xenforofindfilehealthcheck.png?​direct&300|}}
     - Then you will see a general description of what the "File Health Check" is, and have a button to click to start it.     - Then you will see a general description of what the "File Health Check" is, and have a button to click to start it.
-      * {{:​cms:​xenforofilehealthcheckbutton.png?​300|}}+      * {{:​cms:​xenforofilehealthcheckbutton.png?​direct&300|}}
     - If the check was successful, it should look approximately like this:     - If the check was successful, it should look approximately like this:
-      * {{:​cms:​xenforofilehealthchecksuccess.png?​300|}}+      * {{:​cms:​xenforofilehealthchecksuccess.png?​direct&300|}}
   - XenForo should now be installed! Enjoy!   - XenForo should now be installed! Enjoy!
  
cms/install-xenforo-manually.txt · Last modified: 2017/11/10 16:32 by Daniel P.