Using the installation wizard

V0.1a3 introduced an installation wizard that helps with setting up conjoon on a webserver.

Once you have configured your server to access the contents of /build/htdocs in a webbrowser of your choice, open up /install/index.php.

(NOTE: Users who upgrade to any version > 0.1a3 need to copy the contents of /build/htdocs into the root folder of your conjoon application. Override any existing file.)

Start screen

start screen of conjoons install wizard

start screen of conjoon's install wizard

The start screen will introduce you to the installation procedure.  It will look up the installation.info.php and check if you are currently upgrading conjoon, or if you are installing the application from scratch.

If the installation.info.php file was found, most of the settings will be prefilled with the settings from a prior installation (except for passwords).

You have to provide the following settings in the start screen:

  • Support key: If you have requested support from the conjoon project, supply your support key here. You can leave the field empty. We suggest you use your email address here if you have no support key.
  • Edition: This is the “name” of your installation. It will appear here and there in conjoon, but is not important, though we suggest a value so that your installation can be identified. For example: We are running conjoon from USB-Sticks and used “USB edition” as the value for this field.
  • Accept license terms: Before you proceed with the installation, read through the license terms and confirm that you agree to them. In short, this means you agree to the GPL license, under which the software is published.

Once you have provided your settings, click the “Next” button to continue with the installation.

Step 1: Checking requirements

Step 1: Checking requirements

Step 1: Checking requirements

The next step will check if your server’s configuration matches the requirements for running conjoon.

If the installation wizard detects a setting which could make conjoon to not work properly, it will inform you on this page. If a warning or error is generated, you can continue with the installation procedure, but we suggest you first configure your server until the installation wizard does not generate one of the above mentioned notices.

Step 2: Setting up the database

Step 2: Adjusting database settings

Step 2: Adjusting database settings

The next step lets you configure the database connection info. You can choose from a list of database drivers and need to provide the necessary connection settings.

You need to provide the following settings:

  • Database type: The type of database you are using.
  • Database host: The address of the database server.
  • Database port: The port your database service listens to.
  • Database user: The user name for the database connection.
  • Database password: The password for the database conenction. You can leave the field empty if you do not use a password for your database connection.
  • Max allowed packet: The maximum size of data your database can process at once when adding data to the database (in bytes).  If you leave this field blank, the installation wizard will try to determine this value automatically.

Step 3: Setting the path for the application folder

Step 3: Setting path for the application folder

Step 3: Setting path for the application folder

conjoon’s backend relies on the Zend Framework, and all the custom controllers and templates can be found in the conjoon_application folder, which in turn needs to be put somewhere in your filesystem where the PHP scripts have read and write access.

You need to provide the following settings:

  • Path to application folder: The path to the folder on your server where the conjoon_application folder should be stored. If the supplied path is neither readable nor writable by PHP, the installation wizard will generate an error, and ask you to provide another path. Hint: If you leave the field empty, the installation wizard will automatically choose the conjoon’s root folder as the path. This is not recommended and should only be used for demo setups.

Step 4: Setting the include path

Step 4: Setting the include path

Step 4: Setting the include path

conjoon relies on several PHP libraries which have to be stored in a readable location in your filesystem. You need to specify the path to the folder where the conjoon_libs folder should be stored.

You need to provide the following settings:

  • Path to library folder: The path to the folder in your filesystem where the conjoon_libs folder should be stored. If the supplied path is neither readable nor writable by PHP, the installation wizard will generate an error, and ask you to provide another path. Hint: If you leave the field empty, the installation wizard will automatically choose the conjoon’s root folder as the path. This is not recommended and should only be used for demonstration purposes.
  • Let conjoon add this path to php’s include path: It is recommended that you add the chosen path to your php.ini’s include_path setting. However, if you do not have access to the php.ini, conjoon can adjust the include_path-setting during runtime.

Step 5: Setting the document path

Step 5: Setting the document path

Step 5: Setting the document path

The “document path” is the the path where conjoon can be accessed using a webbrowser, minus the server’s name. For example, if conjoon can be accessed using the address http://my.domain.tld/path/to/conjoon, the document path would be path/to/conjoon. If you access conjoon using the document root of your server, the document path would equal to a slash (“/”).

You need to provide the following settings:

  • Document path: The installation wizard will try to determine the document path automatically. If the suggested value does not fit your server’s setup, you can change it manually.

Step 6: Adding a root user

Step 6: Adding the root user

Step 6: Adding the root user

Versions prior to V0.1a3  came with a default “admin” user, so that you could sign in with the user “admin” right away. The installation wizard lets you specify the root user’s login credentials, and it is recommended that you do not use “admin” and “password” as the login data.

Note: This step will not be available if the installation wizard updates a previous version of conjoon, or if the table “user” in the specified database does already have a root user.

You have to provide the following settings:

  • User name: The user name for the root user
  • Password: The password for the root user
  • First name: The first name for the root user
  • Last name: The last name for the root user
  • Email address: The email address for the root user

Step 7: Confirm your settings

Step 7: Confirming the settings

Step 7: Confirming the settings

Before the installation wizard makes any changes to your filesystem, you have to confirm the settings you have provided. Read carefully through the listed values and click “Next” to start installation, or click “Previous” to browse through the various setup steps again.

Once the wizard has finished, the following files will be edited/put in the document root of your conjoon installation:

  • .htaccess: File with mod_rewrite rules for your Apache Webserver
  • installation.info.php: Settings you have provided for this installation (excluding passwords)
  • config.ini.php: Configuration file for this conjoon installation

Once finished, remove the “install” folder out of conjoon’s document root, otherwise conjoon will not start up.

Please use the forums to discuss this article.

14 Responses to “Using the installation wizard”

  1. conjoon V0.1a3 available Says:

    [...] conjoon V0.1a3 is available and comes with an installation wizard. [...]

  2. Malte Spielberger Says:

    Just noticed when using 0.1a3 that the /install/index.php shows a php error:
    Parse error: syntax error, unexpected ‘;’, expecting ‘(‘ in ******/build/htdocs/install/index.php on line 57

    Best
    malte

  3. Malte Spielberger Says:

    Very very sad that there is no support or anybody trying to help me out :(

  4. ThorstenSuckow Says:

    malte, don’t worry, you were heard. Please use the forums over at http://www.conjoon.org/forum, as it will be much easier to collect and respond to all reported issues there.

    The issue will be fixed in the next release.

  5. ThorstenSuckow Says:

    Turns out that the required PHP version was not available on the server of the issue reporter. The wizard will be updated to check for the correct PHP version at startup

  6. pian Says:

    i’ve install conjoon v01.a3 on wamp, but i had trouble with login form. I couldn’t access with user : admin, pass: password (which is default).
    it said that cannot find user. is there a sollution ? please

  7. ThorstenSuckow Says:

    Pian, did you use the installation wizard to create a user name/password? 0.1a3 doesn’t come with a default user anymore. Take a look at the user table and see if there is already data existing.

    You might also want to refer to the forums at http://www.conjoon.org/forum and ask for help there.

  8. ThorstenSuckow Says:

    @malte FYI: The installation wizard now checks for PHP5 before any of PHP5′s functionality is used (see http://wiki.conjoon.org/changeset/905/trunk)

  9. jagadeesh Says:

    i installed conjoon. i logged in as admin successfully.if i create a new user in admin section and when i try to login to that form it is showing invalid user/authentication failed message.i removed that one and i installed again.i am facing same problem again. i am using php>5 and mysql>5 and linux server and apache. finally i changed another webmail. with same pop and smpt settings it is working fine. but i am intrested to work with conjoon. i studied forum fully. but no is giving proper answer. please give me how to setup new user.i will try one more time to install cojoon.

    please help me
    jagadeesh

  10. ThorstenSuckow Says:

    You have to md5 the password – either use mysql’s build in functions or create a md5 hash using PHP’s md5()-function, then insert the password as text into the specific field.

  11. khalid gaafar Says:

    I installed conjoon successfuly 100%, but the problem is that I cant log in because
    I dont know where should I find the login screen, after I finished installation successfuly I didnot know what to do to login

    please your help…..
    thanks a lot

  12. ThorstenSuckow Says:

    Khalid, if you called the install wizard using something like http://yourhoster.com/build/install/index.php, the application can be found at http://yourhoster.com/build/index.php (one directory hierarchy up). If you have further questions, please post them to the forums.

  13. khalid gaafar Says:

    ThorstenSuckow, Thank very much, your it works now very well

  14. conjoon V0.1a3 available « Thorsten Suckow-Homberg Says:

    [...] conjoon V0.1a3 is available and comes with an installation wizard. [...]

Leave a Reply


Refresh