Siplace Pro Fses

Installation/Service
SIPLACE Pro 1.0A

Installationsanleitung
RO
Für Servicetechniker
Installation Manual
For Service Engineers
03/99
Installationsanleitung für SIPLACE Pro 1.0A
UNIX is a registered trademark of AT&T

X-Windows is a trademark
Microsoft and MS-DOS are registered trademarks of Microsoft Corporation
Microsoft Windows is registered trademark of Microsoft Corporation
(The reproduction, transmission or use of this (We have checked the contents of the printed documentation to
document or its contents is not permitted without ensure that is in agreement with the hardware and software
express written authority. described therein. However, since discre-pancies cannot be
Offenders will be liable for damages. All rights, ruled out, we cannot assume responsibility for complete
including rights created by patent grant or agreement.
registration of a utility model or design, are the information given in this printed documentation is however
reserved.) regulary reviewed and necessary corrections included in
subsequent editions. We would appreciate any suggestions for
improvements.)
Siemens AG 1999 All rights reserved Subject to change without prior notice
Item-No.: 00191461-02 Siemens Aktiengesellschaft
UNIX ist ein Warenzeichen von AT&T

X-Windows ist ein Warenzeichen
Microsoft und MS-DOS sind eingetragene Warenzeichen von Microsoft Corporation
Microsoft Windows ist ein eingetragenes Warenzeichen von Microsoft Corporation
(Weitergabe sowie Vervielfältigung dieser (Wir haben den Inhalt der Druckschrift auf Übereinstimmung
Unterlage, Verwertung und Mitteilung ihres mit der beschriebenen
Inhalts sind nicht gestattet, soweit nicht Hard- und Software geprüft. Dennoch können Abweichungen
ausdrücklich zugestanden. nicht ausgeschlossen
Zuwiderhandlungen verpflichten zu werden, so daß wir für die vollständige Übereinstimmung keine
Schadenersatz. Alle Rechte vorbehalten, insbe- Gewähr übernehmen.
sondere für den Fall der Patenterteilung oder Die Angaben in dieser Druckschrift werden jedoch regelmäßig
GM-Eintragung.) überprüft und notwendi-
ge Korrekturen sind in den nachfolgenden Auflagen enthalten.
Für Verbesserungsvor-
schläge sind wir dankbar.)
Siemens AG 1999 All rights reserved Technische Änderungen vorbehalten
Artikel-Nr.: 00191461-01 Siemens Aktiengesellschaft
I-2
Installation Manual for Service Engineers SIPLACE Pro 1.0A
Table of Contents
0 INTRODUCTION.................................................................................................. I-3
0.1 PURPOSE OF THIS DOCUMENT ............................................................................................... I-3
0.2 EDITOR’S NOTE .................................................................................................................... I-3
1 CHECKING CORRECT INSTALLATION .................................................................... I-4
2 TROUBLESHOOTING........................................................................................... I-6
2.1 SOURCES OF INFORMATION FOR TROUBLESHOOTING .............................................................. I-6
2.1.1 The SIPLACE Pro installation log ............................................................................... I-6
2.1.2 The MS SQL Server 7 installation log......................................................................... I-6
2.1.3 The NT event log......................................................................................................... I-6
2.1.4 The MS SQL Server error log ..................................................................................... I-7
2.2 W AS THE INSTALLATION SUCCESSFUL? .................................................................................. I-7

2.2.1 SIPLACE Pro installation check.................................................................................. I-7
2.2.2 MS SQL Server 7 installation check ........................................................................... I-7
2.2.3 MS SQL Server 6.5 installation check ........................................................................ I-8
2.2.4 Possible causes of errors............................................................................................ I-8
2.3 FUNCTIONAL CHECK OF THE MS SQL SERVER ...................................................................... I-9

2.3.1 MS SQL Server 6.5..................................................................................................... I-9
2.3.2 MS SQL Server 7 ...................................................................................................... I-10
2.3.3 Troubleshooting ........................................................................................................ I-10
2.4 FUNCTIONAL CHECK OF SIPLACE PRO SERVER .................................................................. I-11

2.4.1 Is the component running? ....................................................................................... I-11
2.4.2 Did runtime errors occur? ......................................................................................... I-13
2.4.3 Manual registration of executable files ..................................................................... I-15
2.4.3.1 On the computer on which SIPLACE Pro Server should run:............................... I-15
2.4.3.2 On all computers on which SIPLACE Pro Desk should run:................................. I-17
2.5 THE SIPLACE PRO REGISTRY ........................................................................................... I-19
2.6 THE ODBC CONFIGURATION ............................................................................................... I-26

2.6.1 Opening the ODBC Data Source Administrator........................................................ I-26
I-1
2.6.2 Configuring the System DSN .................................................................................... I-27

2.6.3 Error Message „ The System-DNS „Local Server“ fehlt in der
ODBC-Konfiguration ................................................................................................. I-32
3 REINSTALLING THE SQL SERVER ..................................................................... I-33
3.1 MICROSOFT SQL SERVER 7.0 ............................................................................................ I-35
I-2
0 Introduction
0.1 Purpose of this document
This paper contains essential information for Siemens service engineers for trou-
bleshooting the SIPLACE Pro system during installation and operation. It also is
intended to serve as the foundation for creating the official instructions for service
technicians.
Please note that a document of this type can never be “complete”. When trouble-
shooting, a service technician will always have to be somewhat creative. The
author hopes that these efforts will be successful J.
0.2 Editor’s note
You can operate SIPLACE Pro with two versions of the the Microsoft SQL Server
DBMS (database management system):
− Version 6.5 with Service Pack 5a
− Version 7
In this document, the version number is not specified only in cases where the in-
formation applies for both versions. If the DBMS version is mentioned, the infor-
mation applies only to the version specifically stated.
I-3
1 Checking correct installation
The easiest way to check that the system was installed correctly is to start the in-
stalled components, i.e. perform a function test.
To perform the function test, start the following components in the indicated order
or make sure that they are already running:
− MS SQL Server
− SIPLACE Pro Server
− SIPLACE Pro Desk
For the server components, select Start/Settings/Control

Panel/Services and check that status for the services “MSSQLServer” and
“SIPLACE Pro Server” (keep in mind that these entries only exist if the respective
services have been installed on the computer). For the SIPLACE Pro Desk, you
activate its icon on the desktop or in Start\Programs\Siemens SIPLACE.
The function test is successful if the SIPLACE Pro Desk finds the SIPLACE Pro
Server and establishes a connection to it. After its start, SIPLACE Pro Desk indi-
cates a successful connection by displaying the following dialog (note the infor-
mation in the title bar):
Fig. 1: “SIPLACE Pro” Start Dialog
I-4
The dialog box disappears automatically after a short period.
In some cases, the SIPLACE Pro Server may be slow to accept the connection
with a client. If this happens, the title bar of the above SIPLACE Pro Desk dialog
box will say “SIPLACE Pro Server was not found on ....”, just like it does when the
start fails. The dialog will not close automatically in this case.
Before you start to look for an error, wait a little and then click on “Change
Server…”. Confirm the dialog that appears with OK. The system will start another
attempt to set up a connection with the server shown in the dialog box.
I-5
2 Troubleshooting
If the function test fails, you should first check if the installation was performed
correctly. Next, check if each system component runs properly or if any errors
occurred.
2.1 Sources of information for troubleshooting
2.1.1 The SIPLACE Pro installation log
During its installation, the file setup.log is created in the SIPLACE Pro pro-
gram folder. This file contains a log of the most recent installation. Additional files
with the name(s) setup_<n>.log (with <n> being a running number) contain
the logs of prior installations. The file with the highest running number, for exam-
ple, contains the log for the installation before the last one, etc.
2.1.2 The MS SQL Server 7 installation log
When you install MS SQL Server 7, the setup program creates several log files:
− C:\WinNT\setup.log
− C:\WinNT\setupsql.log
− C:\WinNT\*.iss
These files may provide troubleshooting clues if the installation of MS SQL

Server 7 has failed. Before you attempt to install the program again, you should
back up these files and send them to the SIPLACE Pro development team for
examination and to correct possible bugs in the automatic install program for MS
SQL Server 7.
2.1.3 The NT event log
With Start/Programs/Administrative Tools (Common)/Event View-

er you can open the window NT event log. In the Log menu, open the applica-
tion log. Under the source “MSSQLServer” you will see the log entries of the SQL
Server, under “SIPLACE Pro” the entries of the SIPLACE Pro Server.
The most recent entries are at the top of the event log. Pay special attention to
error entries that are marked with a “STOP” sign.
I-6
2.1.4 The MS SQL Server error log
The program directory for the MS SQL Server (default: “c:\mssql65" bzw.
"c:\mssql7") contains in its subdirectory “log” the file “Errorlog” that contains the
current error log for the MS SQL Server. Additional “Errorlog_<n>” files where
<n> is a running number contain previous error logs.
Every time SQL Server starts it creates a new error log. Up to six log old logs can
be stored.
The MS SQL Server error log shows the most recent entries at the bottom of the
list.
2.2 Was the installation successful?
2.2.1 SIPLACE Pro installation check
Based on the files mentioned in Section 2.1.1, "The SIPLACE Pro installation",
you can check if the installation of SIPLACE Pro was performed successfully.
− The message “Setup successfully completed” at the end of the log indicates a
successful installation. If this entry is missing, check the log from the bottom
up for error messages. How to respond to individual errors goes beyond the
scope of this document.
− After the line with the entry “User information” follows a list with the information
that was entered in the installation dialogs. It is important that you check the
selected components. A non-functioning system can also be caused by an in-
complete selection of components to be installed.
It is recommended to first uninstall the system and then perform the

installation again with special care. It is possible that a procedural er-
ror was made during the first installation.
2.2.2 MS SQL Server 7 installation check
The correct installation of MS SQL Server 7 can be checked in several steps:
− After a successful installation, the file C:\WinNT\setup.log must have the

following entries:
[InstallShield Silent]
Version=v5.00.000
File=Log File
[Application]
Name=Microsoft SQL Server 7.0
Version=7.00.000
I-7
Company=Microsoft
[Status]
Completed=1
RebootRequired=0
[ResponseResult]
ResultCode=0
The value for RebootRequired can also be "1".
− Under Start Menu/Settings/Services, there must be entries for the

services MSSQLServer and SQLServerAgent.
− Under Start Menu\Programs you must see a submenu named Micro-

soft SQL Server 7.
It is possible that the Start menu was not automatically updated after the in-
stallation and does not show this entry or shows only an empty submenu. In
that case, you can check the folder C:\WINNT\Profiles\All Users\-
Start Menu\Programs\Microsoft SQL Server 7.0 that is the basis
for the start menu and contains all shortcuts.
− The Registry must contain the key HKEY_LOCAL_MACHINE\SOFTWARE\-

Microsoft\MSSQLServer\MSSQLServer\CurrentVersion with the
value CurrentVersion="7.00.623". This value corresponds to the re-
lease version of the system.
2.2.3 MS SQL Server 6.5 installation check
The correct installation of MS SQL Server 6.5 can be checked in several steps:
− Under Start Menu/Settings/Services there must be entries for the

services MSSQLServer and SQLExecutive.
− Under Start Menu\Programs there must be a Microsoft SQL

Server 6.5 submenu.
− The Registry must contain the key HKEY_LOCAL_MACHINE\SOFTWARE\-

Microsoft\MSSQLServer\MSSQLServer\CurrentVersion with the
value CurrentVersion="6.50.416". This value corresponds to the sys-
tem’s Service Pack 5a.
2.2.4 Possible causes of errors
While in no way complete, the following list contains some possible causes for
failed installations.
− Insufficient access rights for the disk on which the software should be in-
stalled. This is possible even if the local administrator performing the installa-
tion has local Administrator rights. The error exhibits itself when either file
I-8
cannot be written during the installation or when a service was installed but
cannot be started. If it is the second case, you can check by trying to start the
service manually.
In both cases, you may be able to correct the problem by explicitly giving the
local Administrator as well as the user SYSTEM full access rights to the disk.
− The computer may not have a configured network card. This prevents a suc-
cessful installation of MS SQL Server since it requires a functioning TCP/IP. If
it is not possible to configure a real network card to solve the problem, pro-
ceed as follows:
• In "Control Panel/Network/Adapter", configure the "MS Loopback

Adapter".
The "MS Loopback Adapter" is software simulation of a network adapter.
• In "Control Panel/Network/Protocols/TCP/IP" configure the IP

address as 192.168.1.1 and the subnet mask as
255.255.255.0.
Both the IP address and the subnet mask must have these addresses exactly!
2.3 Functional check of the MS SQL Server
2.3.1 MS SQL Server 6.5
On the computer on which SQL Server should be running, select

Start/Programs/Microsoft SQL Server 6.5/SQL Service Manager
and check if for the entry “MSSQLServer” a green light is displayed that indicates
“Started” status. If yes, check the next component.
Fig. 2: “MS SQL Service Manager” Dialog
I-9
2.3.2 MS SQL Server 7
On the computer on which SQL Server is supposed to run, open Start

Menu/Programs/Microsoft SQL Server 7/Service Manager and check
if the entry "MSSQLServer" is shown as "Started" by a green arrow or by the text
in the status bar at the bottom of the dialog box. If yes, check the next compo-
nent.
Fig. 3: Dialog box for “SQL Service Manager” Version 7
2.3.3 Troubleshooting
− Configuration error?
After you open Start/Settings/Control Panel/Services for the entry
“MSSQLServer”, click on “Startup…” and make sure that the settings are as
follows:
I-10
Fig. 4: “Services for the Entry” Dialog
If your settings are different, change them to the above settings and try to
carry out the complete function test again.
− Check the same settings for the service SQLServerAgent (MS SQL
Server 7) or SQLExecutive (MS SQL Server 6.5).
− Runtime error during startup?

Check if the event log contains error entries for the SQL Server. Such entries
are marked with a “STOP” sign.
Also check the SQL Server error log for error messages.
The correction of such errors depends on their nature. Check the documenta-
tion with Start/Programs/Microsoft SQLServer 6.5/SQLServer
Online Documentation or consult an experienced database administrator.
2.4 Functional check of SIPLACE Pro Server
2.4.1 Is the component running?
On the computer on which SIPLACE Pro should be running, select

Start/Programs/Control Panel/Services and check if “SiplacePro-
Server” is shown as “Started”. If yes, check the next error source for this service
(see “Runtime error”).
I-11
Fig. 5: “Control Panel/Services” Dialog
Troubleshooting
It is highly likely that a runtime error occurred during the start that caused the
service to terminate immediately. Perform the following checks:
− Check the NT event log for any recent error entries for the SIPLACE Pro
Server. Such entries are marked with a “STOP” sign.
− If you find any such errors, check if they are of the “Database” category. If yes,
they are runtime errors of the database system that you can troubleshoot with
database administration steps. Typical errors of this nature are described be-
low.
− Error entries with other categories are usually caused by system errors that
cannot be repaired locally.
The “Database” category errors generally contain an error message. The error
messages described below are not quoted literally but provide a general descrip-
tion of the error. The following are typical errors that prevent the SIPLACE Pro
Server from starting:
− Login failed
Check in the Registry and—with the help of the SQL Enterprise Manager—in
the configuration of the SQL Server login if it contains the correct login infor-
mation (see the description of the Registry).
− Open failed - Specified SQL server not found

Either the ODBC configuration is not correct (see description of the ODBC
configuration) or the MS SQL Server is not running.
I-12
− Open failed - Version mismatch SIPLACE Pro Server / SIPLACE Pro Data-
base
The version of the SIPLACE Pro Server is not compatible with the database.
• Make sure that the SIPLACE Pro Server component and the SIPLACE Pro
Database component were installed from the same installation CD. If you
are not sure, repeat the installation.
− Open failed - insufficient access rights

During the installation of the database, the assignment of the access right
probably failed.
• Start the MS SQL Server query application with one of the following start
menu entries, depending on the version:
* Start Menu/Programs/Microsoft SQL Server 6.5/ISQL_w
* Start Menu/Programs/Microsoft SQL Server 7/Query Ana-

lyzer
Log in as "SIPLACEProDBA" with the password "DBA". Enter as the server
the computer name on which the SQL Server and the database have been
installed.
• Open the SQL script <SIPLACE Pro program directory>\-

DBSkripts\GrantAllToPublic.SQL and run it with Query/Run
query. Check for error messages and try to restart the SIPLACE Pro
Server.
2.4.2 Did runtime errors occur?
Runtime errors in SIPLACE Pro Server can interrupt the communication with the
SIPLACE Pro Desk or prevent SIPLACE Pro Server from writing entries made in
SIPLACE Pro Desk to the database.
Troubleshooting
− Open the Windows NT event log with Start/Programs/Administrative

Tools (Common)/Event Viewer and open the application log. Log entries
for SIPLACE Pro are marked with “SIPLACE Pro” as the source. Look for re-
cent error entries (marked with the “STOP” sign).
− If you find any such errors, check if they are of the “Database” category. If yes,
they are runtime errors of the database system that you can troubleshoot with
database administration steps. Typical errors of this nature are described be-
low.
− Error entries with other categories are usually caused by system errors that
cannot be repaired locally.
I-13
The “Database” category errors generally contain an error message. The error
messages described below are not quoted literally but provide a general descrip-
tion of the error. The following are typical errors that occur during the runtime of
the SIPLACE Pro Server and cause system errors:
− Invalid object name 'DBO.POBJECT'

The ODBC configuration is probably wrong with respect to the security proce-
dure used (“NT Authentication” instead of “SQL Server Authentication”).
• Check the ODBC configuration and make any necessary corrections (see
below).
− Duplicate key - table POBJECT, column OBJID

A known error has occurred in the MS SQL Server.
• Close the SIPLACE Pro Server MSSQLServer services and restart both.
This error can occur with MS SQL Server 6.5 in particular. Version 7 has dy-
namic file size management so that this type of error can occur only if the
system runs out of disk space. With this error, the object name shown is un-
important (“PICKUPPOSITION” in the example above). What is important is
the segment:
− "default": The database listed is full and must be increased with the help of the
SQL Server Enterprise Manager: Extend the database medium (or "device")
and them increase the database size. For detailed information about extend-
ing a database, consult the SQL Server online documentation, especially the
articles “Extending the database medium” and Increasing or decreasing data-
bases”.
• "syslogs": The transaction log of the indicated database is full.
* In the SQL Server Enterprise Manager, select the “SQLExecutive” and

check the following:
° Is the SQL Executive service active (green icon)?
° Did the database maintenance tasks “SiplacePro DailyMaintenance”

and “SiplacePro WeeklyMaintenance” run successfully?
° When did these tasks run last? The SQL Server computer must run at
night so that these tasks can be performed. This also applies to
weekends.
* Start the batch file <SIPLACE Pro-Programmverzeichnis>\-
DBSkripts\StartMaintenanceTasks.bat. Check in the task his-
tory of the SQL Server Enterprise Manager if the "SiplacePro Weekly
I-14
Maintenance" task ran successfully (it may run for several minutes, de-
pending on the size of the database). If errors occur, correct them (there
may be insufficient disk space for the backup files, for example) and re-
start the task. As soon as the task has run successfully, you will have
sufficient space again for the transaction log.
* If you cannot find the cause of the error with the above checks, increase
the storage area set aside for the transaction log. For details, check the
two online documentation articles mentioned above.
− Timeout
An access to the SQL Server could not be completed in the time configured.
The configuration is set in the SIPLACE Pro Registry with the value DBSet-
tings\QueryTimeoutSec (see description of the Registry).
• The timeout may have been caused by competing accesses of other data-
base applications. Stop and start the SIPLACE Pro Server and attempt the
failed action again.
• The timeout may also have been caused by unexpectedly high data vol-
ume. Increase the corresponding entry in the Registry and restart the
SIPLACE Pro Server.
− Other errors not mentioned

Check the contents of the error message and how you may respond to it.
As a first step, you can try to stop and restart the SIPLACE Pro Server and
SQL Server services to get them running again.
2.4.3 Manual registration of executable files
If the SIPLACE Pro Desk is unable to find the SIPLACE Pro Server, this may be
caused by a faulty registration of the server or the proxy DLL that is needed for
the communication. To perform the registration manually, proceed as follows:
2.4.3.1 On the computer on which SIPLACE Pro Server should run:

1. Open a command prompt window and switch to the SIPLACE Pro program di-
rectory.
2. Unregister the SIPLACE Pro Server with the command

SiplaceProServer /unregserver
3. Reregister the SIPLACE Pro Server with the command

SiplaceProServer /regserver
4. Modify the settings that were generated as a result of this call:
I-15
a) Run Start/Settings/Control Panel/Services, select the

“SIPLACE Pro Server” entry and click “Startup…” to make sure that the
settings are as follows:
Fig. 6: Control Panel/Services for SIPLACE Pro Server, “System Account”
b) If the Registry entry \SOFTWARE\Siemens SIPLACE\SIPLACE Pro

1.0\Server Settings\Security has the value “1”, make sure that a
valid NT account has been configured for the service (see lower part of the
following dialog box):
I-16
Fig. 7: Control Panel/Services for SIPLACE Pro Server, “This Account”
2.4.3.2 On all computers on which SIPLACE Pro Desk should run:

1. Open a command window and switch to the SIPLACE Pro program directory.
2. Register the proxy DLL with the call

regsvr32 SiplaceProServerPS.dll
I-17
I-18
2.5 The SIPLACE Pro Registry
In this section, the complete tree of Registry entries for SIPLACE Pro is listed. Explanations are provided for all entries that
may be modified by the Siemens service technician.
It is important that there are several instances of the described Registry hierarchy on the same computer:
− always under the root key HKEY_LOCAL_MACHINE
− always under the root key HKEY_CURRENT_USER for the user who installed SIPLACE Pro on the computer
− possibly also under the root key HKEY_CURRENT_USER for additional users who have used the SIPLACE Pro system.
Registry Key (Path) Registry Value Explanation

\SOFTWARE\Siemens SIPLACE\EasyInterface\User This key is used by the SIPLACE terminal software. It
contains the complete information about the user account
to be used when logging on to the NT domain.
"Domain"="DE_MCH_RM35A"
"Name"="easy"
"UserP"="***" The password is actually shown unencrypted—it has
been modified for this example.
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro\1.0A This key is added by the SIPLACE Pro setup. It has no
functional meaning for the SIPLACE Pro system.
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0 This key with all its subkeys is used by the SIPLACE Pro
system.
"CurrentUnit"=dword:00000000
I-19

"LCURootPath"="C:\\"
"CadWizardInputPath"="C:\\"
"LCUExportFormatVersion"=dword:00000192
"Use Display List"="Yes"
"DefaultFolder"="*"
"ControlBarSetOptimizedRedrawE-
nabled"=dword:00000000
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Custom Colors
"0"="219 255 191" Example of Registry values 0 through 15 in this Registry
key.
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\DBSettings This key contains all values that affect access by the
SIPLACE Pro Server to the database.
Any change of any of these values becomes effective only
after a restart of SIPLACE Pro Server.
"ODBC DatasourceName"="SiplaceProDB" This value must correspond to the name of the ODBC
data source (Datasourcename=DSN) that defines on
which MS SQL Server the SIPLACE Pro database will be
used.
I-20

"DatabaseOwner"="dbo" Prefix to be used for table names when formulating SQL
commands.
Example:
"SELECT * from dbo.POBJECT"
If conflicts occur on the customer’s SQL Server as a result
of ambiguities of “dbo” (visible through NT event log en-
tries), you can also specify the SQL-login with database
ownership rights. The default login is “SIPLACEProDBA”.
As the owner of the database, the SIPLACEProDBA login
has expanded user rights.
"Userid"="SIPLACEProUSR" The login name with which the SIPLACE Pro Server logs
in at the SQL Server for accessing the database. This
login has normal read/write user rights for tables and
views.
If the database administrator set up a different login for
the regular user or for the SIPLACE Pro Server, it must be
entered here.
"UseridP"="usr" Password for logging on at the SQL Server as SIPLACE-
ProUsr. The value shown here is the installation default.
If the database administrator assigned a different pass-
word for the SIPLACEProUSR login, it must be entered
here.
This also applies if a login other than SIPLACEProUSR
should be used (see previous line). In that case, the
password for that login must be entered here.
I-21

"RowsetSize"=dword:00000019 This value is used for tuning the database access by the
SIPLACE Pro Server. It describes the number of table
entries that are transferred together across the network
between the application and the SQL Server.
The higher the value, the less the network load, but the
higher the memory requirement of the application.
You must find the optimal setting by testing on the basis
of the actual data load.
"LoginTimeoutSec"=dword:0000001e The number of seconds after which a timeout error occurs
if the login of the SIPLACE Pro Server at the SQL Server
has not yet been executed successfully.
"QueryTimeoutSec"=dword:0000000f Number of seconds after which a timeout error occurs if a
single database access of the SIPLACE Pro Server at
the SQL Server has not yet been executed successfully.
Such timeouts can be caused if other database applica-
tions cause blocks. With SIPLACE Pro, however, access
of other applications to the database is highly unusual.
With timeout errors occur frequently, increase this value.
"BlobSizeHighwaterMark"=dword:00000200 Parameter set by SIPLACE Pro Server itself for optimizing
the internal memory management.
It may be deleted and is automatically reset when re-
quired.
I-22

"CaseSensitiv"=dword:00000000 This parameter contains the result of the test with which
the SIPLACE Pro Server has checked if the SQL Server
with which it has established a connection is case-sensi-
tive (upper/lowercase).
Possible values are:
3 = Yes, i.e. "JOHN" != "john"
4 = No, i.e. "JOHN" = "john"
otherwise = test not performed
When you change or reinstall the SQL Server, you should
delete this value or set it to “0” to trigger a new test of the
case-sensitivity.
"MaxWhereClauseTokens"=dword:000001f4 This value defines the maximum complexity of the SQL
commands generated.
If the SQL Server generates an error with code “S1093”,
this value is too large and must be reduced by trial-and -
error until the error no longer occurs.
The error mentioned is intercepted by the SIPLACE Pro
Server and logged in the NT event log with a corre-
sponding note.
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Logon
I-23

"Logon"=dword:00000000 This switch defines if SIPLACE Pro Desk should log on at
the NT domain with the following Registry values (Domain
and UserName).
Possible values:
0 = No
1 = Yes
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Logon\Domain
"Domain"="DE_MCH_RM35A"
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Logon\UserName
"UserName"="easy"
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Server Settings This key contains values that serve the clients to set up a
connection with the SIPLACE Pro Server or that are ana-
lyzed by the SIPLACE Pro Server itself.
"Server Name"="PL10035C" Name of the computer on which clients should look for the
SIPLACE Pro Server.
"Event source name"="SIPLACE Pro" Value entered in the “Source” column of the NT event log
for entries by the SIPLACE Pro Server.
"SIPLACEPro Admins"="" Security information for the NT user group “SIPLACE-
ProAdmins”. The SIPLACE Pro setup enters a value if
such a user group exists at the time of the installation. If
no such group exists, the value is empty or missing en-
tirely.
If the group is added later, you should run another-
SIPLACE Pro setup for the SIPLACE Pro Server compo-
nent to set this value in the Registry.
I-24

"Security"=dword:00000001 A switch that defines if the “NT Security for SIPLACE Pro”
functionality should be active.
Possible values:
0 = No
1 = Yes
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Workspace This key and all its subkeys contain a series of values that
record the current status of the SIPLACE Pro Desk user
interface so that the settings can be restored with the next
start of the application.
"Window"=dword:00000000
"TabSettings"=dword:00000000
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Workspace\GradientCaption
"GradientCaption"=dword:00000001
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Workspace\ReloadDocumen
ts
"ReloadDocuments"=dword:00000000
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Workspace\ReloadWorkspa
ce
"ReloadWorkspace"=dword:00000001
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Workspace\UndoLevels
"UndoLevels"=dword:00000005
\SOFTWARE\Siemens SIPLACE\SIPLACE Pro 1.0\Workspace\WorkbookMode
"WorkbookMode"=dword:00000000
I-25
2.6 The ODBC configuration
With the ODBC configuration you define a data source (DataSourceName =

DSN) that points to a certain computer with whose SQL Server an application can
set up a connection by specifying the data source name.
The following section explains with screenshots how the data source must be
configured for the SIPLACE Pro system. Normally, the SIPLACE Pro setup pro-
gram performs the configuration automatically, but you can also do it manually,
provided all settings are entered as shown below.
For the screenshots, the SQL Server driver version 3.70.06.23 was used. With
other versions of the SQL Server driver, the DSN configuration dialog boxes may
look differently. Proceed accordingly.
2.6.1 Opening the ODBC Data Source Administrator
Open the ODBC Data Source Administrator with Start/Settings/Control

Panel/ODBC.
Fig. 8: ODBC Data Source Admininistrator Dialog, “Local Server”
Some tabs of the dialog merit special mention:
I-26
− User DSN contains configured data sources that are available to the user
(and only that user) who is currently logged in to NT.
− System DSN contains configured data sources that are available to all users
logged in to that computer. The DSNs used for SIPLACE Pro must be set
up as System DSNs.
− About displays the versions of the DLLs that are part of the ODBC core. This
information can be helpful for system developers when troubleshooting.
− ODBC Drivers displays the ODBC drivers installed on this computer and
their versions. This information can be helpful for system developers when
troubleshooting.
2.6.2 Configuring the System DSN
In the dialog box shown above, click on the System DSN tab if it is not already
activated.
− If the list of DSNs includes an entry with the name SiplaceProDB, select it
and click on “Configure…”.
− If no entry with the name SiplaceProDB is present, click on “Add…” to dis-

play the following dialog:
Fig. 9: “Create New Data Source” Dialog

Select from the list of ODBC drivers the driver for “Microsoft SQL Server” (or
“SQL Server”) and click on “Finish”.
I-27
The system now activates a wizard that displays a series of dialogs. You move
from one dialog to the next one by clicking on “Next”. Click on “Finish” only if
no “Next” button is displayed.
All dialogs are shown below. All settings and entries must be made exactly as
displayed in the screenshots. If necessary, special notes follow the respective
dialog screenshot.
Fig. 10: “Create a New Data Source to SQL Server”, Dialog 1
Notes:
− The name of the data source must be “SiplaceProDB”.
− The text in the “Description” field has no functional meaning.
− From the “Server” drop-down list, you can select from all computer names on
which the system found an MS SQL Server. Select the name of the computer
on which the SIPLACE Pro database was installed or enter the name of the
computer.
I-28
Fig. 11: “Create a New Data Source to SQL Server”, Dialog 2
Notes:
− Make sure that you select “SQL Server Authentication” in the upper portion of
the dialog.
− As the password, enter “usr” or the password in the following Registry entry:
\HKEY_LOCAL_MACHINE
\SOFTWARE
\Siemens SIPLACE
\SIPLACE Pro 1.0
\DBSettings
\UseridP.
The information in the lower section of the dialog box is used for testing the
ODBC link at the end of the configuration. It has no effect on the SIPLACE Pro
system.
I-29
Fig. 12: “Microsoft SQL Server DSN Configuration”, Dialog 1
Fig. 13: “Microsoft SQL Server DSN Configuration”, Dialog 2
In the two dialog boxes above, you can leave the default values unchanged.
I-30
Fig. 14: “ODBC Microsoft SQL Server Setup” Dialog
− When you click on OK, the configuration is complete.
− If you click on the “Test Data Source…” button, the system attempts to ad-
dress the SQL Server via the newly configured DSN. The following dialog dis-
plays the result of the test:
I-31
Fig. 15: “SQL Server ODBC Data Source Test” Dialog
Click on OK.
2.6.3 Error Message „ The System-DNS „Local Server“ fehlt in der ODBC-
Konfiguration
This error very rarely occurs after deinstalling and reinstalling SIPLACE Pro with-
out database:
„The SystemDSN "LocalServer" is missing in the ODBC configuration. Setup is

sorry beeing not able to create the DSN itself in the current phase. You must fol-
low the instructions in the next message in order to continue setup.“
To generate the System-DNS „Local Server“ proceed as described in chapter

2.6.2 . Keep in mind that: at the beginning, click on the DSN entry LocalServer
instead of SIPLACEProDB.
I-32
3 Reinstalling the SQL Server
It may become necessary to reinstall the MS SQL Server. If you don’t make the
proper preparations, you may lose all information about the SIPLACE Pro Data-
base since the master database will be set up from scratch.
3.1 Microsoft SQL Server 6.5
To reinstall the MS SQL Server 6.5 without losing your data, carry out the follow-
ing steps:
1. Stop the SIPLACEProServer service and all other applications that are con-
nected with MS SQL Server.
2. Stop the MS SQL Server service.
3. Stop the SQL Executive service.
4. Copy the complete subdirectory “DATA” from the SQL Server program direc-
tory (“c:\mssql” by default) to a secure location away from this program direc-
tory.
The “DATA” directory contains the master database that is always set up new
with each reinstallation.
5. Uninstall the MS SQL Server:
a) Start the MS SQL Server installation program by calling

Start/Programs/Microsoft SQL Server 6.5/SQL Setup.
b) Click through the first dialogs until you see the Options dialog:
Fig. 16: “Microsoft SQL Server 6.5 – Options” Dialog
I-33
Select “Remove SQL Server”.

c) In the following confirmation dialog, select “Remove files...” and click on
“Continue”.
Fig. 17: “Remove SQL Server” Dialog

Warning: For reasons of safety during the uninstall process, the “Continue”
button is not the usual large default button.
d) The uninstall procedure is now performed and confirmed with a dialog.
6. Reinstall the MS SQL Server by running the SIPLACE Pro setup program.
Select the MS SQL Server component.
Warning: Do not install the MS SQL Server by running its own setup, but run
the SIPLACE Pro setup instead. Otherwise, you would create an installation
that misses major configurations for using SIPLACE Pro.
7. Stop the MS SQL Server service that started after the setup.
8. Close the SQL Executive service that started after the setup.
9. Copy the backed-up “DATA” directory and its contents to the new SQL Server
program directory. Overwrite the “DATA” directory that was created during the
installation.
10.Start the MS SQL Server service.

11.Start the SQL Executive service.
12.Start the SIPLACE Pro Server service.
I-34
3.2 Microsoft SQL Server 7.0
To reinstall MS SQL Server 6.5 without the risk of losing data, perform the fol-
lowing steps:
1. Back up the entire system.
2. Open Start Menu/Programs/Microsoft SQL Server 7/Query Ana-
lyzer under the login "sa" and execute the following commands:
a) sp_helpdb
Print and/or save the output. It contains a list of all known databases. There
are two different groups:
* System and sample databases
° master
° msdb
° tempdb
° Northwind (sample database)
° Pubs (sample database)
* The EASYPRO user database as well as possibly additional user data-

bases of this user.
For each of the user databases on the list produced by sp_helpdb, exe-
cute the following commands:
b) use <database name>
c) sp_helpfile
Print and/or save the output. It contains a list of all files that make up the
respective database.
d) use master
e) sp_detach_db <database name>
1. For each of the user databases except EASYPRO, log the configuration of the
user rights. Consult the system documentation or the online documentation of
MS SQL Server 7 for this procedure.
3. Close the QueryAnalyzer.

4. Stop the SIPLACEProServer service and all other applications that are linked
to the MS SQL Server.
5. Stop the SQLServerAgent service.
I-35
6. Stop the MS SQLServer service.

7. Uninstall MS SQL Server 7 by clicking on Start Menu/Settings/Control
Panel/Add/Remove Programs and selecting the entry for Microsoft SQL
Server 7.
8. For the reinstallation of MS SQL Server 7, start the SIPLACE Pro setup pro-
gram and select only "MS SQL Server" as the component to be installed.
Under no circumstances should you select the "Database" component. If
you do, you will install a new database and lose all your existing data!
9. When you have successfully installed the program, open Start Menu/-
Programs/Microsoft SQL Server 7/Query Analyzer under the login
"sa" and execute the following command for each of the user databases
shown on the list produced by sp_helpdb:
a) sp_attach_db <database name>, <filename_1>, <file-

name_n>
As filenames 1 through n, enter the filenames and full paths from the list
created with sp_helpfile.
b) In the folder <SIPLACE Pro program direc-

tory>\DBScripts\Microsoft SQLServer 7, open the following SQL
scripts and execute them:
* SetDbOptions.sql
* AddLogins.sql
* AddMaintenanceTasks.sql
Ignore any error messages regarding the attempt to delete non-existing
tasks.
* Create StartupProc.sql
* GrantAllToPublic.sql
10. Configure the user rights for all user databases except EASYPRO according to
the settings logged above.
I-36

Siplace Pro Fses

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Siplace Pro Fses

Hochgeladen von

Copyright:

Verfügbare Formate

Installation/Service

SIPLACE Pro 1.0A

UNIX is a registered trademark of AT&T

Item-No.: 00191461-02 Siemens Aktiengesellschaft

UNIX ist ein Warenzeichen von AT&T

Siemens AG 1999 All rights reserved Technische Änderungen vorbehalten

Artikel-Nr.: 00191461-01 Siemens Aktiengesellschaft

0.1 PURPOSE OF THIS DOCUMENT ............................................................................................... I-3

0.2 EDITOR’S NOTE .................................................................................................................... I-3

1 CHECKING CORRECT INSTALLATION .................................................................... I-4

2.2 W AS THE INSTALLATION SUCCESSFUL? .................................................................................. I-7

2.3 FUNCTIONAL CHECK OF THE MS SQL SERVER ...................................................................... I-9

2.4 FUNCTIONAL CHECK OF SIPLACE PRO SERVER .................................................................. I-11

2.5 THE SIPLACE PRO REGISTRY ........................................................................................... I-19

2.6 THE ODBC CONFIGURATION ............................................................................................... I-26

2.6.2 Configuring the System DSN .................................................................................... I-27

3 REINSTALLING THE SQL SERVER ..................................................................... I-33

3.1 MICROSOFT SQL SERVER 7.0 ............................................................................................ I-35

0.1 Purpose of this document

0.2 Editor’s note

− Version 6.5 with Service Pack 5a

1 Checking correct installation

− SIPLACE Pro Server

− SIPLACE Pro Desk

For the server components, select Start/Settings/Control

Fig. 1: “SIPLACE Pro” Start Dialog

The dialog box disappears automatically after a short period.

2.1 Sources of information for troubleshooting

2.1.1 The SIPLACE Pro installation log

2.1.2 The MS SQL Server 7 installation log

These files may provide troubleshooting clues if the installation of MS SQL

2.1.3 The NT event log

With Start/Programs/Administrative Tools (Common)/Event View-

2.1.4 The MS SQL Server error log

2.2 Was the installation successful?

2.2.1 SIPLACE Pro installation check

It is recommended to first uninstall the system and then perform the

2.2.2 MS SQL Server 7 installation check

The correct installation of MS SQL Server 7 can be checked in several steps:

− After a successful installation, the file C:\WinNT\setup.log must have the

The value for RebootRequired can also be "1".

− Under Start Menu/Settings/Services, there must be entries for the

− Under Start Menu\Programs you must see a submenu named Micro-

− The Registry must contain the key HKEY_LOCAL_MACHINE\SOFTWARE\-

2.2.3 MS SQL Server 6.5 installation check

− Under Start Menu/Settings/Services there must be entries for the

− Under Start Menu\Programs there must be a Microsoft SQL

− The Registry must contain the key HKEY_LOCAL_MACHINE\SOFTWARE\-

2.2.4 Possible causes of errors

• In "Control Panel/Network/Adapter", configure the "MS Loopback

• In "Control Panel/Network/Protocols/TCP/IP" configure the IP

2.3 Functional check of the MS SQL Server

2.3.1 MS SQL Server 6.5

On the computer on which SQL Server should be running, select

Fig. 2: “MS SQL Service Manager” Dialog

2.3.2 MS SQL Server 7

On the computer on which SQL Server is supposed to run, open Start

Fig. 3: Dialog box for “SQL Service Manager” Version 7

Fig. 4: “Services for the Entry” Dialog

− Runtime error during startup?

2.4 Functional check of SIPLACE Pro Server

2.4.1 Is the component running?

On the computer on which SIPLACE Pro should be running, select

Fig. 5: “Control Panel/Services” Dialog