Login/Register

Advanced Usage FAQ

How do I install Installatron Plugin?

Download and install Installatron Plugin

How do I install Installatron Server?

Continue to the What is Installatron Server? page.

How do I upgrade/update Installatron Plugin or Installatron Server?

Installatron automatically adds a Crontab or Windows Task Scheduler process to upgrade/update once per day.

To force an upgrade/update, click run Installatron update now in Administration, or follow the steps on the upgrade page.

How do I uninstall Installatron Plugin?

Continue to the How to: Uninstall/remove Installatron Plugin page.

How do I restore an Installatron Plugin or Installatron Server backup to a different location?

To edit a backup so that it can be restored to a different location or web hosting account:

That's it! It should now be possible to restore the backup through the Installatron GUI.

If problems are experienced with the restored application, use phpMyAdmin to search the database for the old install URL. A few applications keep the install URL in their database and this will need to be updated (for example, Magento has a variable named "web/secure/base_url" in the "core_config_data" table).

If there are any questions open a ticket.

How do I translate Installatron products?

The Installatron Locale Translator tool allows anyone to translate lines, and can also be used to generate locale customizations for your server.

How do I add applications to Installatron?

The Installatron Application Packaging SDK allows anyone create and maintain applications.

How do I mirror an Installatron Plugin or Installatron Server configuration between multiple servers?

To help streamline the management of individual Installatron Plugin or Installatron Server instances on a large number of servers it's possible to simply mirror these files between servers using rsync or a product like Puppet:

/usr/local/installatron/etc/settings.ini
/root/.appdata/.settings
/home/admin/.appdata/.settings
/var/installatron/data/admin/.settings
/var/installatron/data/root/.settings

To mirror secondary groups, also include these files:

/root/.appdata/.groups
/home/admin/.appdata/.groups
/var/installatron/data/admin/.groups
/var/installatron/data/root/.groups
/root/.appdata/*.settings
/home/admin/.appdata/*.settings
/var/installatron/data/admin/*.settings
/var/installatron/data/root/*.settings

Note that depending on the control panel software used some of these files may not exist. Only mirror files that exist.

How do I make the Installatron platform work with my own control panel?

Installatron Server enables any web hosting control panel or user interface to incorporate Installatron.

How do I transfer Installatron Plugin to another server?

To transfer Installatron Plugin to another server and retain all existing installed applications, backups, and administrative settings:

To reinstate administrative settings: After Installatron Plugin is installed on the new server, copy these files from the old server to the new server. Note that depending on the control panel software used some of these files may not exist.

/usr/local/installatron/etc/settings.ini
/root/.appdata/.settings
/root/.appdata/*.settings
/home/admin/.appdata/.settings
/home/admin/.appdata/*.settings
/var/installatron/data/admin/.settings
/var/installatron/data/admin/*.settings

How do I change the IP on my Installatron Plugin license?

Login to your account page and save a new IP value for your license.

How do I forcibly enable Automatic Update for all installed applications?

Automatic Update will automatically create a backup and update installed applications immediately as new versions become available. In the event the update fails, Installatron will automatically restore the created backup.

Automatic Update can be forcibly enabled for every installed application on a server by executing this command from the SSH root command prompt:

/usr/local/installatron/installatron --edit --id='*' --autoup=2

Alternatively, to limit Automatic Update to minor versions and security releases, use this command instead:

/usr/local/installatron/installatron --edit --id='*' --autoup=1

How do I renew a monthly or annual Installatron Plugin license before it expires?

Log into your account and click the renew link for the license you wish to renew. This will create an invoice, email you the details, and take you to the payment page.

Licenses renewed before expiration have the renewal added to the existing expiration. There is no waste when renewing early.

How do I install web applications using the command line?

How do I install web applications using an API?

Installatron is able to install and upgrade applications from both a command line interface and HTTP-API. This can be used to pre-populate new hosting accounts with software. Continue to the Automation Guide for more information and usage examples.

How do I create an Installatron Fast Update server?

Installatron Fast Update enables providers to deploy a local Installatron data mirror, enabling Installatron to be installed and updated through the local network instead of through the traditional Internet. In the event a Fast Update server is offline, out of sync, or missing a file, servers will automatically fallback to updating through the Internet. Fast Update saves bandwidth, increases update speed, and is fully redundant. To deploy an Installatron Fast Update server please follow the below instructions.

Two configuration modes are available for Installatron Fast Update: 'mini' which includes the latest files and other files updated within the past year and 'full' which includes all files. A 'mini' Fast Update server currently requires around 10GB disk space and grows at approximately 50MB per month. A 'full' Fast Update server currently requires around 20GB disk space and grows at approximately 400MB per month.

To setup Installatron Fast Update: provision a small server or VPS with CentOS 6 (or newer) and 128MB dedicated memory (or more depending on the number of servers using the data mirror). The recommended disk quota is 30GB for 'mini' mode and 100GB for 'full' mode to allow for growth without continually upping the quota. This server can be configured to only accept incoming connections from within your network. Note that in general Fast Update servers are extremely lightweight; if only a couple hundred servers will be using the Fast Update server, it's feasible to use an account on an existing shared hosting server instead of a dedicated server/VPS.

Once the bare server is provisioned, no control panel software must be installed, however using control panel software may save some management time in the long run. To set up a Fast Update server without a control panel, execute the below command from the server's SSH root command prompt. Skip this section if a control panel will be used instead.

yum install httpd php php-gd

Finally, add the below cronjob to sync Installatron data every hour. If a control panel or shared hosting account was chosen, the cronjob's reference to the /var/www/html directory should be modified to point to the home directory of the control panel account created for Fast Update.

For 'mini' mode:

12 * * * * rsync -rlptDvzW --delete data1.installatron.com::mini/ /var/www/html

For 'full' mode:

12 * * * * rsync -rlptDvzW --delete data1.installatron.com::full/ /var/www/html

Now that the Fast Update server is activated, to configure existing servers to use the server as their primary data source execute this command from the SSH root command prompt on each server:

echo "mirror=installatron.company.com" >> /usr/local/installatron/etc/settings.ini

To provision new servers, execute this command from the SSH root command prompt (replacing controlpanel with the type of control panel):

FASTUPDATE=installatron.company.com rpm -Uvh http://installatron.company.com/installatron-plugin-controlpanel.latest.noarch.rpm

Want a fully-managed Fast Update server?
We provide full management services for Installatron Fast Update servers under certain circumstances. Please contact us for further information.

How do I re-apply installed application branding after changing it?

Executing the below command from the command prompt will reapply installed application branding. Depending on the number of installed applications this command may take some time to complete.

/usr/local/installatron/installatron --rebrand-installs

How do I add an Installatron.com-styled The Apps page to my website?

How do I use the Installatron List Builder?

The Installatron List Builder tool enables a list of applications to be generated. The resulting files (one for each Installatron ACL) can be incorporated into a website.

To display a dynamic page similar to Installatron.com's The Apps page, a flat file database will need to be created using this code:

And then the below PHP code can be pasted into a website PHP file. Make sure to at minimum modify the LB_PATH constant to point to the correct list builder directory.

http://installatron.com/docs.listbuilder.appbrowser.phps

How do I change the affiliate ID displayed on the WHMCS install screen?

To change the affiliate ID from the default value, navigate to Installatron Admin >> Interface >> Locale and enter the below line into the Locale Customizations textbox, replacing "2222" with the desired affiliate ID:

_installer_whmcs_licensekeytext_aid=2222
© 2004 - 2014 Installatron LLC. All rights reserved.