sysdm client installation guide

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.

March 2013 Table of Contents 1/1

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 SysDM Client Installation and Configuration 2/30

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

o Windows 7

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

o 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.


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


Figure 3.2 : Welcome message

Click Next button. This opens License agreement dialog box.


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.


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.


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.


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.


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.


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.


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.


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).


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

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

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

configure SysDM client

Enter Password

Postgres installation creates a service account by name ‘postgres’. You

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 Provide the above password for confirmation


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.


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.


For Network Installation:

SysDM shows the information about the local client installer.

Figure 3.16 : Local Client Installer


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.


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.


SysDM shows completion of client installation.

Figure 3.19 : Client Installation completion

Click Finish button to complete the client installation.


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.


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.


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


4.1. Connection Settings

Click Connection Setting in the side bar to configure the Server connection.

Figure 4.3 : Connection settings dialog box

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.

Host

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

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


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

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

User Name Provide user name as ‘postgres’

Password Provide password for the user ‘postgres’

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

name

Port By default it is 5432. If your postgreSQL is using different port provide that

port number

Database Provide name of the database


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

local installation for auto-configuration1.

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.

1 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.


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.


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


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.


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 Matlab

SysDM Rev 11 AMESim Rev 11

Matlab R2006b to

Matlab R2009a

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 AMESim Rev 12

Matlab R2006b to Matlab R2010b


Support and contact information

Support

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

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.

http://www.lmsintl.com/LMS-Imagine-Lab-Platform

http://www.lmsintl.com/support

http://www.lmsintl.com/support/contact

http://www.lmsintl.com/lmsworldwide

sysdm client installation guide

Documents

sysdm license server

overview lms

network installation

registered trademarks

system requirements

postgresql installation

silent installation

system data manager