PC -Regen-compact

USER GUIDE

NOTICE
The information contained in this document is believed to be accurate in all respects but is not warranted by
Mitel Networks™ Corporation (MITEL®). Mitel makes no warranty of any kind with regards to this material,
including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The
information is subject to change without notice and should not be construed in any way as a commitment by
Mitel or any of its affiliates or subsidiaries. Mitel and its affiliates and subsidiaries assume no responsibility for
any errors or omissions in this document. Revisions of this document or new editions of it may be issued to
incorporate such changes.

No part of this document can be reproduced or transmitted in any form or by any means - electronic or
mechanical - for any purpose without written permission from Mitel Networks Corporation.
 TRADEMARKS
The trademarks, service marks, logos and graphics (collectively "Trademarks") appearing on Mitel's Internet
sites or in its publications are registered and unregistered trademarks of Mitel Networks Corporation (MNC) or
its subsidiaries (collectively "Mitel") or others. Use of the Trademarks is prohibited without the express consent
from Mitel. Please contact our legal department at [email protected] for additional information. For a list of the
worldwide Mitel Networks Corporation registered trademarks, please refer to the website:
http://www.mitel.com/trademarks.

© Copyright 2017, Mitel Networks Corporation

All rights reserved

CONTENTS
1 INTRODUCTION 1
2 HOW TO USE PC-REGEN-STARTER 1
2.1 INSTALLATION 1
2.2 HELP MENU 1
2.3 TARGET TYPE 2
2.4 SOURCE TYPE 2
2.5 REGENERATION PATH 3
2.6 ADD EXTRA PRINT COMMANDS TO BATCH FILE 3
2.7 SCRIPT FILE 4
2.8 EXECUTION BUTTONS 4
2.9 CLEAR LOG BUTTON 5
2.10 SOURCE VERSION BUTTON 5
3 REGENERATION 6
3.1 REGENERATION PROCEDURE 6
 PC-REGEN-STARTER

1 INTRODUCTION
PC-Regen-compact consists of 2 executables:
1. PC-Regen-compact.exe.
This is a shell program that performs the main tasks like regeneration, syntax check and
generation of batch files.

2. PC-Regen-starter.exe.
This is the GUI front end that calls PC-Regen-compact

2 HOW TO USE PC-REGEN-STARTER

2.1 INSTALLATION
Download the file PC-regen-compact-setup.msi file, run it and follow the instructions. The whole
package including PC-regen-compact and PC-regen-starter will be installed.
PC-regen-starter is a tool that uses Pc-regen-compact. It will collect data from user and send to
PC-Regen-compact for processing.
The procedure for a regeneration is:
1. Create a batch file to use for data extraction.
2. Send the batch file to extract data.
3. Regenerate the data.
4. Send the regenerated data to target system

2.2 HELP MENU

User guide, will open this document in Your default PDF viewer.
Version, will open a shell and display the current version of Your PC-Regen-compact.
Tips, will open a document with small tricks and tips in Your default PDF viewer.
ReadMe, will open a text file containing history of updates for PC-Regen-compact.

9/1553-ANF 901 14 Uen PA3 2018-06-12 1

 PC-REGEN-STARTER

2.3 TARGET TYPE

Selection of target type, click on combo box and select type of target system. When a target is
selected the Source type combo box will be available.

2.4 SOURCE TYPE

Selection of source type, click on combo box and select type of source system.

9/1553-ANF 901 14 Uen PA3 2018-06-12 2

 PC-REGEN-STARTER

2.5 REGENERATION PATH

Selection of regeneration path, click on Regen path: button and select/create the desired path from
the Folder dialogue presented. Below this path there must be a …/source and a …/target directory
present. The data extracted from MX-One shall be placed under the …/source directory.

2.6 ADD EXTRA PRINT COMMANDS TO BATCH FILE

It is possible to add extra print commands to the generated data_gen.batch file.
This is done by creating an extra file containing these commands. Then select this file with the Add to
batch: button. The content of this file will then be added last in the data_gen.batch file.

9/1553-ANF 901 14 Uen PA3 2018-06-12 3

 PC-REGEN-STARTER

2.7 SCRIPT FILE

This display will show the currently selected script file to run when an execution button is pushed.

2.8 EXECUTION BUTTONS

The execution buttons control the execution.
The Run regeneration button will start the regeneration and put the result to the ../target directory
under the regen path.
The Generate batch files button will produce a data_gen.batch file and put it at the regen path
directory. If a file is chosen as an Add to batch it will be appended at the end of data_gen.batch.
The Syntax check button will perform a syntax check.
When the operation is ready all 3 buttons will open a new window containing the ERROR.LOG file.

9/1553-ANF 901 14 Uen PA3 2018-06-12 4

 PC-REGEN-STARTER

2.9 CLEAR LOG BUTTON

Pushing this button will remove the ERROR.LOG file so next operation will be logged first in file.

2.10 SOURCE VERSION BUTTON

Pushing this button will open the file ts_about stored in ../source directory. Use this to ensure that the
correct script file is used.

9/1553-ANF 901 14 Uen PA3 2018-06-12 5

 PC-REGEN-STARTER

3 REGENERATION
3.1 REGENERATION PROCEDURE
All communication with MX-ONE is here done via an SSH shell.
1. To select a target system. This step will determine what source systems that is available. Using
the Target type combo box make an appropriate selection.
2. To select a source system. Using the Source type combo box make an appropriate selection.
3. To select a regeneration path. Under this path it is necessary to have a \source and a \target
directory. These directories can be created for PC-Regen-starter or the general file manager.
4. To create a batch file. This file is sent to the source MX-ONE system to generate print data
data_gen.batch. This step will also generate files gjtsp.batch, pu_add_info.batch,
racep2.batch and scexp2.batch. These files are used by PC-Regen-compact at data collection
time. To do this, click the Generate batch files button.

Note!: It is possible to attach custom printouts last in data_gen.batch by creating them as a separate file
and select the file with the Add to batch button.
5. Zip all the files generated in step 4 to a zip file. i.e. data_gen_file.zip.
6. Move the file that was created in step 5 to a separate directory on the source MX-ONE system, i.e.
/tmp/pcregenData, and unzip the file.
7. Run the file to collect print data. On the MX-ONE source system, go to directory /tmp/pcregenData
and run:
source ./data_gen.batch | tee logFile.txt. This will collect the print data to this directory.
8. Zip all collected data from this directory into a zipped file i.e.:
/tmp/pcregenData # zip -j pcregenSource.zip *.

Note!: The –j option zips the files without directory information.

9. Move the file pcregenSource.zip to your PC onto the ./source directory below your regeneration
path and unzip it.
10. Perform the actual regeneration. From the PC-Regen-starter program with, the proper Target
type, Source type and Regen paths selected, click the:
Run Regeneration button. This will create the initiation files to be sent to you target MX-ONE.
11. Zip all files in the .../target directory of your regen path to a single file.
i.e. pcregenTarget.zip.
12. Move the file that was created in step 11 to a separate directory on your target MX-ONE system
i.e, /tmp/upgradeData. Unzip the file: tmp/upgradeData # unzip pcregenTarget.zip
13. Run the generated batch file REGENCMD.TXT:
tmp/upgradeData # mdsh -c source REGENCMD.TXT I tee upgradeLog.txt
Your system shall now be running with regenerated data. It is a good idea to do a system backup:
tmp/upgradeData # data_backup

9/1553-ANF 901 14 Uen PA3 2018-06-12 6