LMS Imagine.

Lab SysDM Rev12

Client Installation & Configuration

Copyright LMS IMAGINE S.A. 1995-2013

AMESim is the registered trademark of LMS IMAGINE S.A.
LMS Imagine.Lab is a registered trademark of LMS International N.V.
SysDM is a registered trademark of LMS International N.V.
Windows is a registered trademarks of the Microsoft Corporation
All other product names are trademarks or registered trademarks of their respective companies.

TABLE OF CONTENTS
1. Overview ................................................................................................................ 2
2. Prerequisites ......................................................................................................... 2
2.1. System requirements ...................................................................................... 2
2.2. Installed Software and other requirements ..................................................... 2
3. Installing SysDM Client ......................................................................................... 3
3.1. PostgreSQL Installation ................................................................................ 13
3.2. Silent Installation .......................................................................................... 20
4. Configuring SysDM Client .................................................................................. 21
4.1. Connection Settings...................................................................................... 23
4.2. Database Settings ........................................................................................ 24
5. Configuring SysDM Server Connection details ................................................ 25
6. Verifying the Client Installation .......................................................................... 27
7. Compatibility ....................................................................................................... 29
Support and contact information ........................................................................... 30

March 2013

Table of Contents

1/1

LMS Imagine.Lab SysDM Client

Installation & Configuration
1. Overview
LMS Imagine.Lab SysDM is an Enterprise Solution for the Collaborative Management of Models,
Data and related artifacts in Model Based System Engineering. SysDM stands for System Data
Manager. This document provides step by step process to install and configure SysDM client for
Independent and Network installation.

2. Prerequisites
2.1. System requirements

The following version of OS are supported by SysDM

o

Windows XP Professional SP2 and above

Windows 7

Open SUSE Linux 10.2 & 11.3(32 & 64 bit)

RHEL (Red Hat Enterprise Linux) 5.6 (64 bit)

2GB RAM minimum, 4GB RAM is recommended

Minimum Disk space of 400MB required. Maximum is based on the data.

Processor : Pentium IV and above

2.2. Installed Software and other requirements

SysDM license file or SysDM license server must be available.

SysDM server must be installed and configured. SysDM server must be available in the
same network.

There should not be any firewall between SysDM server and SysDM client.

User who is going to run SysDM client application must have write access in SysDM client
installation directory and its sub-directories.

March 2013

SysDM Client Installation and Configuration

2/30

3. Installing SysDM Client

For Windows:
Double click the SysDM client Installer XXXXXXXX_SysDM_EC_Rev_12.exe (For example,
20130213_SysDM_EC_Rev_12.exe). This opens installation wizard which will guide you through
complete installation process.
Figure 3.1 : Installation Wizard

After this, SysDM shows welcome message.

For Linux:
Kindly ensure executable rights are available to the client installer script XXXXXXXX_SysDM_EC_
Rev_12.sh (For example, 20130213_SysDM_EC_Rev_12.sh). If not, run the following command:
Chmod +x 20130213_SysDM_EC_Rev_12.sh

Double click the SysDM client Installer shell script or type bash < SysDM client Installer shell script>.
This opens installation wizard and shows welcome message

March 2013

SysDM Client Installation and Configuration

3/30

Figure 3.2 : Welcome message

Click Next button. This opens License agreement dialog box.

March 2013

SysDM Client Installation and Configuration

4/30

Figure 3.3 : License agreement dialog box

Go through the License agreement. If you agree with the licensing terms and want to proceed
with the installation, select I accept the agreement option and click Next button.

March 2013

SysDM Client Installation and Configuration

5/30

This opens the Installation type selection window.

Figure 3.4 : Installation type selection window

Independent Installation: By this, each client is installed with the entire executable and application
maintained data. Executable will not be shared with other clients and exclusively used by the client
where the installation is made.

Network Installation: By this, a common client is installed and the executable will be shared by
many clients in the network. Application maintained data will not be stored in this common client.
Application maintained data will be stored independently in each client system which is connected to
this common client. You cannot directly use this installation. You have to install a local client to use
the SysDM application (Refer SysDM_Local_Client_Installation_guide document for more details).

Select the type of installation as Independent Installation or Network Installation and click Next
button.

March 2013

SysDM Client Installation and Configuration

6/30

This opens Select Destination directory dialog box.

Figure 3.5 : Select Destination directory dialog box

By default SysDM installs the client under C:\Program Files (x86)\ LMS\Imagine_Lab_SysDM
directory. If you want to change the installation directory to some other folder, click Browse button.
This opens OS File Browser dialog box. Browse and choose the directory where you want to install.
The selected directory will be displayed in Destination directory field. Alternatively if you know the
installation directory path, you can type the directory path in Destination directory field. If the
destination directory path is not available, SysDM will create the destination directory. After this
click Next button.

March 2013

SysDM Client Installation and Configuration

7/30

Select Start Menu / Symlinks screen is applicable only for the

independent client installation.
For Windows:
This opens Select Start Menu Folder dialog box.
Figure 3.6 : Select start menu folder dialog box

By default, start menu folder will be LMS Imagine.Lab SysDM [Client]. If you want to change the
default start menu, type the menu name in the start menu folder field. Click Next button. This opens
Select Additional Tasks dialog box.

March 2013

SysDM Client Installation and Configuration

8/30

For Linux:
This opens select Directory for Symlinks dialog box.
Figure 3.7 : Select Directory for Symlinks

By default, symlinks will be created under /home/<user name>/bin directory. If you want to change
the default directory, click Browse button. This opens OS File Browser dialog box. Browse and
choose the directory where you want to place the Symlinks. The selected directory will be displayed
in Destination directory field. Click Next button. This opens Select Additional Tasks dialog box.

March 2013

SysDM Client Installation and Configuration

9/30

Select Additional Tasks screen is applicable only for independent

client installation.
Quick launch icon is not applicable for Linux OS
This screen is applicable only for Independent Installation.
Figure 3.8: Select Additional Tasks

Select whether you want to create desktop and / or Quick launch icon by checking the option against
it. Click Next button.

March 2013

SysDM Client Installation and Configuration

10/30

This opens Select Database dialog box.

Select database is not applicable for Linux OS. Only HSQL is
supported in Linux OS.
Figure 3.9 : Select Database

Select HSQL database, if you are not going to perform System Synthesis operations. It is
an embedded database and no additional installation required.

Select PostgreSQL 8.4 database, if you are going to perform System Synthesis operations
as System Synthesis does not support HSQL database. However, for SysDM operations it
is not mandatory. A separate installer will be launched to install PostgreSQL, if it is not
already installed.

For Independent installation, the database selection will create and use the database in the selected
tool. For Network Installation, this will restrict all the local clients to use the selected database. If you
have selected the HSQL option, it will create the database and configure it. In this case, Database
Settings will not be there in the Client Settings dialog box.

If you want to perform System Synthesis functions, you must select

PostgreSQL database.
March 2013

SysDM Client Installation and Configuration

11/30

After selecting the database option, click Next button to continue. SysDM extracts the installation
files from the installer and the progress will be shown with the file names in the following screen.
Figure 3.10 : Installation progress

After extraction, installer starts the installation with third-party packages (if applicable).

March 2013

SysDM Client Installation and Configuration

12/30

3.1. PostgreSQL Installation

This section is applicable only if you selected PostgreSQL database
and do not have PostgreSQL 8.4 version at your local system.
To install PostgreSQL, you need administrative privileges.
SysDM prompts for the required parameters for the PostgreSQL installation.
Figure 3.11 : PostgreSQL installation requirements

PostgreSQL database port. By default it is 5432. If you want to change it

Database Port

change the port number. Remember this port number as it is required to

configure SysDM client
Postgres installation creates a service account by name postgres. You

Enter Password

have to provide password for this account. This password must honour your
local security policy. Remember this password as it is required to configure
SysDM client

Re- Enter Password

March 2013

Provide the above password for confirmation

SysDM Client Installation and Configuration

13/30

Click Next button. SysDM starts PostgreSQL installation with warning message.
Figure 3.12 : PostgreSQL installation warning message

Do not click OK button until the PostgreSQL installation is

completed.

Installer will start the installation of PostgreSQL database. SysDM shows the progress of the
installation.
Figure 3.13 : Setup - PostgreSQL installation progress

After completion of PostgreSQL Installation (after the above screen is closed), PostgtreSQL
installation confirmation message is displayed.
Figure 3.14 : PostgreSQL installation confirmation dialog box

Click OK button. This will navigate you back to the SysDM client installation > Information screen.

March 2013

SysDM Client Installation and Configuration

14/30

For Independent Installation:

SysDM shows the information about database and server configuration requirements.
Figure 3.15 : Information - Database & Server configuration requirement

Click Next button to complete the client installation.

March 2013

SysDM Client Installation and Configuration

15/30

For Network Installation:

SysDM shows the information about the local client installer.
Figure 3.16 : Local Client Installer

March 2013

SysDM Client Installation and Configuration

16/30

Installer for the local client is available in the Client Network Installation directory.
In Windows OS:
Figure 3.17 : Local Client installer

After identifying the local installer, click Next button in the Information screen to complete the client
installation.

March 2013

SysDM Client Installation and Configuration

17/30

In Linux OS:
Figure 3.18 : Local Client Installer - Linux

After identifying the local installer, click Next button in the Information screen to complete the client
installation.

March 2013

SysDM Client Installation and Configuration

18/30

SysDM shows completion of client installation.

Figure 3.19 : Client Installation completion

Click Finish button to complete the client installation.

March 2013

SysDM Client Installation and Configuration

19/30

3.2. Silent Installation

You can install SysDM independent client without user interaction. This is known as silent
installation. Database will be assumed as HSQL in this installation. You can use the following
command to install SysDM in silent mode:
<SysDM Installer> -q dir < empty directory path >
For example,
20130213_SysDM_EC_Rev_12.exe -q -dir "C:\Program Files (x86)\LMS
\Imagine_Lab_SysDM\Client_12"

Do not install SysDM in silent mode if you want to perform System

Synthesis functions.

March 2013

SysDM Client Installation and Configuration

20/30

4. Configuring SysDM Client

This section is applicable only if you selected the independent
installation.
In Windows:
Select Configure Client from the Windows Start menu > All Programs > LMS Imagine.Lab
SysDM[Client].

In Linux:
Select Configure Client from Applications or Click Configure Client.desktop icon

from the client

installation directory.

Initially SysDM will prompt you to locate the RLM license server.
Figure 4.1 : RLM license server configuration

Enter the system name or IP address (with port number if required) of the RLM license server and
press Save button. This will save the RLM server details and SysDM shows the confirmation
message. Also you can set the system environment variable LMS_LICENSE = @<RLM server
name> to specify the license server. For example, LMS_LICENSE=@CHE-N11-007.

March 2013

SysDM Client Installation and Configuration

21/30

Figure 4.2 : RLM license server configuration - save

Press OK button. This opens client settings dialog box. Client settings dialog box has the following in
the side bar:

Connection Settings

Database settings

March 2013

SysDM Client Installation and Configuration

22/30

4.1. Connection Settings

Click Connection Setting in the side bar to configure the Server connection.
Figure 4.3 : Connection settings dialog box

Provide IP address or system name of the SysDM server. If the Server is

Host

not having static IP address, for example Laptop, provide IP address as

127.0.0.1

RMI Registry Port

Provide 1099 for RMI Registry Port

After providing these details, click Save Connection Settings button to save the connection settings.
Click Remove button to remove the connection settings.

You cannot remove client settings until all the Collections in the
local workspace are deleted.

March 2013

SysDM Client Installation and Configuration

23/30

4.2. Database Settings

This section is applicable only if you have selected the PostgreSQL
database during your installation.
Click Database Setting in the side bar to configure the local database.
Figure 4.4 : Database Settings

User Name

Provide user name as postgres

Password

Provide password for the user postgres

Host

Port
Database

By default it is localhost. You should change it to the IP address or system

name
By default it is 5432. If your postgreSQL is using different port provide that
port number
Provide name of the database

After providing these details, click Save button to save the database settings.

March 2013

SysDM Client Installation and Configuration

24/30

5. Configuring SysDM Server Connection details

This section is applicable only if you selected the Network
installation.
You can configure SysDM server parameters in the network installation which will be used by client
1

local installation for auto-configuration .

Figure 5.1 : Network client installation bin folder

You can invoke Server Connection details dialog by double-clicking ServerConfigInput.exe under
<Client Network installation>/bin folder.

If you select HSQL as database for your local client installation, after the installation you can immediately launch
the client application; you need not configure the client. If you select PostgreSQL as database for your local client
installation, the server connection details will be populated in Connection Setting screen.

March 2013

SysDM Client Installation and Configuration

25/30

Figure 5.2 : Server Connection Detail dialog box

Host

Provide IP address or system name of the SysDM server.

RMI Registry Port

Provide 1099 for RMI Registry Port

After saving the server connection details, SysDM shows confirmation message. These details will
be used by local client installation during auto configuration.
Figure 5.3 : Server Connection details Save information message

After the initial Server Connection detail settings, if you make any
changes, the changes will not be propagated to the auto-configured
local clients. Those local clients have to manually re-configure the
modified connection settings.

March 2013

SysDM Client Installation and Configuration

26/30

6. Verifying the Client Installation

This section is applicable only for the independent installation.

After completing the client settings, try to launch the application by:
In Windows:

Selecting SysDM from the Windows Start menu > Programs > LMS Imagine.Lab
SysDM[Client], or

Double click on the SysDM icon

on your desktop

In Linux:

Selecting SysDM Client from the Applications, or

Double click on the SysDM Client.desktop icon

from your client installation directory

This launches SysDM About dialog box first and then the SysDM Main GUI with Login dialog box.
Figure 6.1 : SysDM about dialog

March 2013

SysDM Client Installation and Configuration

27/30

Figure 6.2 : Login dialog box

Enter User ID and password supplied by your application administrator in Login dialog box. If the
login is successful, your client is successfully installed and configured.

March 2013

SysDM Client Installation and Configuration

28/30

7. Compatibility
The following table shows the compatible versions of AMESim and MATLAB for SysDM versions:
Table 7-1 : Compatible Versions

Compatible Versions
SysDM

AMESim

SysDM Rev 11

AMESim Rev 11

SysDM Rev 11 SL1

AMESim Rev 11 SL1

SysDM Rev 11 SL1 VAMT Patch

AMESim Rev 11 SL1 VAMT Patch

SysDM Rev 11 SL1 EE

AMESim Rev 11 SL1 VAMT Patch

SysDM Rev 11 SL2

AMESim Rev 11 SL2

SysDM Rev 12

March 2013

AMESim Rev 12

SysDM Client Installation and Configuration

Matlab

Matlab
R2006b to
Matlab
R2009a

Matlab
R2006b to
Matlab
R2010b

29/30

Support and contact information

Support
General information on our products is
http://www.lmsintl.com/LMS-Imagine-Lab-Platform

available

on

our

Solutions

webpage:

Please refer to our Support webpage: http://www.lmsintl.com/support for information on current and
upcoming releases, FAQs and a bug reporting form.
You can also contact the Support desk of your local LMS Imagine Office directly. The corresponding
e-mail address and phone number are indicated on our Support and Contact webpage:
http://www.lmsintl.com/support/contact.
For problems with a specific model, please send us a test case and a test procedure if possible. If
result data is not needed, please purge the system concerned (using the AMESim Purge tool) and
compress it before sending it.
Please note that the scope of our Software Maintenance Service is limited as defined in your
Software License Agreement.
Contact information
For more information on your local LMS Imagine Office (mail address for example), please refer to
our Contact webpage: http://www.lmsintl.com/lmsworldwide.

March 2013

SysDM Client Installation and Configuration

30/30