Installation

Overview

ReportWORQ runs as a standalone web application that users access through a Chromium-based web browser such as Google Chrome or Microsoft Edge. This article contains all the information you need to install ReportWORQ and get it up and running. It includes system requirements, software download and installation, and initial configuration. Steps for uninstalling ReportWORQ are also provided.

After you finish installing and configuring ReportWORQ, please see the Quick Start Guide for a walk-through of how to create and run ReportWORQ report distribution jobs.

Note: This article describes how to perform a full installation of ReportWORQ 5. If ReportWORQ 5 is already installed and you simply want to update it, you can update to the latest version from within ReportWORQ.

System Requirements

Recommended minimum system requirements to run ReportWORQ are as follows:

• Operating System:

  • Microsoft Windows Desktop: 8, 10, 11 or Microsoft Windows Server: 2012, 2012 R2, 2016, 2019, 2022. Confirm that the latest critical Windows updates have been applied before installing ReportWORQ.

• Processors:

  • 4 core 2 GHz or faster x64-bit processors.

• Memory:

  • 32 GB of installed RAM is recommended. 16 GB is acceptable for light use. More memory may be needed if you plan to work with large Excel reports.

• Disk Space:

  • 10 GB of free disk space. ReportWORQ uses disk space for its application files, settings repository, log files, and any temporary file storage needed while creating job output content such as PDF and Excel files.

• Display:

  • 1280x720 or higher screen resolution is strongly recommended.

• Firewall (optional):

  • If a firewall is active, open port 8300 to allow users to access ReportWORQ via a local web browser.

• SSL (optional):

  • Optionally, the ReportWORQ server can be configured to operate under SSL if a certificate is provided.

• Web Browser:

  • A Chromium-based web browser such as Google Chrome or Microsoft Edge.

• Optional Software:

  • Microsoft Excel

  • Adobe Acrobat Reader, or equivalent PDF reader

Architecture Diagram

Select the image to expand.

Download ReportWORQ

Select a link below to download the latest ReportWORQ installation package.

Please select ReportWORQ 5.0 Official Release unless instructed otherwise. Preview releases include the very latest changes to the product, but only official releases are fully regression-tested.

Install ReportWORQ

Local administrative privileges are required to install the ReportWORQ application.

The installation process copies required files locally and then registers and starts an instance of the ReportWORQ Bootstrap Service, which hosts the ReportWORQ web application.

Before you begin, ensure that your computer meets the minimum system requirements.

To install the ReportWORQ application:

1. In the Downloads folder, open the ReportWORQ_Installer.exe file. If a message appears, asking whether to allow the ReportWORQ app to make changes to your device, select Yes.
   The ReportWORQ Setup Wizard appears.
   
   
   

2. Select Next.
   The End-User License Agreement appears.
   
   
   

3. Read the End-User License Agreement.
   If you accept all the terms, select I accept the terms in the License Agreement and then select Next.
   Note: You cannot install ReportWORQ without accepting the terms in the license agreement.
   The Select Installation Folder page appears.
   
   
   

4. Specify an installation folder and then select Next.
   You can accept the default installation folder (C:\Program Files\ReportWORQ) or Browse to select a different one.

   When the Ready to Install page appears, select Install.

   When installation is complete, select Finish to exit the wizard.

Initial Configuration

This section contains steps for the following tasks:

• Test Connectivity and Set Up an Administrative Account

• Review Service Settings

• Activate ReportWORQ License

• Review Application Settings

Test Connectivity and Set Up an Administrative Account

The first time you connect to ReportWORQ, a configuration wizard prompts you to enter your license key and set up an administrative account.

To test connectivity and set up an administrative account:

1. In a supported web browser, test that you can connect to the ReportWORQ web server locally by navigating to http://localhost:8300 .
   If the test is successful, the ReportWORQ configuration wizard appears.
   
   
   

2. Select Get Started. The license page appears.
   
   

   
   

3. Do one of the following:

   1. If you have a ReportWORQ license and want to activate it now, enter the license key and select Activate. After the license is activated, select Next.

   2. If you want to activate your ReportWORQ license later, select Skip.
      The administrator setup page appears.
      
      
      

4. Provide an existing email address for an administrator account, and then select Next.

   The congratulations page appears.
   
   
   

5. Select Login. The login page appears.
   
   
   

6. In the User Name box, type the administrator email address you provided in Step 4, and then select Login.
   Do not type a password at this time. After you click Login, you will be prompted to create a password.
   The password reset page appears.
   
   

   
   

7. Type the same password in both Password boxes and then select Update Password.
   The password must contain at least six characters and include upper case, lower case, numeric, and non-numeric characters.
   IMPORTANT: Remember the User Name and Password for future logins.
   The ReportWORQ login page appears, pre-populated with the User Name and Password you created.
   
   
   

8. Select Login.
   ReportWORQ opens.
   
   
   

9. From a different computer on the network, test that you can connect to ReportWORQ remotely by opening a supported web browser and navigating to http://<ReportWORQ-machine-name>:8300, where <ReportWORQ-machine-name> is the name of the computer hosting ReportWORQ.
   Typically, remote access to ReportWORQ is initially blocked by a firewall application. A firewall exception rule to allow traffic from other computers through the ReportWORQ server’s configured TCP port may be required. ReportWORQ’s default TCP port is 8300. The port number can be changed later by a ReportWORQ administrator.
   Tip: If you are reinstalling ReportWORQ and the previous installation used SSL and/or a different port number, the URLs required for web access must be adjusted accordingly.
   If the test is successful, the ReportWORQ login page appears. Return to the ReportWORQ computer for the next procedure.

Review Service Settings

Review the properties of the ReportWORQ Bootstrap Service and configure a service account logon if needed.

Steps:

1. Using the Windows Search bar, find and open Services.
   
   
   

2. Right-click ReportWORQ Bootstrap Service and select Properties.
   The Properties window appears.
   
   
   

3. Review the properties on each tab and modify if necessary:

   • General - By default, the service is set to start automatically each time the computer reboots.

   • Log On - If the ReportWORQ server will need to read from or write to network locations, select This account and specify the domain account that the ReportWORQ instance can log on as upon startup. When you Apply the change or select OK, Windows automatically grants the account Logon as a Service permission.
     
     
     Regardless of whether the log on account is the local system account or a different account, it requires the following permissions at a minimum:

     • Logon as a Service permission.

     • Read/write permissions to the root folder where ReportWORQ is installed (default is C:\Program Files\ReportWORQ\).

     • Read/write permissions to the configured Repository folder if it is located outside of the root installation folder.

     • Read/write permissions to any report output destinations that will be defined in ReportWORQ Jobs.

     • Read permissions to any source report provider locations.

ReportWORQ licenses can be activated automatically or manually. If the computer is on an isolated network that does not have Internet access, manual activation is required. The steps in this section describe both automatic and manual activation.

IMPORTANT: ReportWORQ must be used in accordance with the license agreement that you agreed to upon installation, and only by users who are covered by that license agreement. Please consult that licensing agreement and contact us at support@reportworq.com if you have any technical or sales-related questions.

To activate a ReportWORQ license:

1. In the lower right corner of ReportWORQ, select the ReportWORQ requires a license message.
   The Edit ReportWORQ License pane appears.
   
   
   

2. Provide your ReportWORQ license key and select Activate.
   If the activation is successful, skip the remaining steps in this procedure.
   If the activation fails or the computer is on an isolated network that does not have Internet access, manual activation is required. Manual activation requires use of a different computer that has Internet access.

3. Click Copy Code. The request code is copied to the clipboard.

4. Do one of the following:

   1. If you have Internet access, select License Portal.

   2. If you do not have Internet access, send the code to a different computer that has Internet access, and on that computer open a web browser and navigate to https://software.quebit.com/quelock/downloads.html .
      The QueBIT Software Access Catalog logon page appears.
      
      
      

5. Select manual activation.
   The Activation Request Code page appears.
   
   
   

6. Paste the code into the Activation Request Code box, and select Activate.
   The Activation Response Code page appears.
   
   
   

7. Select Copy to Clipboard.

8. If you obtained the code on a different computer, send the code to the ReportWORQ computer and then copy it to that computer’s clipboard.

9. Select Paste Code. The license is activated.

Review Application Settings

To access the application settings, select the Administration (gear) icon in the top right corner of ReportWORQ.

Settings for specifying the Web Server Port and SSL Certificate (optional) determine how users access ReportWORQ from their web browser and should be reviewed after initial installation. These and other settings are described in further detail in the Application Settings topic.

Uninstalling ReportWORQ

After you uninstall ReportWORQ, some files remain in the installation location. If you intend to reinstall ReportWORQ or migrate ReportWORQ to a different computer, do not delete these files.

If you do not plan to reinstall ReportWORQ on this computer, record and release the license key so you can activate ReportWORQ on a different computer later.

To uninstall ReportWORQ:

1. In the Windows Search box, start to type uninstall, and then when Add or remove programs appears as a match, select it.
   
   
   

2. In the list of Installed apps, find ReportWORQ, select its ellipsis , and then select Uninstall.
   
   
   

3. Select Uninstall again.
   
   
   

4. If a message appears, asking whether to allow the ReportWORQ app to make changes to your device, select Yes.
   ReportWORQ is uninstalled. This may take a moment.