TradeX Installation


If you are moving your installation to a new server or to a new domain on the same server, please follow the instructions in the Moving Your Installation portion of this manual.

Unless otherwise noted, you are licensed to install the software on a single domain. If you would like to install the software on more than one domain, you will need to purchase additional licenses or the unlimited domain license. Additional licenses may be purchased though the My Account interface at a discounted rate. Contact me if you would like to upgrade to the unlimited domain license.


Help Prevent Software Piracy

If you have uploaded the TradeX zip (or tar.gz) file to your server, remove it now. Leaving it on your server provides a chance for other users to steal it from your web space. Make sure you never leave a copy of the software archive where other people can access it.

Never share your software with anyone. The license you purchased is for your use only. You may not give or sell the software to anyone under any circumstances. Never share your owners lounge username or password with anyone. Again, that is for your use only. I will never ask for you to send your password, so if you ever get an e-mail requesting it you should not send it.

If you ever find a site that is offering this software for download, please contact me immediately so I can have the site shut down. Every time the software is pirated instead of purchased, it means fewer resources for me to continue the development of this and future software.
Automated Installation
The automated installation will only work on servers where PHP is running with safe_mode disabled. If PHP is running in safe_mode on your server, use the Manual Installation instructions below.

The easiest way to get TradeX installed is to use the automated installation script. To complete the installation do the following:
  1. When downloading TradeX from the JMB Software My Account interface, select the Automatic Installation option. You will then download an archive that contains the auto-installer.php script.

  2. Select a directory of your site where you would like to install TradeX. The software should be installed in an empty sub-directory of your site and not in the base directory of your site or a directory that already contains other files. For the remainder of the installation process, it is assumed that you have selected a directory named tx for your TradeX installation.

  3. Upload only the auto-install.php file from the TradeX software distribution to the tx directory of your website.

  4. Change the permissions on the tx directory to 777.

  5. Access the auto-install.php file through your web browser. If using the recommended directory name of tx, the URL to the auto-install.php file would be:
    http://www.yoursite.com/tx/auto-install.php

  6. The installation script will perform a few tests and display the results for you. If all of the tests are successful, there will be a button labeled Install TradeX. Click on that button to continue the installation process.

  7. The installer will now grab the installer file from jmbsoft.com and create the necessary directories and extract the software files. When it is complete, you will get a message indicating that the software files have been installed on your server.

  8. Before you can access the TradeX control panel, you must delete the auto-install.php file from your server.

  9. The installation confirmation page will also provide you with a link to the TradeX control panel along with the username and password that have been setup. The password is randomly generated for each TradeX installation, so you should write it down for safe keeping.

  10. After writing down the username and password, click the link to access the TradeX control panel. You will then need to enter that username and password to gain access.

  11. The first time you login, and until you save the software settings, the Global Settings dialog will appear. All of the settings will be filled in with default values, however you can change them to whatever values you would like to use. After you have made the changes (or even if you don't make changes at all) save your settings.

  12. Change the permissions on the tx directory to 755.
The installation process is now complete! Continue on to the First Steps After Installation for details on items you will want to complete before going live with your site.
Manual Installation
Manual installation of TradeX requires a bit more work, but it still pretty straightforward. Use the following steps to complete a manual installation:
  1. Select a directory of your site where you would like to install TradeX. The software should be installed in an empty sub-directory of your site and not in the base directory of your site or a directory that already contains other files. For the remainder of the installation process, it is assumed that you have selected a directory named tx for your TradeX installation.

  2. Upload all of the files and directories from the TradeX software distribution, with the exception of the following:

    • The utilities directory and it's files

  3. Set permissions on the files and directories that you uploaded. If you are not sure how to set permissions, consult the documentation for your FTP client and/or contact your server administrator for more information. Below is a table containing the recommended permissions you will need to set on each directory or file. If you do not see a file or directory listed, it means you do not need to change the permissions on that file or directory

      File or Directory Permissions
      data directory 777
      logs directory 777
      All files in data directory 1 666
      All sub-directories of the data directory 2 777
      All files in templates directory 666
      templates/_compiled directory 777
      in.php file 666
      out.php file 666
      image.php file 666
      lib/config.php file 666

    1 This includes all files in the data directory itself, and all files in all sub-directories and their descendant directories.
    2 This includes all sub-directories, their descendant sub-directories and so on.

    These are only the recommended file permissions, and may need to be altered depending on your server configuration. For example, on servers using suPHP you will want to use 755 permissions in place of 777 and 644 permissions in place of 666.

  4. From the utilities directory of the TradeX software distribution upload the reset-access.php script to the cp directory of your TradeX installation.

  5. In your web browser, bring up the reset-access.php script. If using the recommended directory name of tx, the URL to the reset-access.php file would be:
    http://www.yoursite.com/tx/cp/reset-access.php

  6. The reset-access.php script will generate a username and password for the TradeX control panel. Before you can access the control panel, delete the reset-access.php script from your server. Be sure to write down the username and password before you click on the link to access the TradeX control panel.

  7. After writing down the username and password, click the link to access the TradeX control panel. You will then need to enter that username and password to gain access.

  8. The first time you login, and until you save the software settings, the Global Settings dialog will appear. All of the settings will be filled in with default values, however you can change them to whatever values you would like to use. After you have made the changes (or even if you don't make changes at all) save your settings.
The installation process is now complete! Continue on to the First Steps After Installation for details on items you will want to complete before going live with your site.