BarnOwl has created an Updater tool, which enables you to quickly and easily upgrade your version of BarnOwl to the latest version. The BarnOwl Updater can be run on your BarnOwl Application server, and once the update has been completed, all user workstations will be updated when the user opens the BarnOwl application. Note that the user workstation must be on the network, and must be able to access the Application server.
There are 5 steps to running the BarnOwl Updater:
Before you begin, please note the following prerequisites:
Not all of the folders listed above may have been created during installation.
BarnOwl will send out a notification when a new version of BarnOwl is available. You can download the upgrade files from the BarnOwl Customer Hub Knowledge Base. For more information, see Downloading and Running the Updater.
Click the link which contains the Upgrade files.
If you are using the Server Update for the first time, you will need to configure your Master database, create environments, and specify database sets for those environments. This only needs to be done once.
For more information, see About the Master Database.
The first time you open the BarnOwl Updater, you will be prompted to specify a Master Database. After you have created and specified the BarnOwl Master database, you do not need to perform this step again. The BarnOwl Server Update will automatically connect to the master database you have specified.
To create a new Master Database:
If you select Windows authentication, your Windows credentials will be used, and the Login and Password fields are not enabled. If you are using Windows authentication, please ensure that you have the correct SQL permissions.
If you select SQL Server authentication, enter the Login name and password. In this example, we are using SQL Server Authentication.
BarnOwl will automatically create a new master database called BarnOwl_Master, on the selected SQL server. The files BarnOwl_Master.mdf and BarnOwl_Master_log.ldf will be created in the SQL server default locations for data and log files.
If you rename the master database (for example, BarnOwl_master_ABC) the Server Update will not detect it on the server.
The BarnOwl Server Update enables you to add and edit your database environments.
If you are running the BarnOwl Updater for the first time, you need to add and configure your Environments. If you have not yet created environments in the Server Update, the form will be blank, and you need to add new environments in the Environment form, accessed by clicking the
If you have already set up Environments, you can simply click the environment in the list.
After you click the
button (for a new environment) or select an existing environment, you need to specify the Environment Directories and configure Data Sets for the environment.
For detailed information on the Environment Directories, see Configuring Environment Directory Settings.
This form enables you to specify all the database information as well as the BarnOwl Web location and Warehouse ETL location. Click the
to open the Database Set form.
A database set consists of between one and three databases:
Each environment can contain more than one database set. For example, you can have an environment called Production for a database called ABC. Within that database, you can have different sets which are used by different users. Therefore, within your production database, you might have database sets called Production Testing, Production Documentation and Production Development. Each of these database sets can have a BarnOwl database, a Warehouse database and a Snapshot database, as required.
For detailed information, see Configuring Database Sets.
After you have specified and configured all your environment and database sets, you are ready to upgrade! For more detailed information, see Updating a BarnOwl Environment.
The Environment directories and databases must have the status Ready for Update.
button. A message is displayed requesting confirmation of the update, and displaying all the directories and databases which will be updated. A server log form is displayed.
If you experience a problem, contact BarnOwl Support.