Database Configuration

     



     

    Configure the Database

    By default ServiceDesk Plus - MSP supports PostgreSQL database, to switch over to SQL database, you need to configure SQL server credentials to establish connection and start the server.

     

    Configuring PostgreSQL Server

    1. Execute the changeDBServer.bat [changeDBServer.sh for Linux] file presented under the ServiceDesk Plus - MSP Home. This opens the Database Setup Wizard page. Fill in the details of the form to configure SQL server.

      • Server Type: Select the server type from the combo box. Say, PostgreSQL

      • Host Name: Enter the IP Address/ host name in which the database is available. The default host name is 'localhost'.

      • Port: Specify the Port. The default port is 1433.

      • Database: By default the database name will be servicedesk in non-editable format.

      • User Name: Specify the User Name to login to the server

      • Password: Specify the Password.

    database_setup_wizard

    1. To check the availability of connection, click the Test button. A pop up window pops up showing 'Connection Established' message.

    2. Click OK to proceed.

    3. Click Save button to save the SQL server settings.

     

    Configuring MSSQL Server

    1. If you are using a remote MSSql server and do not want to use the inbuilt server then,

    2. Select Server Type as MSSql server. This opens the database wizard page.

    3. Specify the Host Name, Port, User Name & Password.

    4. Click Test button and check the availability of the connection.

    5. Once the connections are established, save the details and start the server.  

     

    Configuring MYSQL Server

    1. If you are using a remote MySql server and do not want to use the inbuilt server then,

    2. Select Server Type as MySql server. This opens the database wizard page.

    3. Specify the Host Name, Port, User Name & Password.

    4. Click Test button and check the availability of the connection.

    5. Once the connections are established, save the details and start the server.  

     

    Non GUI Users

    Run the changeDBServer.bat [changeDBServer.sh for Linux] under command prompt by passing parameter as given below,

     

    C:\[ServiceDesk Plus - MSP Home]\bin>changeDBServer.bat --console

    It will get the DB Server necessary information from the console.

    database_gui

     

    Connect to PostgreSQL Server

    ServiceDesk Plus - MSP uses PostgreSQL as its default database.

     

    Connect to PostgreSQL Server in Windows

    1. Go to [ServiceDesk Plus - MSP Home] \ pgsql \ bin in the command prompt.

    C:\> cd ManageEngine\ServiceDeskPlus - MSP\pgsql\bin

    1. Enter the command: pgsql.exe -U postgres -p 65432 -w servicedesk

    C:\> cd ManageEngine\ServiceDeskPlus - MSP\pgsql\bin> psql.exe -U postgres -p 65432 -w servicedesk

    ServiceDesk is the name of the database. 65432 is the port on which ServiceDesk Plus - MSP database runs. ServiceDesk Plus - MSP uses root account to connect to the database and does not use any password. You can connect to PostgreSQL database only from the server console.

    pgsql-connect-windows

     

    Connect to PostgreSQL Server in Linux

    1. Install the PostgreSQL client which supports your Linux version.

    2. Once this is accomplished, make sure that the command "psql" is in path. (Most often, mysql should be under path, if not, you may add the complete path to psql command under PATH variable in the bashrc file.

    3. Go to [ServiceDesk Plus - MSP Home] \ pgsql \ bin in the command prompt.

    # cd [ServiceDesk Plus - MSP Home]/pgsql/bin

    1. Enter the command: pgsql.exe -U postgres -h localhost -p 65432 servicedesk

    pgsql-connect-linux

    Connect to MY SQL Server

    ServiceDesk Plus - MSP uses MYSQL as its default database.

     

    Connect to MYSQL Server in Windows

    1. Go to [ServiceDesk Plus - MSP Home] \ mysql \ bin in the command prompt.

    C:\> cd ManageEngine\ServiceDeskPlus - MSP\mysql\bin

    1. Enter the command: mysql.exe -u root -P 33366 servicedesk

    C:\> cd ManageEngine\ServiceDeskPlus - MSP\mysql\bin> mysql.exe -u root -P 33366 servicedesk

    ServiceDesk is the name of the database. 33366 is the port on which ServiceDesk Plus - MSP database runs. ServiceDesk Plus - MSP uses root account to connect to the database and does not use any password. You can connect to MYSQL database only from the server console.

    mysql-connect

     

    Connect to MYSQL Server in Linux

    1. Install the MYSQL client which supports your Linux version.

    2. Once this is accomplished, make sure that the command "mysql" is in path. (Most often, mysql should be under path, if not, you may add the complete path to mysql command under PATH variable in the bashrc file.

    3. Go to [ServiceDesk Plus - MSP Home] \ mysql \ bin in the command prompt.

    # cd [ServiceDesk Plus - MSP Home]/mysql/bin

    1. Enter the command: # mysql -u root -S ../tmp/mysql.sock servicedesk A

    mysql-linux

     

    Troubleshooting Tips

     

    PostgreSQL Connection Resolution

    Verify the following,

      • Check if PostgreSQL server is running.

      • Check if the server name or the port number is misspelled or incorrect.

      • If the PostgreSQL server is running in a remote machine then there may be a firewall blocking the port number you have entered.

      • If none of the above mentioned issues matches then contact your system administrator.

    MY SQL Connection Resolution

    Verify the following,

      • Check if MY SQL server is running.

      • Check if the server name or the port number is misspelled or incorrect.

      • If the MY SQL server is running in a remote machine then there may be a firewall blocking the port number you have entered.

      • If none of the above mentioned issues matches then contact your system administrator.  

    MS SQL Connection Resolution

    If a connection is refused and an exception is thrown by SQL Server as 'unable to connect the server' then there could be following reasons why this could happen such as,

      • The server name is misspelled or the port number is incorrect

      • The SQL server may not configured to use TCP/IP. In this case, enable TCP/IP from SQL server's network utility application.

      • If there is a firewall blocking the port 1433 on the server then you will not be able to connect to the server.

      • To confirm the firewall block connect to TCP/IP use \"telnet<server_host>1433\"\n to confirm the block.

      • SQL Server Instance is not currently supported by ServiceDesk and will be available in the feature release. You can also connect to SQL Server named instance once if you know the machine name and port of the named instance.

      • Create new user with full privileges as shown below,  

    sql-server-login-properties

      • While configuring SQL server properties select the authentication type as SQL server as shown below. Windows authentication is not supported by ServiceDesk Plus - MSP currently.

    sql_server_properties

     

     

     

    Copyright © 2017, ZOHO Corp. All Rights Reserved.