Documenting a Java System

My company is fairly new in Java development. We are
engaged in a project right now using this technology and
are trying to come up with a strategy for documenting our system. I am sure there are many of you out there who are light years ahead of us in java development.
Can you share what documentation strategy you have used for your systems? Is there a tool out there in Java land that can make documentation painless?
Your feedback would be much appreciated.

There is javadoc, which produces documentation that looks like the API documentation that comes with Sun's SDKs. Look in the folder docs/tooldocs/javadoc for more information. That produces documentation for programmers who are going to use the classes... but perhaps you were thinking about documenting it for users? <slight exaggeration>As far as I can see, nobody does that any more.</slight exaggeration>

Similar Messages

  • Adding a JDBC driver in Sun Java System Web Server 7

    I'm trying to configure JDBC database connection pooling for a Microsoft SQL Server 2005 Express Edition though the Sun Java System Web Server 7 administration console. I don't want to use the MSSQL JDBC driver that comes bundled with the SJSWS 7. So I've downloaded the lastest MSSQL JDBC driver from the Microsoft website and put in the "lib" subdirectory of the SJSWS installation directory. So when I go to add a new JDBC resource through the administration console, the newly added MSSQL database driver doesn't appear in the "Driver Vendor" drop-down box.
    How do I add the downloaded JDBC driver to the server so that it appears in the "Driver Vendor" drop-down under "Create JDBC resource".

    Check this documentation from MS on using the JDBC driver with DataSource
    http://msdn2.microsoft.com/en-us/library/ms379052.aspx
    SJS Web Server 7.0 should work with any driver that has support for javax.sql.DataSource. The great majority of drivers do.
    So instead of using the driver name, use the DataSource class name:
    com.microsoft.sqlserver.jdbc.SQLServerDataSource
    The properties to add should be:
    user=username
    password=password
    servername=sql_server_hostname
    portnumber=sql_server_port
    databasename=databasename
    In general, all the setters required to get the datasource configured can be set as properties.

  • Sun Java System Web Server 7.0 available

    I am delighted to announce that Sun Java System Web Server 7.0 is now available for download, purchase, deployment, and more.
    This release builds on the highly scalable and stable heritage of Web Server. It features an entirely re-designed Administration interface designed around clusters, easy access to frequently performed tasks, simplification of frequently performed tasks., and a fully scriptable command line interface featuring functional parity with the browser-based interface.
    In addition to the administration changes this release features:
    o Full 64-bit support for Solaris SPARC and Solaris AMD64 platforms
    o Regular expression pattern matching for URL re-writing and mass hosting
    o If/Then/Else constructs within request processing
    o Advanced sed based input and output filters
    o Dynamic loading of Certificate Revocation Lists (CRLs) without requiring daemon restart
    o Elliptic Curve Cryptography (ECC)
    o Built in request mapping for protection against abnormal load patterns and Denial of Service protection
    o WebDAV ACL support
    o Out-of-box Java support for Servlets 2.4, JSP 2.0, JSF 1.1, JSTL 1.1, JWSDP 2.0 based web services
    o Java session failover and recovery within a cluster of peers
    o Integrated HTTP reverse proxy User-Agent
    o Bundled FastCGI client for use with third party scripting environments such as Perl, PHP, Ruby on Rails, etc
    o Enhancement of perfdump, stats-xml, and SNMP as well as more ability to monitor the Java container and the ACL system
    o Much more
    The software can be downloaded from:
    http://www.sun.com/download/products.xml?id=45ad781d
    The documentation is available at:
    http://docs.sun.com/app/docs/coll/1308.3

    If 7.0 was released, how come http://www.sun.com/webserver still only talks about 6.1?

  • Sun Java System Application Server8 can not startup (help me )

    I work in an japanese compay in China. recently, my JSC can not work
    who can help me
    the error infomation is :
    The Sun Java System Application Server could not start:
    Possible reasons:
    1.port conflict
    2.Incorrect server configuartion
    3.corrputed deployed application
    my java Studio Creator version: 2004Q2 Update9
    I have used this tool for three weeks , in the frist week. everything is ok.
    no probroblem happened. in the second week ,sometimes my JSC can not startup, so I restarted my JSC. and it can work again. later, the same problem happened again. when I restarted my JSC , it sill does not work, so I have to restart my computer and it startup successfully,
    two days later, the same problem happened again. I restarted my computer , it still did not work. so I have to change my port number in the domain.xml. sometimes it woks well, but sometimes I can't not startup.
    in the third week, no matter what I do, the problem can not be solved.
    some of my colleagues don't have such problem. but some of them have the same problem. when I run my project on the computer that don't have such problem , it can startup. I don't know why, just a little weird.
    till now , no one in our company can tell why this problem happened.
    and I believe that anybody who use JSC will encountered this error sooner or later.
    who can tell me why will this problem happen? and where can I find some related imformation about this problem. thanks!!!!!!
    my domain.xml
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE domain PUBLIC "-//Sun Microsystems Inc.//DTD Application Server 8.0 Domain//EN" "http://www.sun.com/software/appserver/dtds/sun-domain_1_0.dtd">
    <!--
    Copyright 2004 Sun Microsystems, Inc. All rights reserved.
    SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
    -->
    <!-- Generated from default-domain.xml.template -->
    <domain application-root="${com.sun.aas.instanceRoot}/applications" log-root="${com.sun.aas.instanceRoot}/logs">
    <applications>
    <j2ee-application enabled="true" location="${com.sun.aas.instanceRoot}/applications/j2ee-apps/MEjbApp" name="MEjbApp" object-type="system-all"/>
    <j2ee-application enabled="true" location="${com.sun.aas.instanceRoot}/applications/j2ee-apps/__ejb_container_timer_app" name="__ejb_container_timer_app" object-type="system-all"/>
    <web-module context-root="/web1" enabled="true" location="${com.sun.aas.installRoot}/lib/install/applications/adminapp/adminapp_war" name="adminapp" object-type="system-admin">
    <!-- System Web Module - DO NOT DELETE! -->
    </web-module>
    <web-module context-root="/asadmin" enabled="true" location="${com.sun.aas.installRoot}/lib/install/applications/admingui/adminGUI_war" name="admingui" object-type="system-admin">
    <!-- System Web Module - DO NOT DELETE! -->
    </web-module>
    <web-module context-root="/com_sun_web_ui" enabled="true" location="${com.sun.aas.installRoot}/lib/install/applications/com_sun_web_ui" name="com_sun_web_ui" object-type="system-admin">
    <!-- System Web Module - DO NOT DELETE! -->
    </web-module>
    </applications>
    <resources>
    <jdbc-resource enabled="true" jndi-name="jdbc/__TimerPool" object-type="system-all" pool-name="__TimerPool"/>
    <jdbc-resource enabled="true" jndi-name="jdbc/PointBase" object-type="user" pool-name="PointBasePool"/>
    <jdbc-connection-pool connection-validation-method="auto-commit" datasource-classname="com.pointbase.xa.xaDataSource" fail-all-connections="false" idle-timeout-in-seconds="300" is-connection-validation-required="false" is-isolation-level-guaranteed="true" max-pool-size="32" max-wait-time-in-millis="60000" name="__TimerPool" pool-resize-quantity="2" res-type="javax.sql.XADataSource" steady-pool-size="8">
    <property name="DatabaseName" value="jdbc:pointbase:embedded:ejbtimer,database.home=${com.sun.aas.instanceRoot}/lib/databases"/>
    <property name="User" value="pbPublic"/>
    <property name="Password" value="pbPublic"/>
    </jdbc-connection-pool>
    <jdbc-connection-pool connection-validation-method="auto-commit" datasource-classname="com.pointbase.xa.xaDataSource" fail-all-connections="false" idle-timeout-in-seconds="300" is-connection-validation-required="false" is-isolation-level-guaranteed="true" max-pool-size="32" max-wait-time-in-millis="60000" name="PointBasePool" pool-resize-quantity="2" res-type="javax.sql.XADataSource" steady-pool-size="8">
    <property name="DatabaseName" value="jdbc:pointbase:server://localhost:9092/sun-appserv-samples"/>
    <property name="Password" value="pbPublic"/>
    <property name="User" value="pbPublic"/>
    </jdbc-connection-pool>
    </resources>
    <configs>
    <config name="server-config">
    <http-service>
    <http-listener acceptor-threads="100" address="0.0.0.0" default-virtual-server="server" enabled="true" id="http-listener-1" port="28080" security-enabled="false" server-name="" xpowered-by="true">
    </http-listener>
    <http-listener acceptor-threads="100" address="0.0.0.0" default-virtual-server="server" enabled="true" id="http-listener-2" port="21043" security-enabled="true" server-name="" xpowered-by="true">
    </http-listener>
    <http-listener acceptor-threads="100" address="0.0.0.0" default-virtual-server="__asadmin" enabled="true" id="admin-listener" port="24848" security-enabled="false" server-name="" xpowered-by="true">
    </http-listener>
    <virtual-server hosts="sif-caicj" http-listeners="http-listener-1,http-listener-2" id="server" state="on">
    <property name="docroot" value="${com.sun.aas.instanceRoot}/docroot"/>
    <property name="accesslog" value="${com.sun.aas.instanceRoot}/logs/access"/>
    </virtual-server>
    <virtual-server default-web-module="admingui" hosts="sif-caicj" http-listeners="admin-listener" id="__asadmin" state="on">
    <property name="accesslog" value="${com.sun.aas.instanceRoot}/logs/access"/>
    </virtual-server>
    </http-service>
    <iiop-service client-authentication-required="false">
    <orb max-connections="1024" message-fragment-size="1024" use-thread-pool-ids="thread-pool-1"/>
    <iiop-listener address="0.0.0.0" enabled="true" id="orb-listener-1" port="23700" security-enabled="false"/>
    <iiop-listener address="0.0.0.0" enabled="true" id="SSL" port="21060" security-enabled="true">
    <ssl cert-nickname="s1as" client-auth-enabled="false" ssl2-enabled="false" ssl3-enabled="true" tls-enabled="true" tls-rollback-enabled="true"/>
    </iiop-listener>
    <iiop-listener address="0.0.0.0" enabled="true" id="SSL_MUTUALAUTH" port="21061" security-enabled="true">
    <ssl cert-nickname="s1as" client-auth-enabled="true" ssl2-enabled="false" ssl3-enabled="true" tls-enabled="true" tls-rollback-enabled="true"/>
    </iiop-listener>
    </iiop-service>
    <admin-service type="das-and-server">
    <das-config admin-session-timeout-in-minutes="60" autodeploy-dir="${com.sun.aas.instanceRoot}/autodeploy" autodeploy-enabled="true" autodeploy-jsp-precompilation-enabled="false" autodeploy-polling-interval-in-seconds="2" autodeploy-verifier-enabled="false" deploy-xml-validation="full" dynamic-reload-enabled="true" dynamic-reload-poll-interval-in-seconds="2"/>
    </admin-service>
    <web-container/>
    <ejb-container cache-idle-timeout-in-seconds="600" cache-resize-quantity="32" commit-option="B" max-cache-size="512" max-pool-size="32" pool-idle-timeout-in-seconds="600" pool-resize-quantity="8" removal-timeout-in-seconds="5400" session-store="${com.sun.aas.instanceRoot}/session-store" steady-pool-size="0" victim-selection-policy="nru"/>
    <mdb-container idle-timeout-in-seconds="600" max-pool-size="32" pool-resize-quantity="8" steady-pool-size="0"/>
    <jms-service init-timeout-in-seconds="60" type="LOCAL">
    <jms-host admin-password="admin" admin-user-name="admin" host="sif-caicj" name="default_JMS_host" port="27676"/>
    </jms-service>
    <log-service alarms="false" file="${com.sun.aas.instanceRoot}/logs/server.log" log-rotation-limit-in-bytes="2000000000" log-to-console="false" use-system-logging="false">
    <module-log-levels admin="INFO" classloader="INFO" cmp="INFO" cmp-container="INFO" configuration="INFO" connector="INFO" corba="INFO" deployment="INFO" ejb-container="INFO" javamail="INFO" jaxr="INFO" jaxrpc="INFO" jdo="INFO" jms="INFO" jta="INFO" jts="INFO" mdb-container="INFO" naming="INFO" resource-adapter="INFO" root="INFO" saaj="INFO" security="INFO" server="INFO" verifier="INFO" web-container="INFO"/>
    </log-service>
    <security-service anonymous-role="ANYONE" audit-enabled="false" audit-modules="default" default-realm="file" jacc="default">
    <auth-realm classname="com.sun.enterprise.security.auth.realm.file.FileRealm" name="file">
    <property name="file" value="${com.sun.aas.instanceRoot}/config/keyfile"/>
    <property name="jaas-context" value="fileRealm"/>
    </auth-realm>
    <auth-realm classname="com.sun.enterprise.security.auth.realm.certificate.CertificateRealm" name="certificate">
    </auth-realm>
    <jacc-provider name="default" policy-configuration-factory-provider="com.sun.enterprise.security.provider.PolicyConfigurationFactoryImpl" policy-provider="com.sun.enterprise.security.provider.PolicyWrapper">
    <property name="repository" value="${com.sun.aas.instanceRoot}/generated/policy"/>
    </jacc-provider>
    <audit-module classname="com.sun.enterprise.security.Audit" name="default">
    <property name="auditOn" value="false"/>
    </audit-module>
    </security-service>
    <transaction-service automatic-recovery="false" heuristic-decision="rollback" keypoint-interval="2048" retry-timeout-in-seconds="600" timeout-in-seconds="0" tx-log-dir="${com.sun.aas.instanceRoot}/logs"/>
    <monitoring-service>
    <module-monitoring-levels connector-connection-pool="OFF" ejb-container="OFF" http-service="OFF" jdbc-connection-pool="OFF" orb="OFF" thread-pool="OFF" transaction-service="OFF" web-container="OFF"/>
    </monitoring-service>
    <java-config classpath-suffix="${com.sun.aas.installRoot}/pointbase/lib/pbclient.jar${path.separator}${com.sun.aas.installRoot}/pointbase/lib/pbembedded.jar${path.separator}" debug-enabled="false" debug-options="-Xdebug -Xrunjdwp:transport=dt_shmem,server=y,suspend=n,address=creator-14848" env-classpath-ignored="true" java-home="${com.sun.aas.javaRoot}" javac-options="-g" rmic-options="-iiop -poa -alwaysgenerate -keepgenerated -g" server-classpath="${com.sun.aas.javaRoot}/lib/tools.jar${path.separator}${com.sun.aas.installRoot}/lib/install/applications/jmsra/imqjmsra.jar${path.separator}${com.sun.aas.imqLib}/jaxm-api.jar${path.separator}${com.sun.aas.imqLib}/fscontext.jar${path.separator}${com.sun.aas.antLib}/ant.jar">
    <!-- various required jvm-options -->
    <jvm-options>-client</jvm-options>
    <jvm-options>-Djava.endorsed.dirs=${com.sun.aas.installRoot}/lib/endorsed</jvm-options>
    <jvm-options>-Djava.security.policy=${com.sun.aas.instanceRoot}/config/server.policy</jvm-options>
    <jvm-options>-Djava.security.auth.login.config=${com.sun.aas.instanceRoot}/config/login.conf</jvm-options>
    <jvm-options>-Dsun.rmi.dgc.server.gcInterval=3600000</jvm-options>
    <jvm-options>-Dsun.rmi.dgc.client.gcInterval=3600000</jvm-options>
    <jvm-options>-Xmx512m</jvm-options>
    <jvm-options>-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot}/config/keystore.jks</jvm-options>
    <jvm-options>-Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot}/config/cacerts.jks</jvm-options>
    <jvm-options>-Djava.ext.dirs=${com.sun.aas.javaRoot}/jre/lib/ext${path.separator}${com.sun.aas.instanceRoot}/lib/ext</jvm-options>
    <jvm-options> -Djdbc.drivers=com.pointbase.jdbc.jdbcUniversalDriver</jvm-options>
    <jvm-options>-Dcom.sun.enterprise.taglibs=appserv-jstl.jar,jsf-impl.jar</jvm-options>
    <jvm-options>-XX:NewRatio=2</jvm-options>
    </java-config>
    <thread-pools>
    <thread-pool idle-thread-timeout-in-seconds="120" max-thread-pool-size="200" min-thread-pool-size="0" num-work-queues="1" thread-pool-id="thread-pool-1"/>
    </thread-pools>
    </config>
    <!-- config model with name "server-config" ends -->
    </configs>
    <servers>
    <server config-ref="server-config" name="server">
    <application-ref enabled="true" ref="adminapp" virtual-servers="__asadmin"/>
    <application-ref enabled="true" ref="admingui" virtual-servers="__asadmin"/>
    <application-ref enabled="true" ref="com_sun_web_ui" virtual-servers="__asadmin"/>
    <application-ref enabled="true" ref="MEjbApp" virtual-servers="server"/>
    <application-ref enabled="true" ref="__ejb_container_timer_app" virtual-servers="server"/>
    <resource-ref enabled="true" ref="jdbc/__TimerPool"/>
    <resource-ref enabled="true" ref="jdbc/PointBase"/>
    </server>
    </servers>
    </domain>
    my server.log
    I am sorry there are some japanese words in the log
    �v���I: fatal
    ����: information
    �x��:warning
    �R�l�N�V���������������G���[�������������� : error happened when connecting
    Starting Sun Java System Application Server Platform Edition 8.0.0_01 (build b08-fcs) ...
    [#|2006-02-10T12:59:48.050+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5076: Using [Java HotSpot(TM) Client VM, Version 1.4.2_06] from [Sun Microsystems Inc.]|#]
    [#|2006-02-10T12:59:49.206+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.tools.admin|_ThreadID=10;|ADM0020:Following is the information about the JMX MBeanServer used:|#]
    [#|2006-02-10T12:59:49.394+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.tools.admin|_ThreadID=10;|ADM0001:MBeanServer initialized successfully|#]
    [#|2006-02-10T12:59:51.628+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|Creating virtual server server|#]
    [#|2006-02-10T12:59:51.659+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|S1AS AVK Instrumentation disabled|#]
    [#|2006-02-10T12:59:51.738+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.security|_ThreadID=10;|SEC1143: Loading policy provider com.sun.enterprise.security.provider.PolicyWrapper.|#]
    [#|2006-02-10T12:59:53.910+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.transaction|_ThreadID=10;|JTS5014: Recoverable JTS instance, serverId = [100]|#]
    [#|2006-02-10T12:59:55.519+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|Satisfying Optional Packages dependencies...|#]
    [#|2006-02-10T12:59:55.707+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.resource.resourceadapter|_ThreadID=10;|RAR7008 : Initialized monitoring registry and listeners|#]
    [#|2006-02-10T12:59:56.394+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5100:Loading system apps|#]
    [#|2006-02-10T12:59:57.019+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.classloading|_ThreadID=10;|LDR5010: All ejb(s) of [MEjbApp] loaded successfully!|#]
    [#|2006-02-10T12:59:57.769+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.ejb|_ThreadID=10;|EJB5109:EJB Timer Service started successfully for datasource [jdbc/__TimerPool]|#]
    [#|2006-02-10T12:59:57.769+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.classloading|_ThreadID=10;|LDR5010: All ejb(s) of [__ejb_container_timer_app] loaded successfully!|#]
    [#|2006-02-10T12:59:57.816+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0302: Starting Tomcat.|#]
    [#|2006-02-10T12:59:57.957+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0100: Loading web module [adminapp] in virtual server [server] at [web1]|#]
    [#|2006-02-10T12:59:58.113+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0100: Loading web module [admingui] in virtual server [server] at [asadmin]|#]
    [#|2006-02-10T12:59:58.113+0800|�x��|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0500: default-locale attribute of locale-charset-info element has been deprecated and is being ignored. Use default-charset attribute of parameter-encoding element instead|#]
    [#|2006-02-10T12:59:58.129+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0100: Loading web module [com_sun_web_ui] in virtual server [server] at [com_sun_web_ui]|#]
    [#|2006-02-10T12:59:58.129+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.startup.Embedded|_ThreadID=10;|Starting tomcat server|#]
    [#|2006-02-10T12:59:58.129+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.startup.Embedded|_ThreadID=10;|Catalina naming disabled|#]
    [#|2006-02-10T12:59:58.222+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.core.StandardEngine|_ThreadID=10;|Starting Servlet Engine: Sun-Java-System/Application-Server-PE-8.0|#]
    [#|2006-02-10T13:00:01.285+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.startup.ContextConfig|_ThreadID=10;|�A�v���P�[�V������web.xml�����������������A�f�t�H���g�������g�p������ StandardEngine[server].StandardHost[server].StandardContext[]|#]
    [#|2006-02-10T13:00:03.191+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Coyote HTTP/1.1���|�[�g28080��������������|#]
    [#|2006-02-10T13:00:03.254+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Coyote HTTP/1.1���|�[�g 28080 ���N��������|#]
    [#|2006-02-10T13:00:03.348+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Coyote HTTP/1.1���|�[�g21043��������������|#]
    [#|2006-02-10T13:00:03.363+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Coyote HTTP/1.1���|�[�g 21043 ���N��������|#]
    [#|2006-02-10T13:00:03.379+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Coyote HTTP/1.1���|�[�g24848��������������|#]
    [#|2006-02-10T13:00:03.379+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Coyote HTTP/1.1���|�[�g 24848 ���N��������|#]
    [#|2006-02-10T13:01:04.883+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.resource.jms|_ThreadID=10;|JMS5035: Timed out after 60000 milliseconds while trying to verify if the JMS service startup succeeded.|#]
    [#|2006-02-10T13:01:04.883+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.resource.jms|_ThreadID=10;|JMS5037: Check permissions of MQ instance directory E:\Sun\Creator\SunAppServer8\imq\var\instances|#]
    [#|2006-02-10T13:01:04.883+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.resource.jms|_ThreadID=10;|JMS5036: More details may be available in the log file for the JMS service broker instance imqbroker. Please refer to the JMS provider documentation for the exact location of this log file.|#]
    [#|2006-02-10T13:01:04.883+0800|�v���I|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5071: An error occured during initialization
    com.sun.appserv.server.ServerLifecycleException: [C4003]: �R�l�N�V���������������G���[���������������B - ���o java.net.ConnectException: Connection refused: connect
         at com.sun.enterprise.jms.JmsProviderLifecycle.checkProviderStartup(JmsProviderLifecycle.java:415)
         at com.sun.enterprise.server.PEMain.run(PEMain.java:224)
         at com.sun.enterprise.server.PEMain.main(PEMain.java:172)
         at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
         at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
         at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
         at java.lang.reflect.Method.invoke(Method.java:324)
         at org.apache.commons.launcher.ChildMain.run(ChildMain.java:269)
    Caused by: com.sun.messaging.jms.JMSException: [C4003]: �R�l�N�V���������������G���[���������������B - ���o java.net.ConnectException: Connection refused: connect
         at com.sun.messaging.jmq.jmsclient.ExceptionHandler.getJMSConnectException(ExceptionHandler.java:233)
         at com.sun.messaging.jmq.jmsclient.ExceptionHandler.handleConnectException(ExceptionHandler.java:180)
         at com.sun.messaging.jmq.jmsclient.PortMapperClient.readBrokerPorts(PortMapperClient.java:172)
         at com.sun.messaging.jmq.jmsclient.PortMapperClient.init(PortMapperClient.java:97)
         at com.sun.messaging.jmq.jmsclient.PortMapperClient.<init>(PortMapperClient.java:50)
         at com.sun.messaging.jmq.jmsclient.protocol.tcp.TCPConnectionHandler.<init>(TCPConnectionHandler.java:53)
         at com.sun.messaging.jmq.jmsclient.protocol.tcp.TCPStreamHandler.openConnection(TCPStreamHandler.java:102)
         at com.sun.messaging.jmq.jmsclient.ConnectionInitiator.createConnectionOld(ConnectionInitiator.java:271)
         at com.sun.messaging.jmq.jmsclient.ConnectionInitiator.createConnection(ConnectionInitiator.java:107)
         at com.sun.messaging.jmq.jmsclient.ConnectionInitiator.createConnection(ConnectionInitiator.java:92)
         at com.sun.messaging.jmq.jmsclient.ProtocolHandler.init(ProtocolHandler.java:562)
         at com.sun.messaging.jmq.jmsclient.ProtocolHandler.<init>(ProtocolHandler.java:1102)
         at com.sun.messaging.jmq.jmsclient.ConnectionImpl.openConnection(ConnectionImpl.java:1741)
         at com.sun.messaging.jmq.jmsclient.ConnectionImpl.init(ConnectionImpl.java:588)
         at com.sun.messaging.jmq.jmsclient.ConnectionImpl.<init>(ConnectionImpl.java:274)
         at com.sun.messaging.jmq.jmsclient.UnifiedConnectionImpl.<init>(UnifiedConnectionImpl.java:33)
         at com.sun.messaging.jmq.jmsclient.QueueConnectionImpl.<init>(QueueConnectionImpl.java:32)
         at com.sun.messaging.ConnectionFactory.createQueueConnection(ConnectionFactory.java:72)
         at com.sun.messaging.jmq.admin.jmsspi.JMSAdminImpl.pingProvider(JMSAdminImpl.java:734)
         at com.sun.enterprise.jms.JmsProviderLifecycle.waitForJmsProvider(JmsProviderLifecycle.java:324)
         at com.sun.enterprise.jms.JmsProviderLifecycle.checkProviderStartup(JmsProviderLifecycle.java:384)
         ... 7 more
    Caused by: java.net.ConnectException: Connection refused: connect
         at java.net.PlainSocketImpl.socketConnect(Native Method)
         at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:305)
         at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:171)
         at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:158)
         at java.net.Socket.connect(Socket.java:452)
         at java.net.Socket.connect(Socket.java:402)
         at java.net.Socket.<init>(Socket.java:309)
         at java.net.Socket.<init>(Socket.java:124)
         at com.sun.messaging.jmq.jmsclient.PortMapperClient.readBrokerPorts(PortMapperClient.java:152)
         ... 25 more
    |#]
    [#|2006-02-10T13:01:04.883+0800|�v���I|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|Server Startup failed. Exiting...|#]
    [#|2006-02-10T13:01:04.883+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|Server shutdown in progress...|#]
    [#|2006-02-10T13:01:04.883+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0303: Stopping Tomcat.|#]
    [#|2006-02-10T13:01:04.883+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Stoping http11 protocol on 28080 server:type=ThreadPool,name=http28080|#]
    [#|2006-02-10T13:01:04.899+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Stoping http11 protocol on 21043 server:type=ThreadPool,name=http21043|#]
    [#|2006-02-10T13:01:04.915+0800|����|sun-appserver-pe8.0.0_01|org.apache.coyote.http11.Http11Protocol|_ThreadID=10;|Stoping http11 protocol on 24848 server:type=ThreadPool,name=http24848|#]
    [#|2006-02-10T13:01:05.008+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5051: Shutting down all J2EE applications ...|#]
    [#|2006-02-10T13:01:05.008+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.ejb|_ThreadID=10;|EJB5122:EJB Timer Service shutdown at [2006/02/10 13:01:05]|#]
    [#|2006-02-10T13:01:05.008+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5052: Application shutdown complete.|#]
    [#|2006-02-10T13:01:05.008+0800|�x��|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5061: Exception :
    com.sun.appserv.server.ServerLifecycleException: MQ startup failed :[C4003]: �R�l�N�V���������������G���[���������������B - ���o java.net.ConnectException: Connection refused: connect
         at com.sun.enterprise.jms.JmsProviderLifecycle.checkProviderStartup(JmsProviderLifecycle.java:364)
         at com.sun.enterprise.jms.JmsProviderLifecycle.onShutdown(JmsProviderLifecycle.java:433)
         at com.sun.enterprise.server.ApplicationServer.onShutdown(ApplicationServer.java:400)
         at com.sun.enterprise.server.PEMain.run(PEMain.java:233)
         at com.sun.enterprise.server.PEMain.main(PEMain.java:172)
         at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
         at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
         at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
         at java.lang.reflect.Method.invoke(Method.java:324)
         at org.apache.commons.launcher.ChildMain.run(ChildMain.java:269)
    |#]
    [#|2006-02-10T13:01:05.008+0800|�v���I|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|Server stopped due to Server startup failure.|#]
    [#|2006-02-10T13:01:05.024+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=11;|sending notification to server...server|#]
    [#|2006-02-10T13:01:05.024+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=11;|Server shutdown complete.|#]
    Starting Sun Java System Application Server Platform Edition 8.0.0_01 (build b08-fcs) ...
    [#|2006-02-10T13:01:10.743+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5076: Using [Java HotSpot(TM) Client VM, Version 1.4.2_06] from [Sun Microsystems Inc.]|#]
    [#|2006-02-10T13:01:11.728+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.tools.admin|_ThreadID=10;|ADM0020:Following is the information about the JMX MBeanServer used:|#]
    [#|2006-02-10T13:01:11.868+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.tools.admin|_ThreadID=10;|ADM0001:MBeanServer initialized successfully|#]
    [#|2006-02-10T13:01:14.634+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|Creating virtual server server|#]
    [#|2006-02-10T13:01:14.650+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|S1AS AVK Instrumentation disabled|#]
    [#|2006-02-10T13:01:14.665+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.security|_ThreadID=10;|SEC1143: Loading policy provider com.sun.enterprise.security.provider.PolicyWrapper.|#]
    [#|2006-02-10T13:01:16.337+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.transaction|_ThreadID=10;|JTS5014: Recoverable JTS instance, serverId = [100]|#]
    [#|2006-02-10T13:01:17.603+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|Satisfying Optional Packages dependencies...|#]
    [#|2006-02-10T13:01:17.790+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.resource.resourceadapter|_ThreadID=10;|RAR7008 : Initialized monitoring registry and listeners|#]
    [#|2006-02-10T13:01:18.462+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core|_ThreadID=10;|CORE5100:Loading system apps|#]
    [#|2006-02-10T13:01:19.025+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.classloading|_ThreadID=10;|LDR5010: All ejb(s) of [MEjbApp] loaded successfully!|#]
    [#|2006-02-10T13:01:19.728+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.ejb|_ThreadID=10;|EJB5109:EJB Timer Service started successfully for datasource [jdbc/__TimerPool]|#]
    [#|2006-02-10T13:01:19.728+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.core.classloading|_ThreadID=10;|LDR5010: All ejb(s) of [__ejb_container_timer_app] loaded successfully!|#]
    [#|2006-02-10T13:01:19.775+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0302: Starting Tomcat.|#]
    [#|2006-02-10T13:01:19.916+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0100: Loading web module [adminapp] in virtual server [server] at [web1]|#]
    [#|2006-02-10T13:01:20.041+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0100: Loading web module [admingui] in virtual server [server] at [asadmin]|#]
    [#|2006-02-10T13:01:20.041+0800|�x��|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0500: default-locale attribute of locale-charset-info element has been deprecated and is being ignored. Use default-charset attribute of parameter-encoding element instead|#]
    [#|2006-02-10T13:01:20.041+0800|����|sun-appserver-pe8.0.0_01|javax.enterprise.system.container.web|_ThreadID=10;|WEB0100: Loading web module [com_sun_web_ui] in virtual server [server] at [com_sun_web_ui]|#]
    [#|2006-02-10T13:01:20.056+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.startup.Embedded|_ThreadID=10;|Starting tomcat server|#]
    [#|2006-02-10T13:01:20.056+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.startup.Embedded|_ThreadID=10;|Catalina naming disabled|#]
    [#|2006-02-10T13:01:20.150+0800|����|sun-appserver-pe8.0.0_01|org.apache.catalina.c                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      &n

    Hi,
    Restarting the computer should have stopped the appserver.
    To kill the appserver manually you can go to the command prompt
    <install-dir>\Sun\Creator2\SunAppServer8\bin\asadmin.bat\stop-appserv
    Thanks,
    RK.

  • Sun Java System Portal Server 6.0 FAQs

    Sun Java System Portal Server 6.0 FAQs.
    Author: Sanjeev Agarwal
    Q. How to connect to external URLs from Sun ONE Portal Server? I want to use URL Scrapper for some of external sites/URLs.
    Ans:
    You can connect to external URLs if you have a Proxy Server running.
    If you are using Web Server addition of Sun ONE the Portal Server then
    go to /opt/SUNWam/servers/https-hostname.domainname/config/ dir
    In the jvm12.conf file, enter the followings:
    http.proxyHost=proxyservername.domainname
    http.proxyPort=80 (or the appropriate proxy server port number)
    https.proxyHost=proxyservername.domainname
    https.proxyPort=80 (or the appropriate proxy server port number)
    If you are using Sun ONE AppServer addition of Sun ONE Portal Server then
    go to /var/opt/SUNWappserver/domains/domain1/<server-instance>/config dir
    In the server.xml file, enter the followings:
    <jvm-options>-Dhttp.proxyHost=proxyservername.domainname </jvm-options>
    <jvm-options>-Dhttp.proxyPort=80 (or the appropriate proxy server port number) </jvm-options>
    <jvm-options>-Dhttps.proxyHost=proxyservername.domainname </jvm-options>
    <jvm-options>-Dhttps.proxyPort=80 (or the appropriate proxy server port number) </jvm-options>
    After this modification restart the server.
    Q. Explain all the processes (solaris 8 and S1 Portal Server 6.0) which runs when I start the Sun ONE Portal Server.
    Ans.
    These are the processes that a running Portal Server installation (Sun ONE WebServer addition, without SRAP) generally has by default.
    1. Directory server processes:
    - ns-slapd (LDAP server instance)
    - uxwdog (admin server process) (parent process)
    --- ns-httpd
    ----- ns-httpd
    2. Auth Helper processes:
    - doUnix
    3. Web-Server/Identity-Server/Portal-Server processes:
    As the Portal Server and Identity Server runs as web application on the Web Server, so they share the same JVM and processes.
    - uxwdog (web server admin server process) (parent process)
    --- ns-httpd
    ----- ns-httpd
    (for each web server instance)
    - uxwdog (parent process)
    - ns-httpd
    - ns-httpd
    or (in case of MaxProc=n )
    - uxwdog (parent process)
    --- ns-httpd
    ----- ns-httpd
    ----- ns-httpd
    ----- n
    Q. I have created a custom Provider but getting this error when I access the desktop, what do I do?
    > error in the desktop.debug file:
    > ERROR: DesktopServlet.handleException()
    > java.util.MissingResourceException: Can't find bundle for base name CustomTabContainerProvider,
    Ans:
    It needs a resource bundle for the custom provider. You need to create a file CustomTabContainerProvider.properties (as mentioned in the error message) and put it into the /etc/opt/desktop/classes directory. If you are not using any properties defined in this resource file then it can be a empty file. Have a look on the properties files that bundled containerProviders uses in dir <portal-install-dir>/SUNWps/web-apps/https-<host.domain>/portal/WEB-INF/classes.
    As you are extending JSPTabContainerProvider class, you can just copy the file JSPTabContainerProvider.properties from the above directory after renaming it to the <defined-provider-name>.properties (in your case CustomTabContainerProvider.properties) and move it into /etc/opt/desktop/classes directory.
    Q. what is actually multiple instances of Portal Server means?
    Ans:
    Multiple instance of Portal Server means, you will have more http listeners for the same desktop contents and the same identity profiles stored in a single Directory Server which all the instances share.
    In simple words you can have your Portal Server listening on different http ports, but uses same configuration, desktop and identities.
    It can help you to share the load for Portal Server http requests. The alternate methods are to create more web server virtual server processes (maxProc=n, but in this case the listening port will be 1 only) or use some hardware load balancer.
    You can achieve more from multiple instances if you have a multi level organization, you can change the look and feel of all the instances, images, services, components and can assign each instance to different organization or sub-organization.
    Q. How do I check the availability of the Sun ONE Portal Server/Identity Server services.
    Ans:
    You can check the availability of Sun ONE Identity Server services from following urls.
    http://<host.domainname>:<port>/amserver/sessionservice
    http://<host.domainname>:<port>/amserver/loggingservice
    To know the availability of components of Sun ONE Portal Server like Desktop/providers/Rewriter/Netmail you have to login into desktop. These are not services, but just the programming identities which will work if your Web Server and Identity Server is running.
    Just go to URL http://<server>:<port>/portal/dt , if it shows up that means your portal server is fine, and these entities will work for sure.
    Q. I am able to add the yahoo channels to existing users. But I am getting the weather for London not for local New Jersey. My language pref is to en|en_US and also the server is the default U.S server and not europe. How do I add the cities I want to see on weather channel?
    Ans:
    A Portal user himself (after login) can select what cities he want to see in weather channel.
    Steps:
    - click the edit button of weather channel
    - click on the area you belong to from Available Sections
    - select the cities from Available Cities select box and add them to Your Choices.
    - click finished from select city page and then again click finished from select area page.
    It will come back to the Portal Desktop and you will see all the cities you have selected in the weather channel.
    Q. How to use getContent() method to use in custom jsp providers (developed by ourselves) so that it can be used to retrieve a jsp page. I have already placed the JSP file in the directory structure /etc/opt/SUNWps/desktop/default/channel_dir. But still the jsp is not being displayed.
    Ans:
    You don't have to do anything in the custom JSPProvider's getContent method except the call { return super.getContent(request,response); } . If all you want is just to show your jsp, then create a channel from the default JSPProvider, and edit the property contentPage of that channel from samplecontent.jsp to your jsp name, save the changes and login again. You should see your JSP.
    Q. I want to remove all the buttons (help/edit etc.) from all the channels/one particular channel in my desktop?
    Ans:
    You can hide any buttons you want from any channel.
    These steps show how to hide all the buttons.
    1. Create a channel say "myNetlet" from netlet provider.
    2. Set the channel title to "myNetlet"
    3. Go to the dir /etc/opt/SUNWps/desktop/default/JSPTableContainerProvider and edit the file providerCommands.jsp, and modify the last line :
    from :
    <%=minMaximizeCommand%><%=helpCommand%><%=editCommand%><%=detachAtachCommand%><%=removeCommand%>
    to:
    <% if ( !(title.equals("myNetlet"))){ %><%=minMaximizeCommand%><%=helpCommand%><%=editCommand%><%=detachAtachCommand%><%=removeCommand%><% } %>
    4. Clean the dir mentioned below which contains compiled JSPs. /var/opt/SUNWps/https-<host>.<domain>/portal/tmp/_jsps/_etc/_opt/_SUNWps/_desktop/_default_en/_JSPTableContainerProvider/_html and reload the page.
    Relogin, and you would not see any buttons on "myNetlet" channel. You can customize this logic as per your needs.
    Q. How to change the title of SampleJSP Channel. I tried to change the channel properties title value via iplanet directory Server Access Management GUI. But it is not getting reflected.
    Ans:
    Through Admin console you can change the channel property "title", and as soon as you refresh the page (Shift reload) of relogin in the portal it get's reflected.
    The reason to this problem may be due to the channel property "title" is having "propagate" value as false and you are setting the channel title in the org level display profile not in the user level display profile.
    So better you change the channel name in user's display profile also.
    For this login into admin console and go to :
    - View: "User Management" -> click on organization -> Show: Users
    - click on the blue arrow of that user
    - click on Edit in section Desktop (this will open a window)
    - then change the channel properties same way you do for Organization display profile.
    Q. Login Problem with SunOne Portal 6.0.
    I was able to download and install sun one portal 6 on Solaris 8. The sample portal page came up after installation. However whenever I try to login to the Login channel with "amadmin" and the passphrase I used during installation, it takes me to another page - iPlanet/LDAP authentication page. Here I tried using the same login, but fails every time (the same login page appears). The url that shows is "http://<hostname>/amserver/login?module=dproadmin&goto=/amconsole/base/AMAdminFrame"
    I tried registering myself as a new user as well. This too fails.
    Ans:
    Make sure you are giving fully qualifying the hostname in the url which invoked the desktop. This in fact is documented in the administration documentation. If the hostname is not fully-qualified, the login page goes into an endless mode. Again, the correct url is "http://<fully-qualified-hostname>/portal". Once you get to the desktop, the login and the new user registration works.
    Q. How to send variables/parameters from 1 app to another app deployed on Sun ONE Portal Server? It may be the apps or different JSPs of JSP provider channel.
    How to achieve inter channel communication in Sun ONE Portal Server?
    Ans:
    You can use servlet context object or session, or may be the request object itself to store the information from one channel and use that in another channel. The use of either of these 3 approaches may depend on your requirements. Using session, the information will be available to that user's channels only, using request, the information will be available for that user and that request only and by using ServletContext you can share the information across users and sessions. You can obtain DesktopServlet's ServletContext object inside JSP/JSPProvider.
    Q. I am trying to modify the default desktop JSPs in TableContainerProvider and TabCotntainerProvider dirs, but it is not picking my modified JSPs ? what do I do?
    Ans:
    One easiest way to 100% ensure that it updates all your new jsp pages is to remove all the compiled jsps so that with next request the Sun ONE Portal Server compiles all the jsps and will make sure that your modification will be taken care of in next request.
    Go to /var/opt/SUNWps/https-<instance_name>/portal/tmp/_jsp/_etc/_opt/_SUNWps/_desktop/_default_<locale>/ and remove everything. and access the Portal server, it will be little slow as it has to compile all the JSPs again. Here you will find directories in the name of Containers and Channels, so if you are modifying any particular Container/Channel you can just delete that only. This approach can help a lot during development time.
    Q. What is the location of compiled JSPs in Sun ONE portal Server and what servlet spec does it supports?
    Ans: The Portal server 6.0 runs on Sun ONE Web Server 6.0 sp2, which supports only jdk 1.3 and servlet spec 2.2 only. The Sun ONE Portal Server keeps the compiled jsps of desktop and channels in : /var/opt/SUNWps/https-<instance_name>/portal/tmp/_jsp/_etc/_opt/_SUNWps/_desktop/_default_<locale>/ dir as per the channels/container names.
    Servlet 2.3 is supported if you run the Portal Server edition that runs on Sun ONE Application Server 7.0.
    Q. How do I change jdk for Sun ONE Portal Server to another jdk? I want to change the JDK of only one of my Portal Server instances, is it possible? how?
    Ans:
    Yes you can achieve both.
    A. To change the JDK for all the server instances:
    Open <portal-install-dir>/SUNWam/servers/https-admserv/start-jvm file and modify the first line
    NSES_JDK=/usr/java_1.3.1_04; export NSES_JDK
    to
    NSES_JDK=<your-jdk-location> ; export NSES_JDK
    then open <portal-install-dir>/SUNWam/servers/https-<instance-name>/config/jvm12.conf file of all the server instances and add a line
    jvm.option=-server after the first line
    B. To change the JDK for a particular server instances:
    Make a another copy of the start-jvm file rename it and modify the jdk location in it as mentioned above.
    Open the start script from <portal-install-dir>/SUNWam/servers/https-<instance-name> dir and modify these lines :
    if test -r {SERVER_ROOT}/https-admserv/start-*
    then
    for STARTSCRIPT in {SERVER_ROOT}/https-admserv/start-*
    modify this to
    if test -r {SERVER_ROOT}/https-admserv/<changed_name_of_start-jvm-file>
    then
    for STARTSCRIPT in {SERVER_ROOT}/https-admserv/<changed_name_of_start-jvm-file>
    Note: As Portal Server 6.0 uses Web server 6.0 sp2, jdk 1.4 is not supported.
    Q. How do I create a custom login page or a link, which will just log me into the portal server.
    Ans:
    You can create a custom page in your jsp page, just add this portion of html into your web page :
    <FORM action="http://<server>:<port>/amserver/login?module=<login-module>&page=1" method=post name=login_form2 target=_top>
    Login page using <login-module><br>
    <P>Enter UserId<BR><INPUT name=TOKEN0 size=22></P>
    <P>Enter Password<BR><INPUT name=TOKEN1 size=22 type=password></P>
    <P><INPUT name=Submit type=submit value=Submit> </P>
    </FORM>
    The <login-module> can be LDAP or Unix or Membership which ever you have enabled. Or instead of this you can create a link. For example for LDAP auth module :
    "<a href="http://<server>:<port>/amserver/login?module=LDAP&page=1&TOKEN0=user&TOKEN1=password" target=_top> Login into Portal </a>"
    where user and password are the user credential for the portal server.
    Q. Can I install a portal server pointing to another Identity server? I want to install few postal servers (on different machines) pointing to same identity server, is it possible?
    Ans:
    No, right now the Sun ONE Portal Server is tightly integrated with Sun ONE Identity Server so you can't just install only Sun ONE Portal Server and point it to another Sun ONE Identity Server. You can have a common Directory server if you want.
    Q. I have an application which takes input in from anonymous user and then to complete the request the user than has to login. I am having problem in passing the taken input from anonymous page to logged in user. all the request parameters are lost when I log in. How do i get the request parameters after I log in
    Ans:
    You can create a custom login page and submit the form to "/amserver/login" with a hidden parameter "goto" through which you basically specify which url to go after you log in. So you can use this mechanism to create a query string with all your request parameters you want to pass after login. For example:
    You can create a jsp which take few inputs from user and to complete the request you have to login so it posts the input form to a login jsp and stores the parameters taken from user in a hidden field (goto) :
    <FORM action="/amserver/login?module=LDAP&page=1" method=post name=login_form2 target=_top>
    Login page using LDAP<br>
    <P>Enter UserId<BR><INPUT name=TOKEN0 size=22></P>
    <P>Enter Password<BR><INPUT name=TOKEN1 size=22 type=password></P>
    <INPUT TYPE=HIDDEN NAME="goto" VALUE="/portal/dt?param1=<%=request.getParameter("param1")%>&param2=<%=request.getParameter("param2")%>">
    <P><INPUT name=Submit type=submit value=Submit> </P>
    </FORM>
    After you login through this page both the param1 and param 2 will be available in the request object after you login and you can retrieve them in your application or jsp.
    Q. I have few System.out.println in my jsp which i am using in my JSP provider channel, but when I look at the portal server's /var/opt/SUNWam/debug/desktop.debug file, none are there. I looked at the web server's access and error logs too, but it is not there also. Can somebody tell me how do it get those ? Do we have any other mechanism to put debug logs ?
    Ans
    By default the binary which web server runs is uxwdog which eats up System.out.println output. If you want to see the System.out.println then you need to change the product binary from the start script of the portal server instance.
    - Go to <portal-install-dir>/SUNWam/servers/https-<instance-name> and open the start script
    - Change the PRODUCT_BIN=uxwdog to PRODUCT_BIN=ns-httpd , save the file
    - Run the script ./start to start the portal server
    Note : with ns-httpd ON the server will not leave that shell, and in the same window/shell you will be able to see all your System.out.println statements. To close the server you have to kill the server process with "kill -9 pids" command
    Alternate way is to use api inside your application or jsp:
    <%@page import="com.sun.portal.providers.jsp.JSPProvider, com.sun.portal.providers.*, com.sun.portal.providers.containers.*, com.sun.portal.providers.context.*" %>
    <% JSPProvider p=(JSPProvider)pageContext.getAttribute("JSPProvider");
    ProviderContext pc = p.getProviderContext(); %>
    <%-- after that you can use these lines any where in your jsp --%>
    <%
    pc.debugError("your error msg");
    pc.debugMessage("your msg");
    pc.debugWarning("your warning msg");
    %>
    The particular mgs will be shwon in /var/opt/SUNWam/debug/desktop.debug file as per your "debugLevel" parameter setting in /etc/opt/SUNWps/desktop/desktopconfig.properties file. By default the debugLevel is set to error so only pc.debugError("error msg") will be shown.
    Q. Multipart form (file upload) processing in providers? Is it supported
    Ans:
    The Sun ONE Portal Server's DesktopServlet does not have the ability to process a request with the content encoding type of multipart/form-data. DesktopServlet does not pass the input stream for the request on to the Provider.
    To accomplish handling of multipart/form-data type requests, it is necessary to create a companion servlet or JSP that process the multipart/form-data. This servlet can then pass control back to the Portal channel. The data from the file can be shared between the servlet and the provider by using static Java members or by storing the data in a back-end database and then passing a reference to the data over to the provider.
    Q. After installing the Portal Server I am trying to login as admin, but it is failing and coming back to login page every time. How do I login?
    Ans:
    The Default Admin user is 'amadmin' and the password is the PASSPHRASE you give during Portal Server installation. Try login using these credentials.
    Also in the browser give the complete URL for the Portal Server like : Http://<myhost>.<mydomain>:<port>/amserver/login or Http://<myhost>.<mydomain>:<port>/amconsole. You can't login into portal server's IDSAME console by giving IP Address or just the hostname, also your machine should be listed in the DNS server so that it can resolve the name.
    Q. I installed Sun ONE Portal Server 6.0 some time back, and now I want to know all the installation parameters and user/passwords for whole portal installation. How do I do that?
    Ans:
    The Default Admin user is 'amadmin' and the password is the PASSPHRASE you give during Portal Server installation. Also in the browser give the complete URL for the Portal Server like : Http://<myhost>.<mydomain>:<port>/amserver/login or Http://<myhost>.<mydomain>:<port>/amconsole. You can't login into portal server's IDSAME console by giving IP Address or just the hostname, also your machine should be listed in the DNS server so that it can resolve the name.
    In case you have forgotten the port numbers and PASSPHRASE that you give during installation, you still can see all the information for each component of your Portal Server Installation. The Portal server and it's components like Directory Server, Web Server and IDSAME are installed as Solaris package so the system has all the information for these packages.
    Portal Server : See file /var/sadm/pkg/SUNWps/pkginfo
    Directory Server : See files /var/sadm/pkg/SUNWamds/pkginfo and /var/sadm/pkg/SUNWamdsc/pkginfo
    Web Server : See file /var/sadm/pkg/SUNWamws/pkginfo
    Identity Server : See file /var/sadm/pkg/SUNWamsam/pkginfo
    Note: In any case you should never edit/modify these files.
    Q. Controlling the display of the help (?) button.
    Where are the links/image elements defined for the help/edit/minimize buttons? the leafWrapper.jsp pulls the hashtable out of the HttpRequest, and that hashtable is being used by providerCommands.jsp:
    Hashtable commands = (Hashtable)request.getAttribute("provider_cmds");
    Any idea where this is being set?
    Ans:
    - You can remove the help/edit button of any channel by adding the line into the Channel's properties by editing the Xml of display profile in the admin console.
    <String name="helpURL" value="" advanced="false" merge="replace" lock="false" propagate="true"/>
    <Boolean name="isEditable" value="false" advanced="false" merge="replace" lock="false" propagate="true"/>
    The Attribute 'provider_cmds' is set into /etc/opt/SUNWps/desktop/default/JSPTableContainerProvider/tablecolumn.jsp :
    <dttable:getProviderCommand id="provider_cmds" scope="request" />, and after that only the leafwrapper.jsp is included, but the Hashtable is generated by a class com.sun.portal.providers.util.ProviderCommands.java and made available through taglib classes. So you can't change the generated contents/string in the Hashtable.
    But you can change the default 'alt' text displayed and the images linked to the help/edit icons. As this modification is at Provider level, it will change the icons for all the channels in the desktop.
    Please see the file:
    /opt/SUNWps/web-apps/https-<host>.<domain>/portal/WEB-INF/classes/JSPTABLEContainerProvider.properties.
    Here you will find the mapping. The image location are given from the context root of portal server which is by default : /opt/SUNWps/web-apps/https-<host>.<domain>/portal.
    Q. I have a number of web applications needed to integrate to portal server. Any pointers or tips of what my option is?
    Ans:
    You can very well integrate all your web application with Portal server. Portal Server 6.0 has web container same as Sun ONE web server 6.0 Sp2, which runs on Jdk-1.3.
    If your web applications are just Servlets/Jsps then you can very well port them on Portal server's webserver which supports war module deployment. (infect for Web server the Portal server and Identity server is like a war module.)
    There can be two possibilities in this case, either you put the whole of your application on portal server and make the link available into the desktop via 'Application Provider Channels' or you can create a client to your web application into portal server.
    If your web application is on Sun ONE Application server 7.0 and needs authentication, you can also have SSO. If you just want to show the link of your web application into desktop then you can either use URL Scrapper to show the first page of your web application or use Bookmark channel to provide just the url.
    The easiest way to make a client of your web application is to use JSP Channel using JSPProvider and put your logic into the samplecontents.jsp file or you can create your own custom Provider extending JSPProvider. There can be a lot of different configurations, depending on the web application you want to integrate and your needs
    Q. I removed few channels from the org level display profile but still they are coming to the desktop of users, I had accessed the desktop before. why?
    Ans:
    If you still see any channel after you remove it from the display profile at organization lever, that means you have to edit the user's display profile. So go to admin console and select User from Show: menu and click on the blue arrow near the user. In the right frame under the 'Desktop' category click on the Edit link (right side). This will open user's display profile in a window. Now edit it as per your requirements.

    Unfortunately Web Server 6.0SP2 is no longer available for download.
    If you must use Web Server 6.0, you should use the most current Service Pack. It is backward compatible and contains many performance and security fixes.

  • ABAP+JAVA system copy using 3rd party export/import tools

    Hi all,
    I am trying to do a homogenous system copy.  I am following the syscopy guide for SAP NW 7.0 SR3 ABAP+JAVA systems
    We are running AIX 5.L and Oracle.
    My question is this.  We are using an IBM XiV system for our disk storage, and we are able to restore from "snaps" which is their version of images.  Does anyone know if it is possible to restore or "import" the data in a system copy using an outside tool like this?  If so, do you have any information on how to?
    I know it is possible to restore the database from an offline backup using BRTools rather than r3load and jload, and I just wanted to see if I can restore from a snap as it would save a lot of time in the procedure.
    Any help or ideas would be much appreciated.
    Thanks!

    >My question is this.  We are using an IBM XiV system for our disk storage, and we are able to restore from "snaps" which is their version of images.  Does anyone know if it is possible to restore or "import" the data in a system copy using an outside tool like this?  If so, do you have any information on how to?
    That approach is not supported.
    The reason is: combined instances write the instance name and hostname in various places, on the filesystem in .properties files, in the JDBC configuration, depending on the java applications you run on top in various other places. What you're trying to do is effectively "renaming" an instance.
    Technically it's possible to do it and to get it run, yes, but the supported way is running sapinst and choose ABAP + Java system copy. This will prevent you from lots of (not really documented) manual work after the copy.
    Markus

  • How can I use Servlets on Sun Java System WebServer 6.1

    Hi
    This is Khurram,
    I have just downloaded, and installed "Sun One Java System Web Server 6.1" on WindowsXP. This is installed and working properly on my system. But I want to use Servlet technology on this server, even I did download it just for working on servlets. Before it, I was using typical JavaWebServer2.0 for this purpose.
    Any ways.
    Can any one tell me, how can I do this on "Java System Web Server 6.1".
    Thanks
    any help will be appriciated
    regards
    Khurram

    Thanks for your such action.
    Actually I have installed it since 2 days, and have read throughly the documentation of WebServer, But Only the Link for this purpose is provided "Programmer's Guide to Web Applications", Now I have just searched for it and found only "Programmer's Guide" .PDF format. I have just read it out now, But here also provided a small refference to see "Programmer's Guide to Web Applications". Now I have just the problem that where to find it.
    Please, tell me if you have some solution to my problem
    or atleast tell me where to find the refference "Programmer's Guide to Web Applications". I tried but only found "Programmer's Guide" for Sun Web Server 6.1.
    Thanks any way to give some time.
    Khurram

  • Configure MS SQL Server 2000 DataSource in Sun Java Systema App Server

    How can I configure Sun Java Systema App Server 8 to use a DataSource of MSSQL Server 2000?

    This has been covered in this forum multiple times. It is also documented in the SJSAS developers guide jdbc chapter. If you still have questions, please post, but the info has previously been discussed here and recently

  • Setting up java.system.property in WL 6.0

    Hi all,
    I just installed Web Logic 6.0. I would like to know if anyone knows how
    to set java.system.property in Web Logic 6.0
    In old Web Logic 5.1, I added this line in weblogic.properties file. Now
    since we don't have weblogic.properties file anymore, I am assuming this
    should go in config.xml. Documentation says I should use Admin Console
    to modify config.xml and to convert old weblogic.properties file, but I
    found Admin Console confusing.
    My Web Logic 6.0 is installed on d:\bea\. I clicked on Convert
    Weblogic.properties and I see directories on my system. I click on icon
    to get the directory that has weblogic.properties file. Then I get page
    that ask me to pick Clusters and Server and I have no idea what
    directory I need to click on
    If someone knows what to do next or how to edit Config.xml so that I can
    add my java.system.property, please e-mail me
    Thanks in advance
    Qaiser

    Did you see the directions on page 3-11 of the WLS 6.0 Administration Guide? I
    followed these steps, and was able to create a new domain. I found them to be
    clear.
    Laurel
    "Jesper de Jong" <[email protected]> wrote:
    >
    Hello all,
    Instead of working with "mydomain" and "myserver" I want to create my
    own domain.
    IMHO, the documentation on e-docs is not very clear on the steps that
    are necessary
    to do this.
    What are the steps, or where can I find better documentation on creating
    a domain?
    regards,
    Jesper

  • CUA with AS Java systems

    Hi "Team"
    Some of you may have read my previous post on SSO and CUA (I don't know how to post the link to that here, sorry).
    Following up on that discussion, I'm no longer dealing with the SSO part of my problem.  I, however, need to get a good idea of how to get an AS Java system to get user and role assignments from my CUA master.  I've seen this done before.
    The problem I'm facing is that I have documentation (that I've only partially read) that suggests how to go about getting the AS Java system to use an AS ABAP system as a user store, and I get the part that the AS JAVA system will read the user list from the ABAP system, and stay up to date.  But I'm not clear on how the role assignments between the CUA box and the JAVA box are setup.
    The way I've seen it is that dummy roles are created in the AS ABAP box that is used as the user store (e.g. ECQ or something else) and then there is some correlation between those roles and the AS JAVA roles. 
    Any suggestions on where I'd start getting this information together?
    Thanks a lot!
    Santosh Krishnan

    Julius,
    I agree with you.  But my client has made promises to their big guys and so they've made agreements (way prior to bringing me onboard to get this all going) that I have no influence upon.  I actually suggested exactly what you wrote, but I got so much heat on it, I now have a healthy burnt look.
    So I'm going to have to implement CUA, and get the AS JAVA boxes to use that method to provision users and handle role assignments.
    However I didn't get your point about many many clients.  Am I missing something regarding the setup?  So far (with the information I have), I was thinking I'd designate one ABAP system as the user store for the Java systems.  Do elaborate.
    Thanks a lot.
    Santosh Krishnan

  • Uninstall Sun Java System Messaging Server

    Hi, I need Uninstall Sun Java System Messaging Server, but I not find a command to uninstall. Where is it? Any documentation?
    Thanks

    The uninstall program is located in:
    /var/sadm/prod/entsys

  • Java.system.property

    I repost Craig Sandin's question, which was post on Feb 06th. I have the same problem
    as him.
    I have used java.system.property in my wls 5.1 weblogic.properties file, and it
    set a system property I could get at runtime. Is there an equivalent in wls 7.0?
    I haven't found anything in the documentation for config.xml. Obviously I can
    pass -D options to the jvm, but I was looking for a way from the config file.
    hongjie

    We don't offer this anymore.. Sorry.
    You could write your own very simple
    wrapper class to start WLS:
    Properties props = new Properties();
    props.load(new FileInputStream("weblogic.properties");
    System.setProperties(props);
    weblogic.Server.main();
    Cheers
    mbg
    "hongjie" <[email protected]> wrote in message
    news:[email protected]..
    >
    I repost Craig Sandin's question, which was post on Feb 06th. I have thesame problem
    as him.
    I have used java.system.property in my wls 5.1 weblogic.properties file,and it
    set a system property I could get at runtime. Is there an equivalent inwls 7.0?
    I haven't found anything in the documentation for config.xml. Obviously Ican
    pass -D options to the jvm, but I was looking for a way from the configfile.
    >
    hongjie

  • Export of Java system failing

    Hello,
    I'm trying to do a system copy of our production PI system and create a new QA PI system. According to OSS note 585277, we are going to do the SAVLIB/RSTLIB method. That is working fine.
    However, the first part of the note talks about doing the export of the java system using the SAPinst program. Our system is a NW 7.00 system, so we need to perform the export of the java side to get the SDM portion of the java engine. We are using the database-specific option as stated in the documentation, but during the export we are getting an error in the "Export from Java central instance" step. Looking at the sapinst.log file there is an error that says the following: FCO-00011  The step setSDMStandAloneMode with step key |NW_Export|ind|ind|ind|ind|0|0|NW_Java_Export_Dialog|ind|ind|ind|ind|5|0|NW_JAVA_Export_CI|ind|ind|ind|ind|3|0|setSDMStandAloneMode was executed with status ERROR .
    The is the only log that is getting updated. The one other thing is that the system is up and running during the export of the java portion.
    Has anyone every done this or seen this error or had any experience with this? Does the system need to be down in order to complete this?
    Thanks,
    Dale Dingmann

    Hi,
    To be sure the SDM is changing its state to standalone mode, could you execute the statements, below?
    Under "/usr/sap/<SID>/JC<xx>/SDM/program"
    StopServer.sh
    sdm jstartup "mode=standalone"
    StartServer.sh
    At this stage, check the log output, on the screen. To set to to integrated state;
    Under "/usr/sap/<SID>/JC<xx>/SDM/program"
    StopServer.sh
    sdm jstartup "mode=integrated"
    StartServer.sh
    Best regards,
    Orkun Gedik

  • Disc for Java System Copy?

    Hello,
    Does anyone know which installation master disc to use for a java system (specifically portal 6.0) uses?  The documentation I have says to use the NW04 SR1 Installation Master disc.
    I have this disc and have applied the installation control patches, the copy control patches, and ISERPACK7.
    When I try to do the SDM export, I cannot do so because the path SAP NetWeaver '04 Support Release 1 -> Java System -> <DB> -> Central System -> Migration Database Export does not exist.  I get to the 'Central System' portion of the menu, but there's no option to export the DB.
    I'm using disc: SAP NETWEAVER 04 SR1  - SAP Installation Master DVD (51031148).
    I appreciate any insight as to where I might be going wrong.  Thank you.
    ~TJ

    I appreciate everyone's help.  SAP Support came through with a solution for me:
    Hello TJ,
    obviously, the control.xml file delivered with SAP CD/DVD 51032143_1 is
    erroneous. However, for "system copy enterprise portal iseries", I foundthe SAP Note 977906, where following statement can be found:
    Updating the Installation Master DVD (if required)
    In the following cases you must update the "6.20/6.40 Installation
    Master (Edition Sept. 2006)" DVD before starting SAPinst:
    o you want to install a Java or Add-In system
    o you want to do a Java export <-- !!!!!!
    Since this is the situation you currently face, I would advise you to
    follow the instructions from that SAP Note:
    1. Download the attached NW04_09.SAR archive.
    2. Extract NW04_09.SAR to the root directory of the copied "6.20/6.40
    Installation Master (Edition Sept. 2006)" DVD using SAPCAR.
    3. Start SAPinst as described in the installation guide.
    That is, you should remove the current installation directory
    /usr/sap/SAPinst/NW04/COPY/EXPORT/JAVA/COPY/EXP , and restart the EP
    system copy from scratch.
    With kind regards / mit freundlichen Grüßen
    Frank Uhlig
    SAP Certified Technology Consultant Netweaver
    Global Support - SAP on System i (iSeries)

  • BW 3.5 over ABAP+JAVA system homogeneus copy

    Hello Gurus,
    I making a BW homogeneus copy to other hardware (i want change the hardware).
    I check the WAS Abap and WAS java homogeneus copy guide, but i am really confused.
    I think follow this steps:
    1.- Install central instance ABAP (only WAS ABAP)
    2.- install DB instance ABAP
    3.- restore de BD
    4.- export JAVA ADD-in in source system
    5.- import JAVA ADD-in in target system
    6.- post processing
    I dont know if after step 2  I must install the Java ADD-in in target system ( the BW system is over ABAP+JAVA system).
    or the import java add-in install the java component?
    Regards,
    Ernesto.

    Hello Ernesto,
    There are two ways to perform the system copy
    1. Database Specific
    2. Database independent
    I beleive you are trying to do Database Independent system copy that is by creating export cd of source database and use them for system. For your environment which is WINDOWS + MSSQL on 6.40 SR1.
    Please refer to documents
    Homogeneous and Heterogeneous System Copy for SAP Systems based on SAP Web AS ABAP 6.40 SR1
    Homogeneous and Heterogeneous System Copy for SAP Systems based on SAP Web AS Java 6.40 SR1
    To answer your original question, You install the Java Add-In using the Java export on Target System. I have summarized the process flow below
    From document "Homogeneous and Heterogeneous System Copy for SAP Systems based on SAP Web AS Java 6.40 SR1
    check section 4.2 Database-Independent System Copy (Jload Procedure)
    Process Flow for the Source System (Java Add-in)
    On Source System: Windows
    1. You run SAPinst to perform the Java export [page 64].
    We recommend that you perform the export as a test run before you perform a productive run. Deselect the option Stop J2EE cluster before export on the screen Java System > Database Export when running SAPinst for a test run.
    2. You run SAPinst to perform the ABAP export as described in the documentation Homogeneous and Heterogeneous System Copy for SAP Systems based on Web AS ABAP 6.40 SR1.
    3. If required, you can run the SAPinst GUI in standalone mode to perform a remote system copy [page 86].
    On Target System: Windows
    1. You perform the ABAP import as described in the documentation Homogeneous and Heterogeneous System Copy for SAP Systems based on Web AS ABAP 6.40 SR1.
    3. For more information, see Running SAPinst on Windows [page 64].
    4. Java import: You install the Java Add-In using the Java export.
    You must check the documentation Installation Guide u2013 SAP NetWeaver u201904 SR1 Java on <your OS> : <your database>, Part II u2013 Installation and Post-Installation for details concerning the installation of your database that cannot be covered by this documentation.
    a. Central System: You run SAPinst to install the target system and perform the import [page 64].
    Hope this helped you let me know if you still have concerns.
    Thank you,
    Praveen

Maybe you are looking for