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
4 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
5JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
6 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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.
7JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
8 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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.
9JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
cp S20jnc.sh /etc/rc3.d
cp S20jnc.sh /etc/rc4.d
cp S20jnc.sh /etc/rc5.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.
10 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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):
cp S20jnc.sh /etc/rc1.d
cp S20jnc.sh /etc/rc2.d
cp S20jnc.sh /etc/rc3.d
• 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
11JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
12 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
13JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
RemoteHost3 = 0.0.0.0
RemoteHost4 = 0.0.0.0
RemoteHost5 = 0.0.0.0
RemoteHost6 = 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
5. CONFIGURATION OF THE JNC CLIENTS
14 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
5. CONFIGURATION OF THE JNC CLIENTS
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).
15JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
16 JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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® Server 2008
- Windows® Server 2012
- 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\
17JNC Shutdown Client - Ref.: OPMJNCXXXX00-GB 08
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
SolarTel. +40 21 319 36 88 Fax +40 21 319 36 89 [email protected]
RUSSIA
SolarTel. +7 495 775 19 85 Fax +7 495 775 19 85 [email protected]
SLOVENIA
SolarTel. +386 1 5807 860 Fax +386 1 561 11 73 [email protected]
SPAIN
SolarTel. +34 93 540 75 75 Fax +34 93 540 75 76 [email protected]
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