2. Installing the xtConnect Extension Package

Having xTuple ERP installed and running is a prerequisite for installing xTuple Connect. Assuming this is the case, then you are ready to begin.

Note

Before you install the xtConnect package, you should first make a backup copy of your xTuple ERP database. This way you can always restore the backup copy should you encounter problems during the installation process.

Install the xTuple Connect extension package by using these steps: first step is to connect the Updater to your xTuple ERP database. The process for connecting is identical to the process used when logging in using your xTuple ERP client software.

  1. If you have just downloaded the Updater, extract it into the folder of your choice

  2. Start the Updater and click the OPTIONS button. You will see the following screen:

    Login to Updater
  3. Enter your server, database, and port information

  4. Click the SAVE button

  5. Log on with the username and password for your xTuple Administrator user, "admin" by default

  6. Select the File menu option

  7. Select the Open option, as shown in the following screen:

    Load Package into Updater

Once you locate the xtConnect package on your file system (e.g., xtconnect-3.5.0.gz), a short series of prerequisite checks will be performed. The following screen shows the results of a successful prerequisite check:

Update Manager and Package

If the prerequisite check was successful, simply select the START UPDATE button to complete installation. Depending on the quality of your network connection, this final step of the installation process should complete quickly. The following screen shows results for a successful install:

Updater Progress Information

Note

Contact your system administrator if you encounter errors or extreme slowness after selecting the START UPDATE button.

To verify the xtConnect extension package has been successfully installed, log into xTuple ERP. Navigate to the list of installed packages using the following path: System > Design > Packages. If the xtConnect extension package was installed correctly, the package should appear as shown in the following screen:

Package Installed in xTuple ERP