====== Unirgy Installer ======
===== Introduction =====

===== Installation ===== 


1. [[http://www.ioncube.com/loaders.php|Download]] ionCube loader from the official website. Install it as described in the README.txt attached to the archive you've downloaded.

2. Login to Magento backend

3. Go to **System → Tools → Compilation**. 
{{ :unirgy:1496227972699.png?nolink |}}

If Compiler Status is **Enabled**, disable the compilation by clicking the button **Disable** 

4. Download the extension [[http://download.unirgy.com/Unirgy_Installer-latest.zip|here]]

5. Connect to your website with FTP/sFTP/SSH and upload the app folder to the root folder of your Magento installation.
<WRAP center round important 60%>
Use the “Merge” upload mode. Do **not replace** the whole folders, but **merge** them. This way your FTP/SFTP client will only add new files. This mode is used by default by most file transfer applications
</WRAP>

6. In your backend go to **System → Cache Management**
{{ :unirgy:1496229540791.png?nolink |}}

Click **Flush Cache Storage** button. 

7. If you need to enable compilation, you can do it at **System → Tools → Compilation**. Click the **Run Compilation Process** button.

8. Log out from the backend and log in again.  
===== Set up =====

==== Automatically ====


1. Go to  **System → Tools → Unirgy Installer**

2. To add the new license go to the **Add Licenses** tab.

{{ :unirgy:c4f4390968.png?nolink |}}

You need to type (or copy/paste) the license key in the text field.
If you wish the corresponding extensions to be downloaded and installed, you can select the Download and install related extensions checkbox.

<WRAP center round important 60%>
To perform the installation, Unirgy Installer uses  [[http://php.net/manual/en/book.zip.php|PHP Zip]]. If it is not enabled on your server, you can use the manual installation of the extension.
</WRAP>

==== Manual Installation====

1. Go to the **Manage Modules** tab.

{{ :unirgy:fd8a647eaa.png?nolink |}}

2. Click the **Hover/Click** button of the extension that you wish to install.

3. The module will be downloaded on your local device.

4. Follow the same procedures as provided for the installation of the [[unirgy:installer#introduction|Unirgy Installer]]

5. After wiping the caches, logout and login to the Magento backend. You should be able to view the new extensions on your website

<WRAP center round important 60%>
If you face the 404 page on the backend instead of the Module configuration after the installation of the extension, try to perform the logout/login operation</WRAP>

===== Manage Licenses=====

Go to **System → Tools → Unirgy Installer → Manage Licenses**

Here is the grid with all the licenses that you've purchased

{{ :unirgy:e9badcc381.png?nolink |}}


**1. Send Server Info** This allows to send the server info (such as IP, MAC address, etc) to Unirgy server. May be useful in case the client doesn't have this information at hand.

**2. Refresh Licenses** Button applies to all licences

**3. Status** Can be either **Active**, **Inactive** or **Expired**.

**4. License Key** The license key added via Add License tab will be shown here.

**5. Products Covered**. The extension that is assigned to this license key. In case several extensions cover the same license, all of them will be on this list.

**6. Dev Servers** Localhost is always included in the license, in addition, you can specify a single development domain.

**7. Live Servers 1** This field is for the domain name of the live server

**8. Live Servers 2** This field is for the IP/MAC address

**9. License Expires** The date when  trial/1 week licenses are terminated.

**10.Upgrade Expires** Date when your license becomes expired.
===== Manage Modules=====
To find out which Unirgy Modules have been installed go to **System > Tools > Unirgy Installer**.

{{ :unirgy:10edaefb3d.png?nolink |}}

**1. Module.** The name of the extension.

**2. Download URL.** Necessary for the [[unirgy:installer#manual_installation|manual installation]]. The link to download the latest version of the extension available to the client.

**3. Last downloaded.** The date when the latest version of the extension was installed on this server.

**4. Installed.** The version of the installed extension. If background color of this cell is **Red** then module has an update available. If color is **Green** then module has the latest version and if the color is **Orange**, the version installed is not recognized (it happens when you have customized extension.)

**5. Last checked.** Date when the client's licenses were checked for the last time.

**6. Available** The latest version of the extension that is available right now. Bear in mind that in order to download this particular version, the client needs to renew their license in case it is expired.

**7. Changelog** If the client is not using the latest version of the extension, they can check the changelog to look for the new features.

===== Troubleshooting =====

==== Compilation Not Disabled ====
If you did not disable compilation and the website isn't working, open **config.php** file located at **root_folder/includes** and comment out strings 28-29


<code>
#define('COMPILER_INCLUDE_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'src');
#define('COMPILER_COLLECT_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'stat');
</code>


 {{ :unirgy:1496230169053.png?nolink |}} 


Save the changes. This operation should disable the compilation.

After compilation is disabled, your website should be recovered.

To enable compilation, you can do it at **System → Tools → Compilation**. Click the **Run Compilation Process** button.

==== Write Permissions Issues ====

In case you observe the issues with the write permissions that disallow you from the extension installation, you can try to specify the alternative user with write permissions in 
**System → Configuration → Advanced → Unirgy Installer → FTP Settings**

{{ :unirgy:aa5b274f2d.png?nolink |}}


==== Base table or View not found ====
You may observe the SQL error
SQLSTATE[42S02]: Base table or view not found after the extension installation.

{{ :unirgy:f655cc584d.png?nolink |}}

These symptoms are most often due to Magento cache being enabled during the upload process. Unfortunately, this results in setup scripts not being run.
To fix this setup, scripts must be triggered. This can be done only by reinitializing the installation process with caches disabled.

1. Disable any Magento cache.

2. Login to your database.

3. Execute:

<code>
    DELETE from `core_resources` WHERE code LIKE 'usimple%';
</code>
4. Flush and enable caches.

This operation should fix this issue.