The Yellowfin application installer provides a traditional installation file that can be used on premises or on the cloud, via Linux, Windows and MacOS.
Before you begin the installation process, make sure you have followed the pre-requisites explained in detail on the Install And Deploy Yellowfin wiki page. This includes information about license file options and the download location of the application installer. Make sure you have downloaded the installer for your operating system before beginning these steps.
The installer will provide a series of prompts for information and confirmations. These are:
Once you've provided the required information, the installer will indicate the progress of the installation until completion.
You can select the optional content packs to install. We strongly recommend that you install all content packs if you're installing Yellowfin in an evaluation and training setting. The available packs include:
Pack | Description |
---|---|
Core | This is the core software for Yellowfin that must be installed. This is the minimum package required during installation. |
Tutorial Content | This content pack contains Ski Team sample data, views, reports and dashboards that are used in the Yellowfin training and help documentation. This is particularly useful if you haven't used Yellowfin before. |
World Countries Pack | This GeoPack provides selected geographic data for every country on Earth. It includes a metric for country population estimates as of 2005. |
US ZIP Code Pack | This GeoPack provides selected geographic data for states, counties and zip codes in the United States. It includes census-derived demographics for population by age, as well as various demographics for area income, labour force and unemployment. Note: Due to the US Census Bureau's method of converting zip codes to areas there is not 100% correlation of postal zip codes to census collected data. As a result, there are zip code level land areas for which no data is available. |
Configuration | Description |
---|---|
Web Server Port | Set the port number for Yellowfin to listen for web browser requests. By default, all web browsers send requests using port 80. If there are no other web servers on the machine that Yellowfin is being installed on, you can accept the default port number of 8080. If there are already web servers installed on the machine that Yellowfin is being installed on, then there may be port clashes and Yellowfin will fail to function correctly. Therefore, the port number must not currently be in use by any other application on the machine. Port numbers like 8080, 8081 and so on are typically good candidate port numbers. |
Windows Service | Check this box to install Windows Service on the server. This means that it will automatically start up whenever the Windows Server is booted and save having to be manually started. Note: this option will only appear during installation on a Windows platform. |
Application Memory | Specify a memory size (in MB) that should be used by Yellowfin. Yellowfin should be configured to use at least 2GB of memory. By default, the installer will allocate 75% of the system's memory to the Yellowfin, but this size can be changed here. |
The database details required during installation are for the database that stores all the Yellowfin content definitions, configuration information, and event details (ie, not your report data). This database can be created before the installation or the Yellowfin installer can create it for you.
Database Server Location | |
---|---|
Server Host | Enter the network address of the database server hosting the Yellowfin database. If the Yellowfin database is on the same computer as the Yellowfin application, enter localhost. |
Server Port | Enter the network port number of the database hosting the Yellowfin database. |
Database Name | Enter the name of the Yellowfin database. If one doesn't exist, enter a new name. |
Create New Database | If the above database does not exist on the database server, tick this option to allow the Yellowfin installer to create a new database to host the Yellowfin database using the database name entered above. When you check this checkbox, the Administrator User section will appear on the screen for you to add these existing details so that Yellowfin is granted access to create the new database. |
Authentication Details | |
Authentication | This configuration is specific to Microsoft SQL server. Choose how the database users should be authenticated. Options include:
|
Logon Domain | If Windows authentication is selected, specify a logon domain. |
Database User | |
Username | Enter the name of the database server user account that has access to the Yellowfin database. This database user must have full read and write permissions to the Yellowfin database. |
Password | Enter the password of the database server user account that has access to the Yellowfin database. |
Confirm Password | Re-enter the password of the database server user account that has access to the Yellowfin database. (This is only required if creating a new user.) |
Create New User | If the above database user does not exist on the database server, tick this option to allow the Yellowfin installer to create a new database user account to access the Yellowfin database. When you tick this option, the Administrator User section will appear on the screen for you to add these existing details so that Yellowfin is granted access to create a new user. |
Administrator User | |
This section appears if you check the checkbox for Create New Database and/or Create New User. | |
Username | Enter the name of the existing database server user account that has administrator-level access to the database server hosting the Yellowfin database. |
Password | Enter the password of the existing database server user account that has administrator-level access to the database server hosting the Yellowfin database. |
The Yellowfin application installer will suggest an installation path. It should be suitable for most installations, but please consider the following points before using the default.
The steps below cover the full installation process.
The Yellowfin installer will display the Installation Complete screen if the installation is successful: it contains some useful information
If you do not see this screen, contact your Yellowfin representative or contact Yellowfin Support, or see the Troubleshooting section below
An uninstall function has been created for you under the directory nominated in the database selection step. |
Now that Yellowfin is successfully installed on your machine, it's time to deploy. Visit the Deploy Yellowfin page for full details and instructions for a first-time deployment of Yellowfin and the minimal configuration needed.
Most problems related to the Yellowfin application server installation relate to database connectivity and administration issues.
As mentioned previously, a log is kept of the database installation and can be found in $INSTALL_DIRECTORY\uninstall
directory.
The most likely problem will be the incorrect setting or misspelling of the parameters entered in Step 7 Configure the Database Connection and User parameters eg. database name, port, IP address etc.
Customers using Microsoft SQLServer or Microsoft MSDE should ensure that the IP addresses and configuration are consistent with the parameter values entered. The Microsoft program svrnetcn.exe
(SQLServer Network Utility) can be used to check that the SQLServer IP stack (including the JDBC port number) has been configured correctly. It can be used for both SQLServer and MSDE.
Network error IOException: Connection refused: connect()
This error means that the installer cannot connect to your MS SQL server instance. This error occurs before authentication takes place. This means that either:
Verify these settings on the Configuration DB Parameters screen on the installer.
If the above posts do not solve the issues you're experiencing, please send an email to support@yellowfin.bi with a clear description of the issue, along with the following:
Current topic - Install on PremisesThis page is part of the Install And Deploy Yellowfin section of the wiki, which has these topics:
|