Installation & Update

Checking your server configuration

Checking your server configuration can be easily done by accessing System –> System Information, from the drop-down menu on the Back-end of your Joomla! installation.

This tool provides useful information about your host server environment, including operating system, database and PHP settings, and directory information. You can navigate to five different screens: System Info, PHP Settings, Configuration File, Directory Permissions, and PHP Information. Each screen provides detailed information about that aspect of your Joomla! website. This information is very helpful when you are troubleshooting setup problems.

  • Note that none of these settings can be changed from these screens. This must be done in different locations throughout your Joomla! installation, depending on the specific setting.
  • Many settings on the Configuration File screen can be changed from the Global Configuration screen.Some settings shown here depend on your host server configuration and cannot be changed from inside Joomla!.
_images/1.png

A key aspect that is important and might cause issues during J-BusinessDirectory component installation is that the actual installer package is usually over 2M and there are two PHP settings that could cause the normal installation process to fail. These parameters are: the ‘upload_max_filesize’ php parameter which (unfortunately) is restricted by many hosting environments to just ‘2MB’ and the ‘post_max_size’ parameter. Both of these parameters must be set to at least 16MB.

Installing the extension

The current installation includes a component,several modules and a plugin. All are installed when installing the J-BusinessDirectory, so you don’t need to worry on installing them separately. After running the installation you will be able to access the component from the component menu in the backend, and the installed modulesfrom the modules menu.

To begin installation of the J-BusinessDirectorycomponent log in into your Joomla backend and follow the steps described below:

  1. In the main menu go to Extensions ->Extensions Manager
_images/2.png
  1. Click the Browse button to locate your downloaded copy of the J-BusinessDirectory (J-BusinessDirectory.zip).
_images/4.png
  1. After selecting the component click the Upload File& Install button
  2. You will receive a confirmation message upon installation completion

Note

Due to multiple features of J-BusinessDirectory extension the size of installer is higher than 2MB which is the default upload limit set by hosting providers. If you experience any errors on installation please check the upload limit and directory write permission. In some cases it is recommended to contact the hosting provider to fix this.

In some cases, the hosting provider allows you to override the php settings by adding a php.ini file in your document root. Php.ini file should contain the following lines of code.

upload_max_filesize = 16M
post_max_size = 16M

Server requirements

Joomla 3.x
_images/joomlaversion.png
Software Recommended Minimum
PHP (Magic Quotes GPC off) 5.4 + 5.3.10 +
Supported Databases:
MySQL (InnoDB support required) 5.1 + 5.1 +
MSSQL 10.50.1600.1+ 10.50.1600.1+
PostgreSQL 8.3.18 + 8.3.18 +
Supported Web Servers:
Apache(with mod_mysql, mod_xml, and mod_zlib) 2.x + 2.x +
Hiawatha (with UrlToolkit support) latest 8.0
Nginx 1.1 1.0
Microsoft IIS 7 7
Joomla 2.5.x
_images/version25.png
Software Recommended Minimum
PHP 5.4 + 5.2.4 +
Supported Databases:
MySQL 5.0.4 + 5.0.4 +
Supported Web Servers:
Apache(with mod_mysql, mod_xml, and mod_zlib) 2.x + 2.x +
Hiawatha (with UrlToolkit support) latest 8.0
Nginx 1.1 1.0
Microsoft IIS 7 7

QuickStart Installation

Quickstart is a Joomla installation kit that comes with whole setup like on our demo site. Installing the Quickstart is easy and it saves you a lot of time.

Note

The quickstart is available only if you purchase also a template together with the extension.

Downloading and Uploading J-Directory Quickstart Package Files

  1. Download the current release of J-Directory Quickstart.
  2. Move the downloaded installation package to the server. Use a FTP Client to transfer the Joomla! 3.x files to your server. If you don’t already have an FTP client, we recommend Filezilla

Hint

This can be accomplished by simply moving the downloaded package to your server, then unpacking it. Or you can unpack the files on your local computer, then move the Joomla installation over to your server. Either way, the Joomla installation needs to be unpacked in the root of your site.

Database for Joomla! Installation

  1. If you need to create a database, please read ” Create a database for use with Joomla! ” first or skip to step #2.
  1. You will need to note basic database information needed when the actual installation is started.

    • Location of database, localhost Or a specific host’s server such as dbserver1.yourhost.com
    • The database name
    • The database user’s name
    • The database user’s password

Start Install

Main Configuration

With the above requirements met, a database created and the required quickstart files in place, you are ready to install J-Directory quickstart. Start the by opening your favorite browser and browsing to the site’s domain name. On host installation you will use http://www.yoursitename.com. If you are installing the quickstart locally, you will use http://localhost/<path to Joomla files>, and you should see the installation screen.

_images/5.png

Joomla! will try to identify the Select Language field automatically from your browser’s language. You can change this if needed.

Fill in the following information.

  • Site Name: the name of your website — this can be changed at any point later in the Site Global Configuration page.
  • Description: enter a description of the website. This is a the global fallback meta description used on every page which will be used by search engines. Generally, a maximum of 20 to 25 words is optimal. Again, this can be changed on the Site Global Configuration page at any time. For more on metadata, see Global Metadata Settings and Entering search engine meta-data.
  • Admin Email Address: the admin email address. Enter a valid email in case you forget your password. This is the email address where you’ll receive a link to change the admin password.
  • Admin Username: Joomla! uses a default “admin” as the username for the Super User. You can leave it as is, change it now (which a good Security measure) or use My Profile in the Administration interface to change it later.
  • Admin Password: remember that super user has maximum control of the site (frontend & backend), so try to use a difficult password. Use My Profile in the Administration interface to change it later. Confirm the password in the Confirm Admin Password box.
  • Site Offline: click the Yes or No box. Yes - this means when installation is complete, your Joomla! website will display the ‘Site is offline’ message when you browse to yoursitename.com to view the home page. No - this means the site is live when you browse to yoursitename.com to view the home page. You can use the Site Global Configuration in the Administration interface to change the Offline status at any time.

When everything on the first page is completed, click the next button to proceed:

Database Configuration

Configuration Settings

You will need to enter the information about the database you will use for Joomla! now. It was suggested to write this information down under “Prepare for Install” tab. You may also read or review Creating a Database for Joomla!.

_images/6.png

For simplification, these instructions are a reference to installing with a MySQLi database. The instructions on the installation page are self-explanatory, but here they are again:

  • Database Type: MySQLi is the common database used
  • Hostname Where is your database located Common is localhost, but some hosts use a specific database server such as dbserver1.yourhost.com
  • Username: the username used to connect to the database
  • Password: the password for the database’s username
  • Database Name: the name of the database
  • Table Prefix: one is generated automatically, but you can change it. For example, jos3_ can be used. Just don’t forget to put the underscore character (_) at the end of the prefix.
  • Old Database Process: should the installer backup or delete existing tables during the installation of new tables Click, Yes or No to select the choice.

All these choices can be edited on the Site Global Configuration page, under Server options after the installation is completed. Note, you will break your installation if you change these settings after installation unless you have a complete copy of the current database being used by the Joomla! installation. Common uses would be to update the username and password of the database or to complete a move of an existing installation to a new host with different parameters.

When everything on the first page is completed, click the next button to proceed:

Finalize

Overview

It is now time to finalize the Quickstart installation. The last page of the web browser installation contains all the information about the installation. This includes the options(at the top) for installing sample data and the installation’s configurations(at the bottom). Please choose the first option, None, like in the image bellow.

_images/7.png

Configuration Check

Checking Your Configurations

If everything is in order, you will see the install at the top of the overview page. If not, this is the place to check and see what may be causing an issue.

_images/8.png

The section is broken into 4 groups:

  • Main Configuration: all the website specific information, such as the website name, description, admin username, etc.
  • Database Configuration: contains the information about the database Joomla! will use.
  • Pre-Installation Check: these requirements must all be shown as Yes, otherwise you will not be able to install Joomla! With the exception of the PHP Version, the rest are usually controlled in the php.ini. You may need assistance from your host in correcting these settings or checking to see if it is possible to adjust them. For more information, see PHP configuration filefile.
  • Recommended Settings: these are settings are recommended in your PHP configuration, but will not prevent Joomla! from being installed. You can refer to the above instructions on how they may be changed.

If everything is correct and all checks are passed, you may now click the Install button in the top right corner of the Overview page. This will start the actual installation process.

After you click the Install button, you should see a progress bar with additional information of the installation. Once the installation completes, you should see the success page!

Finishing Up

Success and Finishing Up the Installation

Congratulations! Joomla! 3 is now installed. If you want to start using Joomla! right way without installing extra languages there is one last step to complete the installation. You must delete the Installation Folder. Click on Remove Installation folder and a success message will appear. Now you can navigate to the Administrator log in by clicking Administrator or go right to your site by clicking Site.

_images/9.png

Update the extension

We are continuously improving the extension by releasing new versions. You can benefit of the latest features and improvements by updating to the latest version. When an update is performed all extension files are overwritten with the latest version, the database and current settings will be preserved.

Attention

It is highly recommended that you should do a backup before you update. All custom changes that are applied to the directory extension files will be overwritten.

Manual update

You can download the latest version by login on your CMSJunkie store account and go to My Downloadable Links section. You can install the new version over the existing one by following the instruction from chapter 1.2 Installing the extension.

Automatically update

There is also the possibility of doing an automatic update. You can update directly from your Joomla website, from Update section of J-BusinesssDirectory extension, not from Joomla Update section.

First you will have to enter your order id and order email and click on Save order details button like in the image bellow. Once the details are entered you will be able to get the latest version if you subscription is still active.

_images/10.png