Jet Reports Homepage |  Community Forum |  Downloads |  Submit A Ticket |  Jet Express Support
Feedback

Installing the Jet 2015 Service Tier


Overview

This article describes how to install the Jet Configuration Service for use with Jet Essentials 2015 and Jet Mobile 15.

For Jet Essentials 2015 Update 1 or Jet Mobile 2015 Update 1, please see the article on Installing the Jet 2015 Update 1 Service Tier .

For Jet Professional and the Jet Web Portal, please see the article on Installing the Jet Service Tier.

 

With the Jet Configuration Service, company administrators can configure Jet data source properties for all their users in a single location. Administrators can define data sources and give users access to these data sources using the Jet Administration console.  When new Jet users are deployed, they just need to point to the location of the Jet Configuration Service to gain access all of their data source connections.

This also makes it easier to share reports as organizations can ensure that a data source has a consistent name, and does not vary from user to user.

 

 

 

Prerequisites

Users must be on Jet Essentials 2015 or higher

  • If you are using Centralized Settings with Jet Essentials 2012 R2 or an earlier version, you will need to upgrade your Centralized Settings database using the Jet Configuration installation for Jet Essentials 2013 before your users upgrade to Jet Essentials 2015 . The prior Centralized Settings database is not compatible with Jet Essentials 2015 . See the section Upgrading from Centralized Settings (below) for details.
    • If you are using the Jet Essentials 2013 Configuration Service, your settings database will be upgraded for use with Jet Essentials 2015 .  Users of Jet Essentials 2013 will *NOT* be able to access the settings in this database.
  • The person installing the Jet Configuration Service must have admin rights on the Microsoft SQL server

 

Installation Process

The Jet Configuration Service includes three components:

  • The Service Database resides on a SQL server instance and stores information about data source connection properties and scopes, users, and user permissions.
  • The Jet Service Tier enables communication between the clients and the Service Database. This communication is encrypted as a security measure.
  • The Jet Administration Console – a graphical user interface that makes it easy for administrators to manage the information in the Service Database.

The link to the Jet Setup file is included in the zip file when you download Jet Essentials 2015

Note: As of July 2014, the Jet Setup file cannot install the Service Database on an Azure server.  To install this database on a server that is on Azure please refer to the “JCS Azure configuration” folder in the product download.


 

Installing the Jet Service Tier, Service Database, and Jet Administration Console


After downloading and extracting the contents of "Jet Setup.zip", run "Jet Setup.exe", select “All Components”, and click Next


 

Select "Jet Administration Console" and "Jet Service Tier" (only... deselect the other options).

Click Next
When asked how you intend to use the Jet Service Tier, select "Jet Configuration Service only".

Click Next
Select the “Run As account" which will run the Jet Service Tier.

It is strongly recommended that you run the Service Tier under the "Network Service" account.  The Network Service account is a predefined local account used by the service control manager.  It has minimum privileges on the local computer and acts as the computer on the network.  ( More information )


If you elect to use a different account, if the account has a password, you will want ensure that it does not change regularly (as the Jet Service Tier will have to be uninstalled and reinstalled each time).

 

We recommend that you use the default service port of 7090 as this matches the default port that is defined in the Jet Application Settings and will make it easy for users to connect to the service.

 

Click Next

Enter the name of the SQL Server Instance and provide a name for the Service Database.

Select either to log in to the database using the "Run As" account, specified on the previous screen, or provide the username and password for a different database user.

This is the account that the Jet Service Tier will use to login to the Service Database, and as such must have access to the Microsoft SQL Server.

 

 

Click Next.

 

Note: if the specified database was previously used with Jet Essentials 2013 , the database will need to be updated for use with Jet Essentials 2015 .  After updating, the database will not be accessible from Jet Essentials 2013.

The setup is now ready to make the changes to your system.

Click the Install button to proceed.

Select "Yes" when prompted to allow the program to make changes to your computer.

If you did not use Centralized Settings with an older version of Jet Essentials, then your installation process is complete.

You can now use the Jet Administration Console to manage your data sources.

  



 

Upgrading from Centralized Settings

If you are using Centralized Settings with a versions of Jet Essentials prior to Jet Essentials 2013, you will need to update your Centralized Settings database using the "Jet Configuration Setup.exe" included with Jet Essentials 2013.

We recommend that you back up your existing database using SQL Server Management Studio prior to this upgrade.

Select "Upgrade Settings"


You will see a message recommending that you backup your existing database.  Please do so if you haven’t already.

 

Select "Yes"

Enter the name of the server and database where your existing centralized settings are located (those used with Jet Essentials 2012 R2 or earlier).

Select "Windows" or "Database" Authentication

Select "Next"

Confirm the settings for your new Service Database and select "Upgrade settings"



The data source configurations from your old database will be transferred to the new database. The old database will not be changed.



Once the upgrade is complete, you will be able to use the Jet Administration Console to view and manage your data source settings and and permissions

 



 

Modifying Service Configuration after Installation

 In some cases you may want to change how the Jet Configuration Service connects to the Service Database.  This requires stopping the Jet Configuration Service, and restarting it with new command line arguments.

Command Line Arguments

The following command line arguments should be given when starting the service in order for it to connect to the database:

/server <database-server> /port <service-port> /database <database-name> [/user <user-name> /password <password>]

 

Notes:

The port provided is the port used by the configuration service, not the port used to connect to the database.

If the user and password are omitted, Windows Authentication is used to connect to the database

  


 

Modifying the “Run as” Service Account

When installing the Jet Service Tier, the service account specified needs to have write access to the 'Jet Configuration Service' folder in the 'Program Files' directory. This permission is given by the Jet Configuration Service installer unless the user account that runs services has been changed from the default. In this case, the permission will need to be given explicitly.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments