Escolar Documentos
Profissional Documentos
Cultura Documentos
Copyright
2011 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge,
ByDesign, SAP Business ByDesign, and other SAP products and services mentioned
herein as well as their respective logos are trademarks or registered trademarks of
SAP AG in Germany and other countries. BusinessObjects and the Business Objects
logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence,
Xcelsius, and other SAP BusinessObjects products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks of Business
Objects S.A. in the United States and in other countries. Business Objects is an SAP
company. All other product and service names mentioned are the trademarks of their
respective companies. Data contained in this document serves informational purposes
only. National product specifications may vary. These materials are subject to change
without notice. These materials are provided by SAP AG and its affiliated companies
("SAP Group") for informational purposes only, without representation or warranty of
any kind, and SAP Group shall not be liable for errors or omissions with respect to the
materials. The only warranties for SAP Group products and services are those that are
set forth in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an additional
warranty.
For trademarks that are owned by the United States Postal Service, see
http://ribbs.usps.gov/files/NCOALINK/TRADEMARKS.PDF
Contents
Preface .............................................................................................................5
Planning for installation ................................................................................7
Using applications on Windows ..................................................................19
Using applications on UNIX ........................................................................33
Using Remote Views.....................................................................................43
License Manager ..........................................................................................59
Index ..............................................................................................................63
Contents
Preface
This System Administrators Guide is a planning guide and reference for those
who use certain SAP BusinessObjects applications on Windows and UNIX.
(Remote Viewsour Windows interface for UNIXis installed on both
systems.) This guide explains system requirements and how to set up your system
to run your applications. For information about installing our programs and
downloading directories and patches, see this guides platform-specific
installation sections.
In a network setting, new software and updates are normally installed by the
system administrator. If you are not the administrator of your network, you
should ensure that your system administrator has access to this guide.
In providing this guide, we assume that youre already familiar with your
hardware, operating system(s), software, and administrative procedures. If this is
not so, we encourage you to contact us.
This guide explains installation and setup issues related to the following SAP
BusinessObjects products.
Other products may be discussed in their own documentation intended for system
administrators.
Conventions
Description
Bold
Used for file names, paths, emphasis, and text that you should type
exactly as shown. For example, Type cd\dirs.
Italics
Used for emphasis and text for which you should substitute your own
data or values. For example, Type a name for your file, and the .txt
extension (testfile.txt).
Preface
Convention
Description
Menu
commands
Indicates commands that you choose from menus in the following format: Menu Name > Command Name. For example, Choose File >
New.
Chapter 1:
Planning for installation
This chapter provides information about system requirements, disk space, and
work space requirements. In addition, it includes general information about
directories and file structure.
System information
This section provides information on currently supported operating systems and
compilers. For projected system information, see the next section.
Currently supported
operating systems
and compilers
Operating system
Systems tested
Compiler
gcc 4.1.2
gcc 4.1.2
gcc 4.1.2
gcc 4.1.2
gcc 4.1.2
gcc 4.1.2
Solaris 9 32-bit
Solaris 9 32-bit
Solaris 10 32-bit
Sun Studio 12
Sun C++ 5.9
SunOS_sparc Patch 124863-01 2007/07/25
Operating system
Systems tested
Compiler
Solaris 9 64-bit
Solaris 9 64-bit
Solaris 10 64-bit
Sun Studio 12
Sun C++ 5.9
SunOS_sparc Patch 124863-01 2007/07/25
System notes
Library and RAPID users
Our products are compiled only from the C++ compiler. To compile C under
C++, you must use a flag to achieve a C compile (for details, see your vendor
documentation).
If you use one of the newer Windows operating system (such as Windows Vista,
Windows 7, and Windows Server 2008), to view the online help for products that
use WinHelp (.hlp) you must download and install the WinHlp32.exe file from
Microsoft. This executable is not installed with your SAP BusinessObjects
applications.
For more information about this issue (including download and installation
instructions), go to http://support.microsoft.com/kb/917607.
During installation of your SAP BusinessObjects software, the installer may tell
you it cannot locate a library file. Because every system is different, its difficult
to anticipate what libraries are or are not installed on your system.
To install a library, youll need to contact your System Administrator to install the
proper libraries for your operating system. If you are an administrator, youll need
to install the proper RPM (Redhat Package Manager) to get the library you need.
RPMs are packages that contain files that are used to install software on Linux
based systems. For example, with Red Hat Linux:
If youre missing this
libc.so.6 library
glibc-2.12-1.7.el6.i686.rpm package
libGLU.so.1
mesa-libGLU-7.7-2.el6.x86_64.rpm package
System informationprojected
This section provides information on the possible future support by SAP
BusinessObjects Postalsoft solutions for operating systems. For current support,
see the previous section or your products release notes.
Operating systems
and compilers
Operating system
upgrades
Discontinued operating
systems
Its important that you stay current on the operating system versions and updates
that your vendor supplies. As vendors discontinue their support and add new
platforms, Postalsoft must also end support for the old versions in order to
support the current versions. If you use an older version of an operating system,
we recommend that you upgrade in the near future.
Being regulatory driven, SAP BusinessObjects Postalsoft solutions may release
frequent support and service packs. For the latest information on OS support, see
your products release notes.
10
Operating system
Comment
Red Hat 4
SuSE 9
Solaris 9
HP-UX
AIX 5.3
Vendor support ends on 30 April 2012. (CSR 2011 was the last
supported release of AIX 5.3.)
We recommend migration to AIX 7.1.
Supported operating
systemsprojected
Linux SuSE
SuSE 10
SuSE 11 (64-bit only)
AIX
Solaris
Solaris 10
Solaris 11 64-bit
HP-UX (PA-RISC)
HP-UX (Itanium)
11
Space requirements
Space for installing
your application
Other considerations
To install all the files related to an application, you need an adequate amount of
disk space on your system. The following guidelines for selected applications
include the job-file, RAPID, Library program files, and any associated Views
files. These guidelines dont include the space needed directories and other files.
Application
ACE
300 MB
DataRight IQ
350 MB
Label Studio
60 MB
Match/Consolidate
550 MB
Printform
40 MB
Presort
73 MB
In addition to the disk space needed for installation, plan for space for work files,
output data, and accompanying directories (see Using directories on page 15).
You can install our products to a single machine, although you may prefer to
distribute the processing across several machines in some cases. The important
consideration is whether the system can handle all the processing with reasonable
speed, and whether the system has room to store all applications, directories, and
data, as well as work files and output files.
Our applications may create temporary work files that remain on disk as long as
your job is active. You select the directory in which to store the work files and
then clean it up when a job (not a session) is finished.
The size of all work files varies, depending on choices that the user makes during
job setup. A general guideline is to allocate processing space up to 2.5 times the
input. However, extremely intensive processing may require up to six times the
input. For example, if you sort the file by ZIP Code in our ACE application, you
can also improve processing. Here are additional work-space considerations:
Product
12
Presort
Label Studio
Requires 48 bytes per record; so, one million records would require 48
million bytes (46 MB or more) for work files.
Our applications can produce output files and reports. No set formula is available
for estimating their size. However, the output file is typically larger than the input
file because our applications let you add new fields and data. The output file may
be smaller if you choose not to carry over all fields or records from the input to
the output file.
Oracle work file
requirements
jobname.xx.db
jobname.xx.rdb
jobname.xx.def
Jobname is the name of the job file, and xx is the input-file number.
Working with large
files on Windows
If you work with large files (over 4 GB), we recommend that your drives be
partitioned as NTFS rather than FAT32.
Some users have run into problems processing large files (more than 4 GB) when
their drives are partitioned FAT32. They receive an error message no write
space even though the amount of space available is many times that of the file.
After they partition their drive to NTFS, the problem goes away.
13
To minimize drive conflict, store the input file on one physical disk drive, the
output file on another, and our directories on a third disk. This segregation
enables ACE to find data in the directory much more quickly.
An example
If you use only three physical disks (rather than the four pictured), you could
logically partition one disk (for example, C, where the files may be read
only) and reserve the other two disks for output files and directories.
In addition, create subdirectories for directories, input, and output. Do not write
to a root directory. Ensure that you inform users about the new file locations so
that they can insert the correct paths in their applications.
Similarly, some applications (such as Match/Consolidate and Presort) create
large, complex work files, and they may run faster if you store the input files on
one drive and the work files on another.
For example, if your input files are stored on your D drive, you might instruct the
program to place its work files on your E drive or a network drive. You can do
this by setting a parameter in the job file. (Note: Placing work files on a network
drive can slow down an application and counteract the time savings you might
see by splitting the files to different drives.)
Performance
14
Using directories
What are directories?
Directories are lookup files whose data ranges from ZIP Codes to change of
address information. Some applications require directories to run. And some
directories are shared by several applications.
We recommend that you install directories in a common area, such as in /disk_n/
postware/dirs on UNIX, where disk_n is the name or number of the disk where
you install software, or \pw\dirs on Windows.
!
Installing directories
If you use one of our Adaptors and one of our application products (such as ACE
or Match/Consolidate), you may need to install one set of directories for the
Adaptor product in one area of your computer, and another for the application
product in another area of your computer. For more information see the product
documentation.
Directory expiration
The company publishes and distributes the ZIP+4 and supporting directories
under a non-exclusive license from the USPS. The USPS requires that our
software disable itself when a user attempts to use expired directories. (Our ACE
product allows non-mailers to turn off directory expirations. For details, see your
ACE documentation.)
If you do not install new directories as they become available, our products issue
a warning when the directories are due to expire within 30 days. Its
recommended that you heed the warning and install the latest directories to
ensure that your jobs are based on up-to-date directory data.
15
1. Go to https://service.sap.com/bosap-support.
2. Sign in with your S-User ID and password.
3. Scroll to the Download Software & Directories section.
If you are a new customers, click New products releases, installations and
upgrades. If you are an existing customer, click Support packages: service
packs, fix packs, merge modules.
4. Click on the product name. You may need to click the name several times on
subsequent pages.
5. Click the operating system name.
6. In the Downloads box, select the items you want and follow the download
instructions.
7. After you download the ZIP or TGZ file, uncompress it in a temporary
location.
Windows
Unzip the downloaded file and extract the files into a folder. For installation
instructions, see Installing on a single PC on page 21 or Installing on your
network on page 23.
UNIX/Linux
After you use the following directions to uncompress your downloaded file, see
Installing the application on page 35.
TGZ files
ZIP files
To uncompress the ZIP file, use the unzip filename.zip command (for example,
unzip pst800cSP3.zip).
Troubleshooting
If the unzip command does not work, consider these troubleshooting tips:
16
Typically, the unzip executable is found in the /usr/bin directory which may
need to be added to your path.
Another option to uncompress the ZIP file if java is installed: jar -xvf
filename.zip (then use chmod -R 777 *).
For technical assistance, log a support message on the SAP Service Marketplace
by clicking the Help & Support tab and then clicking Report a Product Error.
Choose a component code to route the support message to the core applications
support team.
Component
Products
EIM-COR
EIM-COM
If you need assistance with the Service Marketplace, contact the Customer
Interaction Center (CIC) by email at support.bosapamerica@sap.com or call
(866)890-7686.
17
18
Chapter 2:
Using applications on Windows
19
The applications covered by this System Administrators Guide require that your
machines use specific operating systems. For the most up-to-date information
about current operating system versions, see System information on page 8.
DLLs
Location
\system32
RAM
For servers
If you install to a server, your Windows server should have at least 256 MB of
RAM. If you plan to process large databases or complicated jobs, you should
have 512 MB to 2 G of RAM (or even more) for optimal server performance.
For workstations
If you install to a workstation, you need to use an adequate amount of RAM for
running our Job applications on Windows. For workstations on which you run
Views only, see System requirements for Remote Views on page 45 for RAM
recommendations.
For ACE
If you use ACE, keep in mind that memory caching requires more RAM when
you use DPV, LACSLink, NCOALink, and so on. For more information, see your
ACE Technical Users Guide.
20
For multi-tasking
Multi-tasking demands more RAM. For example, if you simultaneously run a job
program while using e-mail and a word processor, or simultaneously run more
than one job program, you need at least the recommended RAM to maintain
acceptable performance. Also, you can expect that many users will want to add
even more RAM to improve their systems multi-tasking performance.
If you use SCSI hard drives, be sure to use the driver that matches your SCSI
controller card. If you do not, your software may not run properly or. In some
cases, your software may not run at all.
Printer drivers
SAP BusinessObjects applications do not use the Windows printer drivers either
for program output or reports. Instead, report format (lines, width, and header
information) is controlled by settings in the report setup in your job file, not the
Windows Print Manager. The printer codes sent to the printer by the Job program
take precedence over print controls that are part of your Windows environment.
The job programs generate reports in plain fixed-ASCII text format so that they
are compatible with many different kinds of printers. Its recommended that you
periodically check with your hardware supplier for updated drivers for your
Windows system.
Installing on a single PC
You can install and run applications on a single PC. For download instructions,
see Downloading service packs and fix packs on page 16.
See the release notes. If your applications release notes include installation
directions, follow those instructions instead. For example, in some cases
service packs and fix packs are not full installations, and so their directions
may differ from whats written here.
To begin installing
1. Initiate the installer by running setup.exe from the uncompressed ZIP file.
2. Follow all on-screen installation instructions. For example:
Environment variables: The Setup program may ask if you want path and
pw_path set up for you. To have the paths configured automatically,
select Yes. If you select No, see Setting paths manually on page 27 to
set the paths manually.
Remember, you must install the directories in order for the applications to work.
For more information, see Installing directories on page 24.
21
Installing to the
server and the
workstations
Limit each drive partition to 2 GB if you use FAT 16 partitions. (If processing
larger files, its recommended that you use NTFS. For more information see
Two gigabyte partition limit (FAT only) on page 31.)
22
Prepending the path. This prompt applies only to applications installed (for
example, C:\pw\ls; C:\pw\ace; and so on). Regardless of whether you answer
Yes or No to modifying variables, all of our program installers on Windows
automatically prepend c:/program files/common files/firstlogic to the path
environment variable.
When prompted to install path and pw_path, click Yes to automatically have
the paths configured, as necessary. If you click No, see Setting paths and
permissions manually on page 27.
23
Setting up
workstations
After you install the application to your Windows server, go to the workstation
and set it up.
To set up a workstation
1. To make sure you have a clean environment, close all applications and reboot the workstation.
2. Be sure to share the pw directory on the server before you set up the
workstation.
3. From the client machine, map the pw directory or parent directory in the
server machine to a local drive (for example, x:) in the client machine.
4. Choose Start > Run.
5. At the Run prompt, type x: \pw\client\setup (x: is the mapped drive to which
this application was installed on the server. If you use a directory other than
pw, substitute that name for pw here.). Click OK.
The installation program copies the appropriate DLLs for the workstations
operating system and sets up the application icons.
Installing directories
Several applications use the same directory information. SAP BusinessObjects
recommends that you place the directories in a common area, such as \pw\dirs.
For a list of directories that are necessary for your application to run, see Using
directories on page 15.
24
If the Adaptor or RAPID and the stand-alone application are on the same
machine, conflicts may occur. What causes the conflicts? Your path and pw_path
environment variables point to locations of your products. If you try to run your
Adaptor or RAPID but your environment variable points to the stand-alone
application location first, the Adaptor or RAPID tries to use the software installed
for the stand-alone application, and vice versa.
To avoid this conflict
1. Set up different user profilesone for the Adaptor or RAPID and one for the
stand-alone application.
2. Set the environment variables in the Adaptor user profile to point to the
location of the Adaptor software as specified in the Adaptors users guide.
Likewise, set the environment variables in the RAPID profile to point to the
location of the RAPID software. See Setting paths and permissions
manually on page 27.
The environment variables in the stand-alone application user profile should
point to the location of the stand-alone application.
Using batch files
You can use Windows batch files to run the stand-alone application and the
Adaptor or RAPID from the same system. The following example shows a batch
file launching the ACE job file.
@echo off
set path=C:\pw\adm;C:\pw\ace;%path%
set pw_path=C:\pw\adm;C:\pw\ace;%pw_path%
pwace C:\pw\acejob.ace
This line launches the
ACE job-file program.
When you use this procedure, the application that you run from the batch file uses
the environment that you set up in the batch file. All other applications that you
run use the normal environment variables that are set up for the user who is
logged in. A command-prompt window remains open until you close the
application that you launched from the batch file.
To use batch files
25
Enabling and
disabling access
26
The RDB file contains descriptive information about the database. This file takes
the place of the input file and the FMT file in the Match/Consolidate job setup. To
run Match/Consolidate with Oracle access, users need to enter the following
information in their RDB file.
Setting
Description
UID
PWD
DSN
Database file.
SELECT
Statement that tells Oracle the data to retrieve from the database.
To initiate or disable Oracle usage, run set_ora.bat. For more information, see
Accessing an Oracle database on page 40.
Your Windows operating system uses a path to know where to look for installed
programs. This path lists all the directories that the operating system will search
in for an executable file. For the operating system to execute applications, your
pw directories must be included in the path statement.
In addition to an operating system path, our applications use pw_path, which
must include the name of the directory for each program that you are installing.
Setting paths
manually
The installation program prompts you to add our path and pw_path variables to
your operating systems path. However, at times you may need to enter or adjust
them manually. So, after you install our applications, you must edit the path
statement and add the pw_path statement.
The installation program for Views applications updates the system registry, but
underlying code requires that path and pw_path be set.
After you set path and pw_path for your applications, you dont need to set them
again for program revisions or updates. If you add another product, you need to
add only that products directory to the path and pw_path statements.
Environment variables
If you use a Windows operating system, you can set paths and other environment
variables as user or system variables.
Variable type
Discussion
User
applies only when the appropriate user name logs into the system.
System
A system variable is applicable to everyone who logs into the system. (Only a system administrator can set system variables in a supported Windows operating system.)
If you choose to set path and pw_path as user environment variables (rather than
as system variables), be sure to do so for each user who accesses applications.
27
Product directories
The purpose of setting path and pw_path statements is to tell your operating
system where to find installed applications. To help you do that, the table below
lists the syntax that you should type in the path and pw_path statements for each
product that you own (assuming that you installed in the default directory).
Separate entries with a semi-colon (;).
For more information about setting path and pw_path, see the specific
instructions for your Windows operating system on the following pages.
Permissions
All products
adm
rapid
ACE
ace
ACE Library
acelib
DataRight IQ Library
dtr_iqlib
Global Match
gmatch
mtc
Label Studio
Match Library
mtc
Match/Consolidate
mpg
28
Presort
pst
Remote Views
csgui
ZipCount
la
System variables are available to every user logged on the system. Administrative
rights are required to set system variables.
User variables apply only when the appropriate user name logs into the system. If
you decide to create path and pw_path as user variables, be sure to do so for each
user who accesses applications.
29
If this is the first installation of any programs, you do not yet have a pw_path
variable. You need to create and define the variable.
To create the pw_path variable
When you verify environment variables, you use the System Information utility.
To verify your environment variables
30
Uninstalling applications
You can uninstall any application that you installed in the recommended manner.
Your process may differ: The directions for uninstalling may vary slightly
depending on your version of the Windows operating system.
To uninstall
In batch files and some text files, a long file name that contains a space must be
enclosed in quotes.
Bookmarks
When we distribute an update to an online help file, it might not accommodate all
of the bookmarks that you have placed in the previous version of the on-line help.
You may need to re-enter bookmarks in the updated file.
Two gigabyte
partition limit (FAT
only)
Any FAT partition is limited to two gigabytes, whether the partition is local or on
a network drive. The NTFS system is not affected by this limit.
Network
troubleshooting
We may be able to help you with a basic assessment of some network issues.
However, we cannot serve as your network administrator. Serious network
problems may require the services of a consultant or systems engineer.
In addition, note that any Windows version could create a FAT partition and in
that event, the partition should not exceed two gigabytes.
31
If you report problems running our program(s) on your network, we will attempt
to reproduce the problem using the same server and workstation operating
systems that we use for testing.
Problems with work files
on network drives
Applications group
Some of our customers have reported intermittent problems accessing work files
when the files are stored on a network drive. If you use a PC-based server,
consider the following tips to ensure proper work-file storage on your network.
Correct hardware deficiencies. Data issues can result from some simple
network problems, such as defective hard drive cables, terminators, network
cable, network cards, and related accessories. By correcting a problem with
any of these components, you can prevent losing valuable data.
Separate read and write. To minimize drive conflict, store the input file on
one physical disk drive, the output file on another, and SAP BusinessObjects
directories on a third disk.
Service Pack. Make sure that the correct Service Pack is installed to your
Windows operating system.
The first time you install a SAP BusinessObjects product, the setup utility adds an
Applications group in your Start menu. Most of our applications will be
represented there.
The appearance of your applications group may vary depending on your
applications and the version of your Windows operating system.
Samples subdirectory
The setup utility automatically defines the samples subdirectory as the working
directory for each product (in Windows, the working directory is referred to as the
start in property). Each samples subdirectory holds the quick tour files that
users can use when theyre first learning how to use products.
When users become familiar with SAP BusinessObjects products, you may want
to define the data directories as their working directory, rather than the samples
directory.
32
Chapter 3:
Using applications on UNIX
ACE Views
DataRight IQ Views
Match/Consolidate Views
Presort Views
Label Studio
System recommendations
Recommendation
Operating
system
For information about the UNIX platforms and versions that SAP
BusinessObjects supports, see System information on page 8.
Processor
RAM
If many users or
multi-tasking
If you plan to support a large number of users or if you plan to multitask, its recommended that you employ high processor speed and
advanced memory configurations.
For best performance, separate input, output, and directory locations
(see How disk space affects performance on page 14).
33
Note
Layer in the appli- Identifying this variable means that 32-bit data path can reliably
cation system used send data up to the 64-bit application. (Sending 64-bit data paths
to 32-bit applications is not recommended.)
Data path type of
communication
between the layers
A direct example
34
You can use Match/Consolidate with other job file products. In the scenario
below, notice that Match/Consolidate and Oracle are all 32-bit applications.
Type an installation directory name. Type Y to verify the path and then
press Enter to continue.
Do not include postware as part of the path; a postware subdirectory is
automatically added to the directory specified.
35
If you want to customize the products you want to install, type a comma
separated list of numbers representing the features that should be
deselected and press Enter (for example, 1, 3, 4).
The installer asks you to preview the list of products you want to install.
Press Enter to continue, or type back to go to the previous screen to change
your selection.
8. When all products are successfully installed on your machine, press Enter to
exit the console.
9. To complete the installation of your product you must also install the
directories. See Using directories on page 15.
Your operating system uses a path environment variable to know where to look
for installed programs. The path lists all the directories in which the operating
system will search for an executable file. In addition to an operating system path,
our products use pw_path, which also must include the name of the directory for
each of the installed programs.
License Manager: For information about setting environment variables for
License Manager, see the License Manager appendix. (License Manager is
required for ACE and Presort users.)
Setting paths
manually
You must manually set program directories to the operating systems path and
pw_path. After installing our programs, instruct users to edit the path statement
and add the pw_path statement in their login script file using the product names
shown below.
After you set path and pw_path for your programs, you do not need to set them
again for program updates. If you must maintain two versions of a program
simultaneously (for example, during a transition in postal regulations), you may
need to change path and pw_path statements. Be careful that only one version is
active at a time. If you purchase another Business Object product, add that
products directory to the existing path and pw_path statements.
Permissions
Its the responsibility of the network administrator to set access permissions after
installing programs. Users need read and execute access to the /disk_n/
postware directory and each subdirectory: adm, dirs, and so on. Normally, users
should not have write access to those directories; only to those that house their
data, jobs, and so on.
.
36
Product
All products
adm
rapid
ACE
ace
ACE Library
acelib
DataRight IQ
dtr_iq
DataRight IQ Library
dtr_iqlib
Label Studio
ls;ls/system
Global Match
gmatch
gmtc
Match Library
mtc
Match/Consolidate
merge
Match/Consolidate Library
mplib
Presort
presort
Remote Views
csgui
ZipCount
la
How you set environment variables may differ depending on the shell you use.
The following instructions show how Bourne and C shell users can set path and
pw_path.
If this is the first time that you have installed any application, add the pw_path
line. Then, if you purchase another product later, just add the entry for that
product to the existing lines. For the correct product abbreviations, see Product
path settings on page 37.
Bourne shell
If you use Bourne shell, add product entries to your .profile or .login file. For
example:
PW_PATH=/disk_n/postware/adm:/disk_n/postware/dtr:/disk_n/
postware/ace
PATH=$PATH:$PW_PATH
export PATH PW_PATH
37
Bourne shell
(Label Studio specific)
C shell
If you use C shell (Berkeley), add product entries to your .cshrc file. For
example:
setenv PW_PATH /disk_n/postware/adm:/disk_n/postware/ace
setenv PATH ${PATH}:${PW_PATH}
C shell
(Label Studio specific)
38
In addition to setting path and pw_path, you must also set the shared library path
environment variable for each user in the appropriate login script. This ensures
that products use the correct files from the product folders in the /disk_n/
postware/ directory.
To set the shared library path
Environment
AIX
LIBPATH
HP-UX
SHLIB_PATH
Linux
LD_LIBRARY_PATH
Solaris
LD_LIBRARY_PATH
Here is a list of the shared library product path settings. Select the path name for
the product(s) that you own.
Product
all products
postware/adm
ACE Library
acelib
DataRight IQ
dtr_iq
DataRight IQ Library
dtr_iqlib
Match Library
mtc
Match/Consolidate Library
mplib
39
You must set the shared library path environment variable for each user in the
appropriate login script. If you use Match/Consolidate Remote Views, you also
need to set the shared library path environment variable in the system start script.
This ensures that Match/Consolidate uses the right libfloci files from the /disk_n/
postware/adm subdirectory. The libfloci is Match/Consolidates link to your
Oracle client software.
To set the shared library path
1. Determine the appropriate shared library path from the table below. Then
perform step 2 or 3.
Platform
Environment
Solaris
LD_LIBRARY_PATH
HP-UX
AIX
LIBPATH
Accessing an Oracle
database
1. Set the environment variables for your system (for more information, see
Setting path and pw_path on page 37).
2. Set the shared library path environment variable (as shown previously).
3. Log out and log in again to activate the changes. Log in as the user whose
script was updated.
4. At a command prompt, type the echo $environment variable to confirm that
the shared library path variable is set. For example, type:
echo $LD_LIBRARY_PATH
Your system should display the following response:
.../disk_n/postware/adm.
40
No Oracle support
Oracle 9i support
Description
UID
PWD
DSN
Database file.
SELECT
Statement that tells Oracle the data to retrieve from the database.
The RDB file contains descriptive information about the database. It takes
the place of the FMT file in the Match/Consolidate job setup.
Disabling access
To install on Solaris, run install.bin (for more instructions, see Installing the
application on page 35). If this method doesnt work, try one of the following
methods.
Option 1:
Set file permissions
Before you run install.bin, set all file permissions to a minimum of 755. For
example, type chmod 755* at the command line.
Option 2:
Install with JRE
If you have a Java Runtime Environment (JRE) version 1.4.2 or newer on your
system, run the install using that JRE. To do this, run install.bin passing in the
path to the JRE executable. For example, you would type install.bin /opt/java/
bin/java at the command line.
The Object Data Manager (ODM) processes DPV records. If you use AIX, you
need to make sure that the ODMDIR variable is set before processing. To display
the path to the ODM directory (for example, /usr/lib/objrepos), type the
following command: echo $ODMDIR. If the path does not exist, you need to set it.
41
Match/Consolidate on
Solaris, and HP-UX
When you run Match/Consolidate with an Oracle database, additional work files
are created in the work file directory. One of these (the .db file) may become very
large, depending on the size of fields and number of records that you work with.
To calculate how large this file may be, multiply the combined length of all
selected fields by the total number of selected records (or rows). This number (in
bytes) is roughly the size of the .db file. For example, if the combined length of
all selected fields is 150 characters, and there are 200,000 selected records, then
the size of your .db file would be roughly 30 million bytes, or 30 MB.
Make sure that you have enough disk space to accommodate these work files:
jobname.xx.db
jobname.xx.rdb
jobname.xx.def
Jobname is the name of the job file and xx is the input file number.
Some users of RAPID also use a stand-alone (batch) application such as ACE or
Presort. If RAPID and the stand-alone application are on the same machine, you
may encounter conflicts.
To avoid this conflict, its recommended that you set up different user profiles:
one for RAPID and one for the stand-alone application. Set the environment
variables in the RAPID profile to point to the location of the RAPID software as
shown in Product path settings on page 37.
The environment variables in the stand-alone application user profile should
point to the location of the stand-alone application, as specified in Setting
environment variables on page 36.
42
Chapter 4:
Using Remote Views
This section contains specific information about Remote Views such as installing,
setting multiple instances of the server, and using the Remote Views client.
Remote Views is an additional module that is included with the UNIX job-file
versions of select products. SAP BusinessObjects offers the following Remote
Views applications:
ACE Views
DataRight IQ Views
Match/Consolidate Views
Presort Views
Label Studio
The Remote Views module allows a Windows client to configure and run jobs on
a UNIX server. Remote Views supports batch processing only.
43
Your users need to learn only the client side of Remote Views. After they create
and verify a job file in their Views interface, they issue the Run Job command,
still from within Views. The UNIX server processes their instructions and issues
progress messages to the Windows client.
Only you, as the system administrator, need to be concerned with the technical
details about how the server side of Remote Views works. Here are some of those
details:
Remote Views installs one Remote Views Server (vserve), which spawns a
process for each product.
Product
Process
ACE Views
vserveace
DataRight IQ Views
vservediq
Label Studio
vservels
Match/Consolidate Views
vservempg
Presort Views
vservepst
44
The system administrator activates the server side (vserve) with root
permissions. Root is needed so that vserve can use key UNIX system
services, such as user and password authentication (for network security
reasons, information known only to root). After the login authentication
process is complete, vserve changes user from root to the user who requests a
task.
Remote Views can support 64-bit applications. However, if you use 32- and
64-bit applications together, you must install the 32-bit applications first. For
more information, see Combining 32-bit and 64-bit applications on UNIX
on page 34.
Use a UNIX server that has a supported operating system. For the most up-to-date
information about supported versions and patches, see System information on
page 8.
Your UNIX server should meet the following system requirements (in addition to
the system requirements listed in the Windows section of this documentation):
TCP/IP enabled.
Adequate disk space for Remote Views: approximately 12 MB, plus space
for the job file software. See Space requirements on page 12.
Adequate disk space for directories. See Using directories on page 15.
64-bit operating systems receive a 64-bit executable for the UNIX server. If you
need to update your shipments, contact your SAP BusinessObjects account
manager. Windows clients remain 32-bit because those are 32-bit operating
systems. However, if you have a 64-bit UNIX application on a 64-bit UNIX
operating system, a job runs at 64-bit.
When you combine 32- and 64-bit installations to the same system, always
install the 32-bit product versions first.
Windows client
TCP/IP enabled
512 MB RAM
These requirements assume that Views is the only application that you run on the
client workstation. If you run additional applications, see the Windows section in
this guide.
45
When you combine applications on the same system, install the 32-bit
applications first, followed by the 64-bit applications.
In most cases, Remote Views installs with all supported UNIX media for ACE,
DataRight IQ, Presort, Label Studio, and Match/Consolidate.
To install the Windows Views application on each Windows client workstation,
follow the information in Installing on a single PC on page 21.
Updating your Remote
Views application
When you receive an update of your Remote Views application, you need to
reinstall your application and the server and client.
To update your Remote Views application
1. Stop the Views server (vserve). See Stopping the Views server on page 51.
2. Reinstall the server software. See one of the following:
a) Installing on a single PC on page 21.
b) Installing on your network on page 23.
3. Reinstall the client software. See one of the following:
a) Installing on a single PC on page 21.
b) Installing on your network on page 23.
c) Installing client software on page 52.
4. Restart vserve. See one of the following:
a) Starting the Views server manually on page 50.
b) Starting Remote Views automatically on page 51.
When you complete the previous steps, your system should be ready to run
your Remote Views application again.
46
Editing the
configuration file
(params.cs)
It controls how the Remote Views server opens the TCP/IP communication
ports that clients use to activate the Remote Views server
It sets locations for the Run Job log file and the Match/Consolidate Match
Percent dictionary
It controls whether open job files are saved when the network connection is
lost
To configure the application, you need to edit the parameters in the server
configuration file.
To edit the configuration file
4. Edit the parameters (you must supply an entry for the first five parameters).
For information about the first five parameters, see the following table.
Caution: If your file contains commented lines, params.cs will not run.
47
Parameter
Discussion
Enter the range of port numbers that will support the Run Job menu option from the
client. The engine sends progress messages and needs a range of available port numbers
for multiple instances of the Run Job command. We recommend that you start by
reserving 10 ports.
If you define an inadequate number of ports, the client may fail to connect. It is rarebut
possiblefor the client to connect under these circumstances but to still receive incorrect
progress messages. Although the screen display would be incorrect in this case, the job
will actually process correctly. To prevent this, calculate the number of multiple instances
of Run Job that is likely to be initiated in a multi-user environment and reserve one port
per instance.
Select different port numbers for the server and engine ports.
Active/Completed
Jobs File Location
Type the name of the directory on your UNIX server in which to store the Run Job status
log. This location must be accessible to all users (for example,
/disk_n/postware/csgui/status). If the content that is output by vserve exceeds
preferred application disk space, you may place the status directory elsewhere, provided
that it has permissions accessible to all Remote Views users.
The first time the client activates the Run Job option, the server creates a single Run Job
status log file per user. It names the file using the format username.jobslog.log. It
appends entries to the file regardless of which Views product you run.
In the status log file, youll find the following data:
Remote Views client users can view their own status logs only within the application.
However, by specifying a central directory, you can view all status logs, if necessary,
with any UNIX text editor. Do not edit the file; if you do, Run Job status messages may
not appear properly in the Remote Views client.
Jobfile Save Setting on This parameter controls the disposition of job files that are open when a network
Lost Connection
connection between client and server is lost. If you want to save any pending changes to
such job files, type 1. To discard any changes and revert to the last saved version of the
job file, type 2.
Match/Consolidate
Match Percent
Dictionary
48
Type the full path and file name for the Match/Consolidate Match Percent dictionary.
This dictionary is used by only Match/Consolidate Views. If you did not install Match/
Consolidate Views, leave this parameter blank.
You can add path and pw_path to your root profile. In this way vserve can be
started without setting up the environment. For syntax examples, see Setting
path and pw_path on page 37.
Creating the
environment file
By following the steps below, you create an environment file in the roots home
directory called .flprofile. You execute it by using the dot command before each
time the vserve process is started.
To create the environment file
Match/Consolidate
This example shows the shared library setting for Solaris. For the equivalent
HP-UX and AIX variable names, see Setting the shared library path on
page 40.
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/disk_n/postware/adm:
export LD_LIBRARY PATH
PW_PATH=/disk_n/postware/adm:/disk_n/postware/csgui:/disk_n/postware/merge
export PW_PATH
PATH=$PATH:$PW_PATH
export $PATH
49
At this step, SAP BusinessObjects recommends that you start the server manually
first (as explained below). When you are sure that the server is ready to accept
connections, add it to your UNIX server startup.
Starting the Views
server manually
Remember, if you dont want messages to display on the console, you can
start with the nohup command.
4. Change the directory to /disk_n/postware/csgui
5. At the command prompt type one of the following lines:
vserve params.cs &
./vserve params.cs &
When the manual instance of the server starts properly, you may see the
following message echoed in the shell:
Views Server ready to accept connections
50
If the Remote Views server detects an error during processing, it writes an error
report to a server log file. This log file is located in the current working directory
where vserve is initiated (for example, /disk_n/postware/csgui). Remote
Views does not create the log file when the server is initialized; it does so only
when it records a processing error.
The server names the log file as follows:
vserve.log.xxxxxx.mmddyyhhmmss (where xxxxxx is a random string)
Correcting errors
Adding multiple
instances
Most network users will find a single server (vserve) adequate to support Remote
Views, because vserve internally spawns additional processes. If a single instance
proves inadequate to handle a high volume of Views activity, see Creating
additional instances of the server on page 54.
If you need to stop the Remote Views server, you (as user root) must find the
process ids for any active, running vserve instances (for example, ps -ef|grep
vserve) and issue the UNIX kill command to stop the process(es) (for example,
kill -9 pid).
Before you can restart automatically, you need to stop the vserve that you
started manually. If you dont do this, you receive the message:
vserve: gis_init failed... program terminated.
Starting Remote
Views automatically
You can set up the Remote Views server to start automatically whenever the
server is re-booted and to continue to operate when the root logs out. To do so,
include these instructions in your UNIX servers preferred systems start
instructions. (See Creating the environment file on page 49.)
Here is an example:
. ./.flprofile
cd /disk_n/postware/csgui
./vserve params.cs &
For the path name (/disk_n/postware/csgui) and the command line start
instruction (vserve params.cs & for C shell; nohup vserve params.cs & for
Bourne shell), do the following:
When you install Remote Views, you also copy job file versions of ACE, Match/
Consolidate, and/or DataRight IQ to the UNIX server. You must properly
configure that job file software for Remote Views to be able to issue the Run Job
command from the client.
51
After you install the server software and the server is ready to communicate,
install the client software to each Windows workstation. Before you install the
client software, at each client machine, enable TCP/IP communication protocol
within the operating system.
To obtain the client software
1. Initiate the installer by running setup.exe from the uncompressed ZIP file.
2. Follow all on-screen installation instructions.
Note: We do not currently support the client setup utility from within Views,
nor do we support shared use of the Views software for Remote Views users.
As a result, you must install the client software on each workstation from
which you might use it.
Editing the
configuration file
The vws_hsts.dat file is the source of connection data from the Remote Views
client (you cannot add server names from within the Views application). Each
line in vws_hsts.dat represents a UNIX server port where the Remote Views
server is waiting for data from the client.
With your client software, we supply a template for the configuration file
(vws_hsts.dat.new). To configure the software, you must edit the file.
52
3. Open vws_hsts.dat and edit the file (for more information see Editing the
vws_hsts.dat file on page 53).
When you start a Remote Views application, a drop-down list appears in the List
of Servers window, from which you must select the appropriate server port. The
drop-down list reflects each line of connection data that you configure in this file.
Editing the
vws_hsts.dat file
When you edit the vws_hsts.dat file, use the following guidelines:
Use each line of the file to identify a server hostname. Define only one server
hostname per line. (Note: If you have only one server to connect to, you need
only one line.)
For each hostname define three parameters (see the table below).
Parameter
Direction
Hostname
description
Hostname
Port number
Type the port number on which the Remote Views server is listening. On the server, this is defined as the server port number in
params.cs. For details about the Remote Views servers
params.cs file, see Configuring the Remote Views client on
page 52.
Add spaces for legibility, if you want. But keep in mind that spaces are
truncated in processing.
Commenting lines
When you place an asterisk (*) as the first character in a line, the Remote Views
client will not process that line. Therefore, you may add comments to your file by
adding an asterisk as the first character of the line. Remote Views ignores blank
lines.
Example
As the Remote Views client reads each line in vws_hsts.dat, it skips over the
hostname description, and passes hostname and port number values to its
Windows client to connect to the Remote Views server.
After you complete a vws_hsts.dat file, copy it to c:\pw\csgui for any
additional Remote Views client that will share the same server.
53
Type this
C shell
Bourne shell
54
When users work at a Windows client workstation, they should use their own
login. If they use a shared login, it may result in a jobs log file that is too large
per user for the UNIX server to manage.
In addition, SAP BusinessObjects recommend that users edit their own jobs. If
they share jobs, you must review directory and permission rights on the UNIX
server.
Editing jobs
Remote Views client users edit jobs in remote mode much like Windows users
edit their jobs, with the following exceptions:
If the Windows system is set up for Remote Views, select the Remote mode
from the Select Views Connection window. If Local Mode is not licensed, the
Remote Views client assumes remote processing. It will skip the mode
selection screen, and proceed directly to the List of Servers window.
In Remote mode, Remote Views prompts the user for their UNIX username
and password to log in to the server.
The browse command finds and selects UNIX path-style names on the UNIX
server.
The Run Jobs command will activate the UNIX servers job file software.
The Job Status menu option enables you to view and manage the contents of
the Run Job status file. The users view is restricted to their own status log.
Each user may opt to delete a log entry, delete a log entry with the
corresponding job files log file, or terminate a job that is in progress.
The File Transfer menu option is a handy, simplified tool, useful for
transferring small files between the server and client (for example, if a client
session creates a job locally). However, it can transfer ASCII files only. If a
user needs to transfer other file types or large files, we recommend that you
help them by using the file transfer protocol (FTP) utilities enabled on your
UNIX servers operating system.
If the server and client do not communicate, before you call Customer Assurance
for assistance, see Troubleshooting and tips for Remote Views on page 56.
55
the most recent vserve.log.* file (if it exists) from the UNIX server
the client configuration file vws_hsts.dat (if you have completed the client
installation steps)
Windows
When this guide uses the term Windows in the section, it refers to the
workstation edition of the operating system because, generally, a Windows client
would be a workstation rather than a server.
Problem: You dont receive a Ready to accept connections response from the
Remote Views server (vserve).
Symptom
Remedy
Vserve not found Be sure that /disk_n/postware/csgui is set in pw_path and check
whether your system requires the syntax ./vserve params.cs &.
Pwsysmsg.4b not Be sure that /disk_n/postware/adm is set in pw_path. Also,
found
check if the system requires the syntax ./vserve params.cs &.
gis_init failed...
program terminated
Connection failure
56
This occurs if you attempt to restart vserve while the Remote Views
server is still running. Either stop the vserve (see Stopping the
Views server on page 51) or configure an additional vserve (see
Creating additional instances of the server on page 54).
Problem: A Remote Views client fails to establish a connection and work with
the Remote Views server.
Symptom
Remedy
pvmsg.txt not
found
Unable to locate
vws_hsts.dat
Check that you have properly set up the vws_hsts.dat file and
placed it in the proper location. Also, check that you have included
c:\pw\csgui in pw_path on the client.
Hostname not
found
Symptom
Remedy
Invalid password
If, on remote login, the user name works, but the password fails,
vserve might not be able to find the shadowed or hidden password
files on the UNIX server. Ensure that vserve started as user root.
Provide vserve with read privileges to the password file.
In Remote Views, job files edited from the PC client carry UNIX
directory and file permissions. One user cannot open another
users jobs unless the UNIX system administrator provides shared
permissions. Start the server from root; it will change to the proper
user permissions as it receives requests to edit files.
Verifying hostnames
To find the local hostname of your UNIX system, at a UNIX command prompt
type hostname and then press the Enter key.
Verifying domain
names
The Domain Name System (DNS) provides a standard naming convention for
machines on IP-based systems. As networks grow, your company may develop a
variety of domain names, usually in a hierarchical arrangement.
Remote Views needs to use your higher-level domain name (for example,
yourcompany.com). Increasingly, Windows-based systems refer to this higherlevel domain name as your DNS suffix.
Verify the higher-level domain name of the UNIX server, and then test the
hostname.domain server name from the Windows client with the ping command.
Type ping hostname and then press the Enter key.
In most cases, a successful ping responds with the format hostname.domain, as in
the following example:
PING hostname.yourcompany.com: (111.11.1.1): 56 data bytes
64 bytes from 111.11.1.1:icmp_seq=0 ttl=255 time=5ms
64 bytes from 111.11.1.1:icmp_seq=1 ttl=255 time=0 ms
Tip: You may need to press Ctrl C to stop the ping test. If hostnames fail, you
might be able to achieve suitable results by substituting the IP Address. If you
substitute the IP address, exercise care, because some networks use dynamic
addressing, which changes the IP Address of a system to meet system
requirements.
Verifying between
systems
You can verify data on either the system on which you are working (by using the
local hostname or IP address) or a remote system (by using the hostname or IP
address of the remote system). You can verify this data by using Ping, a network
communication utility.
Ping is especially useful for testing communication between systems when you
believe you have identified the correct hostname and domain name.
In general, you can verify the communication activity of either your own
hostname or the remote host to which you are trying to connect from Remote
Views. You can use Ping to verify the address and existence of the remote host
when you receive an error message from within Remote Views.
57
Using Ping
Try to ping the remote UNIX server from the Windows client to verify that the
hostname.domain construction in vsw_hsts.dat is a live connection. Type:
ping hostname and then press Enter
or
ping IP address and then press Enter
For detailed instructions on using the Ping command, see your operating system
documentation.
If Ping works
If Ping is enabled and the command is successful, you see a result similar to the
following:
Pinging hostname.yourcompany.com [111.11.111.111] with 32 bytes of
data:
Reply from 111.11.111.111: bytes=32 time<10ms TTL=128
Reply from 111.11.111.111: bytes=32 time<10ms TTL=128
Reply from 111.11.111.111: bytes=32 time<10ms TTL=128
Reply from 111.11.111.111: bytes=32 time<10ms TTL=128
Ping statistics for 111.11.111.111:
Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
Minimum = 0ms, Maximum = 0ms, Average = 0ms
If Ping fails
When the Ping utility cannot locate the remote host, it responds with an error
message (for example, Bad IP address hostname).
If the ping fails, reverify the hostname.domain string as you have identified it in
vws_hsts.dat. If the ping command fails to connect again with the verified
hostname.domain name, confirm that the remote host is active and that your TCP/
IP is properly configured on both the remote host and local client.
Performing DPV
processing on the AIX
platform
The Object Data Manager (ODM) processes DPV records. If you are running
AIX, you need make sure the ODMDIR variable is set before processing. Type
the following command to display the path to the ODM directory (for example, /
usr/lib/objrepos):
echo $ODMDIR
If the path does not exist, you need to set the path.
58
Appendix A:
License Manager
What is License
Manager
License Manager is a SAP BusinessObjects application that lets you manage your
product activation keycodesthe numeric codes that are referred to each time
that you run certain products.
By using the License Manager application, you can view, add, and remove
product activation keycodes for products (such as ACE and Presort) that require
them.
Local system only. License Manager accesses keycodes on the local system
only; you cannot access the keycodes from a remote system.
Whats different
Before the release of ACE version 7.81c and Presort version 7.82c, some
products were keyed using the old Firstlogic system. Now these products are
protected (or keyed) in a way that lets you unlock their functionality more
efficiently.
In the old system, when you purchased another product or feature later, you were
sent an additional product CD that contained your new product or feature. With
this new system, when you purchase a new product or feature, you can
immediately activate that new functionality with the new product activation
keycode that SAP BusinessObjects provides.
59
On UNIX
If you use Windows, you dont need to perform any manual setup of License
Manager. Environment variables are set when License Manager is installed.
On UNIX
If you use UNIX (ACE and Presort users only), you need to set the environment
variable (BOE_REGISTRYHOME) for License Manager.
Although you can use a different setting, its strongly recommended that you use
/var/opt for BOE_REGISTRYHOME.
If you use Bourne shell, add product entries to your .profile or .login file. For
example:
BOE_REGISTRYHOME=/var/opt ; export BOE_REGISTRYHOME
If you use C shell (Berkeley), add product entries to your .cshrc file. For
example:
setenv BOE_REGISTRYHOME /var/opt
60
You can run License Manager either as part of the installation process (the
installation program prompts you to start License Manager) or later. If you choose
to run License Manager later, you can either locate where its installed or access it
through the Start menu.
To start License Manager (Windows)
On UNIX
Business Edition: On the Start menu, go to Programs > Postalsoft > License
Manager.
To run License Manager on UNIX, you need to locate where its installed and
then execute its shell script.
To start License Manager (UNIX)
Start License Manager. When you click the shortcut on the Start menu (Windows)
or execute the shell script (UNIX), the License Manager window displays your
key code(s) sorted alphabetically.
To add a product activation keycode
1. In the Add Key Codes text box, type the keycode(s) that you want to add
(each keycode must be on a separate line) and click Add.
2. When you have added your key code(s), click Done.
3. To make sure the new keycode(s) take effect, restart your application.
To remove a product activation keycode
1. In the Registered Keycodes text box, select the keycode(s) that you want to
remove and click Remove.
2. When you have removed your keycode(s), click Done.
3. Restart your application.
61
62
Index
Numerics
32-bit operating system, and 2GB file size, 42
A
activating Remote Views server, 50
Active/completed jobs file location, parameter, 48
Adaptors, 15
AIX, 41
F
files
batch for RAPID and Adaptors, 25
DLL, 20
B
Bourne shell, setting boe_registryhome, 60
Bourne shell, setting path and pw_path, 37
C
C shell, setting boe_registryhome, 60
C shell, setting path and pw_path, 38
client
configuration file, 52
guidelines for using, 55
Remote Views, 52
system requirements, 45
compilers, 8
configuration file
Remote views, 52
configuring
Remote Views client, 52
root, 49
server, 47
connection
server and client, 56
verifying, 57
H
hostname, 53, 57
I
installation
directories, 15
on Solaris, 41
planning
Remote Views, 46
UNIX, 35
Windows network, 22
Remote Views client, 52
Windows
applications on network, 23
applications on single PC, 21
instances, multiple server, 54
invalid password, 56
J
Job file save setting on lost connection, parameter, 48
directories
Adaptors, 15
expiration, 15
installation, 15
Windows, 24
introduction, 15
product names, 28
disk space
performance, 14
Remote Views, 45
requirements, 12
domain, verifying, 57
drive conflict, minimizing, 14
License Manager, 59
installing, 60
setting up, 60
starting, 61
Links
stand-alone application on UNIX, 42
stand-alone application on Windows, 25
login, Remote Views, 55
E
editing jobs, Remote Views, 55
engine port number, parameter, 48
environment file
M
Match percent dictionary, parameter, 48
Match/Consolidate
Oracle on UNIX, 40
Oracle on Windows, 26
multiple instances, 54
creating, 54
Remote Views, 51
Index
63
O
operating systems, 8
Oracle, 42
Match/Consolidate on UNIX, 40
Match/Consolidate on Windows, 26
work file requirements, 13
P
path
product names, 37
setting
manually on Windows, 27
Remote Views, 49
UNIX, 37
Windows XP, 29
variables
Windows XP, 29
performance
how disk space affects, 14
optimizing, 14
ways to boost, 35
Windows, 22
permissions, 28
setting on UNIX, 36
setting on Windows, 27
ping, 57
platforms, 8, 10
processing
improving speed, 14
product path names, 37
projected system requirements, 10
psinstall
creates subdirectories, 35
pw_path
setting
Remote Views, 49
UNIX, 37
Windows XP, 29
variables
Windows XP, 29
R
RAM, 45
RAPID
stand-alone application on UNIX, 42
stand-alone application on Windows, 25
user profile on UNIX, 42
Remote Views
activating, 43
activating server, 50
client, 44
client/server connection, 56
configuring
client, 52
root, 49
server application, 47
connection, 56, 57
creating
environment file, 49
multiple instances, 54
editing jobs, 55
64
environment variables, 51
error report, 50
hostname, 53
individual login, 55
introduction, 44
list of products, 43
manually starting server, 50
multiple instances, 51
server, 44
setting path and pw_path, 49
starting automatically, 51
stopping server, 51
system requirements, 45
troubleshooting, 56
using client, 55
removing the product, 31
requirements
disk space, 12
Oracle work file space, 13
output file space, 12
Remote Views system, 45
report file space, 12
space, 12
system, 7, 8
UNIX, 33
operating system, 33
processor requirements, 33
Windows
operating system, 20
printer drivers, 21
processor requirements, 20
RAM, 20
SCSI hard drive, 21
work space, 12
S
server
manually starting, 50
multiple instances of, 54
stopping, 51
server port number, parameter, 48
shared libraries, 39
accessing, 39
path settings, 39
Solaris, 42
installation, 41
space requirements, 12
subdirectories, created by psinstall, 35
system requirements, 7, 8
Remote Views, 45
Windows, 20
T
troubleshooting
Remote Views, 56
UNIX, 41
Windows, 31
U
UNIX
installing
applications, 35
Solaris, 41
operating system requirements, 33
Oracle, 40
planning for installation, 35
setting environment variables, 36
setting permissions, 36
troubleshooting, 41
using 32- and 64-bit applications, 34
using applications, 33
V
vserve, 51
not found, message, 56
vws_hsts.dat
cant locate, 56
configuration files, 52
W
Windows, 19
batch files, 25
DLLs, 20
installing
directories, 24
network, 23
single PC, 21
manually setting paths, 27
network troubleshooting, 31
Z
zip4us.dir, 35
Index
65