Page Comparison

Open the "Environment variable" form by going to the "Control panel" and, then "System" and then "Advanced system settings" (Control Panel\System and Security\System). Click on the "Environment variables" button. Remove the "EDM_LIC_xxx_xxxx" item from the system variables list; xxx is your license number. Afterwards, remove "%EDM_HOME%\bin" from the path variable by selecting the Path variable from the system variables and clicking on the edit button; see Figure 20, below.

Anchor
_Ref60730293 _Ref60730293

Anchor
_Toc66972239 _Toc66972239

Figure 20. Remove System variables

Anchor
_Toc56431941 _Toc56431941

Anchor
_Toc56432271 _Toc56432271

Anchor
_Toc56431942 _Toc56431942

Anchor
_Toc56432272 _Toc56432272

Anchor
_Toc66972163 _Toc66972163

Appendices

Anchor
_Toc372890531 _Toc372890531

Anchor
_Ref373491277 _Ref373491277

Anchor
_Ref373491282 _Ref373491282

Anchor
_Toc374368575 _Toc374368575

Anchor
_Toc389828961 _Toc389828961

Anchor
_Toc389829497 _Toc389829497

Anchor
_Ref399950303 _Ref399950303

Anchor
_Ref399950310 _Ref399950310

Anchor
_Ref399950318 _Ref399950318

Anchor
_Toc402435764 _Toc402435764

Anchor
_Toc402451608 _Toc402451608

Anchor
_Toc402458719 _Toc402458719

Anchor
_Toc416769099 _Toc416769099

Anchor
_Toc429402815 _Toc429402815

Anchor
_Ref64387227 _Ref64387227

Anchor
_Ref64387247 _Ref64387247

Anchor
_Ref66970101 _Ref66970101

Anchor
_Toc66972164 _Toc66972164

EDM6ServerConsole system

EDM6ServerConsole is a separate application that is delivered alongside of EDMtruePLM. Through this software you can manage different EDMserver solutions and start and stop them as MS Windows services. The software has two separate components

...

Reference: https://conwik.jotne.com/display/EDM/EDM6ServerConsole+guide

Anchor
_Toc389828962 _Toc389828962

Anchor
_Toc389829498 _Toc389829498

Anchor
_Toc402435765 _Toc402435765

Anchor
_Toc402451609 _Toc402451609

Anchor
_Toc402458720 _Toc402458720

Anchor
_Toc416769100 _Toc416769100

Anchor
_Toc429402816 _Toc429402816

Anchor
_Toc66972165 _Toc66972165

Installing and starting the EDMservice

Before using the system, EDMservice must be installed and started as a Windows service.
Windows services can only be installed by using the "Windows Administration role".

Anchor
_Ref383761484 _Ref383761484

Anchor
_Toc389829528 _Toc389829528

Anchor
_Toc400693579 _Toc400693579

Anchor
_Toc402458821 _Toc402458821

Anchor
_Toc416769262 _Toc416769262

Anchor
_Toc429402857 _Toc429402857

Anchor
_Toc66972240 _Toc66972240

Figure 21. Starting the command prompt as an administrator
This will open the administrator command window.

Anchor
_Ref383761512 _Ref383761512

Anchor
_Toc389829529 _Toc389829529

Anchor
_Toc400693580 _Toc400693580

Anchor
_Toc402458822 _Toc402458822

Anchor
_Toc416769263 _Toc416769263

Anchor
_Toc429402858 _Toc429402858

Anchor
_Toc66972241 _Toc66972241

Figure 22. Administrator command prompt
Go to the bin directory (C:\Program Files\Jotne\EDMmodelServer_plcs\edmcore-v602.210.93\bin) of the EDMsix installation and execute the following command:
EDM6Service.exe -i

Anchor
_Toc66972242 _Toc66972242

Figure 23. EDMservice as a Windows installation
This will install the EDMservice as a Windows service on your system. To start the service run the command without any arguments.
EDM6Service.exe
EDMservice shall automatically start after a Windows reboot.

Anchor
_Toc389828963 _Toc389828963

Anchor
_Toc389829499 _Toc389829499

Anchor
_Toc402435766 _Toc402435766

Anchor
_Toc402451610 _Toc402451610

Anchor
_Toc402458721 _Toc402458721

Anchor
_Toc416769101 _Toc416769101

Anchor
_Toc429402817 _Toc429402817

Anchor
_Toc66972166 _Toc66972166

Starting the EDM6ServerConsole

Start the EDM6ServerConsole by running the EDM6serverConsole.exe either from the command window or from the shortcut placed on the desktop. If the EDMservice is not yet started, the following error message will be displayed.

Anchor
_Toc389829532 _Toc389829532

Anchor
_Toc400693583 _Toc400693583

Anchor
_Toc402458825 _Toc402458825

Anchor
_Toc416769266 _Toc416769266

Anchor
_Toc429402861 _Toc429402861

Anchor
_Toc66972243 _Toc66972243

Figure 24. Error from EDM6ServerConsole
The EDM6ServerConsole is the GUI management tool for the EDMserver and applications based on EDMserver, like EDMtruePLM. An EDMserver solution is a combination of the following settings:

...

Through this application you can create, delete, start, and stop solutions based on EDMsix server and application servers.

Anchor
_Toc389828964 _Toc389828964

Anchor
_Toc389829500 _Toc389829500

Anchor
_Toc402435767 _Toc402435767

Anchor
_Toc402451611 _Toc402451611

Anchor
_Toc402458722 _Toc402458722

Anchor
_Toc416769102 _Toc416769102

Anchor
_Toc429402818 _Toc429402818

Anchor
_Toc66972167 _Toc66972167

EDM6ServerConsole GUI

For configuring the EDM6ServerConsole open the "Tools" → "Application settings" menu item.

Anchor
_Ref3903460 _Ref3903460

Anchor
_Toc389829533 _Toc389829533

Anchor
_Toc400693584 _Toc400693584

Anchor
_Toc402458826 _Toc402458826

Anchor
_Toc416769267 _Toc416769267

Anchor
_Toc429402862 _Toc429402862

Anchor
_Toc66972244 _Toc66972244

Figure 25. EDM6ServerConsole main window
Note: In above figure, 10007 is the EDM license number. Your computer may use a different license number.
The following sections will go through the different options within the EDM6ServerConsole setting panel.

Anchor
_Toc389828965 _Toc389828965

Anchor
_Toc389829501 _Toc389829501

Anchor
_Toc402435768 _Toc402435768

Anchor
_Toc402451612 _Toc402451612

Anchor
_Toc402458723 _Toc402458723

Anchor
_Toc416769103 _Toc416769103

Anchor
_Toc429402819 _Toc429402819

Anchor
_Toc3906773 _Toc3906773

Anchor
_Toc66972168 _Toc66972168

Common settings

Anchor
_Hlk64384785 _Hlk64384785

Anchor
_Toc389829534 _Toc389829534

Anchor
_Toc400693585 _Toc400693585

Anchor
_Toc402458827 _Toc402458827

Anchor
_Toc416769268 _Toc416769268

Anchor
_Toc429402863 _Toc429402863

Anchor
_Toc66972245 _Toc66972245

Figure 26. Common settings

Anchor
_Toc389828966 _Toc389828966

Anchor
_Toc389829502 _Toc389829502

Anchor
_Toc402435769 _Toc402435769

Anchor
_Toc402451613 _Toc402451613

Anchor
_Toc402458724 _Toc402458724

The common setting panel allows a user to setup the path for the internal EDM6ServerConsole configuration file, solution database location, and the port it uses to communicate with the EDMservice, EDM6Service port. To change the port, you must first change the port here and then restart the EDMservice. This will update the EDMservice port number.

Important:
The port number must not be blocked or used by any other application.

Anchor
_Toc416769104 _Toc416769104

Anchor
_Toc429402820 _Toc429402820

Anchor
_Toc3906774 _Toc3906774

Anchor
_Hlk64384794 _Hlk64384794

Anchor
_Toc66972169 _Toc66972169

Console settings

Anchor
_Toc389829535 _Toc389829535

Anchor
_Toc400693586 _Toc400693586

Anchor
_Toc402458828 _Toc402458828

Anchor
_Toc416769269 _Toc416769269

Anchor
_Toc429402864 _Toc429402864

Anchor
_Toc66972246 _Toc66972246

Figure 27. Console setting
The console setting allows the user to adjust how the EDM6ServerConsole behaves.

Anchor
_Toc64385370 _Toc64385370

Anchor
_Toc64385583 _Toc64385583

Anchor
_Toc64386438 _Toc64386438

Anchor
_Toc64557189 _Toc64557189

Anchor
_Toc64557257 _Toc64557257

Anchor
_Toc64894630 _Toc64894630

Anchor
_Toc64894696 _Toc64894696

Anchor
_Toc64895955 _Toc64895955

Anchor
_Toc64896084 _Toc64896084

Anchor
_Toc65261371 _Toc65261371

Anchor
_Toc65567252 _Toc65567252

Anchor
_Toc66732709 _Toc66732709

Anchor
_Toc66732911 _Toc66732911

Anchor
_Toc66881019 _Toc66881019

Anchor
_Toc66881085 _Toc66881085

Anchor
_Toc416769105 _Toc416769105

Anchor
_Toc66971559 _Toc66971559

Anchor
_Toc66972170 _Toc66972170

...

Anchor
_Toc66972176 _Toc66972176

Application settings

Anchor
_Hlk64384825 _Hlk64384825

This tab will allow you to configure the behaviour of the EDM6ServerConsole GUI.

Anchor
_Toc64385377 _Toc64385377

Anchor
_Toc64385590 _Toc64385590

Anchor
_Toc64386445 _Toc64386445

Anchor
_Toc64557196 _Toc64557196

Anchor
_Toc64557264 _Toc64557264

Anchor
_Toc64894637 _Toc64894637

Anchor
_Toc64894703 _Toc64894703

Anchor
_Toc64895962 _Toc64895962

Anchor
_Toc64896091 _Toc64896091

Anchor
_Toc65261378 _Toc65261378

Anchor
_Toc65567259 _Toc65567259

Anchor
_Toc66732716 _Toc66732716

Anchor
_Toc66732918 _Toc66732918

Anchor
_Toc66881026 _Toc66881026

Anchor
_Toc66881092 _Toc66881092

Anchor
_Toc416769106 _Toc416769106

Anchor
_Toc66971566 _Toc66971566

Anchor
_Toc66972177 _Toc66972177

...

Anchor
_Toc66972184 _Toc66972184

Appearance

Anchor
_Hlk64384832 _Hlk64384832

This tab allows you to configure the event log window and the EDMserver and EDMappserver logs; see section A.3.4 for details of application servers (EDMappserver).

Anchor
_Toc389828967 _Toc389828967

Anchor
_Toc389829503 _Toc389829503

Anchor
_Toc402435770 _Toc402435770

Anchor
_Toc402451614 _Toc402451614

Anchor
_Toc402458725 _Toc402458725

Anchor
_Toc416769107 _Toc416769107

Anchor
_Toc429402821 _Toc429402821

Anchor
_Toc3906775 _Toc3906775

Anchor
_Toc66972185 _Toc66972185

Service crash settings

The service settings are explained below.

Anchor
_Toc64385386 _Toc64385386

Anchor
_Toc64385599 _Toc64385599

Anchor
_Toc64386454 _Toc64386454

Anchor
_Toc64557205 _Toc64557205

Anchor
_Toc64557273 _Toc64557273

Anchor
_Toc64894646 _Toc64894646

Anchor
_Toc64894712 _Toc64894712

Anchor
_Toc64895971 _Toc64895971

Anchor
_Toc64896100 _Toc64896100

Anchor
_Toc65261387 _Toc65261387

Anchor
_Toc65567268 _Toc65567268

Anchor
_Toc66732725 _Toc66732725

Anchor
_Toc66732927 _Toc66732927

Anchor
_Toc66881035 _Toc66881035

Anchor
_Toc66881101 _Toc66881101

Anchor
_Toc389828968 _Toc389828968

Anchor
_Toc389829504 _Toc389829504

Anchor
_Toc402435771 _Toc402435771

Anchor
_Toc402451615 _Toc402451615

Anchor
_Toc402458726 _Toc402458726

Anchor
_Toc416769108 _Toc416769108

Anchor
_Toc66971575 _Toc66971575

Anchor
_Toc66972186 _Toc66972186

Anchor
_Toc66972187 _Toc66972187

Auto restart setting

Anchor
_Hlk64384846 _Hlk64384846

The auto restart setting allows a user to configure how the EDMservice should react if the EDMserver has crashed. By default, the EDMservice restarts the EDMserver after each crash. If the EDMserver has crashed for the maximum number of counts within the time period, "Reset restart count after", the EDMservice will not restart the EDMserver, if it crashes again. After the time period, the counter will reset to zero. This will also happen if the Windows system is rebooted or the EDMservice is restarted.

Anchor
_Toc389829536 _Toc389829536

Anchor
_Toc400693587 _Toc400693587

Anchor
_Toc402458829 _Toc402458829

Anchor
_Toc416769270 _Toc416769270

Anchor
_Toc429402865 _Toc429402865

Anchor
_Toc66972247 _Toc66972247

Figure 28. Auto restart solution

Anchor
_Toc66972188 _Toc66972188

Email notification

Anchor
_Hlk64384865 _Hlk64384865

EDM6Service can send e-mail notifications in case of EDMserver crash or similar issues.
E-mails are sent via a dedicated SMTP server. You need to select this option to enable email notifications and complete the form with necessary information.

Anchor
_Toc66972248 _Toc66972248

Figure 29. Email notification

Anchor
_Toc66972189 _Toc66972189

Start Solution

Anchor
_Hlk64384871 _Hlk64384871

A solution (EDMserver + one or multiple app servers + optionally Tomcat) can be started and stopped manually. There is an option to start/restart solutions automatically.

Anchor
_Toc66972249 _Toc66972249

Figure 30. Start solution

Anchor
_Hlk64384878 _Hlk64384878

Anchor
_Toc66972190 _Toc66972190

Backup

Database backup procedure can be scheduled once a day. During backup, the corresponding solution is stopped. The EDM database is copied to a defined folder as a ZIP package. The solution is restarted automatically after backup.

Anchor
_Toc66972250 _Toc66972250

Figure 31. Backup

Anchor
_Toc66972191 _Toc66972191

Memory usage check

Anchor
_Hlk64384888 _Hlk64384888

This option should be switched off.

Anchor
_Toc66972251 _Toc66972251

Figure 32. Memory usage check

Anchor
_Toc389828970 _Toc389828970

Anchor
_Toc389829506 _Toc389829506

Anchor
_Toc402435773 _Toc402435773

Anchor
_Toc402451617 _Toc402451617

Anchor
_Toc402458728 _Toc402458728

Anchor
_Toc416769111 _Toc416769111

Anchor
_Toc429402822 _Toc429402822

Anchor
_Toc3906776 _Toc3906776

Anchor
_Ref63863659 _Ref63863659

Anchor
_Toc66972192 _Toc66972192

Solution configuration

Anchor
_Hlk64384896 _Hlk64384896

A solution is a setting to start one EDMserver and one or multiple application servers, also called appservers.
Before starting a solution, its components must be configured. To manage a component configuration, either use the menu item for that component or use the component tab. In addition, the component tab shows the list of different configurations for the component.
All components are configured automatically during installation of the EDMtruePLM server.
Simple user actions are needed to complete the solution configuration.
We assume here that the EDM license was installed before the installation of the EDMservice. In this case the "Solution" tab (see Figure 33) has at least one row with a license number at the first column.
Drop down lists in column 2 (Server), 3 (Configuration) and 4 (Database) should offer selections. More details are given in the sections, below.
It is recommended to set a tick to the check box in the column before "Start/Stop" button. In this case the solution will be started automatically when Windows is restarted.
Image RemovedImage Added

Anchor
_Ref65259626 _Ref65259626

Anchor
_Toc66972252 _Toc66972252

Figure

Anchor
_Hlk64895463 _Hlk64895463

33. Database drop down list
After setting the above details, the solution can be started manually by clicking the "Start" button.
Notes:

...

Anchor
_Toc66972194 _Toc66972194

Server tab

Anchor
_Hlk64384909 _Hlk64384909

The server tab lists all available servers (see Figure 34).

Anchor
_Ref384021175 _Ref384021175

Anchor
_Toc389829538 _Toc389829538

Anchor
_Toc400693589 _Toc400693589

Anchor
_Toc402458831 _Toc402458831

Anchor
_Toc416769273 _Toc416769273

Anchor
_Toc429402867 _Toc429402867

Anchor
_Toc66972253 _Toc66972253

Figure 34. List of all available server configurations
In addition, through the server tab one can create, delete or edit a server configuration. To create a server configuration either right click in the tab area or use the Server menu item.

Anchor
_Toc389829539 _Toc389829539

Anchor
_Toc400693590 _Toc400693590

Anchor
_Toc402458832 _Toc402458832

Anchor
_Toc416769274 _Toc416769274

Anchor
_Toc429402868 _Toc429402868

Anchor
_Toc66972254 _Toc66972254

Figure 35. Server tab popup menu item

Anchor
_Toc389828972 _Toc389828972

Anchor
_Toc389829508 _Toc389829508

Anchor
_Toc402435775 _Toc402435775

Anchor
_Toc402451619 _Toc402451619

Anchor
_Toc402458730 _Toc402458730

Anchor
_Toc416769113 _Toc416769113

Anchor
_Toc66972195 _Toc66972195

Adding a new EDMserver executable

Anchor
_Hlk64384922 _Hlk64384922

To create a new configuration, click on "Add new edmserver" (see Figure 36).

Anchor
_Ref383781593 _Ref383781593

Anchor
_Ref383781575 _Ref383781575

Anchor
_Toc389829540 _Toc389829540

Anchor
_Toc400693591 _Toc400693591

Anchor
_Toc402458833 _Toc402458833

Anchor
_Toc416769275 _Toc416769275

Anchor
_Toc429402869 _Toc429402869

Anchor
_Toc66972255 _Toc66972255

Figure 36.

Anchor
_Ref383781580 _Ref383781580

Add new EDMserver
Give a name to the configuration and make sure that the system is correctly pointing to the EDM version you want to use and press the "OK" button. The default binary files point to the last EDM installation.

Anchor
_Toc389828973 _Toc389828973

Anchor
_Toc389829509 _Toc389829509

Anchor
_Toc402435776 _Toc402435776

Anchor
_Toc402451620 _Toc402451620

Anchor
_Toc402458731 _Toc402458731

Anchor
_Toc416769114 _Toc416769114

Anchor
_Toc66972196 _Toc66972196

Editing EDMserver executables

To edit an existing EDMserver configuration, select the configuration from the list and click on the "Edit edmserver" menu item, this will open the "Edit EDMserver executable", see Figure 37.

Anchor
_Ref384021554 _Ref384021554

Anchor
_Toc389829541 _Toc389829541

Anchor
_Toc400693592 _Toc400693592

Anchor
_Toc402458834 _Toc402458834

Anchor
_Toc416769276 _Toc416769276

Anchor
_Toc429402870 _Toc429402870

Anchor
_Toc66972256 _Toc66972256

Figure 37. "Edit edmserver" configuration

Anchor
_Toc389828974 _Toc389828974

Anchor
_Toc389829510 _Toc389829510

Anchor
_Toc402435777 _Toc402435777

Anchor
_Toc402451621 _Toc402451621

Anchor
_Toc402458732 _Toc402458732

Anchor
_Toc416769115 _Toc416769115

Anchor
_Toc66972197 _Toc66972197

Deleting EDMserver executables

To delete a configuration, select the configuration item and click on the "Delete EDMserver executables" menu item.

Anchor
_Toc389828975 _Toc389828975

Anchor
_Toc389829511 _Toc389829511

Anchor
_Ref402258002 _Ref402258002

Anchor
_Toc402435778 _Toc402435778

Anchor
_Toc402451622 _Toc402451622

Anchor
_Toc402458733 _Toc402458733

Anchor
_Toc416769116 _Toc416769116

Anchor
_Toc429402823 _Toc429402823

Anchor
_Toc3906777 _Toc3906777

Anchor
_Toc66972198 _Toc66972198

Configuration tab

The configuration tab lists all the available runtime settings for the EDMserver and EDMappservers; see Figure 38.

Anchor
_Ref383782037 _Ref383782037

Anchor
_Toc389829542 _Toc389829542

Anchor
_Toc400693593 _Toc400693593

Anchor
_Toc402458835 _Toc402458835

Anchor
_Toc416769277 _Toc416769277

Anchor
_Toc429402871 _Toc429402871

Anchor
_Toc66972257 _Toc66972257

Figure 38. Configuration tab
To manage the EDMserver configuration use the "Configuration" menu item or right click in the "Configuration" tab to either add, edit or delete a server configuration, see Figure 39.

Anchor
_Ref383782935 _Ref383782935

Anchor
_Toc389829543 _Toc389829543

Anchor
_Toc400693594 _Toc400693594

Anchor
_Toc402458836 _Toc402458836

Anchor
_Toc416769278 _Toc416769278

Anchor
_Toc429402872 _Toc429402872

Anchor
_Toc66972258 _Toc66972258

Figure 39. Configuration tab menu

Anchor
_Toc389828976 _Toc389828976

Anchor
_Toc389829512 _Toc389829512

Anchor
_Toc402435779 _Toc402435779

Anchor
_Toc402451623 _Toc402451623

Anchor
_Toc402458734 _Toc402458734

Anchor
_Toc416769117 _Toc416769117

Anchor
_Toc64385399 _Toc64385399

Anchor
_Toc64385612 _Toc64385612

Anchor
_Toc64386467 _Toc64386467

Anchor
_Toc64557218 _Toc64557218

Anchor
_Toc64557286 _Toc64557286

Anchor
_Toc64894659 _Toc64894659

Anchor
_Toc64894725 _Toc64894725

Anchor
_Toc64895984 _Toc64895984

Anchor
_Toc64896113 _Toc64896113

Anchor
_Toc65261400 _Toc65261400

Anchor
_Toc65567281 _Toc65567281

Anchor
_Toc66732738 _Toc66732738

Anchor
_Toc66732940 _Toc66732940

Anchor
_Toc66881048 _Toc66881048

Anchor
_Toc66881114 _Toc66881114

Anchor
_Toc66971588 _Toc66971588

Anchor
_Toc66972199 _Toc66972199

Anchor
_Toc66972200 _Toc66972200

Add new EDMserver configuration

To add a new runtime server configuration, click on the "Add new server configuration", this will open the "New runtime configuration" dialog (see Figure 40).
For a full description of each item within the "New runtime configuration" dialog refer to the EDM help manual. Below you can find a brief description of each item.

Anchor
_Ref383783014 _Ref383783014

Anchor
_Toc389829544 _Toc389829544

Anchor
_Toc400693595 _Toc400693595

Anchor
_Toc402458837 _Toc402458837

Anchor
_Toc416769279 _Toc416769279

Anchor
_Toc429402873 _Toc429402873

Anchor
_Toc66972259 _Toc66972259

Figure 40. New EDMserver configuration

...

Anchor
_Toc389828977 _Toc389828977

Anchor
_Toc389829513 _Toc389829513

Anchor
_Toc402435780 _Toc402435780

Anchor
_Toc402451624 _Toc402451624

Anchor
_Toc402458735 _Toc402458735

Anchor
_Toc416769118 _Toc416769118

Anchor
_Toc66972201 _Toc66972201

Editing an EDMserver configuration

To edit an existing EDMserver configuration, select the configuration from the list and click on the "Edit EDMserver configuration" menu item, this will open the "Edit EDMserver configuration", see Figure 41.

Anchor
_Ref384025574 _Ref384025574

Anchor
_Toc389829545 _Toc389829545

Anchor
_Toc400693596 _Toc400693596

Anchor
_Toc402458838 _Toc402458838

Anchor
_Toc416769280 _Toc416769280

Anchor
_Toc429402874 _Toc429402874

Anchor
_Toc66972260 _Toc66972260

Figure 41. Edit EDMserver configuration

Anchor
_Toc389828978 _Toc389828978

Anchor
_Toc389829514 _Toc389829514

Anchor
_Toc402435781 _Toc402435781

Anchor
_Toc402451625 _Toc402451625

Anchor
_Toc402458736 _Toc402458736

Anchor
_Toc416769119 _Toc416769119

Anchor
_Ref66890356 _Ref66890356

Anchor
_Toc66972202 _Toc66972202

Deleting an EDMserver configuration

To delete a configuration, select the configuration item and click on the "Delete EDMserver configuration" menu item.

Anchor
_Toc389828979 _Toc389828979

Anchor
_Toc389829515 _Toc389829515

Anchor
_Toc402435782 _Toc402435782

Anchor
_Toc402451626 _Toc402451626

Anchor
_Toc402458737 _Toc402458737

Anchor
_Toc416769120 _Toc416769120

Anchor
_Toc429402824 _Toc429402824

Anchor
_Toc3906778 _Toc3906778

Anchor
_Toc66972203 _Toc66972203

Database tab

The database tab lists all available EDM databases, see Figure 42.

Anchor
_Ref383784977 _Ref383784977

Anchor
_Toc389829546 _Toc389829546

Anchor
_Toc400693597 _Toc400693597

Anchor
_Toc402458839 _Toc402458839

Anchor
_Toc416769281 _Toc416769281

Anchor
_Toc429402875 _Toc429402875

Anchor
_Toc66972261 _Toc66972261

Figure 42. Database configurations
The "Database" menu item or the Database tab context menu allows to create, add, remove (from EDM6ServerConsole) and delete (from disk) databases.

Anchor
_Toc389829547 _Toc389829547

Anchor
_Toc400693598 _Toc400693598

Anchor
_Toc402458840 _Toc402458840

Anchor
_Toc416769282 _Toc416769282

Anchor
_Toc429402876 _Toc429402876

Anchor
_Toc66972262 _Toc66972262

Figure 43. Database menu items

Anchor
_Toc389828980 _Toc389828980

Anchor
_Toc389829516 _Toc389829516

Anchor
_Toc402435783 _Toc402435783

Anchor
_Toc402451627 _Toc402451627

Anchor
_Toc402458738 _Toc402458738

Anchor
_Toc416769121 _Toc416769121

Anchor
_Toc64385404 _Toc64385404

Anchor
_Toc64385617 _Toc64385617

Anchor
_Toc64386472 _Toc64386472

Anchor
_Toc64557223 _Toc64557223

Anchor
_Toc64557291 _Toc64557291

Anchor
_Toc64894664 _Toc64894664

Anchor
_Toc64894730 _Toc64894730

Anchor
_Toc64895989 _Toc64895989

Anchor
_Toc64896118 _Toc64896118

Anchor
_Toc65261405 _Toc65261405

Anchor
_Toc65567286 _Toc65567286

Anchor
_Toc66732743 _Toc66732743

Anchor
_Toc66732945 _Toc66732945

Anchor
_Toc66881053 _Toc66881053

Anchor
_Toc66881119 _Toc66881119

Anchor
_Toc66971593 _Toc66971593

Anchor
_Toc66972204 _Toc66972204

Anchor
_Toc66972205 _Toc66972205

Create new database

The "Database"->"Create new EDM database" menu item opens the "Create new EDM database" window.

Anchor
_Toc66972263 _Toc66972263

Figure 44: Create new database
Select an EDMsixServer executable from the list of available EDMsixServers, and provide the database path, the database name and the database password.
Notes:

...

Anchor
_Toc389828981 _Toc389828981

Anchor
_Toc389829517 _Toc389829517

Anchor
_Toc402435784 _Toc402435784

Anchor
_Toc402451628 _Toc402451628

Anchor
_Toc402458739 _Toc402458739

Anchor
_Toc416769122 _Toc416769122

Anchor
_Toc66972206 _Toc66972206

Add existing database

To add an existing database to the list, use the "Add existing EDM database" menu item, which will bring up Figure 45. To add the database to the list provide a name and the location of the database "db.EDM" file. To enable the EDMserver backup check the "Enable backup" check box and enter the backup destination location and the number of backup versions.

Anchor
_Ref384030907 _Ref384030907

Anchor
_Toc389829549 _Toc389829549

Anchor
_Toc400693600 _Toc400693600

Anchor
_Toc402458842 _Toc402458842

Anchor
_Toc416769284 _Toc416769284

Anchor
_Toc429402878 _Toc429402878

Anchor
_Toc66972264 _Toc66972264

Figure 45. Add existing database

Anchor
_Toc389828982 _Toc389828982

Anchor
_Toc389829518 _Toc389829518

Anchor
_Toc402435785 _Toc402435785

Anchor
_Toc402451629 _Toc402451629

Anchor
_Toc402458740 _Toc402458740

Anchor
_Toc416769123 _Toc416769123

Anchor
_Toc66972207 _Toc66972207

Restore EDM database from backup created by EDMserver

Restoring backup package can be done manually by the following steps:

...

Anchor
_Toc66972208 _Toc66972208

Edit database settings

Select the item from the list and click on the "Edit EDM database" menu item.

Anchor
_Toc389829550 _Toc389829550

Anchor
_Toc400693601 _Toc400693601

Anchor
_Toc402458843 _Toc402458843

Anchor
_Toc416769285 _Toc416769285

Anchor
_Toc429402879 _Toc429402879

Anchor
_Toc66972265 _Toc66972265

Figure 46. Edit EDM database

Anchor
_Toc389828983 _Toc389828983

Anchor
_Toc389829519 _Toc389829519

Anchor
_Toc402435786 _Toc402435786

Anchor
_Toc402451630 _Toc402451630

Anchor
_Toc402458741 _Toc402458741

Anchor
_Toc416769124 _Toc416769124

Anchor
_Toc66972209 _Toc66972209

Remove EDM database from list

To remove the EDM database from the database list, select the database and click on the "Remove information about EDM database".
Note: This will only remove the item from the list and will not delete the actual database files from the hard drive.

Anchor
_Toc389828984 _Toc389828984

Anchor
_Toc389829520 _Toc389829520

Anchor
_Toc402435787 _Toc402435787

Anchor
_Toc402451631 _Toc402451631

Anchor
_Toc402458742 _Toc402458742

Anchor
_Toc416769125 _Toc416769125

Anchor
_Toc66972210 _Toc66972210

Delete EDM database from disk

To delete the EDM database files from the hard drive, select the database and click on the "Delete EDM database from disk". This will remove the selected database from the disk.
Note: No warning will be given when the user clicks on the "Delete EDM database from disk".

Anchor
_Toc389828989 _Toc389828989

Anchor
_Toc389829525 _Toc389829525

Anchor
_Toc402435788 _Toc402435788

Anchor
_Toc402451632 _Toc402451632

Anchor
_Toc402458743 _Toc402458743

Anchor
_Toc416769126 _Toc416769126

Anchor
_Toc429402825 _Toc429402825

Anchor
_Toc3906779 _Toc3906779

Anchor
_Toc66972211 _Toc66972211

Solution tab

The solution tab lists available EDMserver licenses for which the user can create an EDM solution based on the items from the other tabs.

Anchor
_Ref60732984 _Ref60732984

Anchor
_Toc389829555 _Toc389829555

Anchor
_Toc400693602 _Toc400693602

Anchor
_Toc402458844 _Toc402458844

Anchor
_Toc416769286 _Toc416769286

Anchor
_Toc429402880 _Toc429402880

Anchor
_Toc66972266 _Toc66972266

Figure 47. List of solutions
Select the configurations that you want from the dropdown lists and press the "Start" button, under the last column, to start the solution. The "auto start" check box identifies if you wish the solution to automatically start when the EDMservice is restarted.
Important: The EDMtruePLM does not use the Tomcat section shown in Figure 47.
If the EDM6ServerConsole cannot connect to the EDMservice, the last column will show a start button that will allow the user to try to reconnect to the EDMservice (see Figure 48).

Anchor
_Ref389827264 _Ref389827264

Anchor
_Toc389829556 _Toc389829556

Anchor
_Toc400693603 _Toc400693603

Anchor
_Toc402458845 _Toc402458845

Anchor
_Toc416769287 _Toc416769287

Anchor
_Toc429402881 _Toc429402881

Anchor
_Toc66972267 _Toc66972267

Figure 48. Disconnected from the EDMservice state
You can also create a new configuration of each item directly from their respective dropdown lists, see Figure 49.

Anchor
_Ref383781643 _Ref383781643

Anchor
_Toc389829557 _Toc389829557

Anchor
_Toc400693604 _Toc400693604

Anchor
_Toc402458846 _Toc402458846

Anchor
_Toc416769288 _Toc416769288

Anchor
_Toc429402882 _Toc429402882

Anchor
_Toc66972268 _Toc66972268

Figure 49. Shortcut in the component dropdown list
To stop a solution, click on the "Stop" button, see Figure 50.

Anchor
_Ref384039514 _Ref384039514

Anchor
_Toc389829558 _Toc389829558

Anchor
_Toc400693605 _Toc400693605

Anchor
_Toc402458847 _Toc402458847

Anchor
_Toc416769289 _Toc416769289

Anchor
_Toc429402883 _Toc429402883

Anchor
_Toc66972269 _Toc66972269

Figure 50. Stopping the solution

Anchor
_Toc389828990 _Toc389828990

Anchor
_Toc389829526 _Toc389829526

Anchor
_Toc402435789 _Toc402435789

Anchor
_Toc402451633 _Toc402451633

Anchor
_Toc402458744 _Toc402458744

Anchor
_Toc416769127 _Toc416769127

Anchor
_Toc429402826 _Toc429402826

Anchor
_Toc3906780 _Toc3906780

Anchor
_Toc66972212 _Toc66972212

The Log Windows

The log windows show the events of the EDMservice and of the EDMserver. Each time a solution is started, a new tab will be created with the name of the solution license, if the tab has not already been created.

Anchor
_Toc389829559 _Toc389829559

Anchor
_Toc400693606 _Toc400693606

Anchor
_Toc402458848 _Toc402458848

Anchor
_Toc416769290 _Toc416769290

Anchor
_Toc429402884 _Toc429402884

Anchor
_Toc66972270 _Toc66972270

Figure 51. Log windows
EDM6ServerConsole log
The "Log" tab displays the EDMservice events logs from all solutions in chronological order. The three columns show the time of the log, the license for the solution and a description of the event.
Solution logs
Each solution will have its own log tab. The tab contains the EDMserver start up command and EDMserver standard output.
Note: It is possible to increase the EDMserver log by providing the "-t" as an additional argument in the runtime configuration.
Cleaning the log tabs
To clean the log tabs right click in the log window and click on the "Clean log" popup button.

Anchor
_Toc389828991 _Toc389828991

Anchor
_Toc389829527 _Toc389829527

Anchor
_Toc402435790 _Toc402435790

Anchor
_Toc402451634 _Toc402451634

Anchor
_Toc402458745 _Toc402458745

Anchor
_Toc416769128 _Toc416769128

Anchor
_Toc429402827 _Toc429402827

Anchor
_Hlk64384394 _Hlk64384394

Anchor
_Toc66972213 _Toc66972213

Hiding or exiting the EDM6ServerConsole

The EDM6ServerConsole can be hidden to the system tray by clicking on the dialog box close button or by choosing the "Hide" menu item in the "File" menu, see Figure 52.

Anchor
_Ref384040543 _Ref384040543

Anchor
_Toc389829560 _Toc389829560

Anchor
_Toc400693607 _Toc400693607

Anchor
_Toc402458849 _Toc402458849

Anchor
_Toc416769291 _Toc416769291

Anchor
_Toc429402885 _Toc429402885

Anchor
_Toc66972271 _Toc66972271

Figure 52. Minimizing the application
The minimised application is shown in the system tray as an icon. Either double click on the icon or select "Restore" in the tray icon context menu to show the EDM6ServerConsole window, see Figure 53.

Anchor
_Ref389828252 _Ref389828252

Anchor
_Toc389829561 _Toc389829561

Anchor
_Toc400693608 _Toc400693608

Anchor
_Toc402458850 _Toc402458850

Anchor
_Toc416769292 _Toc416769292

Anchor
_Toc429402886 _Toc429402886

Anchor
_Toc66972272 _Toc66972272

Figure 53. Opening the EDM6ServerConsole from the system tray

Anchor
_Changing_system_admin _Changing_system_admin

Anchor
_Toc61032120 _Toc61032120

Anchor
_Hlk64384418 _Hlk64384418

Anchor
_Toc66972214 _Toc66972214

Changing database password

Follow the steps below to change the superuser and database passwords.
Important:

...

Step 1. Launch the EDMSupervisor (edms.exe) (C:\Program Files\Jotne\EDMmodelServer_plcs\edmcore-v602.210.93\bin\bin)

Anchor
_Toc60846347 _Toc60846347

Anchor
_Toc60846559 _Toc60846559

Anchor
_Toc61032222 _Toc61032222

Anchor
_Toc66972273 _Toc66972273

Figure 54. EDM supervisor
Step 2. Go to "Remote Systems" ? "Server context" ? "Define Context" as shown in Figure 55, below.

Anchor
_Ref63864342 _Ref63864342

Anchor
_Toc60846348 _Toc60846348

Anchor
_Toc60846560 _Toc60846560

Anchor
_Toc61032223 _Toc61032223

Anchor
_Toc66972274 _Toc66972274

Figure 55. EDMsupervisor tab
Fill in the form: enter server context name, user, group, old password, and server details as shown in Figure 56, below.

Anchor
_Ref63864397 _Ref63864397

Anchor
_Toc60846349 _Toc60846349

Anchor
_Toc60846561 _Toc60846561

Anchor
_Toc61032224 _Toc61032224

Anchor
_Toc66972275 _Toc66972275

Figure 56. Define Server context form
Step 3. Go to "Remote Systems"? "System Adm." ? "Change password" (Figure 57) and provide a strong new password.

Anchor
_Ref63864471 _Ref63864471

Anchor
_Toc60846350 _Toc60846350

Anchor
_Toc60846562 _Toc60846562

Anchor
_Toc61032225 _Toc61032225

Anchor
_Toc66972276 _Toc66972276

Figure 57. System admin password change tab
Step 4. Repeat step 2 with this new superuser password and then Go to "Remote Systems"? Database ?"Change database password" and enter the same password.
Note: The database password must be the same as the superuser password.

Anchor
_Toc60846351 _Toc60846351

Anchor
_Toc60846563 _Toc60846563

Anchor
_Toc61032226 _Toc61032226

Anchor
_Toc66972277 _Toc66972277

Figure 58. Database password change tab
Step 5. Launch EDM6ServerConsole.exe and stop the solution

Anchor
_Toc60846352 _Toc60846352

Anchor
_Toc60846564 _Toc60846564

Anchor
_Toc61032227 _Toc61032227

Anchor
_Toc66972278 _Toc66972278

Figure 59. EDM6ServerConsole
Step 6. Update the new database password in the EDM6ServerConsole as shown in Figure 60 and Figure 61, below.

Anchor
_Ref63864919 _Ref63864919

Anchor
_Toc60846353 _Toc60846353

Anchor
_Toc60846565 _Toc60846565

Anchor
_Toc61032228 _Toc61032228

Anchor
_Toc66972279 _Toc66972279

Figure 60. EDM database password update

Anchor
_Toc60846354 _Toc60846354

Anchor
_Toc60846566 _Toc60846566

Anchor
_Toc61032229 _Toc61032229

Anchor
_Ref66971290 _Ref66971290

Anchor
_Toc66972280 _Toc66972280

Figure 61. Update with new database password
Step 7. Start the "Solution".

Anchor
_Ref65567387 _Ref65567387

Anchor
_Ref65567395 _Ref65567395

Anchor
_Hlk64384533 _Hlk64384533

Anchor
_Toc66972215 _Toc66972215

How to Install SSL/TLS certificate

Ensure that your internal servers, Intranets, and Virtual Private Networks (VPN) are secured.
SSL/TLS certificates are what enable websites to move from HTTP to HTTPS, which is more secure. An SSL/TLS certificate is a data file hosted in a website's origin server (EDMtruePLM server, for instance). SSL certificates make SSL/TLS encryption possible, and they contain the website's public key and the website's identity, along with related information. Devices attempting to communicate with the origin server will reference this file to obtain the public key and verify the server's identity. The private key is kept secret and secure.
Below we describe how to get SSL/TLS certificate issued by an external certificate authority.
Alternatively, you may use your own local certificate authority.
Self-signed SSL certificate is not recommended option.

Anchor
_Toc64385416 _Toc64385416

Anchor
_Toc64385629 _Toc64385629

Anchor
_Toc64386484 _Toc64386484

Anchor
_Toc64557235 _Toc64557235

Anchor
_Toc64557303 _Toc64557303

Anchor
_Toc64894676 _Toc64894676

Anchor
_Toc64894742 _Toc64894742

Anchor
_Toc64896001 _Toc64896001

Anchor
_Toc64896130 _Toc64896130

Anchor
_Toc65261417 _Toc65261417

Anchor
_Toc65567298 _Toc65567298

Anchor
_Toc66732755 _Toc66732755

Anchor
_Toc66732957 _Toc66732957

Anchor
_Toc66881065 _Toc66881065

Anchor
_Toc66881131 _Toc66881131

Anchor
_Toc61894356 _Toc61894356

Anchor
_Toc66971605 _Toc66971605

Anchor
_Toc66972216 _Toc66972216

Anchor
_Toc66972217 _Toc66972217

Create a Certificate Signing Request (CSR)

Anchor
_Hlk64384546 _Hlk64384546

This step can be optional. Certificate authority may generate CSR automatically. Or they may have GUI wizard to simplify CSR creation.
Keytool is utility that can be used to generate CSR. The utility is part of JDK installation.
You can run this utility wherever you have the keytool command available - most likely on your server, but you can also run it on your own computer if you have installed Java locally. Just make sure you keep track of your keystore file after you create your CSR, because you'll need that file because it will contain your private key, and it will be required to install your certificate.
This is the command that should be executed.
Note: there are sample parameters there. Change values according to your need.
keytool -genkey -alias plm -keyalg RSA -keysize 2048 -keystore trueplm_org.jks -dname "CN=trueplm.org,OU=EPM Tech, O=Jotne, L=Oslo, ST=Norway, C=Oslo" && keytool -certreq -alias plm -file trueplm_org.csr -keystore trueplm_org.jks
trueplm_org.jks and trueplm_org.csr are files that will be created by that commands. We suggest using full path to specify those files.
trueplm.org is sample web server domain name.
You need to use the command prompt to execute the command. CD into your JDK bin folder.
As an example, the utility can be found in the folder like the following.
C:\Program Files\Java\jdk-11.0.5\bin

Anchor
_Toc66972281 _Toc66972281

Figure 62. Keystore details
The Java keytool utility creates both your private key and your certificate signing request, and saves them to two files: trueplm_org.jks, and trueplm_org.csr. Those files are needed to order SSL/TLS certificate. 

Anchor
_Toc61894357 _Toc61894357

Anchor
_Toc66972218 _Toc66972218

Importing the Certificate

Anchor
_Hlk64384569 _Hlk64384569

We assume trueplm_org.p7b is the certificate file you ordered from a certificate authority. 
You must install the SSL/TLS Certificate file to the same keystore file and under the same alias name (e.g., "plm") that you used to generate your CSR. 
Run the command below to import the certificate into your keystore. 
keytool -import -alias plm -file trueplm_org.p7b -keystore trueplm_org.jks 
You should get a confirmation that the "Certificate reply was installed in keystore". 

Anchor
_Toc61894358 _Toc61894358

Anchor
_Hlk64384577 _Hlk64384577

Anchor
_Toc66972219 _Toc66972219

Edit the Tomcat Configuration File

The final step is to configure the Connectors in the server.xml file that can be found in the following folder. 
C:\ProgramData\Jotne EPM Technology AS\TruePLM_base\conf\ 
To configure a SSL/TLS connector, you will need to remove the comments and edit the item with port "8443" to look like this. 
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" 
            maxThreads="150" SSLEnabled="true" scheme="https" secure="true" 
            clientAuth="false" sslProtocol="TLS" keyAlias="plm"  
            keystoreFile="path/to/trueplm_org.jks" keystorePass="*******" /> 
Where keystoreFile is path to keystore file made in section B.2 and keystorePass is password specified in section B.1. 
Port 8443 can be changed if it is needed. You may use value 443. It is default SSL/TLS port.