Beruflich Dokumente
Kultur Dokumente
Page 1 of 33
Copyright Notice
2012 P2 Energy Solutions. All rights reserved.
No reproduction without written permission.
While all reasonable care has been taken in the preparation of this document, no liability is accepted by
the authors, P2 Energy Solutions, for any errors, omissions or misstatements it may contain, or for any
loss or damage, howsoever occasioned, to any person relying on any statement or omission in this
document.
Any questions regarding this document should be forwarded to:
P2 Energy Solutions
1670 Broadway, Suite 2900
Denver, CO
80202, United States
Page 2 of 33
1 Application Architecture
Page 3 of 33
2 Technical Requirements
1.1 Client Desktop Requirements
The following table lists the minimum hardware requirements to run the Qbyte FM and Qbyte LM
products. Please note that these are the minimum requirements and that the processor speed and amount
of memory available will directly impact the performance of the software.
Hardware Item
CPU
Memory
Disk Space
Monitor
Video Card
Software Item
Operating System
Oracle Client
Browser
Java
Acrobat Reader
Requirement
1 GHz or better
1 GB
1 GB
Must support SVGA 800*600
Super VGA
Requirement
WinXP Professional, Windows 7
9i or 10g client required for Qbyte Outlook
9i, 10g, or 11g client required for Qbyte LM
Oracle client 11g with OLEDB provider for
Qbyte FM Spreadsheet Upload
Internet Explorer 8/9 (32-bit only)
1.6.0.29 or higher
Adobe Acrobat Reader 9.0 or higher
Implementing Qbyte FM or Qbyte LM (reporting) will require a java-enabled browser and Acrobat Reader.
Qbyte FM and parts of the Qbyte LM (reporting) applications are written using the Oracle Internet
Developer Suite. The screens were developed using the Oracle Forms product and most reports were
developed with Oracle Reports. Qbyte LM was developed under PowerBuilder11 and Oracle Reports.
While development of the reports is done within the Windows environment, for performance reasons the
reports are run on the UNIX server.
To run Qbyte Outlook we must also install the Oracle 9i, or 10g Client (aka Oracle Net, SQL*Net). This
is the networking software used by Oracle to communicate between the client application and the database
instance on the UNIX server. Qbyte LM requires either the Oracle 10g Client. Following is a list of
software that must be installed prior to running the Qbyte FM, LM, and Outlook products.
Page 4 of 33
Select Downloads
Scroll down to Browse by Category ->Database -> Database 11g Enterprise/Standard Editions
Page 5 of 33
Or
Page 6 of 33
Select Oracle Database 11g Release 2 Client (11.2.0.1.0) for Microsoft Windows (64-bit)
Win64_11gr2_client.zip (615,698,264 bytes)
Page 7 of 33
Using Windows Explorer, change directories to where you downloaded the file.
Extract the Zip file
With FM 11.2, it has become apparent that when installing on Windows7 computers, the
application must be installed with the proper privileges. If you do not run the install as Run as
Administrator the app will appear to install correctly, but the Provider will not be registered and
available. You will receive Provider not installed errors during the Spreadsheet load. Attempt
to install with these added privileges whenever possible.
Right Click on the setup.exe file Run as Administrator
Choose Administrator installation
Click Next
Page 8 of 33
Page 9 of 33
Page 10 of 33
Installing .
Click Close
You have now installed the Client software
Page 11 of 33
Now we need to install the OLE Provider. This component is required for the Spreadsheet upload.
Go back to where you installed the files
Right click on setup.exe Run as Administrator
Select Custom.
Click Next
Page 12 of 33
Page 13 of 33
Cick Next
Page 14 of 33
Installing
Page 15 of 33
Installing
Click Close
The Oracle Client software should now be installed.
Page 16 of 33
2 Configuration
2.1 Configuring TNSNAMES
Now you need to edit the tnsnames.ora file.
This file is by default located in the
ORACLE_HOME\network\admin directory. After installation, this directory will be empty, but in the
samples directory you will see a couple of templates. If necessary, you can use these templates. It is very
possible that your Network Adminstrators will already have this file which contains all of the entries for
your organizations databases.
We will want to install the configuration information for the Qbyte databases.
The necessary entries depend if you are using a VPN or a accessing Qbyte via an Internet connection
(again, check with your Network Administrator). The entries will resemble the following.
# VPN-based connection
QPSAMPLE=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=172.25.4.7)(PORT=13062))
(CONNECT_DATA=(SERVICE_NAME=QPSAMPLE.qbyte.com)))
QTSAMPLE=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=172.25.4.7)(PORT=13062))
(CONNECT_DATA=(SERVICE_NAME=QTSAMPLE.qbyte.com)))
#
OR
# internet-based connection
QPSAMPLE=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=66.38.147.197)(PORT=13062))
(CONNECT_DATA=(SERVICE_NAME=QPSAMPLE.qbyte.com)))
QTSAMPLE=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=66.38.147.197)(PORT=13062))
(CONNECT_DATA=(SERVICE_NAME=QTSAMPLE.qbyte.com)))
Page 17 of 33
Notes:
1) We usually see the Oracle Provider for OLE DB entry when using this method
2) On one occasion utilizing Windows 64-bit OS and Oracle 32-bit install, it did not appear. The
provider was available when doing the Spreadsheet Load. So, if you do not see the correct enty using
this test, it may be wise to test the Spreadsheet load. It may work.
This is what you would see if the Oracle Provider for OLE DB was not installed
Page 18 of 33
This is what you should see if Oracle Provider for OLEDB was installed and registered correctly
Page 19 of 33
The Qbyte applications include a Qbyte developed batch queuing / scheduling / streaming software called
Job Submissions, a Java/ksh process capable of running different types of jobs (Oracle Reports, Pro*C
programs, SQL*Plus scripts, stored packages, ksh scripts). Output is generated in PCL (text) format or
PDF format. Job Submissions is configured for your specific environment by executing
$APP_HOME/jobsub/install_jobsub, which will prompt you for information about your environment
and any features you may choose to enable:
Email notification when jobs finish
Printing of barcodes on specific reports
Setting the time of day when expired output will be removed from the system
4 Spreadsheet Deployment
Release 11.2 contains the following versions of Qbyte Spreadsheet Upload processes.
Transaction Data Entry, TDEU001.xls (version /main/73)
Transaction Data Entry, TDEU002.xls (version /main/53)
Production Reserves CONU028.xls (version/main/8)
Cost Allocation Detail Upload, ADTU001.xls (version /main/24)
If this is the current version of the Cost Allocation Detail Spreadsheet being used, redeployment should
not be necessary. However, if you are upgrading from a release prior to 11.0.0, the above versions will
need to be redeployed to all users.
The spreadsheets have been tested under the following Excel versions:
Microsoft Excel 2003 (11.8307.8221) SP3
Windows 7 (32-bit) and Microsoft Excel 2007 12.0.6654.5003 SP3
Windows 7 (64-bit) and Microsoft Excel 2007 12.0.6654.5003 SP3
Windows 7 (32-bit) and Microsoft Excel 2010 14.0.6112.5000
Windows 7 (64-bit) and Microsoft Excel 2010 14.0.6112.500
Windows XP and Microsoft Excel 2010 14.0.4760.1000
If problems arise while running TDEU001, TDEU002 or ADTU001 on versions of Excel other than the
ones mentioned above, P2 Energy Solutions will attempt to resolve the problems on a best effort, time
and materials basis.
As a reminder, role security is present in the TDEU001.xls and TDEU002.xls templates. Users wishing to
upload information from these spreadsheets must have either the PWSQL_61_TDEU_UPLOAD role or
the PWSQL_50_SUPER_USER role. In addition, role security is present in the ADTU001.xls
Page 20 of 33
template; therefore, users wishing to upload information from this spreadsheet must have either the
PWSQL_71_ALLOCATION role or the PWSQL_50_SUPER_USER role. Also, to view/update
vouchers uploaded using TDEU001/TDEU002, users require role PWSQL_63_TDES_VIEW_TDEU.
Otherwise, the vouchers can still be viewed through TDQS001 (Transactions Data Query Screen).
Your desktop personnel should ensure the HOME0 entry in the desktop registry is pointed to Oracle
Client version 11.2 or greater.
Generally, there are two different methods for deploying the Qbyte Spreadsheet Upload (TDEU) to each
user:
TDEU001.xls
This spreadsheet can be found in the desktop directory where other executables reside for all
clients except ASP clients;
ASP clients can find the spreadsheet in the COMMON/PROD or COMMON/TEST directories.
This version of the spreadsheet contains all of the formatting and coding embedded in the
spreadsheet itself, which makes the size of this object approximately 819 KB. The disadvantage
of using this object as your base spreadsheet is every time Qbyte changes something in the
spreadsheet (Visual Basic code, comments, descriptions etc) each user must receive a new copy of
TDEU001.xls and use this new version as their working copy.
Page 21 of 33
o Once the first user opens the new version of the TDEU002 spreadsheet and enables the
macros, the add-in will be moved (not copied) to their local hard drive (for Windows XP this
will be copied to C:/Documents and Settings/User Id/Application Data and for Windows 7
this will be copied to C:/Users /User ID/App Data/Roaming/Microsoft/AddIns) resulting
in the add-in being removed from the common drive. This would mean other users no longer
have access to the file from the common drive.
Some clients have created a program to ensure the add-in stays on a common network drive. P2
Energy Solutions will be developing something similar to this in the future to ensure the
deployment of the add-in to users will work without having this problem. However, until P2
develops this tool, clients using TDEU002 and the add-ins should copy the add-in to the
common network drive as well as email the new add-in to all users. Then the users should copy
the file onto their local hard drive (for Windows XP should be copied to C:/Documents and
Settings/User Id/Application Data and for Windows 7 this should be copied to C:/Users /User
ID/App Data/Roaming/Microsoft/AddIns).
Important note:
Currently, Qbyte Online clients cannot use TDEU002.xls, as we are unable to deploy the add-in
on the Citrix server.
If your company is using either TDEU001.xls or TDEU002.xla/.xls, the newest version of the
spreadsheet upload should be deployed using one of the above methods or new functionality in
the release may not work as expected.
A reminder, if the versions of the spreadsheet have not changed, it is not necessary to re-deploy
the spreadsheet .xls/.xla files.
ADTU001.xls
For Cost Allocation Detail, there is only one method of deploying the spreadsheet. This
spreadsheet is located in the desktop directory where other executables reside for all clients except
ASP clients; where it can be found in the COMMON/PROD or COMMON/TEST directories.
Merge functionality
Page 22 of 33
To make the deployment of the TDEU001.xls and TDEU002.xls templates easier, there is a merge
functionality built into the TDEU001.xls and TDEU002.xla templates. When the user opens these
new versions of TDEU, a menu option entitled Merge Spreadsheet Versions appears under the
Qbyte menu. When the user chooses this option, the default windows open popup box will appear
and allows the user to select the previous version of the spreadsheet they wish to merge into the
new version. Once the old version of the spreadsheet is chosen, TDEU will merge all the old
information into the new version of the spreadsheet.
End of Document
The following pages should be treated for information purposes only on an as-need basis
They are documents to be used if installing Oracle 11.2.0.3 Client.
The information is not applicable for the preceding installation.
3
Page 23 of 33
Type:PROBLEM
Status:PUBLISHED
Priority:3
In this Document
Symptoms
Changes
Cause
Solution
References
Applies to:
Symptoms
After installing the Oracle Provider for OLE DB from the 11.2.0.3 Patch 10404530. The
Oracle Provider for OLE DB 11.2.0.3 is not installed or registered correctly. It does
appear as installed in the Oracle Universal Installer. However, it does not show up in
the list of available providers when attempting to test the connection using a UDL file.
Note: This can happen with 32-bit or 64-bit Oracle Provider for OLE DB.
Basically the Oracle Provider for OLE DB not listed in data link properties
Here is the error message when you try to use it from an application:
Provider cannot be found. It may not be properly installed.
Page 24 of 33
Changes
Installed the Oracle Provider for OLE DB from the 11.2.0.3 client installation media.
Cause
Solution
To complete the installation of the Oracle Provider for OLE DB. Please complete the
following steps:
1. Open command prompt, if you are running on Windows 7 or Windows 2008
please make sure to run the command window with "Run As Administrator"
privileges.
2. In the command window execute the following command to register the Oracle
Provider for OLE DB :
regsvr32 <OracleHome>\bin\OraOLEDB11.dll
Where <OracleHome> is the physical path to the Oracle home where the driver is
installed. i.e <drive>:\app\oracle\product\11.2.0\client_1\bin\OraOLEDB11.dll
Page 25 of 33
Oracle Database
Oracle Database patch set, release 11.2.0.3 is a full installation of the Oracle Database
software. This means that you do not need to install Oracle Database 11g Release 2
(11.2.0.1) before installing Oracle Database 11g Release 2 (11.2.0.3).
See Also:
Page 26 of 33
Note the following changes with the new patch set packaging:
New installations consist of installing the most recent patch set, rather than
installing a base release and then upgrading to a patch release.
Direct upgrades from previous releases to the most recent patch set are
supported.
Out-of-place patch set upgrades recommended, in which you install the patch set
into a new, separate Oracle home. In-place upgrades are supported, but not
recommended.
In-Place Upgrade
This feature enables you to upgrade an existing installation of Oracle database to
Oracle Database 11g Release 2 (11.2.0.3) into the same Oracle home directory by
replacing the existing database files. The patch set application requires more downtime
and is not recommended. This upgrade type requires less disk space.
Note:
If you select In-place upgrade to upgrade Oracle database to the
latest version, then you must:
Out-of-Place Upgrade
This feature enables you to install Oracle Database 11g Release 2 (11.2.0.3) in a new,
separate Oracle home directory. After the installation is complete, the data from the
Page 27 of 33
database in the old Oracle home directory is migrated to the database in the new
Oracle home directory.
Out-of-place upgrade process is similar to Oracle database upgrade from one version to
another and is the recommended type. The benefits of this upgrade type is that the
patch set application requires much less downtime, and is safer when the patch set
application must be aborted. This upgrade type requires more disk space to
accommodate two Oracle home directories simultaneously.
Critical Patch Updates (CPU) and Patch Set Updates (PSU) are proactive quarterly patch
releases.
To review the latest Critical Patch Update information for Oracle Database 11g Release
2 (11.2.0.3), visit the Oracle Technology Network Web site at:
http://www.oracle.com/technetwork/topics/security/ale
rts-086861.html
To review the latest information on Patch Set Updates for Oracle Database 11 g Release
2 (11.2.0.3), see document 854428.1, Patch Set Updates for Oracle Products on the My
Oracle Support (formerly OracleMetaLink) Web site:
https://support.oracle.com
To locate document 854428.1:
1. Log on to My Oracle Support.
2. Set Article ID as the search source.
3. Enter 854428.1 in the search field, then click the Search icon.
3 System Requirements
Check your platform-specific installation guide for a list of supported operating systems.
Check Certifications on the My Oracle Support Web site for the latest certification
information.
Page 28 of 33
This document may be updated after release. To check for updates to this document,
see document 880782.1, ALERT: Oracle 11g Release 2 (11.2) Support Status and
Alerts, on the My Oracle Support Web site:
https://support.oracle.com
To locate document 880782.1:
1. Log on to My Oracle Support.
2. Set Article ID as the search source.
3. Enter 880782.1 in the search field, then click the Search icon.
5 Software Availability
Oracle Database 11g Release 2 (11.2.0.3) is available in the latest media pack. You can
also download the software from My Oracle Support Web site:
https://support.oracle.com
To download the software from My Oracle Support:
1.
2.
3.
4.
5.
6.
7.
Page 29 of 33
Installation Type
Zip File
p10404530_112030_platform_1of7.zip
p10404530_112030_platform_2of7.zip
p10404530_112030_platform_4of7.zip
Oracle Gateways
p10404530_112030_platform_5of7.zip
Oracle Examples
p10404530_112030_platform_6of7.zip
Deinstall
p10404530_112030_platform_7of7.zip
6 Database Documentation
The latest documentation for Oracle Database 11g Release 2 (11.2) is available on the
Oracle Technology Network Web site at
http://www.oracle.com/pls/db112/homepage
Review Oracle Database Readme and your platform-specific Oracle Database Release
Notes before installing Oracle software. For new installations, refer to the appropriate
installation guide for the product you are installing.
See "How to Upgrade to Oracle Grid Infrastructure 11g Release 2" in Oracle Grid
Infrastructure Installation Guide for details about performing Oracle Clusterware and
Oracle Automatic Storage Management upgrades. See Oracle Database Upgrade Guide
for complete information about planning and executing Oracle Database upgrades.
Oracle installation guides and release notes for each platform, the readme, and the
upgrade guide are available at
Page 30 of 33
http://www.oracle.com/pls/db112/portal.portal_db?sele
cted=11&frame=
8 Known Issues
To review known issues for Oracle Database 11g Release 2 (11.2.0.3), see document
1348336.1, Availability and Known Issues on the My Oracle Support Web site:
https://support.oracle.com
To locate document 1348336.1:
1. Log on to My Oracle Support.
2. Set Article ID as the search source.
3. Enter 1348336.1 in the search field, then click the Search icon.
To check the list of bugs fixed for Oracle Database 11g Release 2 (11.2.0.3), see
document 1348303.1, List of Bug Fixes by Problem Type on the My Oracle Support Web
site:
https://support.oracle.com
To locate document 1348303.1:
1. Log on to My Oracle Support.
2. Set Article ID as the search source.
3. Enter 1348303.1 in the search field, then click the Search icon.
10 Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility
Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Page 31 of 33
Oracle customers have access to electronic support through My Oracle Support. For
information, visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are
hearing impaired.
Oracle Database Patch Set Notes, 11g Release 2 (11.2.0.3) Patch Set 2
E24903-01
Copyright 2011, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement
containing restrictions on use and disclosure and are protected by intellectual property
laws. Except as expressly permitted in your license agreement or allowed by law, you
may not use, copy, reproduce, translate, broadcast, modify, license, transmit,
distribute, exhibit, perform, publish, or display any part, in any form, or by any means.
Reverse engineering, disassembly, or decompilation of this software, unless required by
law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not
warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or
anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation
and technical data delivered to U.S. Government customers are "commercial computer
software" or "commercial technical data" pursuant to the applicable Federal Acquisition
Regulation and agency-specific supplemental regulations. As such, the use, duplication,
disclosure, modification, and adaptation shall be subject to the restrictions and license
terms set forth in the applicable Government contract, and, to the extent applicable by
the terms of the Government contract, the additional rights set forth in FAR 52.227-19,
Commercial Computer Software License (December 2007). Oracle America, Inc., 500
Oracle Parkway, Redwood City, CA 94065.
This software or hardware is developed for general use in a variety of information
management applications. It is not developed or intended for use in any inherently
dangerous applications, including applications that may create a risk of personal injury.
Page 32 of 33
If you use this software or hardware in dangerous applications, then you shall be
responsible to take all appropriate fail-safe, backup, redundancy, and other measures to
ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any
damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names
may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All
SPARC trademarks are used under license and are trademarks or registered trademarks
of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo
are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a
registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on
content, products, and services from third parties. Oracle Corporation and its affiliates
are not responsible for and expressly disclaim all warranties of any kind with respect to
third-party content, products, and services. Oracle Corporation and its affiliates will not
be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services.
Page 33 of 33