Version: 1.

TRIGENT SOFTWARE INC

Grinder
Setup
Manual
 Tr i C o n C D M S

Grinder Setup Manual

Copyright 2007  Trigent Software Inc

Natick, MA. 01760
USA

09/24/2007 Grinder
Setup Manual 1.0
Table of Contents

1 Introduction.........................................................................................................................................2
1.1 Purpose...........................................................................................................................................2
1.2 Scope...............................................................................................................................................2
1.3Audience...........................................................................................................................................2
1.4References.........................................................................................................................................2
1.5Disclaimer.........................................................................................................................................2
1.6Terminology and Conventions..........................................................................................................2
2 Overview.............................................................................................................................................2
2.1Minimum System Requirements.......................................................................................................2
3 Setting up the Grinder.........................................................................................................................3
4 Start and Stop of Grinder....................................................................................................................3
5 Test Data Preparation and Execution..................................................................................................3
5.1 Create Releases:...............................................................................................................................3
5.2 Create Installation Revision:............................................................................................................4
5.3Create Base Assemblies:...................................................................................................................4
5.4Create Variations:.............................................................................................................................5
5.5 Create Selection Part-For Base assembly:.......................................................................................5
5.6Create Selection Hole-For Base assembly:.......................................................................................5
5.7 Create Selection Part-For Variation:................................................................................................5
5.8Create Selection Hole-For Variation:...............................................................................................6
6 Appendix A-The Grinder Console .....................................................................................................6

09/24/2007 Grinder Setup

Manual 1.0
1 Introduction
1.1 Purpose
This document covers the system requirements and setting up of Grinder

1.2 Scope
This document covers the system requirements and setting up of Grinder to load large
volume of data.
Installation of TriconCDMS application is out of scope of this document

1.3Audience
o TriConCDMS Application Users.

1.4References
o Not Applicable

1.5Disclaimer
In this document,
• “International Truck and Engine” and “International” refer to one and the same
organization.
• “Trigent Software, Inc.” and “Trigent” refer to one and the same organization.
• “TriCon”, “TriConCDMS” and “Trigent Configuration Data management System”
are synonymous.
• “Grinder Console”, “Console" are synonymous

1.6Terminology and Conventions

TriConCDMS: Trigent Configuration Platform – Configuration Data Management
System.

2 Overview
Before setting up the Grinder one has to clear on basic requirements and how to setup
up the Grinder. This section helps in achieving this purpose.

2.1 Minimum System Requirements

Hardware
Operating system Windows 2000 Profession or higher
Processors supported Pentium IV 500 MHz or higher
Memory 512 MB RAM or higher
Disk space 300 MB Hard Disk Space

09/24/2007 2 Grinder Setup Manual 1.0

3 Setting up the Grinder
Pre-requisite

a.) The TriconCDMS Application should have been deployed and

must be running.

Installation Procedure

1. Extract TriconCdmsGrinder.zip on to the machine where the Grinder has to be

executed.
2. After extracting, you will find a folder by name “TriconCdmsGrinder”, which in
turn contains many subfolder. We will refer “grinder-3.0-beta25” as the
<GRINDER_HOME> in the rest of the document.
3. Update the “grinder.properties” under <GRINDER_HOME>\config with the
following parameter.
a. grinder.consoleHost=<Grinder Console MachineName or IP>
b. server=<CDMS Application MachineName/IP>:<PORT>
c. user=<CDMS Application UserName>
d. password=<CDMS Application Password>

Example:
a. grinder.consoleHost=tslc0494
b. server=tslc0671:9080
c. user=dcp
d. password=TriCon

4 Start and Stop of Grinder

To Start the Grinder goto “<GRINDER_HOME>\bin” folder double click on the
batch file “console.bat” wait until The Grinder Console window comes up (See Fig-01
under Appendix -A), and then start the “Agent.bat” check in the command window a
message “Waiting for the Console window” which means the Agent is now ready to
receive the command from the Console.

To Stop the Grinder, goto the Grinder Console window, click on the File menu, and
then click Exit, this would stop both the Console as well the agent process.

5 Test Data Preparation and Execution

5.1 Create Releases:
1. Change “grinder.properties” under “<GRINDER_HOME> \config” to have 1
process and 1 thread.
2. Change the “ReleaseCreate.txt” under
“<GRINDER_HOME>CreateData\Input_Data” to have a valid program number
and the number of releases that need to be created (110 i.e. 100 for Create of
Installation and 10 releases for revise)

09/24/2007 3 Grinder Setup Manual 1.0

 3. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory
(Button-01-Appendix-A)
4. In the Grinder Console window, select “CreateRelease.py” under
“<GRINDER_HOME>\SCRIPTS\CreateData”.
5. Click on “Set Script to run” (Button-02).
6. Click on “Send changed files to worker processes” (Button-03)
7. Click on “Start the worker processes” (Button-04).
8. After the above script had run successfully, login to the CDMS application
go to the Release-Advance Search page and give Program number and Created
Date = Current date, to fetch all the 110 releases created above. Save the search
result to a file.

5.2 Create Installation Revision:

1. Change “CreateSelection.txt” under
“<GRINDER_HOME>\ SCRIPTS\CreateData\Input_Data” to have 100 new
installation numbers (should be exactly 10 digits like INSTALL001,
INSTALL002 etc) and copy the first 100 valid release numbers, which was
created in section 5.1

2. Change “ReviseReleases.txt” under

“<GRINDER_HOME>\ SCRIPTS \CreateData\Input_Data” to have other
remaining 10 releases that were created in section 5.1

Note-01: In “CreateSelection.txt” the input should be given as

CREINSTL01, 50075A where the first 10 character is the Installation Number
and the second 6 characters is the Release number both a separated by
comma.

Note-02: In “ReviseReleases.txt” the input should be given as 50075M,dummy where

the first one is the Release number and the second is some value (Please
note, the word dummy is mandatory in the file, do not alter the file except for
the release number)

3. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory (Button-

01)
4. In the Grinder Console window, select “CreateInstRevisions.py” under
“<GRINDER_HOME>\SCRIPTS\CreateData”.
5. Click on “Set Script to run” (Button-02).
6. Click on “Send changed files to worker processes” (Button-03)
7. Click on “Start the worker processes” (Button-04).
8. This will create a total of 1100 Installation revision records.

5.3Create Base Assemblies:

1. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory
(Button-01)
2. In the Grinder Console window, select “CreatebaseAssemblies.py” under
“<GRINDER_HOME>\SCRIPTS\CreateData”.
3. Click on “Set Script to run” (Button-02).

09/24/2007 4 Grinder Setup Manual 1.0

4. Click on “Send changed files to worker processes” (Button-03)
5. Click on “Start the worker processes” (Button-04).
6. This will create a total of 1000 records.

5.4Create Variations:
1. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory
(Button-01)
2. In the Grinder Console window, select “CreateVariations.py” under
“<GRINDER_HOME>\SCRIPTS \CreateData”.
3. Click on “Set Script to run” (Button-02).
4. Click on “Send changed files to worker processes” (Button-03)
5. Click on “Start the worker processes” (Button-04).
6. This will create a total of 1000 records.

5.5 Create Selection Part-For Base assembly:

1. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory
(Button-01)
2. In the Grinder Console window, select “CreateSelectionParts.py” under
“<GRINDER_HOME>\SCRIPTS\CreateData”.
3. Click on “Set Script to run” (Button-02).
4. Click on “Send changed files to worker processes” (Button-03)
5. Click on “Start the worker processes” (Button-04).
6. This will create a total of 2000 records, (2 SelectionPart under each Base
Assembly).

5.6Create Selection Hole-For Base assembly:

1. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory

(Button-01)
2. In the Grinder Console window, select “CreateSelectionHoles.py” under
“<GRINDER_HOME>\SCRIPTS\CreateData”.
3. Click on “Set Script to run” (Button-02).
4. Click on “Send changed files to worker processes” (Button-03)
5. Click on “Start the worker processes” (Button-04).
6. This will create a total of 2000 records, (2 SelectionHole under each Base
Assembly).

5.7 Create Selection Part-For Variation:

1. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory
(Button-01)
2. In the Grinder Console window, select “CreateVariationSelectionParts.py”
under “<GRINDER_HOME>\SCRIPTS\CreateData”.
3. Click on “Set Script to run” (Button-02).
4. Click on “Send changed files to worker processes” (Button-03)
5. Click on “Start the worker processes” (Button-04).
6. This will create a total of 2000 records, (2 SelectionPart under each Variation).

09/24/2007 5 Grinder Setup Manual 1.0

 5.8Create Selection Hole-For Variation:
1. Set “<GRINDER_HOME>\SCRIPTS\CreateData” as the root directory
(Button-01)
2. In the Grinder Console window, select “CreateVariationSelectionHoles.py”
under “<GRINDER_HOME>\SCRIPTS\CreateData”.
3. Click on “Set Script to run” (Button-02).
4. Click on “Send changed files to worker processes” (Button-03)
5. Click on “Start the worker processes” (Button-04).
6. This will create a total of 2000 records, (2 SelectionHole under each Variation).

6 Appendix A-The Grinder Console

This section briefly describes on different options available on the Console window

Fig-01: The Grinder Console Window.

Button-01: Set the root directory for Script distribution

Click on this button and set the directory on the console host that contains
the python scripts, in our current setup the scripts are available under the
directory “<GRINDER_HOME>\SCRIPTS\CreateData”

Button-02: Set script to run

This selects the script from those in the distributed list that is to be run.

Button-03: Send changed files to worker processes

This pushes out the contents of the root directory to all connected worker
Processes.

09/24/2007 6 Grinder Setup Manual 1.0

 Button-04: Start the worker processes
This would start the worker process and execute the test scripts

Button-05: Reset the worker processes

This will cause the existing worker processes to exit and the agent process
to start fresh worker processes which will update the console with the new
test information.

09/24/2007 7 Grinder Setup Manual 1.0