Installing Java LiveUpdate (JLU) Manually
after Symantec Mail Security for Domino (SMSDOM) has been installed
Larry Wall
Sr. Principle Software Support Engineer
Installing Java LiveUpdate (JLU) Manually after SMSDOM
1
We Will Cover The Following Topics
1
Introduction
2
Downloading/Installing Java
3
Downloading/Installing Java Crypto Extensions (JCE)
4
Install Java LiveUpdate (JLU)
5
Replace the liveupdate.conf file
6
Replace the Product.Catalog.JavaLiveUpdate file
7
Problems you may encounter
Installing Java LiveUpdate (JLU) Manually after SMSDOM
2
Introduction
• You may be installing JLU after SMSDOM because
– When SMSDOM was originally installed Java/JCE was not installed
– Definitions were originally coming from another Symantec product like
SEP but this is no longer the case
– During the installation you forgot to check to install LiveUpdate
• The basics to installing Java LiveUpdate are
– Install Java
– Install Java Cryptography Extensions (JCE)
– Install Java LiveUpdate (JLU)
Installing Java LiveUpdate (JLU) Manually after SMSDOM
3
While this presentations is specifically for installing JLU after
SMSDOM the same steps with some minor modifications can be done
to work with other products.
Your paths could be different depending on OS version and bit
version. It is more confusing when on a 64bit machine because 64bit
and 32bit applications can both run. Minimally you need the same bit
version of Java to match the bit version of SMSDOM. But you can
simplify this by just installing both 32bit and 64bit versions of Java.
Also, the Product.Catalog.JavaLiveUpdate file may need to be
changed. It needs to contain the correct moniker and product name in
order to download the proper definitions.
Lastly, the steps listed are specifically for Windows. JLU works
across different types of operating systems because it is a Java program.
But the basics are still the same, install java, java cryptography
extensions (if required), install Java LiveUpdate, and then make sure the
configuration files are okay. As of this writing JCE is not needed on AIX
for example because the program will not try to encrypt/decrypt the
liveupdate.conf file.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
4
Download Java JRE and JCE
The newer versions of JLU require Java 5 (also called 1.5) or higher. You
can download this from java.com but because you may also need to download JCE
a better location http://www.oracle.com/technetwork/java/javase/downloads/index.html.
You want to download the JRE (need runtime environment minimally) and then
down near the bottom you will see the Java Cryptography Extension (JCE)
Unlimited Strength Jurisdiction Policy Files. If you download Java JRE 6 you need to
also download the JCE 6.
• Note
Also if you download JRE 6 there is a 32bit version and a 64bit version but
there is only one JCE download that works for both.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
5
Installing Java JRE
When installing Java JRE just accept the default settings.
Depending on bit version and the OS version will depend on
where the files have installed to. Could be C:\Program Files\Java
or C:\Program File (x86)\Java.
– You can install both 32bit and 64bit versions of Java if you like on a 64bit
OS. This is a good idea to do if you are testing both bit versions on one
machine or you just have a combination of 32bit and 64bit applications
that require Java.
– After installing you should be able to go to DOS prompt and run java
commands. If you type “java –version” it should return version
information for the first found version of java.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
6
Installing Java JCE
Installing Java JCE is easy. You just open the zip file, go
into jce folder, and copy the two jar files (US_export_policy.jar &
local_policy.jar) to the proper location. The files can be used for
both 32bit and 64bit Java but the versions must match. So JCE 6
jar files must be used for Java 6 (32bit or 64bit).
– If Java is installed to C:\Program Files\Java go to C:\Program
Files\Java\jre\lib\security and put both jar files there.
– If Java is installed to C:\Program Files (x86)\Java go to C:\Program Files
(x86)\Java\jre\lib\security and put both jar files there.
– Also, if Java is installed to both of those locations you should just go
ahead and apply the two JCE jar files to both locations to keep from
having one that works and one that doesn’t which could be confusing.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
7
Installing Java LiveUpdate
• If you installed SMSDOM from a self uncompressing, self
executing file then this would have to be uncompressed first so
that you have access to the data1.cab file. For example,
Symantec_Mail_Security_Domino_8.0.9.151_Win64_IN.exe. If
your installation package is already uncompressed go to the
next slide.
1.
2.
3.
4.
5.
6.
Create a folder called uncompressed on your desktop
Doubled click to execute the program
Press OK to when window pops up saying “This program installs Mail
Security x.x for Domino.”
In the next window Browse to and select your uncompressed folder and
then uncheck “When done unzipping open: Setup.exe.” This way it
uncompresses to your folder but does not try to install SMDOM.
Next Close the installer.
Goto your uncompressed folder.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
8
Note: If you uncompressed the 64bit version of SMSDOM go to uncompressed folder and
then double click the Data1.cab file to open it so that you can access the files inside. If you had
uncompressed the 32bit version of SMSDOM you will see two folders called SMSDOM and
SMSDOM-x64 and this may be confusing. The SMSDOM-x64 is still 32bit compilation but was
specifically compiled as a 32bit application to run on a 64bit OS. You can choose either folder
to go into because the jlu.jar file we are looking for is the same in both folders. Once in that
folder open the Data1.cab file by double clicking it.
7.
Copy the jlu.jar.54E561A0_BE49_4E56_B71C_FC93C7BAF85D to your
desktop. The numbers and letters after as part of the file name after
jlu.jar may be different.
8.
Rename the file to just jlu.jar
9.
Now copy jlu.jar to the root of your C:\ drive.
10. Bring up a Command Window to enter DOS commands and go to the
root by typing “cd \” and pressing enter.
11. Type “java -classpath jlu.jar Installer” and press enter. JLU should
install.
12. Can now delete the jlu.jar file by typing “del jlu.jar” and press enter.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
9
Replace liveupdate.conf file
Some important notes about the liveupdate.conf file and JLU.
• More than likely if you have been running without JLU then there is a possibility that your
liveupdate.conf file is incomplete, empty, or just plane 0 bytes in size.
• Newer versions of SMSDOM will try to encrypt the liveupdate.conf file after installing and
so if JCE is not installed prior the liveupdate file could be 0 bytes in size right from the
start.
• JLU can read in a readable text based or the encrypted version of liveupdate.conf file. So if
you want to test a proxy setting keep a text version of this file, add the settings, then copy
this over the one used by JLU.
• Most of the generic settings like host/0, host/1,host/2, workdir, and logging are built into
JLU. If they do not exist in the liveupdate.conf file then the defaults are used. For this
reason a 0 byte liveupdate.conf file will not prevent JLU from trying to run with the
defaults.
• If JCE is not present the liveupdate.conf file will become 0 bytes in size after JLU runs. This
is because after JLU has determined its settings and has run it will then pass the settings to
JCE for encryption. If JCE is not present Java will return 0 bytes of encrypted data. And
then we overwrite the file with 0 bytes.
Example problem – customer puts proxy settings in so that LiveUpdate works. They report it works
one time and then no longer works. What happened was that they added their own
liveupdate.conf file with the proxy settings and because JCE did not exist here is what happened.
First JLU reads the settings, including the proxy settings in and works. But after running JLU sends
the settings to Java to be encrypted. JCE does not exist and so liveupdate conf file becomes 0
bytes.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
10
Default liveupdate.conf file
############################################################
#
#
# livepdate.conf - Symantec LiveUpdate configuration file
#
#
#
# This file is used to configure the settings used by
#
# LiveUpdate
#
#
#
############################################################
hosts/0/url=http://liveupdate.symantecliveupdate.com:80
hosts/1/url=http://liveupdate.symantec.com:80
hosts/2/login:ENC=b3effdd10d982d2c7339c9604c67c34c
hosts/2/password:ENC=18d2e2d4c1445548f8a5ef124ed20bfd
hosts/2/url=ftp://update.symantec.com/opt/content/onramp
logfile=C:\Documents and Settings\All Users\Application Data\Symantec\Java LiveUpdate\liveupdt.log
workdir=C:\Documents and Settings\All Users\Application Data\Symantec\Java LiveUpdate\Downloads
serverlogging=true
cacheMode=false
Installing Java LiveUpdate (JLU) Manually after SMSDOM
11
You can go ahead and copy the liveupdate.conf file from the
last slide and use this as your default liveupdate.conf file which can be
modified for your own use in the future. You do need to make sure the
paths are correct for the workdir and logging parameters. If you change
the paths as needed this file can also work on other platforms.
The settings in the liveupdate.conf file are also case sensitive.
So the cacheMode line must have that M capitalized or else it will not
work. If cacheMode equals false JLU will remove cache files when it is
done which will help prevent running out of disk space.
If you use a text based liveupdate.conf file and then run JLU the
file will become encrypted if JCE is installed. To make changes then you
can either overwrite this with another text based copy or you can use
the ConfigEditor parameter to bring up a GUI for making changes. To
run this editor find where jlu.jar installed itself to. Could be one of the
following paths:
C:\Program Files\Common Files\Symantec Shared\Java LiveUpdate
C:\Program Files (x86)\Common Files\Symantec Shared\Java LiveUpdate
Go to this folder with command window DOS prompt and then run the
following command:
java -classpath jlu.jar ConfigEditor
Installing Java LiveUpdate (JLU) Manually after SMSDOM
12
Replace Product.Catalog.JavaLiveUpdate file
Some important notes about the Product.Catalog.JavaLiveUpdate file and JLU.
• This file is located in the %AllUsersProfile%\Program Data\
• There is a possibility that this file is 0 bytes in size. This can happen if
someone tried to run LiveUpdate and it was not installed.
• JLU will look at this file first to see if liveupdate is needed to run. So if
you run LiveUpdate now and new defs come in and then turn around
and run LiveUpdate again, JLU will be able to quickly determine this is
not needed. We have seen weird scenarios where JLU failed to
download new definitions but still updated this file. And so when you
then try to test LiveUpdate again it just says you have the latest defs.
Because of this it is a good idea to keep a copy of this file handy.
• If you keep a copy of the file just remember that the moniker and
product listed in the file is different for 32 and 64bit versions. These
are also different for other products as well. If you use the 32bit
version it will cause an initialization failure because the 64bit files will
not be there like expected.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
13
Default Product.Catalog.JavaLiveUpdate file
for 32bit SMSDOM on Windows
[{6B9B12D6-93E0-460e-BF4E-0A7251925D80}]
MONIKER={6B9B12D6-93E0-460e-BF4E-0A7251925D80}
PRODUCTNAME=SMSDOM Windows Virus Definitions
PRODUCT=SMSDOM Windows Virus Definitions
VERSION=8.0
LANGUAGE=English
SEQ.VirusDef=0
[{C498C4FD-B2DE-4415-BE68-5CA2BD9D113F}]
MONIKER={C498C4FD-B2DE-4415-BE68-5CA2BD9D113F}
PRODUCTNAME=SMSDOM VSP
PRODUCT=SMSDOM VSP
VERSION=2.0
LANGUAGE=SymAllLanguages
SEQ.VSP=0
Installing Java LiveUpdate (JLU) Manually after SMSDOM
14
Default Product.Catalog.JavaLiveUpdate file
for 64bit SMSDOM on Windows
[{17199101-194A-4883-85F9-B6FA33381C03}]
MONIKER={17199101-194A-4883-85F9-B6FA33381C03}
PRODUCTNAME=SMSDOM Windows64 Virus Definitions
PRODUCT=SMSDOM Windows64 Virus Definitions
VERSION=8.0
LANGUAGE=English
SEQ.VirusDef=0
[{C498C4FD-B2DE-4415-BE68-5CA2BD9D113F}]
MONIKER={C498C4FD-B2DE-4415-BE68-5CA2BD9D113F}
PRODUCTNAME=SMSDOM VSP
PRODUCT=SMSDOM VSP
VERSION=2.0
LANGUAGE=SymAllLanguages
SEQ.VSP=0
Installing Java LiveUpdate (JLU) Manually after SMSDOM
15
Default Product.Catalog.JavaLiveUpdate file
for 32bit SMSDOM on AIX
[{5C5CD07E-2B50-4a23-A410-F3A935AB5920}]
MONIKER={5C5CD07E-2B50-4a23-A410-F3A935AB5920}
PRODUCTNAME=SMSDOM AIX Virus Definitions
PRODUCT=SMSDOM AIX Virus Definitions
VERSION=8.0
LANGUAGE=English
SEQ.VirusDef=0
[{A7F40636-A387-49da-8C21-8CDAC9FB79B9}]
MONIKER={A7F40636-A387-49da-8C21-8CDAC9FB79B9}
PRODUCTNAME=SMSDOM VSP
PRODUCT=SMSDOM VSP
VERSION=2.0
LANGUAGE=SymAllLanguages
SEQ.VSP=0
Installing Java LiveUpdate (JLU) Manually after SMSDOM
16
Default Product.Catalog.JavaLiveUpdate file
for 64bit SMSDOM on AIX
[{5C5CD07E-2B50-4a23-A410-F3A935AB5920}]
MONIKER={5C5CD07E-2B50-4a23-A410-F3A935AB5920}
PRODUCTNAME=SMSDOM AIX64 Virus Definitions
PRODUCT=SMSDOM AIX64 Virus Definitions
VERSION=8.0
LANGUAGE=English
SEQ.VirusDef=0
[{A7F40636-A387-49da-8C21-8CDAC9FB79B9}]
MONIKER={A7F40636-A387-49da-8C21-8CDAC9FB79B9}
PRODUCTNAME=SMSDOM VSP
PRODUCT=SMSDOM VSP
VERSION=2.0
LANGUAGE=SymAllLanguages
SEQ.VSP=0
Installing Java LiveUpdate (JLU) Manually after SMSDOM
17
Problems you may encounter
• Product.Catalog.JavaLiveUpdate is 0 bytes in size. This can happen if
someone tries to run LiveUpdate and LiveUpdate was not installed.
Replace file with correct default to correct issue.
• When running LiveUpdate it returns quickly with status saying you
already have the latest definitions. Product.Catalog.JavaLiveUpdate
may have been updated even though JLU failed. Replace file with
correct default and look at the last logs in the livupdt.log to figure out
and fix issue with JLU then try running LiveUdpate again.
• liveupdate.conf file is 0 bytes in size. JCE is not installed. Install JCE,
replace liveupdate.conf file with default plus any additional changes,
and then try LiveUpdate again.
• After new definitions have downloaded SMSDOM fails saying
SMSDOM ERROR: Unable to initialize SMSDOM engine. on the
Domino console. Either bad set of definitions or you have incorrect
Product.Catalog.JavaLiveUpate file that caused JLU to get wrong
definitions. When this causes nntask to fail it can also cause mail to
backup as dead with our dead failure reason.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
18
Conclusion
There are a lot of variables that can make
installing and troubleshooting Java LiveUpdate seem like
a difficult task. But really when it comes to just
installing after a install of SMSDOM, you just need to
install java, jce, jlu, and replace the two configuration
files. If you have each of these already in front of you
and on the machine intended for this process can be
done in just a few minutes.
Essentially the same requirements are needed for
AIX without the need for JCE. But you do need good
running Java, JLU and configuration files.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
19
Thank you!
Larry Wall
Copyright © 2011 Symantec Corporation. All rights reserved. Symantec and the Symantec Logo are trademarks or registered trademarks of Symantec Corporation or its affiliates in
the U.S. and other countries. Other names may be trademarks of their respective owners.
This document is provided for informational purposes only and is not intended as advertising. All warranties relating to the information in this document, either express or implied,
are disclaimed to the maximum extent allowed by law. The information in this document is subject to change without notice.
Installing Java LiveUpdate (JLU) Manually after SMSDOM
20