Difference between revisions of "Installation:website"

From PrometheusIPN Wiki
Jump to: navigation, search
(Fixed grammatical issues, and expanded on previous information regarding installation ^Tristan)
Line 7: Line 7:
  
 
* Extract the contents of the "Web files" folder to your web server
 
* Extract the contents of the "Web files" folder to your web server
* Edit the file config.php to fit your MySQL database details
+
* Create a MySQL database and user using your website's control panel. Make sure to give the user read/write/execute access to the database.
* Create the database you specified above
+
* Edit the file config.php that you have uploaded and fill in the MySQL database and user information from step 2. (for the host, typically you can leave it as 'localhost' and port '3306')
* Visit yourwebsite.com/install.php Now you will see something similar to this:
+
* After you have modified your config.php file, navigate to yourwebsite.com/install.php. Here, you will see something similar to this:
 
<br><br>
 
<br><br>
 
[[File:Web1.png|900px]]
 
[[File:Web1.png|900px]]
<br>
+
<br><br>
  
 
The three last fields will be automatically filled in and the other ones are pretty self explanatory.
 
The three last fields will be automatically filled in and the other ones are pretty self explanatory.
  
The next step is for Linux only Make sure to set the right permissions for your files!
+
====== Extra Steps for Linux Installations ======
This can be done by running these commands in a linux terminal:
+
 
 +
The next step is for Linux only. Make sure to set the right permissions for your files! This can be done by running these commands in a Linux terminal:
  
 
  cd path/to/installdir
 
  cd path/to/installdir
Line 25: Line 26:
  
 
===== BLANK PAGE =====
 
===== BLANK PAGE =====
 +
If you are encountering an issue with the page being blank or your web browser stating an 'Internal Error 500', please follow the below guide in order to fix it:
  
 
====== Windows ======
 
====== Windows ======
 
The next step is for Windows only!
 
The next step is for Windows only!
 
* Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory
 
* Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory
 +
* If you are having error 500 and have already allowed IIS_USRS access, please make sure to also grant IUSR access.
  
 
====== Linux ======
 
====== Linux ======
 
* Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions ''recursively''
 
* Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions ''recursively''
* (Alternatively just run the SSH command ''sudo chmod 0777 cache/* ''whilst in the Prometheus directory)
+
* Alternatively, you can also just run the SSH command ''sudo chmod 0777 cache/* ''whilst in the Prometheus directory.
 +
 
 
'''Both'''
 
'''Both'''
  
If the blank page issue persists, please find a PHP error log and submit a ticket over at [[nmscripts.com]] with the error log. It's likely you are missing a depdendency.
+
If the blank page issue persists, please find a PHP error log and submit a ticket over at [[nmscripts.com]] with your host's PHP error log (found on your website's control panel typically). It's likely that you are missing a dependency.
 +
 
 +
When you have completed the installation you can now visit yourwebsite.com and click 'Sign In' from the menu. The first user that signs in is the one that will get root admin permission, so please make sure to sign in quickly to make sure you don't get locked out.
  
When the installation is done the first user to sign in gets admin privileges
+
===== Optional Steps =====
 +
You may complete the following additional tasks to extend your Prometheus installation's capabilities:
 +
* You can set your /img folder to have read/write permissions (CHMOD 0777) to allow you to upload files directly when configuring packages and servers.
 +
* If you include a Steam API key in your config.php file, it will be used as a fallback in case Steam authorization fails. This is recommended.

Revision as of 21:30, 7 June 2016

Video tutorial


WEBSITE INSTALLATION

The web installation is pretty straight forward.

  • Extract the contents of the "Web files" folder to your web server
  • Create a MySQL database and user using your website's control panel. Make sure to give the user read/write/execute access to the database.
  • Edit the file config.php that you have uploaded and fill in the MySQL database and user information from step 2. (for the host, typically you can leave it as 'localhost' and port '3306')
  • After you have modified your config.php file, navigate to yourwebsite.com/install.php. Here, you will see something similar to this:



Web1.png

The three last fields will be automatically filled in and the other ones are pretty self explanatory.

Extra Steps for Linux Installations

The next step is for Linux only. Make sure to set the right permissions for your files! This can be done by running these commands in a Linux terminal:

cd path/to/installdir
sudo chown www-data:www-data install.php img/pkgs updates themes
sudo chmod 775 install.php cert/* ipn_errors.log img/pkgs updates
sudo chmod 0777 cache/* themes
BLANK PAGE

If you are encountering an issue with the page being blank or your web browser stating an 'Internal Error 500', please follow the below guide in order to fix it:

Windows

The next step is for Windows only!

  • Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory
  • If you are having error 500 and have already allowed IIS_USRS access, please make sure to also grant IUSR access.
Linux
  • Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions recursively
  • Alternatively, you can also just run the SSH command sudo chmod 0777 cache/* whilst in the Prometheus directory.

Both

If the blank page issue persists, please find a PHP error log and submit a ticket over at nmscripts.com with your host's PHP error log (found on your website's control panel typically). It's likely that you are missing a dependency.

When you have completed the installation you can now visit yourwebsite.com and click 'Sign In' from the menu. The first user that signs in is the one that will get root admin permission, so please make sure to sign in quickly to make sure you don't get locked out.

Optional Steps

You may complete the following additional tasks to extend your Prometheus installation's capabilities:

  • You can set your /img folder to have read/write permissions (CHMOD 0777) to allow you to upload files directly when configuring packages and servers.
  • If you include a Steam API key in your config.php file, it will be used as a fallback in case Steam authorization fails. This is recommended.