--- title: "Installation" canonical: "https://wiki.yellowfinbi.com/space/USER71/2031917/Installation" format: markdown --- > Macro (anchor) > Macro (toc) ## Prerequisites Yellowfin requires that the customer has installed the following products prior to installing the Yellowfin product: ### Java JRE The server hosting the Yellowfin application MUST have Java 1.5 or higher installed on it. The Java JRE is sufficient for this purpose. Refer to the Sun web site for download and installation instructions ([http://www.java.sun.com](http://www.java.sun.com)) ### Database The database software which will contain the Yellowfin database should already be installed. Suitable jdbc drivers to enable the database to communicate with the Yellowfin application should also be installed. It is not necessary for the database server to reside on the same machine as the Yellowfin application. ## Installation Steps Yellowfin is provided as a java archive file called Installer.jar. Copy the file to a temporary directory on the server onto which the application is to reside. ### Language Selection > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Welcome Screen > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Terms & Conditions > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Required Components > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Licence File > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### General Options > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Database Selection > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Database Details (Sample) > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Installation Path > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Installation Progress > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Shortcuts > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Installation Completion > Macro (section) > > > Macro (legacy-content) > > > Macro (legacy-content) ## Troubleshooting 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. ### Example ***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: 1. SQL Server is stopped on the server you are trying to connect to. 2. The connection details you entered were incorrect. 3. You have a network problem that stops the computer you're running the installer on connecting to the SQL server host (Unlikely if you are connecting to your localhost). Verify these settings on the Configuration DB Parameters screen on the installer. 1. Database Server Name - This will probably be the "localhost". 2. Database Server Port - This should be 1433 3. Database Name - This is the name of the database you want Yellowfin to install to. This should be "yellowfin". This is used for Yellowfin configuration and operational data. It is not the database you wish to report off. 4. Create Database - Click this to create the new Yellowfin database. We suggest removing the Yellowfin database if your installation failed previously. 5. DBA User: This could be "sa" 6. DBA Password: This could be "sa" 7. Reports UserId:Set this to "yellowfin_user" 8. Reports UserId password: Set this to "yellowfin_user" or whatever you prefer. 9. Create user id - Check this checkbox. ### Additional Resources If you are experiencing other installation issues the Yellowfin forum is a good place to look for answers. Go to [http://www.yellowfinbi.com/YFForum.i4](http://www.yellowfinbi.com/YFForum.i4) to explore previous posts or seek help from other users and Support Members. Some useful troubleshooting posts include: 1. [http://www.yellowfinbi.com/YFForum-ERROR-Yellowfin-Installation-on-MS-Server-08-?thread=103838](http://www.yellowfinbi.com/YFForum-ERROR-Yellowfin-Installation-on-MS-Server-08-?thread=103838) 2. [http://www.yellowfinbi.com/YFForum-install-Yelliowfin-on-SQL-Server-2005-?thread=89809](http://www.yellowfinbi.com/YFForum-install-Yelliowfin-on-SQL-Server-2005-?thread=89809) 3. [http://www.yellowfinbi.com/YFForum-New-installation-of-Yellowfin-but-it-s-not-launching-?thread=105437](http://www.yellowfinbi.com/YFForum-New-installation-of-Yellowfin-but-it-s-not-launching-?thread=105437) If the above posts do not solve the issues you're experiencing, please send an email to [support@yellowfin.bi](mailto:support@yellowfin.bi) with a clear description of the issue, along with the following: 1. Screenshots (if applicable) 2. YellowfinInstallLog-date.log (this can be found in the Yellowfin directory) 3. All log files found in Yellowfin\appserver\LOGS (if you have any)