ISPA Database Technical Administration Manual V1.2.1 ENG
Short Description
ISPA Database Technical Administration Manual...
Description
Version:
ISPI Next 1407
Date:
2014-05-09
This document describes the installation and configuration of the ISPA database IDB. Valid from: Application Component
Version
ISPA Server
10.15.2 or higher
ISPA Client
5.2.0.x or higher
ISPA Oracle DBS
11.2.0.1
ISPA DB
1.2.1
Page
BMW Group ISPA Database Technical Administration Manual
2
of 40
1.1
Purpose of this document ................................................................ ............................................................................................................ ............................................ 4
1.2
Explanation of Symbols used ...................................................................................................... ......................................................................................................4
1.3
Additional Documents ................................................................................................................. .................................................................................................................4
1.4
Required Installation Media .............................................................................................. ......................................................................................................... ........... 4
2.1
Requirements ........................................................... .............................................................................................................................. ...................................................................5
2.2
Preparation ............................................................... .................................................................................................................................. ...................................................................5
2.2.1
Create user group “ora_dba” .......................................................... ........................................................................................... ................................. 5
2.2.2
Add your administration user to the user group “ora_dba” ...............................................6
2.2.3
Restart your Computer ......................................................... ..................................................................................................... ............................................ 6
2.2.4
Create a Network Share for Backup (optional) ................................................................. ................................................................. 6
2.3
Install IDB .................................................................. .................................................................................................................................... ..................................................................7
2.3.1
Extracting the Oracle Files ............................................................... ................................................................................................ ................................. 7
2.3.2
Starting the Installation Wizard ......................................................................................... .........................................................................................7
2.3.3
Definition of the Backup Destination Folders ......................................................... .................................................................... ........... 8
2.3.4
Definition of the Backup Settings ................................................................... ...................................................................................... ................... 9
2.3.5
Starting the Installation Process ..................................................................................... ..................................................................................... 13
3.1
Creation of ISPA Database Administration Ad ministration Icon ....................................................................... 16
3.2
Configuration of Backup Schedules .......................................................................................... .......................................................................................... 16
3.3
Oracle Services ........................................................ ......................................................................................................................... .................................................................17
6.1
“Fixing Up” the IDB .............................................................. .................................................................................................................... ......................................................25
7.1
Path configuration Overview ........................................................... ..................................................................................................... .......................................... 27
7.1.1
Installation Path ........................................................ .............................................................................................................. ...................................................... 27
7.1.2
Backup Path..................................................................................... Path.................................................................................................................... ............................... 27
7.2
Change Backup Path .......................................................... ................................................................................................................ ...................................................... 28
7.2.1
UNC path ................................................................... ........................................................................................................................ ..................................................... 29
7.2.2
Local Dump Path ............................................................................................................ 31
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group ISPA Database Technical Administration Manual
3
of 40
7.3
Changing Backup Parameters .................................................................................................. 32
9.1
Installation do es not start st art .......................................................................................................... 37
9.1.1
Installation does not start without any Warning .............................................................. .............................................................. 37
9.1.2
.NET Error Messages ..................................................................................................... 37
9.2
Insufficient Memory ............................................................. ................................................................................................................... ...................................................... 37
9.3
ORACLE or SCORE are not checked ...................................................................... ....................................................................................... ................. 38
9.4
Oracle Installation Insta llation has not finished successfully .............................................................. ....................................................................... ......... 38
9.5
Tasks were not created ............................................................................................................. ............................................................................................................. 38
9.6
Oracle Services S ervices were not n ot created ............................................................................................. ............................................................................................. 38
9.7
Importing a Backup has finished with Errors ......................................................... ............................................................................. .................... 38
9.8
Creating a Backup has finished with errors ........................................................... ............................................................................... .................... 38
9.9
IDB Installer does not run with Administrator Rights ........................................................ ................................................................. ......... 38
9.10
Fixup has not completed successfully ...................................................................... ....................................................................................... ................. 39
9.11
IDB Administration does not run with administrator rights ........................................................ 39
9.12
ORACLE listener does not start ................................................................................................ ................................................................................................40
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
4
of 40
ISPA Database Technical Administration Manual
The "ISPA Database Technical Administration Manual" describes the installation, configuration and administration of the IDB. The document is addressed to the technical administrator of the ISPA system in the workshops and sales companies. The following topics are covered:
Installation of the Oracle Server and the IDB.
Configuration of Backup and Restore.
Problem handling.
These
has to be read carefully, because otherwise problems can be caused.
Areas marked with this symbol provide you with additional
.
The following additional documents are referenced in this document:
ISPI Planning Guide
This document is referenced by
ISPA Client Technical Administration Manual, ISPI Next 1407
ISPA Light Technical Administration Manual, ISPI Next 1407
You need one of the following media for installation:
Blu-ray Disc provided with all installation packages for the setup of a new dealer (disc one of four – four – ISPI ISPI Next Applications).
NAS/Shared Storage with installation packages provided online via the ISPI Admin Client.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
5
of 40
ISPA Database Technical Administration Manual
The IDB can be installed on the ISPA Hub or another external device. The installation described here, creates a new and empty database together with the required Oracle Server 11gR2.
The ISPA Hub or external database server hardware and including the operating system is installed. For technical details please refer to the “ISPI Planning Guide”.
All important Windows updates have to be installed especially the updates for .Net.
For the installation administrator rights are required.
The files listed in the following table are required for the installation. Please make sure, that these files are available on your NAS / shared storage. The files can be provided from an offline installation medium (Blu-ray Disc) or downloaded via ISPI Admin Client from the central BMW systems.
ISPA Oracle DBS
BMW_ISPI_TRAC_OracleDBS_.exe e.g. BMW_ISPI_TRAC_OracleDBS_11.2.0.1.exe
ISPA DB
BMW_ISPI_TRAC_IDB_.msi e.g. BMW_ISPI_TRAC_IDB_1.2.1.0.msi
Before starting the installation you have to carry out the following tasks on the target system:Login to your Windows OS with your administration user
Go to the local user management:
Press the „
Type in “
Press “
“. ”. “.
Click on the “
Right click on the groups list and se lect “
Enter the group name “
ISPI Next 1407
” folder. ”.
”.
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Click “
”.
Click “
.
Go to the local user management:
Press the „
Type in “
Press “
6
“. ”. “.
Click on the “
” folder.
Double click your current
Select the tab “
Click on “
”.
Enter “
” into the text area.
Click on “
Confirm with “
”.
Confirm with “
”.
account. ”.
”.
To activate the group settings above you have to restart Windows.
Press the „
”.
Type in “
Press “
Wait until Windows has restarted.
”. “.
If you want to store the backups of your IDB on an external device within your network, you have to create a network share on this device.
Please create a user with a password that
.
Select the destination folder where you want to store the backups.
Share this folder to the network with write access for the user you have created before. Later on during installation of the IDB, this information is required to configure the backup parameters.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
7
of 40
ISPA Database Technical Administration Manual
Copy both install packages for “ISPA Or acle DBS” and “ISPA DB” (see table in chapter 2.1) from your NAS/Shared Storage into a temporary local folder on the ISPA Hub or your external database server. During the installation you may have to accept “User Access Control” and “Firewall” messages. In order to install IDB correctly, you must allow every access.
Start the install package for “ISPA Oracle DBS” and wait until the extraction has completed:
When the file extracting has completed without any error, the window will be closed. Otherwise you will receive an error message.
Now start the install package for “ISPA DB” (see table in chapter 2.1) and the required files will be copied to the target directory. Then the installation starts. If the installation does not start automatically, please refer to chapter 9.1 “Troubleshooting: Installation does not start”.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Select your preferred “ click on “
” for the
8
and the
dialog and
”.
In the next step, you must not change the preconfigured paths to integrate the IDB into the default BMW folder hierarchy. If you change the preconfigured paths, the ISPI Admin Client cannot retrieve and upload the log files of the IDB in case support is needed.
Confirm this screen without any changes and click on “
ISPI Next 1407
”.
Copyright © BMW AG
Page
BMW Group
9
of 40
ISPA Database Technical Administration Manual
For the daily backups of your IDB you now have to configure the required parameters. 2.3.4.1
Target Directory to store the Backup Files
This can either be a local Dump path on your computer where the IDB is installed, or the path to an external device within your network (UNC path). To prevent a data loss, it is recommended to use a network share that is backed up also to offline media. In case of loss of the hardware (local server or network share) the backups might be lost also.
If you want to store the backup on your local computer, you can select the target directory or define a new folder using the
ISPI Next 1407
button:
Copyright © BMW AG
Page
BMW Group
10
of 40
ISPA Database Technical Administration Manual
After having selected the target directory, it will be displayed in the field left to the button:
To store the backup files on an external device within your network, click on the radio button for the UNC path and define the required parameters:
the full path to the network share you have defined in chapter 2.2.4 “Create a Network Share for Backup (optional)” (
the user you have defined on the target device with access to the network share (
ISPI Next 1407
)
).
the password defined for the UNC username ( the domain of the UNC username (
).
). Copyright © BMW AG
Page
BMW Group
11
of 40
ISPA Database Technical Administration Manual
After you have clicked on the Test button and not all required para meters have been defined, the following hints will be displayed:
After having defined the UNC parameters you can test the connectivity with a click on the button. If the test failed, the Test button will turn to
and an error message is
displayed:
Check the UNC parameters you have entered and try again, until the Test button turns to :
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
2.3.4.2
12
Number of Backup Copies and Backup Times
Accept or change the number of backups in minimum is
. The default and
. You will need about 200 MB free space per backup in your target backup directory. For instance you should have 2800 MB free space for the minimum amount of 14 backups.
Define start time for
and
.
Define your backup configuration and confirm with a click on “
” and proceed with the
Oracle installation. ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
If you want to abort the IDB installation, click on “ message with “
13
” and confirm the following
”:
Otherwise click on “
” and proceed with the Oracle installation.
The next screen will give you an overview, how long the installation will take. Be sure,
and
are checked. Otherwise please refer to chapter 9.3
“Troubleshooting: ORACLE or SCORE are not checked”.
To start the Oracle installation click on “
ISPI Next 1407
”.
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
14
The progress of the installation is displayed, and each installation step executed is recorded. After the installation has been completed, a confirmation message will be displayed:
Then confirm with “
” and the installation of the IDB is completed and the Installer window
can be closed.
After the installation of the IDB has been completed, two
are created to take
the daily database backups of your IDB.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
15
of 40
ISPA Database Technical Administration Manual
If .NET messages are displayed, please refer to chapter 9.1.2 “Troubleshooting: .NET Error Messages”. If the Oracle installation did not complete successfully, please refer to chapter 9.4 “Troubleshooting: Oracle Installation has not finished successfully ”.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
16
of 40
ISPA Database Technical Administration Manual
The following chapters describe how to verify the installation of the IDB. Additionally these steps are also required for analysis, if problems during the daily operations are encountered, e. g. the database is not running or the expected backups are not available.
When the installation has completed successfully, additionally an icon with the shortcut to the “ ” tool is created on the desktop of the local machine:
To verify the Backup Schedules perform the following steps:
Press the “
Select the
ISPI Next 1407
” and type “
”. The result should be:
.
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Open “
17
” (1) and there you should find the folder IDB with the following
two tasks (2):
IDB Backup 1 with Status “
”
IDB Backup 2 with Status “
”
If these tasks are not available, please refer to chapter 9.5 “Troubleshooting: Tasks were not created”.
To verify the Oracle Services have been created successfully, perform the following teps:
Press the “
ISPI Next 1407
” and type “
”. The result should be:
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Select “Services” and check, whether the following “
18
” are shown in the services
screen:
The Oracle Services with Status “Running” in the picture above have also to be in Status “Running” on your ISPA Hub.
If these
are not shown or are not in the correct status, please refer to
chapter 9.6 “Troubleshooting: Oracle Services were not created”. If the status of the Oracle listener “OracleOraDb11g_home1TNSListener” is not “
”
please refer to chapter 9.12 “Troubleshooting: ORACLE listener does not start”.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
19
of 40
ISPA Database Technical Administration Manual
To create an empty database is usually necessary only during rollout or if you want to start from scratch without restoring an existing database. For the Restore of an existing the creation of an empty database is NOT required.
Start the “
Select the radio button “
Confirm with “
To install a completely new and empty database, confirm with “
ISPI Next 1407
” icon on your desktop:
”. ”.
” to continue.
Copyright © BMW AG
Page
BMW Group
20
of 40
ISPA Database Technical Administration Manual
Be always sure, that you really want to create an empty database and delete the existing data!
The progress of the creation of an empty database is always displayed on the screen. After completion the following message is displayed:
Confirm with “
” and then close the
.
When the empty database has been created successfully, continue with one the following steps: If you use the ISPA Client (with or without DMS integration) and you want to start with an empty database, continue to initialize and configure the IDB as described in chapter 9 of the “ISPA Client Technical Administration Manual”. If you use ISPA Light and you want to start with an empty database, continue with the initial configuration of ISPA Light as described in chapter 9 of the “ISPA Light Technical Administration Manual”.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
21
of 40
ISPA Database Technical Administration Manual
Sometimes it may be necessary to create an instant backup besides the automatically created backups, e.g. if you have to setup a new server hardware or you plan to install updates.
To create an “instant” backup of the IDB, start the “
Select the radio button “ “
” icon on your desktop.
” and start the backup with a click on the button
”.
To backup the database, confirm with “
” to continue.
After the backup has been completed successfully, the backup is stored at the configured backup destination and a confirmation message will be displayed:
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Confirm this message with “
22
”.
Additionally check, whether the backup files will appear in the destination folder configured or in the default folder %ProgramFiles%\BMW\ISPI\TRAC\IDB\SCORE) including the log files (in .zip format).
If the backup has not been completed successfully, please refer to chapter 9.8 “Troubleshooting: Creating a Backup has finished with errors”.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
23
of 40
ISPA Database Technical Administration Manual
The restore of an existing database might be necessary:
After hardware problems on the device the IDB is installed on.
After you encountered other problems, e. g. a corrupt database.
If you want to replace your existing database server by another hardware.
Migration of the database to another server.
To restore your IDB from backup, start the “
” icon on your desktop.
Select the radio button “
Select the backup you want to restore, usually the latest one:
ISPI Next 1407
” and “
” for existing backups:
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Now click on “
Confirm the following message with “
24
”:
” to start the import:
After the import has completed successfully, a confirmation message will be displayed:
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Confirm this message with “
25
”.
If the Import has not been completed successfully, please refer to chapter 9.7 “Troubleshooting: Importing a Backup has finished with Errors”.
A “Fixup” is
required with ISPA Light !
The “Fixup” script is a maintenance utility that is included with the ISPA Client. It checks the database and rebuilds all indices and views. If you have installed ISPA Full / ISPA Basic you have to run the “Fixup” after each database import.
Enter the following command from a command line on the ISPA Hub: C:\Program Files (x86)\BMW\ISPI\TRAC\ISPA-Client Starter\ISPAStartHub.exe –fcs –tkpm fixup –m –b
After the “Fixup” has started successfully the following screen will be displayed:
You just need to run the “Fixup”
per database restore.
Otherwise if the “Fixup” did not complete successfully (with error messages) or does not respond, please refer to chapter 9.10 “Troubleshooting: Fixup has not completed successfully”. ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
26
of 40
ISPA Database Technical Administration Manual
If you want to change the backup settings of your IDB during daily operations, start the “ ” icon on your desktop.
Click on “
The current backup settings will be displayed:
ISPI Next 1407
”:
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
The path configuration in frame
27
can be changed only after clicking the button “
”.
The backup settings in frame
can be changed directly without “Edit Configuration”.
The path configuration consists of the categories “I
To possibility to change the installation path for
” and “
and the
”.
is reserved for Support
personnel only. Otherwise changes may cause unpredictable results and the database is not longer available for your ISPA system!
This can either be a local Dump path on your computer where the IDB is installed, or the path to an external device within your network (UNC path). To prevent a data loss, it is recommended to use a network share that is backed up also to offline media. In case of loss of the hardware (local server or network share) the backups might be lost also.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
28
of 40
ISPA Database Technical Administration Manual
To change the backup path configuration proceed with the following steps.
Click on button ”
Then confirm the following message with “
adapt the existing configuration for the UNC path or the local Dump path.
switch from UNC path to a local Dump path.
Switch from a local Dump path to UNC path.
ISPI Next 1407
”.
”.
Copyright © BMW AG
Page
BMW Group
29
of 40
ISPA Database Technical Administration Manual
To store the backup files on an external device within your network, the radio button for the UNC path has to be activated and the required parameters have to be defined. If you want to switch from Dump path to UNC path you have to create first the Backup Share on a remote device within your network as defined in chapter 2.2.4 “Create a Network Share for Backup (optional)”. The parameters to define an UNC path are: the full path to the network share you have defined in chapter 2.2.4 “Create a Network Share for Backup (optional)” ( the user you have defined on the target device with the network share (
access to
).
the password defined for the UNC username ( the domain of the UNC username (
)
).
).
After having changed or defined the UNC parameters, test the connectivity with a click on the button.
If the test failed, an error message will be displayed:
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Check the UNC parameters you have entered and try again, until the test is successful.
To save your changes click on “
Finally confirm the next message with “
Close the
ISPI Next 1407
with “
30
” and confirm with “
”:
”:
”.
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
If you want to store the backup on your local computer, you can select or change the target directory or define a new folder using the
31
button behind the
After having selected the target directory, it will be taken over as local To save your changes click on “
ISPI Next 1407
” and confirm with “
:
.
”.
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Finally confirm the next message with “
Close the
with “
”:
”.
The following backup settings can be changed without „
and/or
The
The
To save your changes click on “
ISPI Next 1407
32
“:
.
, i.e. the number of backups to be stored at the target location configured. to be used for the
. ” and confirm with “
”:
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Finally confirm the next message with “
Close the
ISPI Next 1407
with “
33
”:
”.
Copyright © BMW AG
Page
BMW Group
34
of 40
ISPA Database Technical Administration Manual
If there is a new version available for the IDB, perform the following steps to update your existing IDB. For the correct name of the current msi-file and probable installation details please refer to the release notes always provided with a new release.
Copy the install package for “ISPA DB” (see table in chapter 2.1) from your NAS/Shared Storage into a temporary local folder on the ISPA Hub or your external database server. During the installation you may have to accept “User Access Control” and “Firewall” messages. In order to install IDB correctly, you must allow every access.
Now start the install package for “ISPA DB” (see table in chapter 2.1) and the required files will be copied to the target directory. Then the installation starts. If the installation does not start automatically, please refer to chapter 9.1 “Troubleshooting: Installation does not start”.
Select the
ISPI Next 1407
for the IDB installation dialogue:
Copyright © BMW AG
Page
BMW Group
of 40
ISPA Database Technical Administration Manual
Confirm the Installation paths without any changes (recommended) with “
Confirm the Backup Configuration (or probably change it) and confirm with “
Start the IDB Update with “
The progress of the update is displayed, and each installation step executed is recorded:
ISPI Next 1407
35
”:
”:
”:
Copyright © BMW AG
BMW Group
Page
of 40
ISPA Database Technical Administration Manual
When the installation of the IDB Update is completed, confirm with “
36
” and the Installer
window can be closed.
To check the correctness of the IDB Update installed, verify your IDB installation as described in chapter 3 “Verification of the IDB Installation”.
ISPI Next 1407
Copyright © BMW AG
BMW Group ISPA Database Technical Administration Manual
Page
37
of 40
If you have started the install package “ISPA DB” (see table in chapter 2.1) but the installation window does not start, start the “IDB-Installer .exe” from path “%ProgramFiles%\BMW\ISPI\TRAC\IDB\IDB-Installer\”.
During the ORACLE install process, you might be prompted with messages, that some parts of the .NET Framework are not found.
In this case there possibly is no .NET Framework installed on the target system. If you are running the installation under Windows Server 2012 you have to install the most recent .NET version as a feature.
If the most recent .NET Framework is already installed and you are prompted, that some parts of the .NET Framework 3.5 are not found (see figure below), you can ignore those messages and click them away as often as they appear. They have no impact on a successful installation.
Please check the system requirements! If the system does not have enough free memory, this will result in a corrupt Oracle installation.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
38
of 40
ISPA Database Technical Administration Manual
You can face this behaviour, if the IDB installation has found an existing Oracle installation or an uncompleted uninstall. To prevent malfunction, you should install the IDB on a freshly installed Windows computer.
If you get an error during the Oracle installation, the IDB will not work properly. Please contact your Support.
If the expected 2 scheduled tasks are not shown, run “
”, enter your desired backup
times and save your changes. Then check the tasks again. If the problem still exists, please contact your Support.
Oracle services are not created, if the Oracle installation has run into an error. Restart the Oracle Services or restart your ISPA Hub. If this does not solve the problem, please contact your Support.
Restart “
” and try to restore again. If the import again does not complete
successfully, please try to restore another backup. If this fails again, please contact your Support.
Ensure that you are running “
” with administration rights (see chapter 9.9) and there
is sufficient free disk space available on your selected backup device. Restart “
” and retry to backup your database again. If it fails again, please contact
your Support.
If your IDB Installer does not run with administrator rights, please check, that “%ProgramFiles%\BMW\ISPI\TRAC\IDB\IDB-Installer\IDB-Installer.exe” has the “Run this program as an administrator” flag. Go to “%ProgramFiles%\BMW\ISPI\TRAC\IDB\IDB-Installer\” and follow the instructions in 9.11 “IDB Administration does not run with administrator rights” for the “IDB-Installer.exe”.
ISPI Next 1407
Copyright © BMW AG
Page
BMW Group
39
of 40
ISPA Database Technical Administration Manual
If the Fixup has not completed successfully, try to use another dump file. If it fails again, please contact your Support.
If backup or restore displays the message, the “
” has not been st arted with
Administrator rights, please check that “%ProgramFiles%\BMW\ISPI\TRAC\IDB\IDB Administration\IDB- Administration.exe” has the “
Right click on “
Click “
Select the “
Open “
Set “
Click “
”.
Click “
”.
” flag.
”. ”. ” tab. ” (your decision). ” (see Figure below).
Now the “IDB Administration” starts for all users with administration rights.
To allow everybody to start backup or restore might cause less effort in administration. But this may cause problems if done by unauthorized or untrained staff!
ISPI Next 1407
Copyright © BMW AG
View more...
Comments
