Networking & Installation

Introduction

The installation of Lightspeed OnSite is a fast and simple procedure, outlined here. Prior to installation, though, you must make sure your network and hardware meet the requirements to install Lightspeed OnSite and Lightspeed OnSite Server.

You must be logged into OS X as an Administrator to install Lightspeed OnSite.

Your initial installation is comprised of the Lightspeed OnSite Server, where your data resides, and the Lightspeed OnSite Client, the application that accesses that data. After installation, both the Lightspeed OnSite Client and Lightspeed OnSite Server will be installed. If you wish to access Lightspeed OnSite Server from other computers, you only need to copy the Lightspeed OnSite Client application to the Applications folder of the other computer(s).

Network Preparation

  1. Your server must be on a network. Wired 100/1000 connection is recommended.
  2. The server should have a static IP on the local network. Please contact your network administrator if you are unsure.

Lightspeed OnSite Server and Client Requirements

For a list of minimum and recommended system requirements, see our Troubleshooting article.

Configuring A Firewall To Allow Access To Lightspeed OnSite

Firewalls help prevent unauthorized access to computer resources, but generally require configuration in order to allow access to desire applications. A firewall that is turned on but not configured to allow Lightspeed OnSite clients to connect will prevent users from logging in successfully.

To access Lightspeed OnSite through a firewall, it is necessary to configure the firewall for the installed version of Lightspeed OnSite on the server computer. Lightspeed OnSite is compatible with the firewall included with Mac OS X Server as well as most third-party firewalls, however the firewall that ships with the regular client version of Mac OS X is not compatible as it does not allow for manual configuration of allowed connections.

Lightspeed OnSite 3.0 and above

To enable connections to Lightspeed OnSite Server, included in Lightspeed OnSite 3.0 and above, the firewall must be configured to allow connections on the TCP port being utilized by their Lightspeed OnSite installation. This port is 9630 by default, but should be confirmed before the configuration process by completing the following steps on the computer running Lightspeed OnSite Server:

  1. Under the Apple menu, open your System Preferences, and click Lightspeed OnSite Server.
  2. Select the licensed Lightspeed OnSite Server installation from the list on the left side of the window, and note the number shown for the Port value on the right side of the window.

This will provide the TCP port that must be configured to allow incoming connections for Lightspeed OnSite clients.

Lightspeed OnSite 2.9.2 and below

To enable connections to Lightspeed OnSite 2.9.2 and below through a firewall, the firewall must be configured to allow connections from TCP ports 20221-20230. This allows Lightspeed OnSite clients to connect to the OpenBase database that powers these versions of Lightspeed OnSite.

For further information regarding firewalls and their configuration, Lightspeed recommends that customers seek assistance from network specialists. Payment Card Industry Data Security Standards (PCI-DSS) requirements prevent Lightspeed from providing assistance or advice regarding networking or firewall configurations.

Installation

To install the Lightspeed OnSite Server and Client:

  1. Download the Lightspeed installer here.
  2. Double-click the downloaded .dmg file to open the Lightspeed OnSite installer.
  3. Drag the Lightspeed OnSite Client to your computer’s Applications folder.
  4. Double-click Install Lightspeed Server, and follow the onscreen instructions to complete the server installation.
    Note: During the install process, you’ll be asked whether you want to install the demo or licensed version. Choose to install a licensed version, and enter your Lightspeed OnSite license key when prompted. If you’re upgrading from Lightspeed OnSite 2.x, this option will instead be "Migrate Database".
  5. Once installation in complete, launch Lightspeed OnSite by clicking the Lightspeed OnSite Client (Lightspeed) from the Applications folder.
  6. When the login screen appears, enter your username and password, and then click Connect. By default, the username is "lightspeed", and the password id "admin".

Additional Client Computers

Copy the Lightspeed OnSite Client to any client computers that will be accessing the server. Do not run the installer on client-only computers. Launch Lightspeed OnSite, click Servers, and then click Bonjour. Your client will detect the Lightspeed OnSite database on your network. Select the licensed database, enter the username and password, and then click Connect. If you wish to connect to your Lightspeed OnSite server using a direct IP, please see below for instructions.

Optimizing Performance

When installing the Lightspeed OnSite Server, the installer automatically configures your computer to ensure optimal performance with Lightspeed OnSite. To verify if your server computer is optimized for Lightspeed OnSite, or to re-optimize your computer after making changes to your system:

  1. In the Apple menu, click System Preferences.
  2. Click Lightspeed Server.
  3. If required, unlock the Lightspeed Server preferences by clicking the Lock icon, and then entering your system username and password.
  4. Click Advanced. The optimization window appears.
  5. If your computer is not optimized for use with Lightspeed OnSite, click Reset Configuration.

Lightspeed OnSite Server

As a multi-user, multi-store application, Lightspeed OnSite requires some minor configuration of your network settings, both in OS X, and in the Lightspeed OnSite Server System Preference.  Running Lightspeed OnSite on a central server is a simple process, but you should make sure that the hardware meets the system requirements before proceeding with your installation.

After Installation

  1. Under the Apple menu, open System Preferences, and then click Lightspeed Server.
  2. Select the database and note the port listed to the left.  You should see all the licensing details for the add-ons you have enabled, including Multi-Store and Web Store (eCommerce).
  3. To allow client computers to access the Lightspeed OnSite server on your LAN, your network administrator must open this port on your router.
  4. You are now ready to begin using Lightspeed OnSite. Please see the Getting Started section for more info, including login.