Installation and Upgrade (Linux)

SmarterStats requires a Windows server to be used for the main web interface, but if you use Enterprise Edition, you may install the Remote Service to allow processing of logs on Linux-based servers as well.

NOTE: These instructions are for Linux. For instructions on installing SmarterStats on Windows-based servers, refer to the help topic Installation (Windows)

SmarterStats comes as a single installation file that will automatically download and install the appropriate operating system components required to run the SmarterStats Remote Service on your server.

Jump to:

• Installing SmarterStats Remote Service on Linux
• Upgrading SmarterStats Remote Service
• Uninstalling SmarterStats Remote Service
• Manually Installing SmarterStats Remote Service
• Adding Your Remote Service to SmarterStats

Installing SmarterStats Remote Service on Linux

Run the following in bash command to download and run the SmarterStats installer, which will download and install the current build. Replace the XXXX with the build number you wish to install (a full list of versions is available on the SmarterStats Release Notes page):

This bash command will download and run the SmarterStats installer. This includes setting up all folders and directories needed to run SmarterStats. Therefore, it's just like any standard program installation.

Upgrading SmarterStats

To upgrade SmarterStats, first, backup your SmarterStats installation or take a snapshot of your VM.

Run the following in bash command to download and run the SmarterStats installer, which will download and upgrade the current SmarterStats build. Replacing the XXXX with the build number you wish to install. Yes, this is the same exact bash command that you use to install SmarterStats originally.

Uninstalling SmarterStats

To uninstall SmarterStats, run the following in bash command, in the folder where you downloaded the SmarterStats installer. If you do not have the installer still, you can download it again using the wget and chmod commands in the installation section above.

Manually Installing SmarterStats

To manually install SmarterStats — generally when automating the installation process or installing via scripts — do the following:

1. First, you want to download the installer:
   wget --timeout=6000 https://downloads.smartertools.com/smarterstats/100.0.XXXX/smarterstats_XXXX
2. Next, download the ZIP package, which contains all of the files necessary to install SmarterStats:
   wget --timeout=6000 https://downloads.smartertools.com/smarterstats/100.0.XXXX/smarterstats_XXXX.zip
3. Create a folder called "ss-install-data"
   mkdir ss-install-data
4. Then, you'll want to move and rename the ZIP file you downloaded to that new folder:
   mv smarterstats_XXXX.zip ss-install-data/ss.zip
5. Now you can run the installer:
   sudo ./smarterstats_XXXX install
6. The last step is cleaning up your downloads, otherwise the next upgrade may fail:
   sudo rm -rf ss-install-data
   rm -f smarterstats_*

That should do it. SmarterStats is installed and ready for any future upgrade/update.

Adding Your Remote Service to SmarterStats

Once the Remote Service is installed on your servers, you can begin adding the servers to the MRS. Do the following for each server:

1. Log in to SmarterStats as the System Administrator.
2. Click the Settings icon.
3. Expand the Servers menu, if it isn't already.
4. Click on Servers in the navigation pane. The default server the MRS is installed on should show up.
5. Click the New button

6. A pop-out window opens. Complete the following information:
• Server ID - This number auto-increments, but you are able to set it to whatever you like.
• Server IP - The IP address of the server the Remote Service is installed on.
• Server Name - A friendly name associated with the server. This can be the internal server name (e.g, Web01), the site(s) on the server (e.g., Lincoln Financial sites), etc.
7. Regarding Import Settings, if you want the stats to process on the servers independently -- for example, the server is in a geographically different location than the MRS -- the Import Settings can be configured on a server-by-server basis to account for these types of differences. Otherwise, they'll use the default settings.
8. Be sure to save your settings prior to closing the pop-out window.