Useful Command Line Tools Available with ... - PerkinElmer

Useful Command Line Tools
Available with TotalChrom
Chromatography Data Systems
CHROMATOGRAPHY DATA SYSTEMS
T E C H N I C A L N O T E
Introduction
From time to time during the
TotalChrom ® troubleshooting
process, it is necessary to use
command line tools. There are
a number of command line tools
available within the operating
system. This technical note provides
information and examples
of the tools that are shipped with
TotalChrom Chromatography
Data Systems (CDS). These tools
reside in the Penexe\TCCS\
Ver6.X.X\Bin directory on all
machines with a standard
TotalChrom installation.
Executables
There are many executables in
this directory which can be run
from the command line. Listed
below are the executables that
a TotalChrom administrator can
use for troubleshooting purposes.
Caution: Attempting to run
executables not listed below
can cause unwanted and detrimental
results in your TotalChrom
environment. Ideally, these executables
should be run in your
test environment first, before
attempting to use in the production
system.
• AccountLookUp.exe
• AddRight.exe
• ChangLCDpwd.exe
• LCD.exe
• PenEnv.exe
• PenRegRead.exe
• PnwRegEdit.exe
•ProcList.exe
•Protocols.exe
• RemoveRight.exe
• SwitchVer.exe
•TcRegEdit.exe
www.perkinelmer.com

AccountLookUp.exe
This command is useful when
determining the SID, Validating
Authority or User Rights applied
to the account in question. Examples
of this command from different
perspectives while looking up the
tcprocess account are shown in
Figures 1, 2 and 3.
Figure 1 shows the local machine
viewing the local tcprocess account.
Figure 2 shows the server viewing
the domains process account.
Figure 1.
In these figures, you will notice
two additional rights applied to
the process account.
1. “SeLoadDriverPrivilege” is
a manual setting that allows the
process account to load and unload
printer drivers without the
need to manually set printers for
the process account.
2. “SeInteractiveLogonRight”
is a manual setting that allows a
user to log on to the server as the
tcprocess account. Under normal
circumstances this would not be
possible as the tcprocess account
is just a standard domain account
and does not have the right to
log on to the server interactively
(this is helpful for troubleshooting
purposes).
Figure 3 shows the client which
has TotalChrom loaded with a
standard install.
If you compare the information
from the server and the client, you
will notice the SID is the same but
the Rights List is different. This is
because these are the specific rights
applied to the respective machine.
Figure 2.
Figure 3.
2

AddRight.exe
Figure 4 shows the command
used for adding specific user
rights in the OS.
Figure 4.
RemoveRight.exe
Figure 5 shows the command used
for removing user rights in the OS.
Figure 5.
ChangeLCDpwd.exe
Executing this command will open
the window shown in Figure 6.
(Note: The LCD service must be
active for the window to open.)
Figure 6.
Notice that the password can be
changed on multiple machines from
the user interface shown in Figure 7.
The user executing this command
must know the current password
to make the change.
Figure 7.
www.perkinelmer.com
3

LCD.exe
This command can be used to
reinstall the LCD service after
the account has been deleted.
The service can also be stopped
or started using the command
shown in Figure 8.
Figure 8.
Figure 9 shows the commands
used to:
1. Remove the LCD service
2. Install the service
3. Start the service
The administrator performing the
command must realize that the
account name and password are
now visible as shown in step #2.
1.
2.
3.
Figure 9.
4

PenEnv.exe
This command can be used to view
TotalChrom Environmental Variables
and Registry settings for the
local configuration as shown in
Figure 10, or to review remote configuration
as shown in Figures 11
and 12.
This view is from the LM Host
showing the local settings.
It is helpful in showing the LCD
acct used to install the PenLCD
Service License Manager.
Figure 10.
Remote Configuration A
Figure 11 shows a view
from a PC that was installed
as a Small Client.
Notice the LCD account is
indicated as a Small Client.
Figure 11.
www.perkinelmer.com
5

Remote Configuration B
Figure 12 shows a view from a PC
that was installed as a Standard
Client.
Notice the LCD account is same as
the account used on the LM Host.
Figure 12.
PenRegRead.exe
This command displays the registry
settings from the requested
TotalChrom client as shown in
Figure 13.
The String Values that are Not Defined
are using the default settings as
defined during the standard installation.
For example, the License Manager
is defined as Curlysvr. This entry
is required during the installation.
The Alternate Data Path has been
changed as well. By default it is not
defined, but this value was changed
using the PenRegEdit.exe.
Debug registry settings are viewable
here as well. Contact your TotalChrom
Support Specialist for additional
information regarding debug settings.
Figure 13.
6

PnwRegEdit.exe
Executing this file, as shown in Figure
14, opens a GUI. This provides
the TotalChrom administrator the
opportunity to browse to the file
location that will be used as the
Alternate Data Path. This reduces
typing errors when attempting to
manually enter the path. As always,
the process account must have
R,W,X, and D permissions to this
directory for the folder to be used
by the application, otherwise the
files will be written to the TotalChrom
Temp folder.
Figure 14.
The single application instance
should be defined as True, as shown
in Figure 15, which is a default setting.
When you first open this window
it is not defined. After selecting
your Alternate Data Path, select
“True,” then “Apply” then “Exit”.
Figure 15.
ProcList.exe
This command displays the current
Process List on the local PC as shown
in Figure 16.
Figure 16.
www.perkinelmer.com
7

Protocols.exe
This command displays various RPC
protocols as listed in Figure 17.
Figure 17.
SwitchVer.exe
Executing this file opens a GUI to
allow the TotalChrom administrator
to maintain multiple TotalChrom
versions and switch between them
as shown in Figure 18. Generally,
this is done in the test environment.
Select the appropriate version as
shown in Figure 19, “Apply” then
“Exit”. The radio button is not
filled in until after you have hit
the Apply button.
Figure 18.
Figure 19.
8

TCRegEdit.exe
Executing this file opens a GUI
to allow the TotalChrom administrator
the opportunity to modify the
TotalChrom registry key without the
use of Regedit.exe or Regedt32.exe.
This is a safe way to modify the
registry when used correctly. Also,
many of the String Values are predefined
thus eliminating possible
typing errors.
There is also the option to modify
additional clients and server by
adding the PCs from the Workstation
drop down menu, and the option to
enter the debug setting using this
GUI. Contact your TotalChrom Support
Specialist for debug settings.
In Figure 20, the License Manager
Host is selected (notice that Curlysvr
is not defined because it is the license
manager). Curly2K is pointed
at Curlysvr; this value is entered
during the installation process.
Figure 20.
Summary
With these tools in your TotalChrom
tool bag, you can become a more
effective and successful TotalChrom
administrator.
Author
Robert Santerre
Senior Systems Specialist
PerkinElmer
Life and Analytical Sciences
710 Bridgeport Avenue
Shelton, CT 06484 USA
PerkinElmer Life and
Analytical Sciences
710 Bridgeport Avenue
Shelton, CT 06484-4794 USA
Phone: (800) 762-4000 or
(+1) 203-925-4602
www.perkinelmer.com
For a complete listing of our global offices, visit www.perkinelmer.com/lasoffices
©2004 PerkinElmer, Inc. All rights reserved. The PerkinElmer logo and design are registered trademarks of PerkinElmer, Inc. TotalChrom is a registered trademark of PerkinElmer, Inc. or its
subsidiaries, in the United States and other countries. All other trademarks not owned by PerkinElmer, Inc. or its subsidiaries that are depicted herein are the property of their respective
owners. PerkinElmer reserves the right to change this document at any time without notice and disclaims liability for editorial, pictorial or typographical errors.
007216_01 Printed in USA