User Tools

Site Tools


installation

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
installation [2013/03/26 22:41]
Timbow
installation [2015/06/10 09:58] (current)
datiswous [Installing on a local server]
Line 1: Line 1:
  
  
-====== Installation on a Web Server ====== +====== Installation on a Web Server or a Local Server ====== 
-   + 
-===== Step by Step Installation ​=====+===== Quick Install / Upgrade ===== 
 + 
 +  ​- Extract zip file to your web host 
 +  - Visit your domain and navigate to ''/​admin''​ (or your gsadmin path set in gsconfig), you will be redirected to the upgrade and install scripts 
 + 
 +**NOTE: Your site will be automatically put in maintenance mode during installs or upgrades.** 
 +===== Step by Step Install Procedure ​=====
  
   - [[http://​get-simple.info/​download|Download the latest version]].   - [[http://​get-simple.info/​download|Download the latest version]].
   - Unzip the contents to a new folder on your local computer.   - Unzip the contents to a new folder on your local computer.
   - Upload the contents of that folder with an FTP client to your host. You can upload everything to either the root of your server, or within a subfolder or sub domain.   - Upload the contents of that folder with an FTP client to your host. You can upload everything to either the root of your server, or within a subfolder or sub domain.
-  - You may also need to recursively CHMOD the folder ''/​data/''​ to 755 if your host doesn'​t set it implicitly. +  - You may also need to recursively CHMOD the folder ''/​data/''​ to 755 if your host doesn'​t set it implicitly. {{:​initialuload.png|}} 
-  - From a web browser, navigate to the folder where you just uploaded GetSimple to. This will redirect you to an install screen. (e.g ''​mydomain.tld''​ or ''​mydomain.tld/​path-to-get-simple/''​ ) +  - :!: Until you perform the install, any visitors to the site will get a Maintenance Message eg. //Site is temporarily unavailable//​
-    - **NOTE:** The actual path of the installation page is: ''​mydomain.tld/path-to-get-simple/admin/install.php''​+  - From a web browser, navigate to the folder where you just uploaded GetSimple to. You will need to navigate to the admin subdirectory ''/​admin''​. This will redirect you to an install screen. (e.g ''​mydomain.tld/admin''​ or ''​mydomain.tld/​path-to-get-simple/​admin''​ ) \\ //If you are using a custom gsadmin folder as setup in gsconfig, adjust this accordingly and remember to rename your admin folder for upgrades.//
   - All fields are mandatory. Once complete, you will be asked to sign in with your newly generated random password. Additionally,​ your username and temporary password will be emailed to the email address you input on the installation screen.   - All fields are mandatory. Once complete, you will be asked to sign in with your newly generated random password. Additionally,​ your username and temporary password will be emailed to the email address you input on the installation screen.
   - After completion of the setup you should be automatically forwarded into the administration panel. If you are not, please direct your browser to ''​mydomain.tld/​path-to-get-simple/​admin''​ to sign in.   - After completion of the setup you should be automatically forwarded into the administration panel. If you are not, please direct your browser to ''​mydomain.tld/​path-to-get-simple/​admin''​ to sign in.
   - Once you sign into GetSimple for the first time, you will be prompted to change your password to something you might better remember.   - Once you sign into GetSimple for the first time, you will be prompted to change your password to something you might better remember.
   - **IMPORTANT:​** It is also imperative that you go to **Support -> Health Check** to make sure that you've uploaded all necessary ''​.htaccess''​ files. Some folders in your installation have sensitive data and should not be accessible to outside visitors.   - **IMPORTANT:​** It is also imperative that you go to **Support -> Health Check** to make sure that you've uploaded all necessary ''​.htaccess''​ files. Some folders in your installation have sensitive data and should not be accessible to outside visitors.
-  - **HINT:** Most of the time if you are using "​[[pretty urls|Pretty URLs]]",​ they will not work right away. I usually find that waiting about an hour after installation will give your host enough time to pickup and process the ''​.htaccess''​ file that is needed to do the URL re-writes. 
  
-====== Installing on a local server ​======+===== Installing on a local server =====
 A **local server** is a webserver but it is not connected with the WorldWideWeb,​ it is just running on your local computer. That's why it is a local server. ​ A **local server** is a webserver but it is not connected with the WorldWideWeb,​ it is just running on your local computer. That's why it is a local server. ​
  
 It's never wrong to work on a **local webserver**,​ develop there and customize //your GetSimple// before you publish everything in the wild. Doing so, you have the chance to learn the new system before it is activated, to test plugins or themes ...  It's never wrong to work on a **local webserver**,​ develop there and customize //your GetSimple// before you publish everything in the wild. Doing so, you have the chance to learn the new system before it is activated, to test plugins or themes ... 
  
-These server-software-packages are either called ''​LAMP''​ (Linux, Apache, MySQL, PHP/​Perl/​Python) ​or ''​WAMP''​ (Windows, Apache, MySQL, PHP/​Perl/​Python) and their job is to deliver content from webpages (HTML etc.) like the webservers which deliver the content in the WWW.+These server-software-packages are either called
 +  * ''​LAMP''​ (Linux, Apache, MySQL, PHP/​Perl/​Python) ​ 
 +  * ''​WAMP''​ (Windows, Apache, MySQL, PHP/​Perl/​Python) 
 +  * ''​MAMP''​ (Mac OS X, Apache, MySQL, PHP/​Perl/​Python)  
 +and their job is to deliver content from webpages (HTML etc.) like the webservers which deliver the content in the WWW.\\ 
 +More info: [[http://​en.wikipedia.org/​wiki/​List_of_AMP_packages]]
  
 You work with the local server the same way like you work with a //real// webserver. The only difference is that you do not need to ftp your files to the server, using a file explorer on your local machine does the job.  You work with the local server the same way like you work with a //real// webserver. The only difference is that you do not need to ftp your files to the server, using a file explorer on your local machine does the job. 
  
-There are some software-packages out there, and they are free (mostly). ​The mostknown package ​is XAMP from [[http://​www.apachefriends.org/​en/​xampp.html | Apachefriends]], ​but this is a real big bundle. +There are some software-packages out there, and they are free (mostly).\\ 
-Others are [[http://​vertrigo.sourceforge.net/​ | Vertrigo Serv]] ​or [[http://​www.server2go-web.de/​ | Server2Go]], to name a few.\\ A comparison sheet of WAMP-servers: ​[[http://en.wikipedia.org/wiki/​Comparison_of_WAMPs]]+One of the most popuar packages ​is XAMPP from [[http://​www.apachefriends.org/​en/​xampp.html | Apachefriends]],​ this is a fairly large bundle. 
 +Others are \\ 
 +[[http://​vertrigo.sourceforge.net/​ | Vertrigo Serv]]\\ 
 +[[http://​www.server2go-web.de/​ | Server2Go]]\\ 
 +[[http://www.easyphp.org/|EasyPHP]]\\
  
 Each of these packages come with readmes, tutorials on their webpages or forums. So we can expect to find answers for our questions. ​ Each of these packages come with readmes, tutorials on their webpages or forums. So we can expect to find answers for our questions. ​
- +==== Installation ====
-===== Installation ​=====+
 The installation of GetSimple on a local webserver is nearly identical with the installation on your webspace: The installation of GetSimple on a local webserver is nearly identical with the installation on your webspace:
    * the server must be installed and started    * the server must be installed and started
Line 40: Line 53:
    * the installation will start.    * the installation will start.
  
-===== Known Problems ​=====+==== Known Problems ====
   - the webserver is not running at all in your browser:\\ the standard port used by a webserver is port 80. If you can't open the content which is produced by the webserver, you will have to check whether this port is //free//.\\ A wellknown problem is that other internet-software uses this port as well and by this blocks your local server and one prominent evildoer is **Skype**. Per default Skype listens on port 80 for incoming connections.\\ So you have to block that: Go to advanced/​connections and uncheck the option //use port 80 and 443 as alternatives for incoming connections//​.   - the webserver is not running at all in your browser:\\ the standard port used by a webserver is port 80. If you can't open the content which is produced by the webserver, you will have to check whether this port is //free//.\\ A wellknown problem is that other internet-software uses this port as well and by this blocks your local server and one prominent evildoer is **Skype**. Per default Skype listens on port 80 for incoming connections.\\ So you have to block that: Go to advanced/​connections and uncheck the option //use port 80 and 443 as alternatives for incoming connections//​.
   - the webserver is working, but you cannot install GetSimple on a windows machine:\\ this can be a result of the overprotective user-handling in the newer versions of Windows.\\ We encountered this problem with [[http://​www.server2go-web.de/​ | Server2Go]].\\ The error was that GetSimple was not found, the server started with the URL ''​http://​127.0.0.1:​4011''​. When you start the server (server2go.exe) with administrator rights, the server opens in the browser with ''​http://​127.0.0.1''​ and it is possible to navigate to ''​http://​127.0.0.1/​getsimple''​to have the installation started.\\ Conclusion: it's more a user-rights-problem than an administrator problem.\\ To start server2go always as administrator,​ edit the desktop-link (right-click,​ properties, extended, run as administrator) and you are on the go    - the webserver is working, but you cannot install GetSimple on a windows machine:\\ this can be a result of the overprotective user-handling in the newer versions of Windows.\\ We encountered this problem with [[http://​www.server2go-web.de/​ | Server2Go]].\\ The error was that GetSimple was not found, the server started with the URL ''​http://​127.0.0.1:​4011''​. When you start the server (server2go.exe) with administrator rights, the server opens in the browser with ''​http://​127.0.0.1''​ and it is possible to navigate to ''​http://​127.0.0.1/​getsimple''​to have the installation started.\\ Conclusion: it's more a user-rights-problem than an administrator problem.\\ To start server2go always as administrator,​ edit the desktop-link (right-click,​ properties, extended, run as administrator) and you are on the go 
  
-===== Moving from local server to a '​live'​ site =====+==== Moving from local server to a '​live'​ site ====
  
 If you developed your site in a local GetSimple installation but later want to publish it in the Web, you must know that **it's not only uploading all files** to the public server. It is recommended to do a new GetSimple install (the process will set the necessary file permissions),​ and then uploading your data, theme, plugins, etc.  If you developed your site in a local GetSimple installation but later want to publish it in the Web, you must know that **it's not only uploading all files** to the public server. It is recommended to do a new GetSimple install (the process will set the necessary file permissions),​ and then uploading your data, theme, plugins, etc. 
  
-See full details here: http://​get-simple.info/​wiki/​installation:​migrating+See full details here: [[installation:​migrating|Migrating, Moving and Uploading Complete Sites]]
  
 (If you just upload all, your site might not work. If it does, it could be vulnerable.) (If you just upload all, your site might not work. If it does, it could be vulnerable.)
Line 60: Line 73:
   * after that, upload these updated files to your server   * after that, upload these updated files to your server
  
 +======Links======
 +Back to the GetSimple Wiki [[start|Contents Page]]
 +==Pages in this Section==
 +===Installation===
 +  *[[:​installation|Installation on a Web Server or a Local Server]]
 +  *[[installation:​migrating|Migrating,​ Moving and Uploading Complete Sites]]
 +  *[[installation:​requirements|Server requirements and Apache Modules]]
 +  *[[installation:​upgrade|Upgrading to the Latest Version of GetSimple]]
 +  *[[installation:​specific-webhosters|Guidance for Specific Hosting Companies]]
  
  
installation.1364337700.txt.gz · Last modified: 2013/04/19 14:53 (external edit)