Configuring BarTender System Database Connection Methods
Overview
By default, the BarTender System Database is configured to use Windows Authentication, and the Windows user who runs the BarTender installer package is the one who gets authorization. If multiple users on the same machine are using BarTender, additional database permissions must be configured to prevent unexpected behavior such as app crashes and reprinting failures.
There are several ways to grant database permission to multiple users. Choosing one will depend on which BarTender features and apps are in use, as well as the IT policies of your organization. They will also require administrator access to implement, so you may need to contact your IT team for assistance with these procedures.
Here are three possible methods:
- Enable SQL Authentication and create a login. The advantage of this method is that it uses a single username and password, so any user with those login credentials can access the database. However, it may not be ideal for environments where individual user activity must be tracked.
- Continue using the default Windows Authentication and manually add permissions for users or groups. This allows automatic sign-in and activity logging of specific Windows users, but it requires a bit more expertise to set up and manage.
- Configure the BarTender System Service to run as an administrator account that has access to the System Database. This process is required for connecting to a remote System Database, and it can be a relatively easy shortcut for configuring a local one.
A fourth solution is also worth mentioning: you could bypass the issue entirely by skipping the installation of the BarTender System Database if it is not required in your environment. For more information about this option, please see the support article Do I have to install SQL Server Express for BarTender to work?
Applicable to
BarTender 2019 and later
Information
Click on a method to expand it and show the steps to implement.
Configuring SQL Authentication
Configuring Windows Authentication
- Log into Windows using the account with administrator access to the BarTender System Database.
- Download and install SQL Server Management Studio(SSMS) if you have not already done so.
- Open SSMS and connect to the database.
- In the Object Explorer panel to the left, expand the Security Folder for the BARTENDER instance (default name), then the Logins folder. This will show a list of the users and groups that are already configured. You should see the BUILTIN (local) groups for Administrators and Users, as well as some individual users.
- Identify which users or Groups should have access to the BarTender System Database. If you want to ensure that every user has the minimum necessary permissions, you might simply choose BUILTIN\Users, but you can also choose or add specific users.
- To add a user who is not listed, right-click on the Logins folder and select "New Login".
- For each of these entities, follow the steps below to configure their permissions.
Map user or group to the database
- Choose a user or Group that you wish to grant access to, right-click on it, and select Properties.
- Select User Mapping in the left panel, then check the Map box on the right for the BarTender Database. Click OK to add the user or Group to that database's user list.
- Repeat this process for each entity that will be using the database.
Grant permissions
- Back in Object Explorer, locate the BarTender System Database in the Databases folder, right-click it, and select Properties.
- Select Permissions in the list to the left, then select the user or Group in the list on the right.
- In the Explicit Permissions list in the lower right, check the boxes to Grant the following minimum permissions:
- Connect
- Delete
- Execute
- Insert
- Select
- Update
- Select the next user from the list and check the boxes to grant permissions in the same manner. When all users have been configured, click OK to save your changes.
Restart
Once all the necessary changes have been made, the following processes must be restarted to ensure that the changes take effect:
- The SQL Server instance. In SSMS > Object Explorer, right-click on the BarTender instance name (at the top of the tree) and select Restart, then confirm the security prompts.
- The BarTender System Service. Open the Services app in Windows and locate BarTender System Service on the list. Right-click it, and select Restart. This will restart a few other BarTender services as well, so it will take a few seconds for everything to restart.
If working on a non-server computer, you could also simply reboot it to accomplish this step.
Test the connection
Log on to Windows as a standard user.
If this user does not have access to Administration Console, or if the configuration process was done as a troubleshooting step, then a simple test would be to open a label file in BarTender Designer. Does it open as expected without freezing or crashing?
If this user does have access to Administration Console, they can test the database connection with the System Database Wizard, as follows:
- Open the Administration Console app, then click the System Database option on the list to the left.
- From the right panel, open the System Database Wizard.
- When the dialog opens, click Next, then select Customize connection settings and click Next.
- For the Select Database Server section, click Next without changing any server or authentication settings.
- If the wizard proceeds to the Select BarTender System Database screen, without any connection errors or messages regarding permissions, you're good to go!
If there is an error, please take a screenshot or note the exact message for further troubleshooting.
Setting an Account on the BarTender System Service
What permissions should the account have?
It is generally recommended that the Windows account used to run the BarTender System Service has the following attributes:
- local administrator rights
- domain-level access
- does not change its password
- access to the system database (if connecting to the system database using Windows Authentication)
Instructions
- While logged into Windows as an administrator, open the Services app.
- Locate the BarTender System Service, right-click on it, and select Properties.
- In the Log On tab, select This account, then enter the credentials. (Use Browse if you're not sure of the correct syntax.) Click OK.
- Now right-click on the BarTender System Service (BSS) and Restart it so it will use those credentials. This will also restart the Integration Service and Print Scheduler, so there may be a brief interruption in automated printing.
- If the services restart as expected, test the database connection by running the System Database Wizard from Administration Console (see step 5).
- If BSS takes an unusually long time to start, or fails to start entirely with an error 1053, this is often a sign that something is wrong with the user credentials. Either the password is incorrect, or they don't have the necessary permissions (local administrator with domain access). Verify the permissions for the user account, re-enter the credentials in the BSS Properties, and try to Start it again.
- Open the Administration Console app, select System Database on the list to the left, and open the System Database Wizard. Click Next.
- Continue through the wizard:
- Select Customize connection settings.
- Make sure the correct server name and authentication method is selected.
- Select Use an Existing BarTender System Database and make sure the correct one is selected (the default is Datastore).
- Click Setup to connect
- If the Setup process ends without error message, you're good to go!
- If you get an error message, please take a screenshot or note the exact error message for further troubleshooting.
Enable SQL authentication in the database
Create a new user login for the database
Connect to the system database with the user credentials
If, instead of completed successfully, you see an error message, please take a screenshot or write down the exact error message, then contact Technical Support for further troubleshooting.