Procedure to upload DB to Analytics Plus

Procedure to upload local DB to Analytics Plus

Steps to use Upload Tool for uploading Data from any DB:

1. Download and extract the from this link

2. Configure the Database connection details:
Open the file 'database_connection_params.conf' located under <Uploadtool>\conf\ folder, using wordpad and specify the connection settings about your in-house database behind firewall in this file. The following screenshot illustrates a typical database_connection_params.conf.

The example in the following screenshot illustrates the connection settings for a MySQL database.

The following are the parameters that are to be given in database_connection_params.conf file:

DBTYPESpecify your local database type. e.g: MySQL, SQL Server, Oracle, Sybase etc.,. (Refer to the next section which contains the list of possible values)
HOSTNAMEHost name of your computer in which the database is running, i.e., the name of the computer where your database is running.
PORTThe port number used by the database server. (Refer to the next section to know the default port number for different databases).
USERNAMEYour local database login name.
PASSWORSDPassword for accessing your local database.
DBNAMEYour local database name from which the data is to be uploaded.
MDBFILENAMEIn case you are going to upload data from MS Access database, then specify the complete path of MS Access database file name which contains the data. 
e.g., MDBFILENAME=C:MSACCESSmdbfiles est.mdb.
SQLITEFILENAMEIn case you are going to upload data from SQLite database, then specify the complete path of SQLite database file name which contains the data.
e.g., SQLITEFILENAME=C:SQLITEsqlitefilesSales-Database.db
FIREBIRDFILENAMEIn case you are going to upload data from Firebird database, then specify the complete path of Firebird database file name which contains the data.
e.g., FIREBIRDFILENAME=C:FIREBIRD irebirdfilesmydb.fdb

Once all required DB settings are updated, save the file.

3.  Specify Queries to be Executed on Relational databases

The database_sql_queries.xml file located under <Uploadtool>\conf\ folder, contains all the settings related to the SQL SELECT Queries that are to be executed in the database for fetching the required data, along with settings about the Analytics Plus database and table names into which the data is to be uploaded. To fetch data from your relational databases, you need to specify SQL SELECT query.  These queries will be executed by the upload tool in your local database to fetch the necessary records and upload the same into Analytics Plus according to the settings provided.

You can provide any number of SQL SELECT queries to execute. Each query is to be provided in a <Query> <Query> XML element. Multiple queries can be grouped within the <Queries> <Queries> element.

The following screenshot illustrates a sample SQL SELECT queries in the database_sql_queries.xml file.


The above illustrated queries will fetch data from two tables and import the same into Analytics Plus reporting database ReportsDBName1

Data from the local_db_table1 will be appended into ReportsTableName1 in Analytics Plus. And data from local_db_table2, where the employee number is less than 1000, will replace the existing data inReportsTableName2.

The following is the SQL SELECT query format to be followed to fetch data from your relational database.

<Query dbname="Analytics_Plus_dbname" tablename="Analytics_Plustablename" importtype="APPEND / TRUNCATEADD / UPDATEADD" matchingcols="matching_cols_for_updateadd" selectcols="columns_to_import_from_csv" skiptop="number_of_rows_to_be_skipped"batchsize="number of lines to send per request" queuesize="number of temporary files can be created at a time">sql_query_ to_be_executed</Query>

Make sure that the 'dbname' mentioned in the query is already created in Analytics Plus. 

Save the file once the queries and details are updated.

4. Execute the Uploadfromdb:

      Once both the files are updated, Open a Command prompt and access the location <Uploadtool>\bin\.

      Execute the batch file UploadFromDB.bat with the below parameters.

Example: <UploadTool>\AnalyticsPlus\UploadTool>UploadFromDB.bat localhost 443 admin123

 "Usage  : UploadFromDB.bat [Analyticsplus-host] [Analyticsplus-port] [userEmailAddress] [<-A authtoken>/<password>] [-D dbowner]"
" UploadFromDB.bat <Analyticsplus-host> <Analyticsplus-port> <userEmailAddress> <password>"
" UploadFromDB.bat <Analyticsplus-host> <Analyticsplus-port> <userEmailAddress> <password> -D <dbowner>"     (If uploading to a shared DB, provide DB owners email ID under 'dbowner')
" UploadFromDB.bat <Analyticsplus-host> <Analyticsplus-port> <userEmailAddress> -A <authtoken>"
" UploadFromDB.bat <Analyticsplus-host> <Analyticsplus-port> <userEmailAddress> -A <authtoken> -D <dbowner>"

Once the above batch file is executed, the data will be fetched from local database and will be uploaded to Analytics Plus DB and will be shown a success message as below.

Note: For each DB type the parameters updated in the database_connection_params.conf, differs. Please refer this link to get the right set of parameters.

        New to ADManager Plus?

          New to ADSelfService Plus?

            • Related Articles

            • Analytics Plus Inventory

              Aim: To have the detailed list of all the Reports, Databases created in Analytics  Open Local & Cloud Databases and fill the entries password = Postgres and if any error occurs stating something like "check the DB connection" change the Port to ...
            • Move Analytics Plus from one Server/folder

              Go to Start --> Services.msc and stop the ManageEngine Analytics Plus service. Take a backup of the entire <Analytics Plus_Home> directory and then move it to the new server.  On the new server, navigate to (similar path) <Analytics Plus_Home>\bin ...
            • How to generate and upload log in Service Desk Plus

              On a few occasion, we need logs from your ServiceDesk Plus to narrow down of our analysis and filter out the root cause.  Here is how you can send the detailed logs to our Support team 1.  Navigate to the ServiceDesk Plus installation folder. 2. Go ...
            • How to pull the attachment information of all the users from Servicedesk plus to Analytics plus ?.

              If you are looking to import the information for the attachment of the user module as shown below, Sample imported table in the Analytics plus UI: Then, please follow the below instructions: 1. Login to your Analytics Plus and go-to your ServiceDesk ...
            • How do I create and upload Analytics Plus log file to support team?

              Logs are collected for detailed analysis which doesn't hold up personal info. So, it is completely safe to generate one and upload. Here is how you can generate a log and upload it to the support team 1. Click on help and choose "Product info" 2. ...