Monday Jan 07, 2008

Sun Product Users: Can we talk?

If you have a comment or a question, docs.sun.com (DSC) gives you a direct link to the writers of Sun documentation.

To comment on a particular document, while looking at the document online (on DSC), click Send Comments (see "1" in the graphic below). This is the preferred method in most cases. However, for general comments, you can use the Submit panel at the bottom of the  DSC page (see "2" in the graphic below). In all cases, please be as specific and detailed in your comments as possible.

The information provided by DSC visitors is often quite useful to the writer and is very much appreciated. If you find that the documentation is incorrect or just confusing, please let us know. Currently, the process is not fully automated, so the author might not see the comment for a while.
   

Image of docs.sun.com page with  areas marked from which to make comments 

Thursday Jan 03, 2008

Issues with Agent for Sun Java System Application Server 8.2/9.0/9.1

What's spurring this blog entry is a couple of issues that have come up with Policy Agent 2.2 for Sun Java System Application Server 8.2/9.0/9.1 as such:

  1. The title of this agent was just changed to include the 8.2 part. There were mixed messages out there about which agent to use for Sun Java System Application Server 8.2. Now it's cleared up. If you want to install Policy Agent 2.2 on Sun Java System Application Server 8.2, use Policy Agent 2.2 for Sun Java System Application Server 8.2/9.0/9.1.
  2. Do not install the Application Server 8.2/9.0/9.1 agent and Access Manager on the same Application Server 8.2/9.0/9.1 instance.

The second point comes up from time to time in different ways. For example, it came up in this forum posting:

http://forum.java.sun.com/thread.jspa?forumID=760&threadID=5201914

Anyway, the documentation for this agent states that you cannot install this agent and Access Manager on the same Application Server 8.2/9.0/9.1 instance, as such:

http://docs.sun.com/app/docs/doc/820-2539/gbbir?a=view 

However, this point is often missed. For example, I'm assuming that this issue was missed when someone sent a query to the docs.sun.com website. The question was about the following property:

com.sun.identity.agents.config.location

The property allows a J2EE agent to coexist with Access Manager on the same application server. This option does not apply to Policy Agent 2.2 for Sun Java System Application Server 8.2/9.0/9.1. Therefore, the property is not mentioned in Sun Java System Access Manager Policy Agent 2.2 Guide for Sun Java System Application Server 8.2/9.0/9.1.

I bring this up here because this second point gets missed pretty often. I figure that somehow the documentation isn't clear enough. So, I want to add this info here to try to make it more clear.

By the way, I should say something about how you can send comments to us technical writers when you are looking at documents on docs.sun.com. The question that I talk about above about the com.sun.identity.agents.config.location property was sent directly to docs.sun.com and eventually forwarded to me. Okay, it's decided then. In my next entry, I'll talk about how you can get comments to the writer of a document that you are reading on docs.sun.com.

About

What does this box do?

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today