Table of Contents

Installation wizard for TeemIp as a Standalone Application

This is the process to install TeemIp as a standalone application:

  1. Make sure that you have a properly configured instance of Apache/PHP running.
  2. Unpack the content of the “web” directory in a directory served by your web server (for example /var/www/teemip on Linux or C:\inetpub\wwwroot\teemip on Windows/IIS).
  3. Point your web browser to the URL corresponding to the directory where the files have been unpacked (for example http://localhost/teemip) and follow the indications on the screen.

TeemIp provides a step by step wizard to install the application.

The first step of the installation consists in checking the consistency of the configuration and the prerequisites for MySQL, PHP and optional PHP extensions.

Step 1: Configuration check

The second step of the installation offers the choice to either upgrade an existing TeemIp or to install the application from scratch.

Step 2: Install or upgrade

Fresh installation

If you select to install a new instance then third step of the wizard will prompt you to accept the license agreement.

Step 3: License agreement

The fourth step of the wizard prompts you for the credentials to connect to MySQL and the database that will be used with TeemIp. Make sure that you supply an account with enough rights for installing and running TeemIp. This account needs to create tables, triggers and views in the database, as well as drop views in case of upgrade. If you choose to let the setup create a new database for you, this account needs to have the rights to do it.

You can also specify a prefix to be added to the names of all tables and views created by TeemIp in the database. This is useful if you want to install several applications inside the same MySQL database.

Note that the database server does not need to be on the same physical server as the PHP/web server. It can be a remote host if you prefer to have a two-tier architecture, or connect to an already installed MySQL server.

Step 4: Database info

The next step of the wizard prompts you for the information about the administrator account. TeemIp authentication can rely on external mechanisms (LDAP, Active Directory or JASIG-CAS) but the installation requires that at least one administrator account be created with a local password.

Step 5: Admin account

The next screen prompts your for several miscellaneous information:

Step 6: Misc parameters

In case you have multiple virtual hosts pointing to TeemIp or if you are using a test system with a dynamic IP address (DHCP) and you want to connect anyway from another system, the “address” of the TeemIp server cannot be fixed at installation time. In this case you can use the placeholder $_SERVER_NAME_$ in the URL parameter. For example you can type: http://$_SERVER_NAME_$/teemip as the URL to access the application. At runtime this value will be substituted by the value of the PHP variable SERVER_NAME for the current connection.

Upgrade

Should you decide to upgrade an existing instance, then the following step will ask you to specify that existing instance…

Step 4: Database info

.. before displaying the current and next version of the product

Step 5: Database info

.. and asking you to double check some additional parameters.

Step 6: Database info

The following steps of the installation wizard will help you tailor the “data model” of TeemIp in order to best suit your needs.

Configuring the CMDB

The CMDB is made of 6 modules:

Step 7: CMDB

Configuring IP, DHCP and DNS Management

In the current version, there are 4 modules available:

Step 8: IP Management

Configuring Ticket Management

If you plan to rely on a user portal and manage user requests in TeemIp,

Step 9: Helpdesk

Launching the installation

Once all the choices are made, a summary is displayed. You can drill down to check your choices by clicking on the “plus” button for each section.

To start the actual installation of TeemIp, click on the “Install !” button.

Step 10: Launch installation

The progress of the installation is displayed with a moving progress bar.

Step 11: Installation in progress

Once the installation is done, you can: Review the instructions about setting up the background tasks, by clicking the link “Manual instructions for Tickets Management”. Or enter TeemIp immediately by clicking on the “Enter TeemIp” button.

Instructions to setup the background tasks are also available and potentially more up to date here

Step 12: Installation is successfull

Congratulation, you’ve successfully installed TeemIp!