imqkeytool(1m)

1imqkeytool(1M)          System Administration Commands          imqkeytool(1M)
2
3
4

NAME

6       imqkeytool  -  generate a self-signed certificate for secure communica‐
7       tion
8

SYNOPSIS

10       /usr/bin/imqkeytool [-broker] [-servlet keystore_location]
11
12
13       /usr/bin/imqkeytool -h
14
15

DESCRIPTION

17       The imqkeytool utility generates a self-signed certificate  for  secure
18       communication.  The  certificate  can  be  used by a broker instance to
19       establish a secure connection with a client, or by a Message Queue-sup‐
20       plied  HTTPS  servlet  to  establish  a secure connection with a broker
21       instance. An HTTPS servlet is an SSL-enabled varient of  the  HyperText
22       Transfer  Protocol  that  establishes a secure connection with a broker
23       instance.
24
25
26       Without an option, imqkeytool generates a self-signed certificate for a
27       broker instance.
28
29
30       imqkeytool uses command line options to specify whether the certificate
31       is used by a broker instance or by a servlet.
32

OPTIONS

34       The following options are supported:
35
36       -broker                       Generate a  self-signed  certificate  for
37                                     the  broker  and places it in the Message
38                                     Queue keystore. All broker instances run‐
39                                     ning  on  a system must use the same cer‐
40                                     tificate.
41
42
43       -h                            Display usage help. Do not  execute  any‐
44                                     thing else on the command line.
45
46
47       -servlet keystore_location    Generate a self-signed certificate for an
48                                     HTTPS  servlet  and  places  it  in  key‐
49                                     store_location.
50
51                                     keystore_location  refers to the location
52                                     of the keystore.  You  should  move  this
53                                     keystore to a location where it is acces‐
54                                     sible and readable by the  Message  Queue
55                                     HTTPS  servlet to establish a secure con‐
56                                     nection with a broker.
57
58

ENVIRONMENT VARIABLES

60       The following environment variables affect the execution of  this  com‐
61       mand:
62
63       IMQ_JAVAHOME    Specify  the Java 2 compatible runtime. When this envi‐
64                       ronment variable is not set it defaults to /usr/j2se.
65
66

EXIT STATUS

68       The following exit values are returned:
69
70       0     Successful completion.
71
72
73       >0    An error occurred.
74
75

FILES

77       /etc/imq/keystore     Contains Message Queue keystore in which  imqkey‐
78                             tool  stores  a  self-signed certificate for bro‐
79                             kers.
80
81

ATTRIBUTES

83       See attributes(5) for descriptions of the following attributes:
84
85
86
87
88       ┌─────────────────────────────┬─────────────────────────────┐
89       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
90       ├─────────────────────────────┼─────────────────────────────┤
91       │Availability                 │SUNWiqu                      │
92       └─────────────────────────────┴─────────────────────────────┘
93