Oracle Java Web Console 소프트웨어 문제 해결

다음 정보는 Oracle Java Web Console 소프트웨어를 사용할 때 발생할 수 있는 문제 해결을 돕기 위해 제공됩니다.

콘솔 상태 및 등록 정보 확인

smcwebserver, wcadmin 및 svcs 명령을 사용하여 문제 해결에 유용한 콘솔에 대한 여러 유형의 정보를 얻을 수 있습니다.

콘솔이 실행 중이고 사용으로 설정되었는지 확인하는 방법

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 서버 상태를 확인합니다.

   # smcwebserver status
   Sun Java(TM) Web Console is running

3. Solaris 10 11/06: 콘솔의 SMF 상태 및 사용으로 설정 상태를 확인합니다.

   # svcs -l system/webconsole:console

   사용/사용 안함으로 설정 없이 smcwebserver 명령을 사용하여 서버를 시작 및 중지할 경우 enabled 등록 정보가 false(temporary) 또는 true(temporary)로 표시될 수 있습니다.

콘솔 리소스 및 등록 정보를 나열하는 방법

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 콘솔의 리소스 및 등록 정보를 나열합니다.

   Solaris 10 11/06 릴리스 이상을 실행 중인 경우 이 명령을 사용합니다.

   # wcadmin list
   
   Deployed web applications (application name, context name, status):
    
       console      ROOT            [running]
       console      com_sun_web_ui  [running]
       console      console         [running]
       console      manager         [running]
       legacy       myapp           [running]
    
   Registered jar files (application name, identifier, path):
    
       console  audit_jar     /usr/lib/audit/Audit.jar
       console  console_jars  /usr/share/webconsole/lib/*.jar
       console  jato_jar      /usr/share/lib/jato/jato.jar
       console  javahelp_jar  /usr/jdk/packages/javax.help-2.0/lib/*.jar
       console  shared_jars   /usr/share/webconsole/private/container/shared/lib/*.jar
    
   Registered login modules (application name, service name, identifier):
    
       console  ConsoleLogin  userlogin
       console  ConsoleLogin  rolelogin
    
   Shared service properties (name, value):
    
       ENABLE yes
       java.home         /usr/jdk/jdk1.5.0_06

   ---

   주 - SMF는 이전 절차에 나온 고유의 enabled 등록 정보를 사용하므로 이 ENABLE 등록 정보는 무시됩니다. ENABLE 등록 정보는 콘솔 서버가 SMF로 관리되지 않는 이전 시스템에서 사용됩니다.

   ---

   Oracle Solaris 10, Solaris 10 1/06 및 Solaris 10 6/06 릴리스의 경우 이 명령을 사용합니다.

   # smreg list
   
    The list of registered plugin applications:
   
   com.sun.web.console_2.2.4       /usr/share/webconsole/console
   com.sun.web.ui_2.2.4    /usr/share/webconsole/com_sun_web_ui
   com.sun.web.admin.example_2.2.4 /usr/share/webconsole/example
   
   The list of registered jar files:
   
   com_sun_management_services_api.jar scoped to ALL
   com_sun_management_services_impl.jar scoped to ALL
   com_sun_management_console_impl.jar scoped to ALL
   com_sun_management_cc.jar scoped to ALL
   com_sun_management_webcommon.jar scoped to ALL
   com_iplanet_jato_jato.jar scoped to ALL
   com_sun_management_solaris_impl.jar scoped to ALL
   com_sun_management_solaris_implx.jar scoped to ALL
   
   The list of registered login modules for service ConsoleLogin:
   
   com.sun.management.services.authentication.PamLoginModule optional
   use_first_pass="true" commandPath="/usr/lib/webconsole";
   com.sun.management.services.authentication.RbacRoleLoginModule requisite
   force_role_check="true" commandPath="/usr/lib/webconsole";
   
   The list of registered server configuration properties:
   
   session.timeout.value=15
   authentication.login.cliservice=ConsoleLogin
   logging.default.handler=com.sun.management.services.logging.ConsoleSyslogHandler
   logging.default.level=info
   logging.default.resource=com.sun.management.services.logging.resources.Resources
   logging.default.filter=none
   logging.debug.level=off
   audit.default.type=None
   audit.None.class=com.sun.management.services.audit.LogAuditSession
   audit.Log.class=com.sun.management.services.audit.LogAuditSession audit.class.fail=none
   authorization.default.type=SolarisRbac
   authorization.SolarisRbac.class=
   com.sun.management.services.authorization.SolarisRbacAuthorizationService
   authorization.PrincipalType.class=
   com.sun.management.services.authorization.PrincipalTypeAuthorizationService
   debug.trace.level=0
   .
   .
   .
   No environment properties have been registered.

콘솔 액세스 문제

콘솔 액세스 문제는 콘솔 서버가 사용으로 설정되어 있지 않거나 보안 설정이 제한되어 있음을 나타낼 수 있습니다. 자세한 내용은 콘솔 상태 및 등록 정보 확인 및 Oracle Java Web Console 보안 고려 사항을 참조하십시오.

응용 프로그램 등록 문제

이 섹션에는 콘솔 응용 프로그램에서 발생 가능한 등록 문제 해결에 대한 정보가 포함되어 있습니다. 특정 콘솔 응용 프로그램에 대한 정보는 해당 응용 프로그램의 설명서를 참조해야 합니다.

Solaris 10 11/06 릴리스부터 웹 콘솔은 응용 프로그램 등록 방식을 변경했지만, 이전 버전의 콘솔용으로 개발된 응용 프로그램을 계속 지원할 수 있습니다. 현재 응용 프로그램은 콘솔 서버가 실행 중인 동안 단일 명령으로 등록 및 배치됩니다. 이전 콘솔용으로 개발된 응용 프로그램을 레거시 응용 프로그램이라 하며, 등록 중 콘솔 서버를 중지해야 합니다. 응용 프로그램을 등록 또는 등록 취소해야 하는 경우 다음 절차에 설명된 대로 먼저 응용 프로그램이 레거시 응용 프로그램인지 확인해야 합니다.

응용 프로그램이 레거시 응용 프로그램인지 확인하는 방법

1. 응용 프로그램의 app.xml 파일을 확인합니다.

   app.xml 파일은 응용 프로그램의 WEB-INF 디렉토리에 있습니다.

2. app.xml 파일에서 registrationInfo 태그를 확인합니다.

   레거시 응용 프로그램의 경우 registrationInfo 태그는 버전 2.x입니다. 예를 들면 registrationInfo version="2.2.4"입니다.

   현재 응용 프로그램에서 registrationInfo 태그의 버전은 최소한 3.0 이상입니다. 예를 들면 registrationInfo version="3.0"입니다.

배치된 응용 프로그램을 나열하는 방법

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 배치된 응용 프로그램을 나열합니다.

   Solaris 10 11/06 릴리스 이상을 실행 중인 경우 이 명령을 사용합니다.

   # wcadmin list -a
   
   Deployed web applications (application name, context name, status):
    
       console  ROOT            [running]
       console  com_sun_web_ui  [running]
       console  console         [running]
       console  manager         [running]
       legacy   myapp           [running]

   이 명령은 모든 등록 및 배치된 응용 프로그램을 나열합니다. 레거시 응용 프로그램은 응용 프로그램 이름 legacy로 나열됩니다. 응용 프로그램이 레거시 응용 프로그램인지 확인하는 방법을 참조하십시오 기타 나열된 응용 프로그램은 모두 현재 응용 프로그램이며, Oracle Java Web Console에 현재 응용 프로그램을 등록하는 방법에 설명된 대로 등록됩니다.

   일반적으로 응용 프로그램에 대해 표시되는 상태는 실행 중 또는 중지됨입니다. 상태가 실행 중인 경우 응용 프로그램이 현재 로드되고 사용할 수 있습니다. 상태가 중지됨인 경우 응용 프로그램이 현재 로드되지 않고 사용할 수 없습니다. 응용 프로그램은 성공적으로 등록 및 배치될 수 있지만, 응용 프로그램의 문제로 인해 로드되지 않을 수 있습니다. 이 경우 응용 프로그램의 상태는 중지됨입니다. 응용 프로그램 로드를 시도할 때 console_debug_log에서 콘솔의 기본 웹 컨테이너인 Tomcat의 역추적에 오류가 있는지 확인합니다. console_debug_log에 대한 자세한 내용은 콘솔 디버그 추적 로그 사용을 참조하십시오.

   모든 응용 프로그램이 중지됨으로 표시될 경우(콘솔 응용 프로그램 포함) 일반적으로 콘솔의 웹 컨테이너가 실행되고 있지 않음을 의미합니다. 이 경우 응용 프로그램 목록은 웹 컨테이너에 등록된 정적 context.xml 파일에서 얻을 수 있습니다.

   Oracle Solaris 10, Solaris 10 1/06 및 Solaris 10 6/06 릴리스의 경우 이 명령을 사용합니다.

   # smreg list -a
   
   The list of registered plugin applications:
   
           com.sun.web.console_2.2.4       /usr/share/webconsole/console
           com.sun.web.ui_2.2.4    /usr/share/webconsole/com_sun_web_ui
           com.sun.web.admin.yourapp_2.2.4 /usr/share/webconsole/yourapp

Oracle Java Web Console에 레거시 응용 프로그램을 등록하는 방법

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 웹 서버를 중지합니다.

   # smcwebserver stop

3. 응용 프로그램을 등록합니다.

   # smreg add -a /directory/containing/application-files
   

   smreg 명령은 Oracle Java Web Console의 등록 테이블에 있는 정보를 관리합니다. 이 스크립트는 응용 프로그램 배치를 위한 몇 가지 추가 작업도 수행합니다. 이 명령에 대한 추가 옵션은 smreg(1M) 매뉴얼 페이지를 참조하십시오.

4. 웹 서버를 다시 시작합니다.

   # smcwebserver start

예 3-8 레거시 응용 프로그램 등록

이 예는 해당 파일이 /usr/share/webconsole/example 디렉토리에 있는 레거시 응용 프로그램을 등록하는 방법을 보여줍니다. 레거시 응용 프로그램의 경우 응용 프로그램을 등록하기 전에 콘솔 서버를 중지하고 응용 프로그램이 등록된 후 콘솔 서버를 시작해야 합니다. 이 응용 프로그램은 레거시 콘솔 응용 프로그램이므로 smreg에서 표시하는 경고는 무시할 수 있습니다.

# smcwebserver stop
# smreg add -a /usr/share/webconsole/example

    Warning: smreg is obsolete and is preserved only for
    compatibility with legacy console applications. Use wcadmin instead.

    Type "man wcadmin" or "wcadmin --help" for more information.

Registering com.sun.web.admin.example_version.

# smcwebserver start

Oracle Java Web Console에서 레거시 응용 프로그램 등록을 취소하는 방법

특정 레거시 응용 프로그램을 웹 콘솔의 실행 페이지에 표시하고 싶지 않지만 소프트웨어를 제거하지는 않으려는 경우 smreg 명령을 사용하여 응용 프로그램 등록을 취소할 수 있습니다. 응용 프로그램이 레거시 응용 프로그램인지 확인하는 방법을 참조하십시오

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 응용 프로그램 등록을 취소합니다.

   # smreg remove -a app-name

예 3-9 Oracle Java Web Console에서 레거시 응용 프로그램 등록 취소

이 예는 app-name com.sun.web.admin.example에서 레거시 응용 프로그램을 등록 취소하는 방법을 보여줍니다.

# smreg remove -a com.sun.web.admin.example

 Unregistering com.sun.web.admin.example_version.

Oracle Java Web Console에 현재 응용 프로그램을 등록하는 방법

Solaris 10 11/06: 이 절차는 콘솔 서버를 중지한 다음 다시 시작하지 않고 등록 및 배치할 수 있는 업데이트된 콘솔 응용 프로그램에 적용됩니다. 레거시 응용 프로그램 및 Oracle Solaris 10, Solaris 10 1/06, Solaris 10 6/06 릴리스에 있는 모든 콘솔 응용 프로그램에 대한 등록 절차는 Oracle Java Web Console에 레거시 응용 프로그램을 등록하는 방법을 참조하십시오. 응용 프로그램이 레거시 응용 프로그램인지 확인하는 방법도 참조하십시오.

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 응용 프로그램을 등록하고 배치합니다.

   wcadmin deploy -a app-name -x app-context-name
    /full path/to/app-name

예 3-10 현재 응용 프로그램 등록

이 예는 현재 웹 콘솔용으로 개발되거나 업데이트된 응용 프로그램을 등록하고 배치하는 방법을 보여줍니다.

# wcadmin deploy -a newexample_1.0 -x newexample /apps/webconsole/newexample

Oracle Java Web Console에서 현재 응용 프로그램 등록을 취소하는 방법

Solaris 10 11/06: 이 절차는 콘솔 서버를 중지한 다음 다시 시작하지 않고 등록 취소 및 배치 해제할 수 있는 업데이트된 콘솔 응용 프로그램에 적용됩니다. 레거시 응용 프로그램 및 Oracle Solaris 10, Solaris 10 1/06, Solaris 10 6/06 릴리스에 있는 모든 콘솔 응용 프로그램에 대한 등록 취소 절차는 Oracle Java Web Console에서 레거시 응용 프로그램 등록을 취소하는 방법을 참조하십시오. 응용 프로그램이 레거시 응용 프로그램 또는 업데이트된 응용 프로그램인지 확인하려면 배치된 응용 프로그램을 나열하는 방법 및 응용 프로그램이 레거시 응용 프로그램인지 확인하는 방법을 참조하십시오.

1. 수퍼유저 또는 동등한 역할의 사용자로 로그인합니다.

   역할에는 권한 부여 및 권한이 있는 명령이 포함됩니다. 역할에 대한 자세한 내용은 System Administration Guide: Security Services의 Configuring RBAC (Task Map)를 참조하십시오.

2. 응용 프로그램을 배치 해제하고 등록 취소합니다.

   # wcadmin undeploy -a newexample_1.0 -x newexample