Install Hubble Desktop

Process Overview

The installation process involves connecting to the Object Repository, installation of the software, configuration of the application and deployment. The database connectivity layer is built into the application and is set up during the configuration stage of the process.

Object Repository - The Object Repository contains the application’s configuration information, objects such as hierarchies, Reusable Inquiry Objects and user-specific information. Report parameters are stored in the repository, but not the report results themselves.

The repository is hosted on a supported database platform. The application uses the repository to perform critical processes such as user verification and validation of permissions. The application has a built-in database layer that will allow access from the application to the database.

Installation and Configuration - The software is installed via a Windows Installer Component (msi file). Once the software is installed, the application needs to be configured and users set up via Administrator.

Software Installation

The insightsoftware Professional Services Department provides the installation file for the version you are installing. Save this file to the machine where you will install the software. This section guides you through the Installation Wizard.

Important: The Platform version is available for users to install from version 25.3 onwards, hence the Platform Authentication option will be available from version 25.3 onwards in the installation wizard.

1. Right click the MSI file and select Open with Windows Installer.

2. In the Welcome screen of the setup wizard, select Next.

   

3. In the Installation Scope screen, select the installation scope and folder.

   

4. In the Destination Folder screen, select Change to modify the installation location.

   Important: If you have another version installed, specify a different location for the new version to avoid overwriting the existing installation.

   

5. Select Next.

4. In the setup type screen, choose the required authentication type and select Next.

   

   • Platform: Installs the Production version of Platform

   • Standard: Installs the Standard version

6. Select Install to compete the installation.

   

Rename Program Menu Shortcut

After installation completes, you can rename the Program Menu Name from Hubble to include the specific version name to distinguish between multiple installations:

1. Right click the Program Menu name.

2. Select Open File Location.

   

3. Rename the shortcut to include the version number (for example: Hubble 25.3).

   

Version Upgrade Recommendation

When upgrading to a newer Hubble version, run the new version and current version in parallel. This approach enables you to complete testing and user acceptance phases before fully transitioning to the new version.

Log In to Hubble Reporting as a Platform User

After installing Hubble Desktop, follow these steps to log in as a Platform user:

1. Start Hubble.exe from the Hubble MSI package. The Platform authentication page opens in your browser.

   

2. Enter your credentials and complete authentication. After successful authentication, the system returns you to the Hubble application where the profile selection screen appears.

3. Review the pre-populated fields:

   

   • User: Displays your email address from Platform authentication

   • Profile: Shows available profiles associated with your user

   • Role: Displays your assigned role

4. Select Log In. The system opens the Hubble reporting tool with your selected profile and role.

EBS Script

For Oracle e-Business Suite (EBS) users, installs and upgrades from one major Hubble product release to another require a release-specific script being run. The script will be run for the Schema username you have defined for the release. This script will grant the proper permissions to the ERP Tables we use in our product as well as generate the necessary views. One of the steps in the script includes the creation of a new schema for the EBS Data Connection. Following are important points regarding the new schema:

1. In the script, you will be prompted to enter the name of the new schema. The default schema name is Hubble; however you need to be sure to change it so that you use a new name when creating a new schema. A best practice is to name the schema after the Hubble release so you can associate the schema name easily. An example for a schema name is “HUB19_3” or “HUB19_4”.
2. The same situation exists for every EBS instance (which is the Hubble profile, e.g. PROD or DEV) you connect to within the product. For an upgrade to a major release, the script needs to be run over the data in each instance and the Hubble Data Connection(s) modified to have the new schema name being used in that Connection(s).
3. If you are using Budgeting, you also need to run a separate database script that creates a schema to hold the budgeting tables.

Please contact our Customer Support Department for obtain the scripts or for any questions related to the scripts.

Deploying using Citrix

Once the software has been installed, it can be deployed in several ways. One way it can be published is via Citrix, and in order to do that, the Hubble application must first be installed on the Citrix server. For detailed information on publishing to Citrix, please refer to the product information provided by Citrix.

When following the steps detailed by Citrix, you will input specific information related to Hubble. Some examples are listed below.

• When locating the application, on the Command Line, input the install path and executable file such as C:\ProgramFiles\InsightSoftware.com\Hubble\<version>\Hubble.exe

• When locating the application, optionally you can input the working directory, which is the install path. An example is C:\Program Files\InsightSoftware.com\Hubble\<version>\\

• The icon is located in the install path, such as:

  • C:\Program Files\InsightSoftware.com\Hubble\Hubble_<version>\\citrix_hubble.icon.ico

Deploying using ClickOnce

Hubble can also be deployed via ClickOnce, a Microsoft deployment technology that enables users to install and run an application with minimal IT involvement. See the Hubble Supplementary Deployment Topics Guide for information about deploying via ClickOnce.

Deleting the Application from a Workstation

Follow the steps below to delete the application from a workstation:

1. Back up the repository from within your old version of Administrator.
2. To prevent the occurrence of an orphaned repository database, delete the repository from within Administrator.
3. Access Control Panel > Add/Remove Programs.
4. Find the correct version of Hubble and select it.
5. Click Uninstall.
6. Review folders/files in the install path related to the removed version to verify removal. (The default install path for Hubble is C:\Program Files\InsightSoftware.com\Hubble... If the files are still present in the install path, you can delete them.