Back

Topic

[KB272]FAQ Dream Report

Tags: Dream Report

14 years ago
By RM
Options
Print

Contents :
  1. Web Portal – PHP.ini configuration
  2. Configuration of Remote DSN
  3. Schedule Backup of MS SQL server DB
  4. Setup proper permission for Web folder in DR.
  5. Report Settings – Macro definition for MS Access
  6. Proper Fonts usage in Dream Report
  7. Path length limitation in ODBC DSN to DB
  8. Redundancy in DR
  9. DB size limit in DR
  10. How to configure Date time format to be used in SQL or in SQC?
  11. MySQL Connection Timeout
  12. Feb 2007 cumulative time zone update for Microsoft Windows OS’s
  13. PHP – CGI error in Web – W2K3 Server
  14. SQL compatibility
  15. How far Dream Report fits with secured network environments, in particular for web accesses based on https.
  16. When I’m storing the data into SQL server DB tables are created, but no data is stored.
  17. Logger Init failed message in DRT on project start up.
  18. Dream Report SQL Table parsing.
  19. Determine how many Tags have been used in a project
  20. What happens if a Report or Project exceeds the licensed Tag count?
  21. PHP manual configuration!

Question:

Web Portal – PHP.ini configuration

In the DR Web portal I’m getting strange messages: “Notice…”

Answer:

During DR installation we are installing PHP component, it requires distribution of php.ini into Windows directory. If on the computer PHP was already installed php.ini won’t be overwritten. So in order to resolve that problem you have to modify php.ini manually: Go to Window directory, find and open it. In side you’ll find “Error handling and logging” section. As a parameter put:
error_reporting  =  E_ALL & ~E_NOTICE & ~E_STRICT
Then save it and restart DR web portal.


Question:

Configuration of Remote DSN

How to configure the DSN for remote SQL server?

Answer:

  1. You have to ensure that TCP/IP connection is enabled on SQL server and remote
    access to SQL server configured well. For Example port 1433 is open in firewall
    and router properly set. (See your System Administrator for more details)
  2. See movie “DR_To_SQL_Tutorial” located in the same directory as FAQ

Question:

Schedule Backup of MS SQL server DB

How to schedule backups for my SQL 2005 Express DR Data Base?

Answer:

  1. You have to ensure that you have administrative rights to access SQL 2005 Express server
  2. Import the “expressmaint.sql” SQL script which is located in the same directory as FAQ to the SQL server.
  3. User script is the following:

exec expressmaint
@database      = ‘ALL_USER’,
@optype        = ‘DB’,
@backupfldr    = ‘<path>\backups’,
@reportfldr    = ‘<path>\BackupReport’,
@verify        = 1,
@dbretainunit  = ‘days’,

@dbretainval   = 1,

@rptretainunit = ‘days’,
@rptretainval  = 1,
@report        = 1

Save this script with SQL extension

4. Create a bat file which launches user script as follows:
SQLCMD.EXE -S . -i “<path>\userfullbackup.sql”

5.  Create a fake report in DR, schedule execution time of it according your needs and
in Report Settings define macro that executes bat file from p.4.


Question:

Setup proper permission for Web folder in DR.

How to set permission for Web folder in order to ensure proper report generation from
Dream Report Web portal?

Answer:

In case of generation problem using the web portal, you have to make sure the
web folder of the project has read/write permissions for everyone.
So, if you right click the web folder of the project, then choose properties from
context menu. The folder properties dialog will be opened; you should have a
security tab. If you don’t, it means that you are either using a FAT32 partition, or
that you are using Simple Sharing mode. To switch from simple sharing mode to
regular one, from Windows Explorer, go to the tools menu, then Folder options,
go to the second tab (View), then uncheck the last check box of the advanced
properties as shown in the screen shot below:

FAQ_DR1

If you are using a FAT32 partition, there are no security settings, so the problem
is somewhere else and might be more complex. Please contact Support to resolve
this issue.
So once you have the security tab available, make sure you have an entry
“IUSR_<computer name>” with modify or full control setting. If you don’t, then
add a new user to the list and give it read/write access by either checking
“modify” or “full control” as shown in the screenshot below:

FAQ_DR2

In French, instead of typing “IUSR_<computer name>”, type “Tout le monde”
and similar to “IUSR_<computer name>” in other OS languages.
Then it should be ok.
Just to summarize:

1 – Right Click the Web folder
2 – Properties -> Security
3 – Add “IUSR_<computer name>” with modify access


Question:

Report Settings – Macro definition for MS Access

How to define macro in DR report setting in order to be able to launch and execute MS
Access Macro?

Answer:

Create Macro in DR Report as follow: MACC:”<Path> MACC:”<Path> MACC:”<Path> MACC:”<Path>\\\\<DB_Name.mdb>”:<Macro_Name> <DB_Name.mdb>”:<Macro_Name> <DB_Name.mdb>”:<Macro_Name> <DB_Name.mdb>”:<Macro_Name>
Importance! It is on user responsibility to ensure that MS Access macro will not include some
popup messages or stuff that can block continues execution of the Macro. All this due to the fact
that DR Runtime will wait until macro will be completely executed and then will execute next
tasks.


Question:

Proper Fonts usage in Dream Report

Instead getting correct character set while adding text to DR Report, I’m getting strange
characters. How to fix this problem?

Answer:

By default DR is set to Arial (European) characters set. Please select instead of this one
character set without any extension.


Question:

Path length limitation in ODBC DSN to DB

Each time I’m trying to run DRT.exe or generate report from DRT.exe it will ask me to
specify DSN for DR DB?

Answer:

The problem can be linked to the fact that path to your Project Database folder is longer
then 128 characters. ODBC has limited path length to specify where DB is located.
Solution is following: please move your project to directory so, that patch length will be
shorter then 128 characters.


Question:

Redundancy in DR

How DR can work in redundancy mode.

Answer:

  • Put the same project on Master and Backup machines (nodes/servers).
  • Configure both projects to record data in the same database. Driver name and
    item names will be the same, so it will write in the same table.
  • Define a special flag (data point) on your server, which will tell to Dream Report
    logger if Master machine is active or not. Define log group so it will record data
    on condition when master station is active and status flag is raised to 1.
  • On Backup Dream Report project you can define so, that groups will log data
    only under condition that backup flag has a value, corresponding to the status
    when master is not active. So, only one station at a time will record data into a
    common database. Regarding redundancy in the web portal, we can see only indirect solutions, like:
    to define one alias like http://localhost/DRmaster and http://localhost/DRbackup
    on the same web server machine, but configured on remote master and backup
    machines. So, if http://localhost/DRmaster page will be unavailable, it will be
    redirected to a backup machine.

Question:

DB size limit in DR

When I configure database limit, if I have a database that exceed these settings (eg
2Gbyte), what’s happened with new data values? Will it be stored?

Answer:

If database limit is reached – new data should be recorded and appropriate amount of old
data will be deleted (FIFO).


Question:

How to configure Date time format to be used in SQL or
in SQC?

I’m using MS SQL server. I would like to use in SQC or in SQL tables as condition
calculated Time stamps for start time and end time.

Answer:

For MS SQL server you can use the following conversion function CONVERT:
Syntax for CONVERT:
CONVERT ( data_type [ ( length ) ] , expression [ , style ] )
Where:
expression – Is any valid expression.
data_type – Is the target system-supplied data type. This includes xml, bigint, and
sql_variant. Alias data types cannot be used. For more information about available data
types, see Data Types (Transact-SQL).
style – Is the style of the date format used to convert datetime or smalldatetime data to
character data (nchar, nvarchar, char, varchar, nchar, or nvarchar data types), or to
convert character data of known date or time formats to datetime or smalldatetime data;
or the string format used to convert float, real, money, or smallmoney data to character
data (nchar, nvarchar, char, varchar, nchar, or nvarchar data types). When style is NULL,
the result returned is also NULL.

The styles listed in this topic are supported by SQL Server in the described combinations
with CONVERT target data types. All other styles and combinations are not supported.
Do not use any unsupported styles. Using an unsupported style or an unsupported
combination of style and target data type might return an error or unreliable results.
These results are not guaranteed across releases of SQL Server.

SQL Server supports the date format in Arabic style by using the Kuwaiti algorithm.
In the following table, the two columns on the left represent the style values for
converting datetime or smalldatetime data to character data. Add 100 to a style value to
obtain a four-place year that includes the century (yyyy).

FAQ_DR3

1. These style values return nondeterministic results. Includes all (yy) (without century) styles and a
subset of (yyyy) (with century) styles.
2. The default values (style 0 or 100, 9 or 109, 13 or 113, 20 or 120, and 21 or 121) always return
the century (yyyy).
3. Input when you convert to datetime; output when you convert to character data.
4. Designed for XML use. For conversion from datetime or smalldatetime to character data, the
output format is as described in the previous table.
5. Hijri is a calendar system with several variations. SQL Server 2005 uses the Kuwaiti algorithm.

By default, SQL Server interprets two-digit years based on a cutoff year of 2049. That is,
the two-digit year 49 is interpreted as 2049 and the two-digit year 50 is interpreted as
1950. Many client applications, such as those based on Automation objects, use a cutoff
year of 2030. SQL Server provides the two digit year cutoff configuration option that
changes the cutoff year used by SQL Server and allows for the consistent treatment of
dates. We recommend specifying four-digit years

6. Only supported when casting from character data to datetime or smalldatetime. When character
data that represents only date or only time components is cast to the datetime or smalldatetime data types, the unspecified time component is set to 00:00:00.000, and the unspecified date
component is set to 1900-01-01.
7. The optional time zone indicator, Z, is used to make it easier to map XML datetime values that
have time zone information to SQL Server datetime values that have no time zone. Z is the
indicator for time zone UTC-0. Other time zones are indicated with HH:MM offset in the + or –
direction. For example: 2006-12-12T23:45:12-08:00.
When you convert to character data from smalldatetime, the styles that include seconds or
milliseconds show zeros in these positions. You can truncate unwanted date parts when you
convert from datetime or smalldatetime values by using an appropriate char or varchar data
type length.

Example of SQL Query in Dream Report SQL table:
SELECT Batch_T, End_TS FROM Batch_ID WHERE (End_TS BETWEEN
CONVERT(DATETIME, [f#StartTime_Last_Batch], 105) AND
CONVERT(DATETIME, [f#EndTime_Last_Batch], 105))


Question:

MySQL Connection Timeout

After couple of hours Dream Report starts to generate report without values. All values
are N/A. However all data from Dream Report logger data and alarm groups continue to
be writing properly onto the MySQL DB.

Answer:

By Default MySQL connection time out is limited to 8 hours. After this time while trying
to generate report you will get error message in Dream report log file: “MySQL server
gone away”. That time out can be increased. Open “my.ini” file that usually located in
“C:\Program Files\MySQL\MySQL Server 5.0” and add additional parameter:
wait_timeout=130000 this is correspond to 48 hours connection time out. DR run time
engine is reinitializing connection with MySQL server each 24 hours.


Question:

Feb 2007 cumulative time zone update for Microsoft
Windows OS’s

While generation of report from Web dynamic report generation page, I’m getting values
shifted in time. My time zone is “GMT+2:00 Jerusalem”

Answer:

Starting in the spring of 2007, daylight saving time (DST) start and end dates for the
United States will transition to comply with the Energy Policy Act of 2005. DST dates in
the United States will start three weeks earlier, at 2:00 A.M. on the second Sunday in
March. DST will end one week later, at 2:00 A.M. on the first Sunday in November.

The update that this article describes changes the time zone data to account for the DST change for the United States. This update also includes other DST-related changes, time
zone-related changes, and settings-related changes. Some of these changes will occur in
2007. Some of these changes have occurred since the products that are listed in the
“Applies To” section were originally released. February 2007 cumulative time zone
update for Microsoft Windows operating systems can be found at:
http://support.microsoft.com/kb/931836


Question:

PHP – CGI error in Web – W2K3 Server

I’ve dream Report installed on Windows 2003 Server. In DR web portal I’m getting CGI
error while starting web portal

Answer:

Problem occurs due to security reason. Some times in addition to proper security settings
set for Web portal directory it is necessary to provide same level of authorization to php
folder. See question “Setup proper permission for Web folder in DR.”


Question:

SQL compatibility

When I’m trying to use SQL query in Dream Report Single Data object it appears NA in
final PDF file, however if I’m checking DB there is value correspond to this query.

Answer:

It could be that database configured so it will compatible with SQL server version which
is lower then 8.0. In this case all you need to do is to go to DB properties and change
compatibility of DB to 8.0 or higher.

FAQ_DR4

FAQ_DR5


Question:

How far Dream Report fits with secured network
environments, in particular for web accesses based on https.

How far Dream Report fits with secured network environments, in particular for web
accesses based on https.
How can I secure the http accesses with Dream Report?
Does Dream Report support https?
Does Dream Report support SSL certificates?

Answer:

By default, the web portal is accessible using the following URL:
http://DreamReportHostName/DRWeb where DreamReportHostName is the name or IP
address of the server running the Dream Report runtime.
This URL denotes the use of http, so a communication channel without special security
concerns about the identification/authentication of the server, and no data encryption
(except if the channel is opened over a VPN or another special mechanism).

The following procedure describes steps to secure the communication channel between
the web portal server and the client by setting up:

–    An SSL certificate on the server (to allow clients to authenticate the server
they connect to).
–    Data encryption on the channel.

Setting up IIS for the use of SSL
Step 1
Install the SSL certificate on your IIS server (contact your system administrator for more
information). Such a certificate must be issued by a trusted third party, and therefore can
not be supplied directly by Arc Informatique / Ocean Data System.

Step 2
Launch the IIS Administration console.
Deploy the tree view and right click on the node Default Web site.

FAQ_DR6

Open the Default Web Site properties, and go to the Directory security tab.

FAQ_DR7

Click on the Display button to check the SSL certificate.

FAQ_DR8

Note:
On this example, the SSL certificate has been self issued for a host named Arc5. It
is valid from 21/11/2007 to 28/11/2007. This certificate will not be trusted by any
usual web browsers such as Internet Explorer, FireFox or Opera because it has
not been issued by a trusted third party.

Step 3:
Close the SSL certificate display dialog box and click the Modify button to change SSL
settings.

FAQ_DR9

In this example, we have activated:
–    The use of SSL for server authentication
–    Data encryption on the channel

Depending on your security constraints you may also activate client certificates usage
(contact your system administrator for more information).
Note:
Depending on the list and settings of existing virtual directories, you may be
required to validate the changes for some existing objects (inheritance mechanism
of IIS).

Validate and close the IIS Administration console.

All settings in this tutorial are done based on IIS 6.0, that runs on Windows 2003 Server
and on Vista, however similar settings can be applied for IIS 5.x for Windows 2000 Pro
and Server as well as for Windows XP Professional.
IIS Versions that are newer then IIS 6.0 weren’t validated at moment of release of this
document.

Step 4:
Launch Dream Studio and open your project.
Go to the menu Project settings. Web Configuration Select the remote station.
Change http to https. If necessary, change Alias name, Station name and URL.
Click on Modify and then the OK button to validate changes.

FAQ_DR10

Save the project and launch the Dream Report Runtime.
Step 5:
At startup, Dream Report Runtime creates or recreates the virtual directory using the
Default Web Site configuration

FAQ_DR11

The Web Portal is now accessible using the https URL and data are encrypted on the
https channel.

FAQ_DR12

Note 1:
On the screenshot, a certificate error is mentioned because the certificate is self
issued, not trusted by Internet Explorer. This would not happen with an SSL
certificate issued by a trusted third party. In that case also, Internet Explorer
displays a warning page explaining that the server should not be trusted because
of the non-trustfull certificate issuer, and the fact that the certificate has been
issued for a server named Arc5, and the URL mention a hostname named
localhost. Validating this error forces Internet Explorer to exchange data with
such a server anyway, and therefore display the Web Portal pages.
Note 2:
Be careful to the fact that any virtual directory created using Default Web Site
properties will use the same SSL settings. It is usually the case when securing a
web server (There are no reason for securing a given virtual directory and not the
others).


Question:

When I’m storing the data into SQL server DB tables are
created, but no data is stored.

I’m using localized MS SQL server on OS different from English. When I’m trying to
store the data in SQL server my data is not recorded, however I see that Tables are
created in DB.

Answer:

There could be 2 reasons for this kind of behavior:
1.  It name could include some specific symbols that are not supported by naming convention of SQL server. Usually we take care about this case by replacing the
specific symbols by “_” while writing into DB, however it can be that some
symbols are not in our “black list”. In that case please verify that your issue isn’t
corresponding to p.2 below and then contact us to report your problem.
2.  DSN is configured to default language of OS. If it is the case please during
definition of DSN change it to English. See screen shot below:

FAQ_DR13


Question:

Logger Init failed message in DRT on project start up.

After start up of Dream Report project in DRT I’m getting message: “Logger Init Failed”.
What should I do in order to avoid this message to be occurred?

Answer:

If you received “Logger Init Failed” message it means that DRT is not able to connect to
the DB server (Ms SQL or MySQL etc.). Please ensure:
1.  That you provide proper connection string in Dream Report Project settings DB
definition part
2.  That your DB server is up and running
3.  Check proper definition of DSN.


Question:

Dream Report SQL Table parsing.

After I do “copy/paste” for SQL query that I designed in SQL Management studio into
Dream Report SQL Table my columns are not recognized properly?

Answer:

Dream Report SQL table parser doesn’t supports “carriage return” and “tab” between
entries. So for example following query:
SELECT [TS]
,[Value]
,[Description]
,[Domain]
,[Chrono]
FROM [TRENDTABLE1]
WHERE [Chrono]>= [dbo].[fn_GetFiletimeFromDatetime]
(CONVERT(Datetime,’2008-03-06 11:12:13′,121))
Has to be inserted as:
SELECT [TS] ,[Value] ,[Description] ,[Domain] ,[Chrono] FROM
[TRENDTABLE1] WHERE [Chrono]>= [dbo].[fn_GetFiletimeFromDatetime]
(CONVERT(Datetime,’2008-03-06 11:12:13′,121))


Question:

Determine how many Tags have been used in a project

How can I determine how many Tags have been used in a Project or on a Report?  I don’t
think the number of objects indicated on a Report in the lower left corner of Dream
Report Designer Studio directly corresponds to the number of Tags used?

Answer:

The only indication is a number, displayed in a status bar in bottom left part of the studio.
There is one known issue here – when you add tags, remove, add again – sometimes it’s
not refreshed. Then, when you close studio and open it again – the used tags number will
be correct.


Question:

What happens if a Report or Project exceeds the
licensed Tag count?

What happens if a Report or Project exceeds the licensed Tag count?

Answer:

Tags are counted in a license not by report, but per project. If tag number is exceeded –
you can still edit your project in a studio, but not add new items and as soon as you
launch runtime – it will be closed right after launching.


Question:

PHP manual configuration!

I installed Dream Report on a new OS. I am trying to run the web portal but I receive the
page with some html code. What should I do?

Answer:

This situation may happen when OS or IIS is blocking script execution from while Dream
Report Installer tries to configure php settings. In order to fix this issue user can
configure manually settings of IIS:
Please make sure that .php extension is defined and configured properly:

FAQ_DR14

If it is not the case so please declare it by adding a new extension from “Application
Configuration” dialog above:

FAQ_DR15

This part is applied for Windows 2003 Server. Verify that this Web service extension is
allowed:

FAQ_DR16


 

 

Created on: 17 Dec 2010 Last update: 20 Nov 2024