JNC Shutdown Client - Socomec

JNC Shutdown ClientInstallationsanweisung und Bedienungsanleitung DE

Manual de instalación y uso ES

Manuel d’installation et d’utilisation FR

Installation and operating manual GB

Manuale d’installazione e uso IT

Installatie- en bedieningshandleiding NL

2 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08

CERTIFICATE AND CONDITIONS OF WARRANTY

Installing the software means full acceptance of all contractual terms. For this reason, please read all the points listed below carefully.

If you do not agree with one or more of the contractual terms, do not install this software and/or return it immediately to SOCOMEC.

1. Copyright and Intellectual Property ownership rights

The user of the software acknowledges that all rights referred to and the copyright belong to SOCOMEC, in relation to both the

source code and the object code.

Anyone entering into possession of the software without prior authorisation from SOCOMEC must immediately uninstall it if it has

been installed, and return it to SOCOMEC. If such persons fail to take this action SOCOMEC will exercise its rights to the full extent

permitted by civil and criminal law.

The software and documentation are protected by copyright. The unlawful use and/or partially or totally copying of the software shall

lead to claims for compensation. It is permitted to create a back-up copy of the media supplied by SOCOMEC (CD Rom). This docu-

mentation and software are not specifications. SOCOMEC reserves the right to make changes to information without prior notice.

SOCOMEC retains the full and exclusive ownership of all intellectual rights, such as, but not limited to those relating to documenta-

tion, software, source code, object code etc. Only a personal entitlement to use the documentation and software for the application

indicated by SOCOMEC is granted to the recipients. The reproduction, modification, or distribution of this documentation and

software either partially or totally and in any way is expressly prohibited except upon Socomec’s express prior written consent.

2. Licence to use

The JNC software (object code) and supporting documentation are freely installable for private use solely in combination with the

use of SOCOMEC's products.

The software contains confidential information. This licence does not authorise the user to modify, adapt, decompile, or disassemble

the software in question or to reconstruct the source code using any other method. SOCOMEC will protect its rights against any

such unauthorised use to the full extent permitted by civil and criminal law.

The software may not be hired out to third parties. The licence of use for this software is issued exclusively for the purposes laid out

in the software documentation.

3. Entry into force and duration of the licence

This licence enters into force on the day of installation of the software, whereby the user accepts these conditions of use and

liability. The licence is open term and has no date of expiry. The licence and the limited rights of use by the user of the software will

be invalidated in the event of a breach of any of the points outlined in paragraphs 1. Copyright and Intellectual Property ownership

rights and 2. Licence.

4. Warranty conditions

SOCOMEC neither implicitly nor explicitly provides any warranty concerning the usability of the software. Despite the extensive use

of resources to develop the software, no guarantees are provided concerning the absence of errors. SOCOMEC may provide the

support needed to solve any errors present in the software. Such support is limited to the correction of programming errors and is

not extended to the implementation of new functions that are not present in the version of the software used by the user.

If the user finds any manifest or hidden errors, SOCOMEC should be notified of such errors in writing.

5. Software updates

This licence does not grant the right to receive software updates, or new versions.

6. Limitations of liability

SOCOMEC shall not be held liable, under any circumstances, for damage of any kind, including financial loss, directly or indirectly

resulting from the use of, or inability to use the software.

7. Severability

If any clause of this contract is found to be ineffective or becomes ineffective for any reason whatsoever, the remaining terms of the

licence shall still apply. The unenforceable clause or ineffective provisions will be replaced by a clause, also with retroactive effect,

that addresses subsequently identified requirements, within the scope of legal enforceability.

8. Amendments to the licence

Any amendment to this licence must be made in writing.

9. Applicable law

This contract is subject to French law.

The information contained herein, the software and documentation, are the exclusive property of SOCOMEC.

3JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08

EN

GL

ISH

SUMMARY

EN

GL

ISH

1. JAVA & .NET SHUTDOWN CLIENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.1. GENERAL OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2. OPERATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2. COMPATIBILITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.1. LIST OF OPERATING SYSTEMS SUPPORTED . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.2. COMPATIBILITY WITH UPS SYSTEMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3. INSTALLATION OF THE JAVA AND .NET SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.1. .NET FRAMEWORK FOR WINDOWS® . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.2. JAVA JRE/JDK INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

4. INSTALLATION OF THE JNC CLIENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.1. INSTALLATION PROCEDURE FOR MICROSOFT™ WINDOWS® - .NET . . . . . . 9

4.2. INSTALLATION PROCEDURE FOR UNIX™. . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.3. INSTALLATION PROCEDURE FOR LINUX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.4. INSTALLATION PROCEDURE FOR ORACLE® . . . . . . . . . . . . . . . . . . . . . . . . 10

4.5. INSTALLATION PROCEDURE FOR MAC OS X . . . . . . . . . . . . . . . . . . . . . . . . 10

4.6. INSTALLATION PROCEDURE FOR AS 400® . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.7. INSTALLATION PROCEDURE FOR OTHER OSS . . . . . . . . . . . . . . . . . . . . . . 10

5. CONFIGURATION OF THE JNC CLIENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5.1. CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5.2. PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

5.3. LANGUAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

5.4. MANUAL CONFIGURATION VIA TERMINAL . . . . . . . . . . . . . . . . . . . . . . . . . . 13

6. SHUTDOWN PROCEDURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

6.1. DESCRIPTION OF THE SHUTDOWN PHASES . . . . . . . . . . . . . . . . . . . . . . . . 15

6.2. SHUTDOWN COMMANDS FOR WINDOWS® . . . . . . . . . . . . . . . . . . . . . . . . . 16

7. CLIENT MONITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7.1. UPS STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7.2. UPS ICON COLOUR CONDITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7.3. NOTIFICATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17


1.1-3 .net version 1.1-4 Java version

1.1. GENERAL OVERVIEW

The JAVA & .NET Shutdown client (JNC) software package is a suite of programs for the remote control via EThernet Network and

automatic shutdown of computers powered by SOCOMEC systems.

The programs in the CD are compatible with JAVA and .NET technologies and therefore can support a wide range of operating

systems (Microsoft™ Windows®, LINUX, UNIX™, etc.).

The JNC package consists of a collection of three programs:

• Client Setup: easy and intuitive software tools used to configure the shutdown client parameters.

1. JAVA & .NET SHUTDOWN CLIENT

• Client monitor: the software that displays the main UPS status information using the graphics interface of the operating system.

Shows the status of shutdown events and displays the warning message.

• The service: the software that controls the connection with the UPS and performs certain default actions when events occur.

This part of the package does not use graphic components, but has been designed for use as a service (on Windows® systems)

or daemon/process (on LINUX / UNIX™ systems).

1.1-1 .net version 1.1-2 Java version


EN

GL

ISH

1. JAVA & .NET SHUTDOWN CLIENT

1.2. OPERATIONS

CONNECTION TO NET VISION

The connection between the Ethernet interface, the UPS and the server with the JNC client is carried out using UDP/IP protocol.

Shutdown events have to be activated via html pages on the UPS Ethernet Interface (such as NET VISION, embedded interface, etc.).

CONNECTION TO DELPHYS GREEN POWER

The connection between DELPHYS GREEN POWER range and the server with the JNC client is carried out using UDP/IP protocol.

The RJ45 connector is located on DELPHYS GREEN POWER MIMIC PANEL.

The JNC service must be activated on the mimic panel by setting the UDP port used by JNC: 200 by default.

Shutdown events have to be activated via the embedded web server on the mimic panel. The JNC html page is enabled on the web

server after setting the JNC port on the mimic panel.

DISPLAYING UPS EVENTS

The client uses configurable messages to display any critical situations in the power supplied to PCs by the UPS.

SIMPLIFIED CONFIGURATION

For operating systems with a graphical user interface, the shutdown client parameters can be configured using easily interpreted

panels. For server operating systems that have no graphical interface, the parameters can be configured by modifying a simple end

of text. These parameters can be modified manually by editing the COMMON.CFG in the JNC installation folder.

DESIGNED WITH TECHNOLOGIES INDEPENDENT OF HARDWARE ARCHITECTURE

JAVA and .NET are technologies that are independent of the computer hardware. Full compatibility of this package with your opera-

ting system is assured by the specific libraries that make your system JAVA or .NET compatible.

There are three versions of the shutdown program on the CD:

- JNC (.NET): enhanced version of .NET for Windows® .NET systems

- JNC (JAVA): enhanced version of JAVA for systems with JRE 1.4 (1.6 recommended) and above


2. COMPATIBILITY

The JNC package is compatible with a wide range of operating systems. This compatibility is ensured with the correct installation

of either JAVA or .NET support software.

Many operating systems include native support JAVA or .NET. For details on compatibility levels please consult the on-line guide

for your operating system. The use of non certified SUN JRE could cause unexpected shutdown client behaviour not described in

this manual.

2.1. LIST OF OPERATING SYSTEMS SUPPORTED

Please refer to the chart below for the operating systems supported and their suggested software release.

For details on how to install the support libraries, please refer to chapter 3 JAVA and .NET.Installation and support.

Operating systems supported

Operating system O.S./Version Libraries required/Version JNC (JAVA) JNC (.NET)

Windows®

XP SP2 or later

.net Framework 4.x

√

2003 Server (32/64 bit) √

2008 Server (32/64 bit) √

Vista (32/64 bit) √

7 (32/64 bit) √

8 (64 bit) √

2008 R2 √

2012 √

IBM®

AIX® 4.3.3

JAVA JRE 1.4*

√

AIX® 5.1 or later √

AS 400® V5R3 √

AS 400® V7R1 √

ORACLE® SOLARIS® 8 or later √

Linux All versions distributed √

Apple™ Mac Os X √

* JRE 1.6 is recommended

2.2. COMPATIBILITY WITH UPS SYSTEMS

The JNC package is compatible with all SOCOMEC software communication packages. Some functions might not be available on

the connected UPS. For more details contact the technical support department.


EN

GL

ISH

3.2-1 Windows® 3.2-2 UNIX™ - Linux

3. INSTALLATION OF THE JAVA AND .NET SUPPORT

3.1. .NET FRAMEWORK FOR WINDOWS®

In order to use .NET technology, it may be necessary to install the support for Microsoft™ .NET Framework onto the operating

system.

To install the support, run the file1 \Install_NET_Framework_2_0.bat and follow the instructions.

If the installation program finds a more recent version of the libraries already installed on your operating system, you can close the

procedure and move on to the chapter on installation of shutdown software.

Note: the .NET framework included in the SUPPORT directory is in English. For other languages, please connect to Microsoft™ Download Centre.

3.2. JAVA JRE/JDK INSTALLATION

If you need to know whether JRE or JDK is already installed on your operating system or if, after installing the JRE (or the JDK) you

want to test if the installation was completed successfully, you can open a command shell and type the command java –version

at the command shell prompt.

A text similar to the following confirms the JAVA environment is already installed on your system:

Java(TM) version “1.x.x”

Java(TM) 2 Runtime Environment, Standard Edition (build 1.x.x)

Java HotSpot(TM) Client VM (build 1.x.x, mixed mode)

Package available:

- LINUX i586 and x64 installation package

- ORACLE® for i586 and SPARC installation package.

It is possible to install the LINUX rpm package on other UNIX™ operating systems.

Note: We recommend checking the last version of JAVA environment for your operating system on the Internet.

The JRE installation file can be downloaded from the Sun Microsystems web site or from your operating system producer’s web site.

If you are manually installing the JRE, it should be installed using default paths (see the list below) to permit start scripts (i.e. start.sh) prepared for

each operating system to find the JRE. Alternatively, if you need or prefer to install JRE on a different path, please remember to modify the scripts

in the JNC folder in accordance with the path chosen.

AIX® “/usr/jdk_base”

LINUX “/opt/jre/bin”

ORACLE® “/usr/bin”

Standard path used for all shell files in JNC environment:

JRE_DIR= /opt/jre

If the jre is located in another folder, it will be necessary to create a symbolic link to this folder, or to modify all shell files in the jnc

with the correct jre patch (like /usr/jre/java for example)

Shell files to modify: start.sh (run the daemon), setup.sh (configuration tool), viewer.sh (status Windows®)

Command to create the symbolic link

ln –s JREInstallationDirectory /opt/jre


3. INSTALLATION OF THE JAVA AND .NET SUPPORT

JRE INSTALLATION PROCEDURE FOR LINUX

• Log as root user

• Mount the support where the package is stored

• Select cdrommedia/JNC/SUPPORT/JAVA_JRE folder:

- copy jre-6u26-linux-i586.bin or jre-6u26-linux-x64.bin file to \opt directory

- move to /opt directory:

cd /opt- make the bin file executable, typing:

chmod a+x jre-6u26-linux-i586.bin- install JRE:

./ jre-6u26-linux-i586.bin- after installation there will be a /opt/jre1.6.0_26 new directory. Create a symbolic link using the command:

ln –s jre1.6.0_26 jre The target of this command is to create a “/jre” virtual folder in “/opt” directory

- Check the presence of a new “/opt/jre” directory.

ls /opt/jre

You should see the contents of the ‘java’ folder.

JRE INSTALLATION PROCEDURE FOR ORACLE® FROM THE CD

• Log as root user;

• Select cdrommedia/JNC/SUPPORT/JAVA_JRE folder:

- copy jre-6u26-oracle-i586.sh or jre-6u26-oracle-sparc.sh file to \opt

- move to /opt directory:

cd /opt

- install JRE:

./ jre-6u26-oracle-i586.sh

- after installation there will be a /opt/jre1.6.0_26 new directory. Create a symbolic link using the command:

ln –s jre1.6.0_26 jre

The target of this command is to create a “/jre” virtual folder in “/opt” directory, so please check the presence of a new “/opt/jre” directory.


EN

GL

ISH

4. INSTALLATION OF THE JNC CLIENT

4.1. INSTALLATION PROCEDURE FOR MICROSOFT™ Windows® - .NET

To install the JNC package for Windows®, you must first check, and complete if necessary, the installation of the .NET framework

libraries (Chapter 3).

The installation package can be found in the CD boundle with the UPS (Socomec JNC - CD Setup.msi) or on the SOCOMEC

website (Socomec JNC - Web Setup.msi).

Run setup.exe and follow the instructions.

CAUTION!

The login used to connect to the Windows® system must have administration rights in order to install the package correctly.

4.2. INSTALLATION PROCEDURE FOR UNIX™

You can find JNC on the JNC CD-ROM as a compressed file together with a shell script named install.sh that may be used to install

it from /mnt/cdrom/jnc/jnc/unix, assuming /mnt/cdrom/ as the mount point of your CD reader.

Launch the installation script using the following syntax: ./INSTALL.SH.

You will be prompted to type the name of your operating system so that the installation can copy the files needed by JNC in the

standard path. List of operating systems:

• LINUX

• ORACLE®

• AIX®

• MAC_Os X

• OTHER

If you want to install JNC in a different folder from the standard one you will have to modify the installation script.

Note: to perform the installation you must login as root user.

4.3. INSTALLATION PROCEDURE FOR LINUX

• Move to JNC Unix folder

• run INSTALL.SH script:

./INSTALL.SH

• choose the OS ( i.e. LINUX); at the end of the installation procedure, a new /usr/jnc directory is created, containing all the necessary JNC files;

• to complete the installation procedure, the JNC ‘service’ must start as a daemon. To do this copy the “S20jnc.sh” script, in /etc/

rc2.d, /etc/rc3.d, /etc/rc4.d, /etc/rc5.d directories (runlevels):

cp S20jnc.sh /etc/rc2.d




• Reboot and check JNC is working correctly

- checking the Net Vision Client Table page

- in the process list, start and JAVA should be present on the list. (ps – e)

Note: the above installation procedure has been tested using Linux Ubuntu. If you are using a different Linux distribution, or a different OS

(i.e Mac OS X), some paths/directories may be different, and also the management of the runlevels. Please refer to your Linux distribution

documentation for more info, in order to change the above procedure for proper JNC installation appropriately.

If the installation cannot be performed from the CD reader, copy the JNC folder cdrom_mountpoint/jnc/jnc/unix to a temporary

one on the local hard disk; then change the file authorisations of INSTALL.SH and OWNER.SH making them executable (owner.

sh is available in the folder called /unix/os/platform_name).

Once the installation phase is completed, refer to Chapter 5 for the configuration procedure.


4. INSTALLATION OF THE JNC CLIENT

4.4. INSTALLATION PROCEDURE FOR ORACLE®

• Move to JNC Unix folder

• run INSTALL.SH script:

./INSTALL.SH

• choose the OS ( i.e. LINUX); at the end of the installation procedure a new /usr/jnc directory is created containing all the necessary

JNC files;

• to complete the installation procedure the JNC ‘service’ must start as a daemon. To do this copy the “S20jnc.sh” scipt, in /etc/

rc2.d, /etc/rc3, /etc/rc4, /etc/rc5 directories (runlevels):




• Reboot and check JNC is working correctly (i.e. checking the Net Vision Client Table page)

4.5. INSTALLATION PROCEDURE FOR MAC OS X

Note: to perform the installation you must login as root user. In order to enable the root user, refer to Apple™ MAC OS X website documentation.

• Install JNC:

- move to JNC Unix folder

- run INSTALL.SH script:

./INSTALL.SH

- choose the OS (MAC_OSX); at the end of the installation procedure, a new /usr/jnc directory is created, containing all the necessary JNC files;

- To complete the installation procedure, the JNC ‘service’ must start as a daemon. To do this copy the “S20jnc.sh” script contained

in the CD-ROM\JNC\JNC\UNIX\SCRIPTS folder to your Mac and add it as a service. Please refer to MAC OS X Apple™ website

documentation to start a script file as a service at the startup.

It is possible to add the script as a service, or by preparing an Apple™ Script file.

Reboot and check JNC is working correctly

• check the Net Vision Client Table page

4.6. INSTALLATION PROCEDURE FOR AS 400®

To install the JNC for AS 400®, refer to AS400_notes.txt file in the install package.

NOTICE!

The JNC for AS400 is only available in English.

4.7. INSTALLATION PROCEDURE FOR OTHER OSs

You can find JNC general installation files for other operating systems not present on the compatibility list (and not tested with JNC)

on the JNC CD-ROM in the /jnc/jnc/others folder. There is also a readme.txt file in the same folder that contains a description of

the procedure to install JNC on your OS.

Note: JNC has been tested with many, but not all, operating systems that are compatible with the Java Runtime Environment. SOCOMEC does

not provide support for the installation of the program on OSs not listed in the compatibility list


EN

GL

ISH

5. CONFIGURATION OF THE JNC CLIENT

5.1. CONFIGURATION

This tool is used to set the parameters for connection between shutdown clients and the software communication program/s (e.g.

NET VISION, and DELPHYS GREEN POWER MIMIC PANEL).

For Windows®: Service configuration in SOCOMEC Shutdown service group

For UNIX™ – LINUX: run start.sh

NB OF UPS (N+1)

This parameter is used with N+1 UPS architecture.

This parameter is set to 1 by default for single or parallel UPS systems.

ADDRESS

Select the IP address for the UPS Ethernet Interface. In the case of N+1, it will be necessary to enter all UPS IP addresses.

REDUNDANCY

0 means not redundant. In the case of N+1 architecture, If one or both UPSs have detected a shutdown event, the JNC will perform

the server shutdown.

1 means redundant architecture: if both UPSs have detected a shutdown event the JNC will perform the server shutdown.

REMOTE SERVER UDP PORT

200 as default. If this port is not available on your network architecture it will be necessary to open this specific port.

SERVICE STATUS (ONLY FOR .NET)

Indicates if the shutdown service is running or not.

5.1-1


5. CONFIGURATION OF THE JNC CLIENTS

5.2-1 Java distribution 5.2-2 .Net distribution

5.2. PARAMETERS

This screen shows the parameters regarding the commands to execute for:

- Sending messages;

- Controlled shutdown of processes;

- Operating system shutdown command.

You can also set a delay time to shut down the PC. This delay means that shutdown priority can be implemented by, shutting down

some servers before others to ensure the correct, orderly closure of activity.

Note that the .NET™ distribution has one more configuration, e.g. Message also on Viewer checkbox. This enables warning

messages to be shown in the Service Message box in the Viewer application (useful for Windows® Vista and higher versions where

the Messenger Service is no longer available).

NOTE: ONLY FOR .Net DISTRIBUTION!

After saving the configuration the Shutdown Service restarts automatically. Furthermore, the user can start/stop

the service manually from the configuration window. The current service status is shown in the Service Status

label on the Information tab.

5.3. LANGUAGE

This screen lets you choose the language in which all program messages will be displayed. To change the language of the configu-

ration application, save the new language and then exit and re-enter the program.

The strings translated into various languages are saved in the files <lingua>_language.dat.

The languages supported are:

- uk_language.dat English

- it_language.dat Italian

- fr_language.dat French

- de_language.dat German

- sp_language.dat Spanish

- custom_ language.dat Language that can be customised by the user.

If a selection button is deactivated, check that the relevant language file is installed in the JNC program installation directory.

5.3-1


EN

GL

ISH

5.4. MANUAL CONFIGURATION via TERMINAL

By editing COMMON.CFG configuration file it possible to modify the behaviour of the shutdown client manually.

MODULESPRESENT

Enter the number of UPS in the case of N+1 architecture.

ModulesPresent = <num>

<num> is a number between 1 (single or parallel UPS with data concentrator) and 2–6 (N+1).

REMOTEHOST

List of UPS IP addresses or communication software packages (e.g. NET VISION).

NOTICE!

The number of hosts read by the program depends on the value set in the ModulesPresent parameter.

i.e.:

RemoteHost1 = 127.0.0.1 (example)

RemoteHost2 = 0.0.0.0





HOSTNAME

This field lets you enter the name of the PC that will be displayed in the client’ s connected table in the server communication

(e.g. NET VISION). The field can contain up to 31 characters.

i.e.: HostName = Name of the local PC.

LOCALDELAY

The local delay time before shutdown. Accepted values range from 0 to 600 seconds.

i.e..: LocalDelay = 30

REDUNDANT

Determines the behaviour of the shutdown client for parallel UPS configurations without data concentrator:

YES = Redundant. If only one of the parallel UPS has a fault, the client does not carry out the shutdown procedure (N+1 redundancy).

NO = Non redundant. To be set in cases of:

- A single UPS

- Parallel UPS with data concentrator

- Parallel UPS without data concentrator and with power configuration (N+0 redundancy)

i.e.: Redundant = NO

SHUTDOWNCOMMAND

The OS command to perform system shutdown. Type the path and the complete command name using the case sensitive form.

Only set the HALT Operating System specific command. Use the CustomerScript parameter to set other commands to perform

before the shutdown.

i.e.: ShutdownCommand = /sbin/halt




CUSTOMERSCRIPT

Customised script to be executed before shutdown. If the execution is not complete by the end of the shutdown countdown, the

batch process will be forced to close.

i.e.: CustomerScript = /usr/jnc/stop_batch.sh

MSGWARNING

Set the command used to send the warning messages to the local or remote OS users. Type the path and the complete command

name using the case sensitive form. Insert the special char % where the program will insert the warning string.

i.e.: MsgWarning = /usr/jnc/msg.sh %

WARNINGONVIEWER (ONLY FOR .NET DISTRIBUTION)

Specify if warning messages are to be shown on the Viewer application (in the Service Message area):

YES = Warning message visible also on Viewer

NO = Warning message NOT visible on Viewer

i.e.: WarningOnViewer = YES

AGENTUDPPORT

Set the communication software (i.e. Net Vision) remote UDP port

i.e.: AgentUdpPort = 200

BASEUDPPORT

Set the base local UDP port used to communicate with the communication software.

i.e.: BaseUdpPort = 1025

Note: the software will try to open one of the UDP ports, starting from the selected port.

LANGUAGE

Set the language used to show messages and user interface text strings.

The following values are available:

- uk English

- it Italian

- fr French

- de German

- sp Spanish

- custom Customisable by the user.

i.e.: Language = uk

BASEUDPIPADDRESS

Set the local PC IP address on which opening the BaseUdpPort opens.

i.e.: BaseUdpIPAddress = 192.168.0.1

Notes: this parameter is optional and it is useful to link the JNC to a specific network interface in case the PC has more than one.

If this parameter is not present, the default network card will be used.

If this parameter is used, the IP Address(es) management must be static (DHCP disabled).


EN

GL

ISH

6. SHUTDOWN PROCEDURE

6.1. DESCRIPTION OF THE SHUTDOWN PHASES

The shutdown procedure consists of 3 main phases:

• The reversible shutdown phase (1st one);

• The NON reversible shutdown phase (2nd one);

• The UPS close down (3rd phase).

1st phase starts after an event i.e. mains power failure detected by the UPS.

The UPS sends the information on the event to the server.

Depending on the time set in the 1st warning field for the mains failure event on the Shutdown Parameters Page (UPS Management

main menu), a warning message is sent using the command set in the Warning Command field (MsgWarning parameter on JNC/JSC).

Note: the Delay time, 1st Warning Time and Warning Interval time affect both the local computer and remote computers which are running the

shutdown client program.

6.1-1


6. SHUTDOWN PROCEDURE

6.2-1 SHUTDOWN.EXE parameters

The 1st phase lasts for the time set in the ‘Delay’ field for the mains power failure event on the Shutdown Parameters Page (UPS

Management main menu).

During this phase after the first warning message, other warning messages are sent depending on the time set ‘Warning Interval’

field for the mains power failure event on the Shutdown Parameters Page (UPS Management main menu).

If the alert condition stops i.e. mains power restored during the 1st phase, the whole system returns to the normal ‘waiting’ condition

and stops sending warning messages without performing any further actions.

If the alert condition is longer than the set Delay time, the server enters the 2nd NON reversible phase.

This means that the computer shutdown procedure (for both local and remote units) will become NON reversible so as to ensure

correct completion.

During the 2nd phase warning messages are still sent until the computer is shutdown.

The duration of the 2nd phase is set in the UPS Shutdown Delay field on the Shutdown Parameters page (UPS Management main menu).

As the UPS should close down at the end of the 3rd phase (to avoid damaging the batteries due to complete discharging) and stop

powering the load, it is necessary to set a shorter delay time for computer shutdown (2nd phase).

The shutdown delay for the computer running on the server can be set in the Local Shutdown Delay field.

The shutdown delay for other computers must be set in their shutdown client program configuration.

The 3rd phase consists of UPS close down which simply consists of interrupting power supply to the load and setting the UPS to

standby (waiting for mains power to be restored if this was the cause of the shutdown or the scheduled time).

Note: the UPS will be switched off by the program only in the event of a mains power failure or scheduled shutdown.

IMPORTANT!

With other alert conditions the program lets the UPS manage shutdown and the possibility for setting the shutdown

time for this type of event is only for shutting down the computers (the program has no effect on the UPS shutdown

procedure).

6.2. SHUTDOWN COMMANDS FOR Windows®

By default JNC is already configured to be able to send

shutdown commands for:

- Windows® Server 2003



- Windows® Xp

- Windows® Vista

- Windows® 7

- Windows® 8

using the SHUTDOWN.exe application supplied with JNC.

If you need more information about the SHUTDOWN command,

please type SHUTDOWN /? at the command shell prompt and

a popup window will appear (see figure).

It may be necessary to specify the full SHUTDOWN command path for the server shutdown procedure. By default JNC may not

already be configured with the full path because you may decide to use a different default folder to install JNC. In this case you will

have to substitute the default command:

SHUTDOWN /C /L /T:5

with

<JNC program folder>\SHUTDOWN /C /L /T:5

for example:

C:\Program Files\SOCOMEC\Socomec JNC Systems Shutdown\


EN

GL

ISH

7.1

7. CLIENT MONITOR

This monitor indicates the status of the UPS and the JNC

service, and displays the different notifications sent by JNC.

When the JNC Viewer is running an icon appears in the systray bar:

green (connected to the UPS)

yellow (shutdown procedure in progress or no communi-

cation with UPS)

7.1. UPS STATUS

Status Remark

Connection requested JNC tries to connect to UPS

Normal No shutdown events detected

AC Failed / UPS on Battery power

The shutdown event has been sent to the JNC.

Overload

Over temperature

Imminent Stop(1)

Battery low

On Bypass

EMD Temperature(2)

EMD Humidity(2)

EMD IN1 Abnormal(2)

EMD IN2 Abnormal(2)

Level of battery capacity(2)

(1) The shutdown delay for Imminent Stop set on the UPS should be less than 2 minutes. A delay set to 0 is recommended.

(2) Only with NET VISION 6.

7.2. UPS ICON COLOUR CONDITION

Color Condition

Red JNC tries to connect to UPS

GreenNo shutdown events detected

Normal situation

YellowShutdown event has been detected. Notification sent. Reversible period: if the event is removed the status switches

to NORMAL. The shutdown process is cancelled.

MagentaThe event delay has been reached. The JNC countdown begins. Irreversible period: if the event is removed, the

shutdown process continues.

7.3. NOTIFICATION

The Service Message area shows the reason for the event when it appears, with date and time.

NOTE: If the viewer is not running the notification cannot be seen.

www.socomec.com

HEAD OFFICE

SOCOMEC GROUPS.A. SOCOMEC capital 10 816 800€ R.C.S. Strasbourg B 548 500 149 B.P. 60010 - 1, rue de Westhouse F-67235 Benfeld Cedex - FRANCE Tel. +33 3 88 57 41 41 Fax +33 3 88 74 08 00 [email protected]

Socomec worldwide

BELGIUM

SolarTel. +32 2 340 02 30 Fax +32 2 346 28 99 [email protected]

FRANCE

SolarTel. +33 1 45 14 63 00 Fax +33 1 48 67 31 12 [email protected]

GERMANYPower Control & Energy EfficiencyTel. +49 7243 65292 0 Fax +49 7243 65292 13 [email protected]

UPSTel. +49 621 71 68 40 Fax +49 621 71 68 444 [email protected]

ITALYPower Control & Energy EfficiencyTel.+39 02 98 49 821 Fax +39 02 98 24 33 10 [email protected]

SolarTel. +39 0444 598611 Fax +39 0444 598627 [email protected]

UPS Tel.+39 02 98 242 942 Fax +39 02 98 240 723 [email protected]

NETHERLANDS

SolarTel. +31 30 760 0900 Fax +31 30 637 2166 [email protected]

POLANDPower Control & Energy EfficiencyTel. +48 91 442 64 11 Fax +48 91 442 64 19 [email protected]

UPSTel. +48 22 825 73 60 Fax. +48 22 825 73 60 [email protected]

PORTUGALUPS / SolarTel.+351 261 812 599 Fax +351 261 812 570 [email protected]

ROMANIA


RUSSIA


SLOVENIA

SolarTel. +386 1 5807 860 Fax +386 1 561 11 73 [email protected]

SPAIN


UNITED KINGDOMPower Control & Energy EfficiencyTel. +44 1462 440 033 Fax +44 1462 431 143 [email protected]

UPSTel.+44 1285 863 300 Fax+44 1285 862 304 [email protected]

TURKEY

SolarTel. +90 216 540 71 20-21-22 Fax +90 216 540 71 27 [email protected]

YOUR DISTRIBUTOR

IN ASIA PACIFIC

AUSTRALIAUPSTel. +61 2 9325 3900 Fax +61 2 9888 9544 [email protected]

CHINAUPS / Power Control & Energy EfficiencyTel. +86 21 52 98 95 55 Fax +86 21 62 28 34 68 [email protected]

INDIAPower Control & Energy EfficiencyTel. +91 124 4027210 Fax +91 124 4562738 [email protected]

Tel. +91 44 39215400 Fax +91 44 39215450 & 51 [email protected] [email protected]

SINGAPORE UPS / Power Control & Energy EfficiencyTel.+65 6506 7600 Fax +65 64 58 7377 [email protected]

THAILANDUPSTel. +66 2 941 1644 7 Fax +66 2 941 1650 [email protected]

VIETNAMUPSTel. +84 8 3559 1220 Fax +84 8 3559 1221 [email protected]

IN MIDDLE EAST

UNITED ARAB EMIRATES

SolarTel.+971 4 29 98 441 Fax +971 4 29 98 449 [email protected]

IN AMERICA

USA, CANADA & MEXICOPower Control & Energy EfficiencyTel. +1 617 245 0447 Fax +1 617 245 0437 [email protected]

OTHER COUNTRIES

NORTH AFRICAAlgeria / Morocco / [email protected]

AFRICAOther [email protected]

SOUTH EUROPECyprus / Greece / Israel / [email protected]

SOUTH AMERICATel. +34 93 540 75 75 [email protected]

MORE DETAILSwww.socomec.com/worldwide

IN EUROPE

*OPMJNCXXXX00-GB 08*OPMJNCXXXX00-GB 08 01.2014

JNC Shutdown Client - Socomec

Documents