Sun Microsystems Security and Trust Services APIs 1.0, 1.0 Reference Implementation Installation Manual

Security and Trust Services APIs for

Java 2 Platform, Micro Edition

Version 1.0

Reference Implementation Installation Guide

Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, California 95054
U.S.A. 650-960-1300

July 2004

Copyright ©2004 Sun Microsystems, Inc., 4150Network Circle,Santa Clara,California 95054, U.S.A.All rightsreserved.

Sun Microsystems,Inc. hasintellectual property rights relating totechnology embodiedin the product thatis describedin this
document. Inparticular,and without limitation,these intellectualproperty rights may include oneor moreof the U.S.patents listed
at http://www.sun.com/patents andone or more additionalpatents or pending patent applicationsin the U.S. and inother
countries.

This documentand the product to whichit pertainsare distributedunder licenses restricting theiruse, copying, distribution,and
decompilation. Nopart of the product orof thisdocument may bereproduced inany formby any means without priorwritten
authorization ofSun and its licensors, ifany.

Third-party software, includingfont technology,is copyrighted andlicensed fromSun suppliers.

Sun; SunMicrosystems; theSun logo; Solaris;Java; J2ME;J2SE; JCP; Java2 Platform,Micro Edition;Java 2 Platform,Standard
Edition; JavaDeveloper Connection; Java Card; JavaSpecification Request;Java VirtualMachine; Securityand Trust ServicesAPIs
for theJava 2 Platform, Micro Edition;and JavaCommunity Processare trademarks orregistered trademarks of SunMicrosystems,
Inc. inthe U.S. and other countries.

The Adobe®logo is a registered trademark of AdobeSystems, Incorporated.

Federal Acquisitions:Commercial Software- Government Users Subject toStandard LicenseTermsand Conditions.

DOCUMENTATION ISPROVIDED “ASIS” AND ALLEXPRESS ORIMPLIED CONDITIONS, REPRESENTATIONS AND
WARRANTIES,INCLUDING ANYIMPLIED WARRANTYOF MERCHANTABILITY, FITNESSFOR APARTICULAR PURPOSE
OR NON-INFRINGEMENT,ARE DISCLAIMED,EXCEPT TO THE EXTENT THATSUCH DISCLAIMERS ARE HELD TOBE
LEGALLY INVALID.

Copyright ©2004 Sun Microsystems, Inc., 4150Network Circle,Santa Clara,California 95054, Etats-Unis.Tousdroits réservés.

Sun Microsystems,Inc. ales droits de propriété intellectuelsrelatants àla technologieincorporée dans leproduit quiest décrit dans
ce document.En particulier, etsans lalimitation, ces droits depropriété intellectuelspeuvent inclure un ou plusdes brevets
américains énumérésà http://www.sun.com/patents et unou lesbrevets plus supplémentaires ou lesapplications debrevet
en attentedans les Etats - Uniset dans les autres pays.

Ce produitou documentest protégé par un copyrightet distribuéavec des licencesqui enrestreignent l’utilisation,la copie, la
distribution, etla décompilation. Aucune partie dece produitou document nepeut êtrereproduite sousaucune forme,par quelque
moyen quece soit, sans l’autorisation préalableet écrite de Sun etde ses bailleurs de licence,s’il y ena.

Le logicieldétenu par des tiers, etqui comprendla technologie relative auxpolices de caractères, est protégé parun copyrightet
licencié pardes fournisseurs de Sun.

Sun; SunMicrosystems; theSun logo; Solaris;Java; J2ME;J2SE; JCP; Java2 Platform,Micro Edition;Java 2 Platform,Standard
Edition; JavaDeveloper Connection; Java Card; JavaSpecification Request;Java VirtualMachine; Securityand Trust ServicesAPIs
for theJava 2 Platform, Micro Edition;et JavaCommunity Processsont des marques defabrique ou desmarques déposéesde Sun
Microsystems, Inc.aux Etats-Uniset dans d’autres pays.

Le logoAdobe® est une marque déposéede AdobeSystems, Incorporated.

LA DOCUMENTATIONEST FOURNIE “EN L’ÉTAT” ETTOUTES AUTRES CONDITIONS, DECLARATIONS ETGARANTIES
EXPRESSES OUTACITES SONT FORMELLEMENT EXCLUES, DANSLA MESURE AUTORISEE PAR LALOI APPLICABLE, Y
COMPRIS NOTAMMENTTOUTE GARANTIE IMPLICITE RELATIVE ALA QUALITE MARCHANDE, A L’APTITUDEA UNE
UTILISATION PARTICULIEREOU A L’ABSENCE DE CONTREFAÇON.

Please

Recycle

Contents

Preface v

1. Installing the SATSA Reference Implementation 1

Locating and Downloading Supporting Software 2

Setting System Variables 2

Installing the SATSA Packages 3

Contents of the Reference Implementation 3

Running the SATSA 1.0 Reference Implementation 4

Starting the MIDP 2.0 Emulator 4

Starting the Java Card Emulator 4

SATSA 1.0 Configuration Files 6

The internal.config File 6
The system.config File 7

Glossary 9

Index 11

iii

iv SATSA Installation Guide • July 2004

Preface

This document describes how to install the Security and Trust Services APIs for the

™

Java 2

Who Should Read This Guide

This Installation Guide should be read by J2ME developers working with the
Security and Trust Services APIs 1.0 Reference Implementation.

Before You Read This Guide

In order to fully use the information in this document, you must have thorough
knowledge of the topics discussed in these guides:

■ Java Card Platform, Version 2.2.1 Development Kit, User’s Guide

■ MIDP Reference Implementation, Version 2.0, Using MIDP

■ MIDP Reference Implementation, Version 2.0, Creating MIDlet Suites

Platform, Micro Edition 1.0 Reference Implementation.

v

How This Guide Is Organized

Chapter 1 describes the supporting software needed to install the SATSA 1.0

Reference Implementation, how to test if the SATSA 1.0 installation is successful,
and information about SATSA 1.0 configuration.

Typographic Conventions

Typeface Meaning Examples

AaBbCc123 The names of commands, files,

and directories; on-screen
computer output

AaBbCc123

AaBbCc123 Book titles, new words or terms,

What you type, when
contrasted with on-screen
computer output

words to be emphasized

Edit your .login file.
Use ls -a to list all files.

% You have mail.
% su

Password:

Read Chapter 6 in the User’s Guide.
These are called class options.
Yo u must be superuser to do this.

Command-line variable; replace
with a real name or value

vi SATSA Installation Guide • July 2004

To delete a file, type rm filename.