3 INSTALLATION

The installation of SoMachine can be started from the USB Drive by starting the executable
Launcher.exe.

At first the SoMachine Configuration Manager will be installed and started.

After selecting your preferred language, you can select the kind of installation (selection of packages)

3.1 SoMachine Configuration Manager

The SoMachine Configuration Manager is a standalone tool that can be
started anytime to check/modify/uninstall SoMachine Software.

It is accessible from the Windows > Start > Programs > Schneider Electric > SoMachine Software >
SoMachine Configuration Manager.

3.2 Schneider Electric Software Update

The Schneider Electric Software Update is a standalone tool that allows you
to be notified at Schneider Electric software updates and finally download
and install them.
It is accessible from the Windows > Start > Programs > Schneider Electric > Software Update >
Software Update

Page 21
4 REGISTRATION AND LICENSING IN GENERAL

4.1 Create a Software Licensing Web Portal Account

Create a Web Portal Account to manage your Schneider Electric Software Licenses.
www.schneider-electric.com/licensing

From this web page, go to: Login > Create new Schneider Electric Web User Account (Link)

The Web Portal Account brings you major benefits:

1. Permanent storage of your license Activation IDs.

2. All-in-one-place and permanent knowledge of: date of license activation, e-mail address of the
user who activated the license, remaining number of possible activations, remaining usage time in
case of a time-limited license.
3. Possibility to re-activate your license on this PC after a hard disk replacement or an upgrade of
the Windows operating system.
4. Possibility to move your license from this PC to another one in case of a PC replacement.

4.2 How to register SoMachine

After installing SoMachine, a trial period of 21 days starts. After it expires, you must register
SoMachine as described here:

1.

2. Open the Registration Wizard

3. Start the registration

4.

Page 22
 5. Choose your favorite way to register

6. Follow the indications

To Activate By Web: Enter the email address used to create your Software License Portal
account and finally press next to activate SoMachine V4.

To activate By Phone: Call the Software Registration Center of your area and give the

code and finally press next again to activate SoMachine V4.

7. Your software is registered

By opening the License Manager tool (automatically installed on your computer with
SoMachine V4), you can see from now your registered software. Just start the License
Manager tool from the Windows program list.

Europe | English, German | 8:00 - 18:00 (CET*)

+420 281 088 696 +420 281 088 697
[email protected]

North and Central America | English | 8:00 - 18:00 (EST*)

+1 888 266 8705 (from US and Canada) +1-978-975-9479
+1 978 975 9755 (from other countries)
[email protected]

South America | English | 8:00 - 18:00 (CET*)

+420 281 088 696 +420 281 088 697
[email protected]

Asia and Pacific | English | 8:00 - 18:00 (AEST*)

+61 2 9125 8531 +61 2 9888 3841
[email protected]
France | French | 8:00 - 18:00 (CET*)
0825 012 999 (national) +33 173 024 722
+33 492 088 268 (international)
[email protected]
Italy | Italian | 8:00 - 18:00 (CET*)
+39 011 407 3333 +39 011 22 81 340 Page 23
[email protected]
4.3 License Manager
License manager is a standalone tool to manage many Schneider Electric Software
Licenses.

It is accessible from the Windows > Start > Programs > Schneider Electric > License Manager >
License Manager.

If you have acquired a unique activation ID

the license

Page 24
 5 SQL GATEWAY
SQL gateway is a standalone tool to be installed on a windows PC (or virtual
machine). It has been introduced with SoMachine V4.2 and SoMachine
Motion V4.4.

It allows a SoMachine or SoMachine Motion controller (acting as an SQL client) to communicate to a

database.

Console

5.1 Usage and Licensing of the SQL Gateway

One SQL gateway is required for one network. Each SQL Gateway can connect several controllers to
several databases within this network.

The purchasing of a license is required to use the SQL Gateway. Refer to the following product
reference inside the Schneider Electric catalog:

You need to order a license SQL for SoMachine and SoMachine Motion.
Reference Description License type
SOMSQLCZZSPMZZ SQL for SoMachine and SoMachine Motion. Single License. Unlimited time. Sent
by mail.
Once you have installed the SQL gateway, a trial period of 42 days starts.

5.2 Installation of the SQL Gateway

There are 2 ways to install the SQL gateway.

5.2.1 Installation from the physical media: SoMachine USB Drive

Insert the SoMachine USB Drive.

Go to the root directory and then start \Tools\SqlGateway\SqlGateway.exe

Page 25
5.2.2 Installation from the SoMachine configuration Manager

5.2.3 License activation process

1. Open the SQL Gateway Console Software from the Windows start
menu.

2. Go to Settings License, and click on Launch License Manager

3. Activate By web
computer has an internet connection).

4. After pressing Next Activation ID

the activation process.

5. Activation is being performed

Page 26
 6. When the activation has been activated
successfully, you have then the possibility to
add this license to your Schneider Electric
Web User Account.

7. If Proceed
create a Schneider Electric Web User
Account

8.
has been added to the table inside the License Manager.

6 ETEST FRAMEWORK

6.1 What is ETEST?

ETEST is a powerful SoMachine Framework to Program IEC single unit tests to secure the testing and
non-regression of your application.

Customer benefits:

- Unit tests help the machine programmer to verify the correctness of the implemented
functions.
- Improve the code quality by executing automatic tests on regular base (daily or after every

- The ETEST Framework simplifies the definition and execution of reusable tests.

6.2 Licensing of the ETEST library

6.2.1 License purchasing

The purchasing of a license is required to use the ETEST framework. Refer to the following product
reference inside the Schneider Electric catalog:
Reference Description License type
SOMETTCZZSPMZZ ETEST add-on for SoMachine Software. Single License Single License. Unlimited time. Sent
by mail.
SoMachine includes a 42 days trial period to use the ETEST framework. After its expiration, it is
necessary to activate the license.

Page 27
 6.2.2 License activation of the ETEST Library
To activate the license for the ETEST:
1. Open the License Manager (available from the Windows start menu or from
SoMachine Central > Tools > Schneider Electric License Manager)

2. Activate By web
computer has an internet connection).

3. After pressing Next Activation ID ed by mail and perform

the activation process.

4.
License Manager.

Page 28
 SPANISH

Instrucciones de instalación y registro de SoMachine

La información que se ofrece en esta documentación contiene descripciones de carácter general y/o
características técnicas sobre el rendimiento de los productos incluidos en ella. La presente
documentación no tiene como objeto sustituir dichos productos para aplicaciones de usuario
específicas, ni debe emplearse para determinar su idoneidad o fiabilidad. Los usuarios o integradores
tienen la responsabilidad de llevar a cabo un análisis de riesgos adecuado y completo, así como la
evaluación y las pruebas de los productos en relación con la aplicación o el uso de dichos productos
en cuestión. Ni Schneider Electric ni ninguna de sus filiales o asociados asumirán responsabilidad
alguna por el uso inapropiado de la información contenida en este documento. Si tiene sugerencias
de mejoras o modificaciones o ha hallado errores en esta publicación, le rogamos que nos lo
notifique.

Usted acepta no reproducir, excepto para su uso personal y no comercial, la totalidad o parte de este
documento de ningún modo sin el permiso por escrito de Schneider Electric. También acepta no
establecer ningún enlace de hipertexto a este documento o a su contenido. Schneider Electric no
otorga ningún derecho ni ninguna licencia para el uso personal y no comercial del documento o su
contenido, con la excepción de una licencia no exclusiva para consultarlo "tal cual", bajo su cuenta y
riesgo. Todos los demás derechos quedan reservados.

Al instalar y utilizar este producto es necesario tener en cuenta todas las regulaciones sobre
seguridad correspondientes, ya sean regionales, locales o estatales. Por razones de seguridad y para
garantizar que se siguen los consejos de la documentación del sistema, las reparaciones solo podrá
realizarlas el fabricante.

Cuando se utilicen dispositivos para aplicaciones con requisitos técnicos de seguridad, siga las
instrucciones pertinentes.

Si con nuestros productos de hardware no se utiliza el software de Schneider Electric u otro software
aprobado, pueden producirse lesiones, daños o un funcionamiento incorrecto del equipo.

Si no se tiene en cuenta esta información, se pueden causar daños personales o en el equipo.

© 2017 Schneider Electric. Todos los derechos reservados.

Page 29
 RESUMEN
1 FINALIDAD DE ESTE DOCUMENTO ...................................................................................... 31

2 INFORMACIÓN Y ENLACES ÚTILES ..................................................................................... 31

2.1 Ayuda en línea ..................................................................................................................... 31
2.2 Notas de la versión .............................................................................................................. 31
2.3 Ejemplos de proyectos ....................................................................................................... 32
2.4 Tutoriales en vídeo .............................................................................................................. 32
2.5 Material de formación ......................................................................................................... 32

3 INSTALACIÓN .......................................................................................................................... 33
3.1 SoMachine Configuration Manager ................................................................................... 34
3.2 Schneider Electric Software Update .................................................................................. 34

4 REGISTRO Y LICENCIAS EN GENERAL ............................................................................... 35

4.1 Creación de una cuenta de Software Licensing Web Portal ........................................... 35
4.2 Cómo registrar SoMachine ................................................................................................. 35
4.3 License Manager.................................................................................................................. 37

5 SQL GATEWAY ........................................................................................................................ 38

5.1 Uso y licencias de SQL Gateway ....................................................................................... 38
5.2 Instalación de SQL Gateway .............................................................................................. 38
5.2.1 Instalación desde el soporte físico: unidad USB de SoMachine ....................................... 38
5.2.2 Instalación desde SoMachine Configuration Manager ...................................................... 39
5.2.3 Proceso de activación de la licencia .................................................................................. 39

6 ETEST FRAMEWORK .............................................................................................................. 40

6.1 ¿Qué es ETEST? .................................................................................................................. 40
6.2 Licencias de la biblioteca ETEST....................................................................................... 40
6.2.1 Adquisición de licencias .................................................................................................... 40
6.2.2 Activación de la licencia de la biblioteca ETEST ............................................................... 41

Page 30