====== Installation ====== ^ :!: Notes ^ | If you have used Instant Update 2.0, you might want to take a look at [[install:upgrade#from_2.0|upgrade instructions]]. | | Before you start, make sure your web server meets [[install:sysrequirements|system requirements]], you have [[install:configuration|configured]] and [[install:converting|converted]] your web site. | | There is a video tutorial available on this topic. You can view it [[http://www.instant-update.com/videos/iu3-install/|here]], if you want. | ^ :!: VERY IMPORTANT :!: ^ | If you are forcing **www** subdomain on your website [[http://www.instant-update.com/plus/force-www.txt|via .htaccess file]], you MUST disable it by commenting or deleting lines from .htaccess file until installation is done! | Instant Update installation is rather simple. Once you open **yourwebsite.com/manage** with your browser, where you've [[install:configuration|uploaded]] your Instant Update files, you will be redirected to the Instant Update installer. Installer will automatically detect whether your **manage/connection.php** file is changed or not, and if it is changed this means that Instant Update is already installed (MySQL data is found inside file manage/connection.php) and you are [[install:upgrade|upgrading]] from previous version, but if it is not changed you are installing clean version of Instant Update. So, it is VERY important that you keep your old **connection.php** file if you are upgrading from version 2.0 and to keep your old **connection.php** and **license.php** files if you are upgrading from previous (but not 2.0) version of Instant Update. ===== Step 1: CHMOD ===== It is not important if you are upgrading or installing new version of IU, the first step is same for both actions. We need to ensure that files **connection.php** and **license.php** are writable. If not, you will be asked to make them writable, which means that you will probably need to change their [[install:configuration#chmod|CHMOD]] to 777 if you are hosting your web site on Linux/Unix server (and over 70% of web servers are running Linux/Unix system). If your web site is hosted on Windows server, you'll have to give write permissions for these files to user which is running web server. More info about CHMOD can be found [[install:configuration#chmod|here]]. ===== Step 2: Check license ===== Due to large number of unlicensed (nulled) versions of previous version of Instant Update we have found on web, we are introducing licensing system. In the second step of installation you will be asked to enter your [[http://www.paypal.com/|PayPal]] Transaction ID with which you have purchased Instant Update. Each customer should get Transaction ID from PayPal after purchase, and this is how part of that email looks like: Transaction ID: 2WX421830H9658414 Buyer Name: John Doe Buyer Email: user@domain.com Transaction Amount: $289.00 USD Transaction Date: Jul. 25, 2008 Transaction ID is something like your private serial number for Instant Update. **DO NOT SHARE YOUR TRANSACTION ID!!!** \\ It is really not wise to share your Transaction ID because you are limited with certain number of installations and letting someone else use your Transaction ID will give that person ability to use your installations. If you have unlimited license you could share your Transaction ID but you are risking because we will [[install:transaction_blacklisted|blacklist]] every single Transaction ID we see publicly displayed anywhere on the web, and when Transaction ID is blacklisted there isn't much you can do about that, as we remove Transaction IDs from black list very rarely. After you've entered your Transaction ID you will be redirected to our website which will check validity of your Transaction ID. If everything is okay with your license, you will be redirected back to your website to continue installation. ^ :!: Note ^ | You should keep your Transaction ID **secret**. Do not share it at any cost as your Transaction ID will be [[install:transaction_blacklisted|blacklisted]] if we see you sharing your Transaction ID over the web. | ===== Step 3: Get MySQL data ===== When license is checked, license data will be stored into **manage/license.php**. By default, this file is not accessible with web browser so your data is safe within that file. We advise you to backup this file ASAP because you might accidentally overwrite it with blank license file when [[install:upgrade|upgrading]] to new version. **Do not try** to reverse engineer this file because you won't get support with invalid license file, and your Transaction ID might get [[install:transaction_blacklisted|blacklisted]] if you try to reverse engineer our protection system! In this step you will be asked for MySQL data, which is five (5) datums we need. If you have [[http://www.cpanel.net/|cPanel]] on your website you might get MySQL data from cPanel. Otherwise, please contact your web hosting provider and ask them for following data. Data we need: * MySQL host: In 99% cases this will be **localhost** * MySQL user name: User name of MySQL user which has privileges to work with your MySQL database * MySQL password: Password of previously mentioned user * MySQL database: Name of database which will be used to store Instant Update data. You don't need empty database, you can use any existing database for IU * MySQL table prefix: Anything you want (only letters/numbers/underscores). We suggest **iu3_** or anything else. If you are installing two or more installations of Instant Update in same MySQL database, each installation needs to have **different table prefix** ^ :!: Notes ^ | cPanel users, you can learn how to create database in cPanel and assign user to it [[http://www.everymanhosting.com/cpanel-tutorials/add-mysql-database.php|step by step]], or by [[http://www.cpanel.net/media/tutorials/mysqlwizard.htm|using a wizard]] | | If you get some MySQL errors after this step, you might be using old MySQL server on your website. Take a look at [[troubles:mysql_problems|this solution]]. | ===== Step 4: Create administrator ===== In the 4th step we are creating default administrator account and first user of your Instant Update installation. You can use whatever you want here, but don't use same and easy-to-think-of word for username/password (e.g. do NOT use word **admin** both for user name and password). After you've entered user name you should enter password and confirm it by typing it again (to ensure that you have not mistyped any letters). Click **Finish** to continue and you should get message telling you that everything is okay and that your Installation was successful. ===== Step 5: Clean ===== Everything is done, and your IU should be successfully installed. Before you can start using Instant Update, go to your **manage/** directory and delete whole **install/** directory from within that folder. **install/** directory is IU's installation directory and leaving it on web server might harm your website. When you delete **install/** directory, navigate to //yourwebsite.com/manage// with your web browser to start using your Instant Update. Log in with administrator username and password you've chosen in //Step 4: Create administrator//.