マイグレーションツールで可能なこと

本ページでは Project GlassFish のマイグレーションツールで可能なことを解説します。

  • 設定パラメタの移行
  • 配備記述子 (DD) の移行
  • カスタム JSP タグの実装
  • プロプライエタリ API の実装
  • IDE との統合
  • ビルドスクリプトの生成
  • ログ

設定パラメタの移行

設計ガイドラインより、マイグレーションツールは JDBC データソースのみを移行します。アプリケーションサーバインストールの設定パラメタを上書きすることはありません。この設計により、アプリケーションサーバのシステム管理者がおこなった設定を守っています。したがって、もととなるアプリケーションサーバの設定パラメタを下記の移行方法に分類しています。

  • アプリケーションサーバに移行されるパラメタ。(Migrated)
  • アプリケーションサーバに相当するパラメタがないため移行できないパラメタ。(Cannot Be Migrated)
  • アプリケーションサーバに移行されるべきでないパラメタ。マイグレーションツールは、システム管理者の判断を塗り替えるべきではありません。(Should Not Be Migrated)
  • 製品特有 (WL_HOME, インストールディレクトリ、など) のため、アプリケーションサーバに移行する必要のないパラメタ。(Need Not Be Migrated)
  • アプリケーションサーバに移行されないパラメタ。(Cannot Be Migrated)

以下の表に、もととなる各アプリケーションサーバでのマイグレーションツールの対応状況を一覧します。

Table 6-1 WAS 4.0 設定パラメタの移行

Category Item Description File Migration Resolution  
<virtualHosts> Application server installation and application directory information server-cfg.xml Need Not Be Migrated  
<factories> JDBC Datasource/Connection pool server-cfg.xml Migrated  
<resourceProviders xmi:type="resources:JDBCDriver"> JDBC Driver server-cfg.xml Migrated  
<resourceProviders xmi:type="resources:URLProvider"> URL provider settings server-cfg.xml Cannot Be Migrated  
<resourceProviders xmi:type="resources:MailProvider"> Mail provider settings server-cfg.xml Cannot Be Migrated  
<defaultMimeEntries xmi:id="resources:MimeEntry> MIME types server-cfg.xml Need Not Be Migrated  
<threadPool xmi:id="ThreadPool" Parameters for thread connection. server-cfg.xml Migrated  
<ejbContainer xmi:id="EJBContainer" EJB component parameters server-cfg.xml Need Not Be Migrated  
<transactionService xmi:id="TransactionService"> Parameters for Transaction Manager logs server-cfg.xml Need Not Be Migrated  
<traceService xmi:id="TraceServiceConfig"> Trace service server-cfg.xml Cannot Be Migrated  
<namingServiceSettings xmi:id="NamingServiceProvider"> Name service settings server-cfg.xml Need Not Be Migrated  
<security xmi:id="Security"> Security server-cfg.xml Should Not Be Migrated  
<jvmSettings> JVM settings server-cfg.xml Need Not Be Migrated  
<performanceMonitoring> Performance settings server-cfg.xml Should Not Be Migrated  
<objectLevelTraceSettings> Object level tracing server-cfg.xml Need Not Be Migrated  
<sessionManager> Session management server-cfg.xml Should Not Be Migrated  
<tuningParams> Tuning settings server-cfg.xml Should Not Be Migrated  
<installedApps> Installed applications on the application server server-cfg.xml Need Not Be Migrated  
logging.properties file Logging Parameters logging.properties Need Not Be Migrated  
<entries symbolicName="APP_INSTALL"> Application server root directory server-cfg.xml Need Not Be Migrated  
<entries symbolicName="LOG_ROOT"> Log file root directory server-cfg.xml Need Not Be Migrated  
<entries symbolicName="TRANLOG_ROOT"> Transaction root directory server-cfg.xml Need Not Be Migrated  
<entries symbolicName="WAS_ROOT"> Server root server-cfg.xml Need Not Be Migrated  
<entries symbolicName="JAVA_HOME"> Java Home server-cfg.xml Need Not Be Migrated  
<Log name=""> Log File Name plugin-cfg.xml Cannot Be Migrated  
<Transport> ServerGroup plugin-cfg.xml Cannot Be Migrated  
<VirtualHostGroup> Virtual Host group plugin-cfg.xml Cannot Be Migrated  
<UriGroup> URI Group plugin-cfg.xml Cannot Be Migrated  
<Route> Route plugin-cfg.xml Cannot Be Migrated  

Table 6-2 WLS 5.1 設定パラメタの移行

Parameter Name Item Description File Migration Resolution  
weblogic.password.system System user ID and password weblogic.properties Need Not Be Migrated  
weblogic.httpd.enable =booleanValue To enable HTTP Server weblogic.properties Cannot Be Migrated  
weblogic.cluster.ClusterRelatedProperties Configuring a cluster weblogic.properties Should Not Be Migrated  
weblogic.home =WebLogic installation directory WebLogic home weblogic.properties Need Not Be Migrated  
weblogic.password.username =password weblogic.security.group.groupname =usernames Setting up users and groups weblogic.properties Should Not Be Migrated  
weblogic.system.listenPort =integer Setting up WebLogic's listen port weblogic.properties Need Not Be Migrated  
weblogic.system.bindAddr =IPaddress or hostname Setting up multihoming weblogic.properties Cannot Be Migrated  
weblogic.system.maxLogFileSize =sizeOfFileInKÂ Configuring the log file weblogic.properties Cannot Be Migrated  
weblogic.administrator.ContactDetails Identifying the administrator weblogic.properties Cannot Be Migrated  
weblogic.system.executeThreadCount =integer Performance-related properties weblogic.properties Migrated  
weblogic.system.startupClass(shutdownClass). virtualName =fullPackageName Registering startup and shutdown classes weblogic.properties Migrated  
weblogic.system.disableWeblogicClassPath =boolean Disabling dynamic classloading weblogic.properties Cannot Be Migrated  
weblogic.httpd.webApp.context =WebAppLocation Deploying web applications on WebLogic - Support via Ant build script generation weblogic.properties Indirect Migration  
weblogic.httpd.enableLogFile =boolean Enabling the access log weblogic.properties Need Not Be Migrated  
weblogic.httpd.enableEvents =boolean Tracking HTTPD requests with events weblogic.properties Cannot Be Migrated  
weblogic.httpd.register.virtualName =fullPackageName Registering the WebLogic Servlets weblogic.properties Cannot Be Migrated  
weblogic.httpd.documentRoot =path to directory Setting up the document root weblogic.properties Need Not Be Migrated  
weblogic.httpd.mimeType.standardMIMEType =extension Setting up standard MIME types weblogic.properties Cannot Be Migrated  
weblogic.httpd.register.virtualName =fullPackageName Registering user-written Servlets weblogic.properties Cannot Be Migrated  
weblogic.httpd.initargs.virtualName =nameValuePairs Setting initialization arguments for user-written Servlets weblogic.properties Cannot Be Migrated  
weblogic.httpd.postTimeoutSecs =integer Setting the timeout value for reading HTTP POST data weblogic.properties Cannot Be Migrated  
weblogic.httpd.errorPage.number =URL Configuring HTTP error pages weblogic.properties Cannot Be Migrated  
weblogic.httpd.servlet.lowercaseExtension Controlling Case Sensitivity weblogic.properties Cannot Be Migrated  
weblogic.httpd.register.*.jhtml =args Setting up WebLogic JHTML weblogic.properties Cannot Be Migrated  
weblogic.httpd.register.*.jsp =args Setting up WebLogic JSP weblogic.properties Cannot Be Migrated  
weblogic.httpd.register.cgi-bin Setting up CGI weblogic.properties Cannot Be Migrated  
weblogic.httpd.session. SessionRelatedProperties HTTP session tracking (WebLogic HTTP Servlets) weblogic.properties Cannot Be Migrated  
weblogic.httpd.defaultServlets =virtualName Setting a default Servlets weblogic.properties Cannot Be Migrated  
weblogic.httpd.authRealmName =string Setting an authentication realm name weblogic.properties Cannot Be Migrated  
weblogic.httpd.register.proxy Setting up WebLogic to proxy requests weblogic.properties Cannot Be Migrated  
weblogic.httpd.servlet.classpath =path Using the Servlets classpath weblogic.properties Cannot Be Migrated  
weblogic.httpd.http.keepAliveSecs =integer Configuring persistent HTTP connections weblogic.properties Cannot Be Migrated  
weblogic.httpd.tunneling.TunnelingProperties =integer HTTP Tunneling properties weblogic.properties Cannot Be Migrated  
weblogic.system.enableReverseDNSLookups =boolean Tracking client use with WebLogic Events weblogic.properties Need Not Be Migrated  
weblogic.login.readTimeoutMillis =integer Setting client timeout weblogic.properties Cannot Be Migrated  
weblogic.io.fileSystem.virtualName =fullpath Client read/write access (WebLogic File services) weblogic.properties Cannot Be Migrated  
weblogic.jms.connectionPool =args WebLogic JMS weblogic.properties Need Not Be Migrated  
weblogic.jndi.transportableObjectFactories WebLogic JNDI weblogic.properties Need Not Be Migrated  
weblogic.system.startupClass.name =packageName Remote invocation (WebLogic RMI services) weblogic.properties Need Not Be Migrated  
weblogic.iiop.user =userIdentity RMI over IIOP (WebLogic RMI over IIOP services) weblogic.properties Need Not Be Migrated  
weblogic.allow.permission.ACLname ACLs in the default WebLogic realm (WebLogic ACLs) weblogic.properties Cannot Be Migrated  
weblogic.security.urlAclFile =userlist Setting ACLs on URLs weblogic.properties Cannot Be Migrated  
weblogic.security.SSLRelatedProperties Secure communications via SSL (WebLogic SSL) weblogic.properties Cannot Be Migrated  
weblogic.jdbc.JDBCRelatedProperties Logging JDBC messages (WebLogic/JDBC) weblogic.properties Cannot Be Migrated  
weblogic.jdbc.connectionPool.virtualName =args JDBC connection pools (WebLogic/JDBC) weblogic.properties Migrated.  
weblogic.jdbc.DataSource.jdbc.virtualName =poolName JDBC Datasource weblogic.properties Migrated.  
weblogic.ejb.deploy =fullPathName Enterprise JavaBeans (WebLogic EJB) weblogic.properties Need Not Be Migrated  
weblogic.zac.ZACRelatedProperties Zero Administration Client (ZAC) weblogic.properties Cannot Be Migrated  
PATHS Setting Classpath setEnv.sh Need Not Be Migrated  
PATHS Setting Application Server home directory setEnv.sh Need Not Be Migrated  
PATHS Setting Java Home startWeblogic.sh Need Not Be Migrated  
PATHS Setting classpath startWeblogic.sh Need Not Be Migrated  
PATHS Setting and starting JRE startWeblogic.sh Need Not Be Migrated  

Table 6-3 WLS 6.0/6.1 設定パラメタの移行

Parameter Name Item Description File Migration Resolution  
Server System-specific information config.xml Need Not Be Migrated  
CustomRealm Setting an custom realm config.xml Cannot Be Migrated  
JDBCDataSource JDBC DataSource config.xml Migrated  
StartupClass Registering startup classes config.xml Migrated  
ShutdownClass Registering shutdown classes config.xml Migrated  
JDBCConnectionPool JDBC connection pools (WebLogic/JDBC) config.xml Migrated  
SNMPAgent Configuring SNMP settings config.xml Cannot Be Migrated  
Application Specific application (EAR, WAR) settings config.xml Cannot Be Migrated  

Table 6-4 Jboss 3.0 設定パラメタの移行

Parameter Name Item Description File Migration Resolution  
JDBCDataSource JDBC DataSource *-service.xml Migrated  
JDBCConnectionPool JDBC connection pools *-service.xml Migrated  
DriverType Database Driver Names with associated class and classpath *-service.xml Migrated  
BootstrapEditors Property Editors *-service.xml Cannot Be Migrated  
Properties System Properties *-service.xml Cannot Be Migrated  
ConfigurationURL Log4j Initialization *-service.xml Cannot Be Migrated  
DownloadServerClasses Class Loading *-service.xml Cannot Be Migrated  

Table 6-5 Sun ONE Application Server 6.x 設定パラメタの移行

Parameter Name Item Description File Migration Resolution  
Admin System specific Information Registry Need Not Be Migrated  
DataSource JDBC DataSource Registry Migrated  
CCS0 Various configuration settings Registry Cannot Be Migrated  
IASAT Setting Sun ONE Application Server Administration Tool settings Registry Cannot Be Migrated  
LOGGING Configuring authentication settings Registry Cannot Be Migrated  
Deployment Setting JAR path Registry Need Not Be Migrated  
J2EE-Module Setting custom settings Registry Cannot Be Migrated  
J2EE-Application Specific application (EAR, WAR) settings Registry Cannot Be Migrated  

Table 6-6 J2EE Reference Implementation 1.3 設定パラメタの移行

Parameter Name Item Description File Migration Resolution  
jdbcDataSource JDBC DataSource resource.properties Migrated  
jdbcXADataSource XA (Transaction Managed) DataSource resource.properties Cannot Be Migrated  
jmsCnxFactory JMS settings resource.properties Cannot Be Migrated  
jmsDestination JMS settings resource.properties Cannot Be Migrated  

Table 6-7 J2EE Reference Implementation 1.4 Beta 1 設定パラメタの移行

Parameter Name Item Description File Migration Resolution  
jdbc-resource JDBC DataSource server-config.xml Migrated  
jms-resource JMS settings server-config.xml Migrated  
jdbc-connection-pool JDBC connection pools server-config.xml Migrated  
connector-resource Connector Resources server-config.xml Cannot Be Migrated  
applications Specific application (EAR, WAR) settings server-config.xml Cannot Be Migrated  

配備記述子 (DD) の移行

マイグレーションツールはアプリケーションサーバ固有の配備記述子をもとのサーバから移行します。

WAS 4.0 からの配備記述子の移行

下記 WebSphere 固有の配備記述子ファイルがサポートされます:

  • ejb-jar.xml (server-independent DD, required for converting other WebSphere-specific DDs)
  • ibm-ejb-jar-bnd.xmi (contains JNDI bindings of EJB components)
  • ibm-ejb-jar-ext.xmi (server-specific information about the EJB components such as session timeout)
  • Map.mapxmi (if CMP EJB components contain mappings of CMP fields to Database columns)
  • Schema.dbxmi (if CMP EJB components contain mappings of database schema)
  • web.xml (server-independent DD, required for converting other WebSphere specific DDs)
  • ibm-web-bnd.xmi (used for binding JNDI names to the Environment Naming Context of Servlets/JSPs declared in the web.xml file
  • ibm-web-ext.xmi (contains the error message to be displayed to the user in case a component of the web application fails.)
    アプリケーションサーバ固有の配備記述子を生成するために、上記ファイルの関連する情報を利用します:
  • ejb-jar.xml (remains the same for the Application Server)
  • sun-ejb-jar.xml
  • sun-cmp-mappings.xml (contains information about CMP entity beans; its name is specified in sun-ejb-jar.xml)
  • web.xml (remains the same for the Application Server)
  • sun-web.xml

WLS 5.1 からの配備記述子の移行

下記 WebLogic 固有の配備記述子ファイルがサポートされます:

  • ejb-jar.xml (server-independent DD, required for converting other WebLogic-specific DDs)
  • weblogic-ejb-jar.xml (mapping of the properties declared in the ejb-jar.xml to the server specific properties)
  • weblogic-rdbms-persistence.xml (contains information about CMP entity beans; its name is specified in weblogic-ejb-jar.xml)
  • web.xml (server-independent DD, required for converting to other WebLogic-specific DDs)
  • weblogic.xml (mapping to the server-specific of properties declared in the web.xml DD)
    アプリケーションサーバ固有の配備記述子を生成するために、上記ファイルの関連する情報を利用します:
  • ejb-jar.xml (remains the same for the application server)
  • sun-ejb-jar.xml
  • sun-cmp-mappings.xml (contains information about CMP entity beans; its name is specified in sun-ejb-jar.xml)
  • web.xml (remains the same for the application server)
  • sun-web.xml

WLS 6.0/6.1 からの配備記述子の移行

下記 WebLogic 固有の配備記述子ファイルがサポートされます:

  • ejb-jar.xml (server-independent DD, required for converting other WebLogic-specific DDs)
  • weblogic-ejb-jar.xml (mapping of the properties declared in the ejb-jar.xml to the server specific properties)
  • weblogic-rdbms-persistence.xml (contains information about CMP entity beans; its name is specified in weblogic-ejb-jar.xml)
  • web.xml (server-independent DD, required for converting to other WebLogic-specific DDs)
  • weblogic.xml (mapping to the server-specific of properties declared in the web.xml DD)
    アプリケーションサーバ固有の配備記述子を生成するために、上記ファイルの関連する情報を利用します:
  • ejb-jar.xml (remains the same for the Application Server)
  • sun-ejb-jar.xml
  • sun-cmp-mappings.xml (contains information about CMP entity beans; its name is specified in sun-ejb-jar.xml)
  • web.xml (remains the same for the Application Server)
  • sun-web.xml

J2EE Reference Implementation (RI) 1.3 からの配備記述子の移行

下記 RI 固有の配備記述子ファイルがサポートされます:

  • ejb-jar.xml (server-independent DD, required for converting other RI specific DDs)
  • sun-j2ee-ri.xml (mapping of the properties declared in the ejb-jar.xml to the server specific properties)
  • web.xml (server-independent DD, required for converting to other RI specific DDs)
    アプリケーションサーバ固有の配備記述子を生成するために、上記ファイルの関連する情報を利用します:
  • ejb-jar.xml (remains the same for the Application Server)
  • sun-ejb-jar.xml
  • sun-cmp-mappings.xml (contains information about CMP entity beans; its name is specified in sun-ejb-jar.xml)
  • web.xml (remains the same for the application server)
  • sun-web.xml

J2EE Reference Implementation (RI) 1.4 Beta 1 からの配備記述子の移行

下記 RI 固有の配備記述子ファイルがサポートされます:

  • ejb-jar.xml (server-independent DD, required for converting other RI specific DDs)
  • sun-j2ee-ri.xml (mapping of the properties declared in the ejb-jar.xml to the server specific properties)
  • web.xml (server-independent DD, required for converting to other RI specific DDs)
  • application.xml (server-independent DD, required for converting to other RI specific DDs)
    アプリケーションサーバ固有の配備記述子を生成するために、上記ファイルの関連する情報を利用します:
  • ejb-jar.xml (remains the same for the Application Server)
  • sun-ejb-jar.xml
  • sun-cmp-mappings.xml (contains information about CMP entity beans; its name is specified in sun-ejb-jar.xml)
  • web.xml (remains the same for the Application Server)
  • sun-web.xml
  • application.xml (remains the same for the Application Server)
  • sun-application.xml

JBoss 3.0 からの配備記述子の移行

下記 JBoss 固有の配備記述子ファイルがサポートされます:

  • ejb-jar.xml (server-independent DD, required for converting other JBoss specific DDs)
  • jboss.xml (mapping of the properties declared in the ejb-jar.xml to the server specific properties)
  • jbosscmp-jdbc.xml (contains information about CMP entity beans)
  • web.xml (server-independent DD, required for converting to other JBoss specific DDs)
  • jboss-web.xml (mapping of the properties declared in the web.xml DD)
    アプリケーションサーバ固有の配備記述子を生成するために、上記ファイルの関連する情報を利用します:
  • ejb-jar.xml (remains the same for the Application Server)
  • sun-ejb-jar.xml
  • sun-cmp-mappings.xml (contains information about CMP entity beans; its name is specified in sun-ejb-jar.xml)
  • web.xml (remains the same for the Application Server)
  • {{sun-web.xml}}Note -
    マイグレーションツールがもとの配備記述子の移行処理中、移行先の配備記述子ファイルに必要な情報がないことがあります。この様な場合には、移行先配備記述子ファイル中には「REPLACEME」を出力し、
    <ASMT_HOME>/log/ASMTUser.log に報告します。

カスタム JSP タグの実装

サポートされる JSP カスタムタグを以下にリストします:

WAS 4.0 のサポートされるカスタム JSP タグ

WAS 4.0 にバンドルされる全てのカスタム JSP タグはサポートされています。ただし、<tsx:getProperty> はデータベース操作に関してサポートされますが、Bean 操作に関してはサポートされません。

Extension Category Custom JSP Tag Coverage  
Tags for Database access <tsx:dbconnect> Supported  
Tags for Database access <tsx:passwd> Supported  
Tags for Database access <tsx:dbquery> Supported  
Tags for Database access <tsx:dbmodify> Supported  
Tags for Database access <tsx:userid> Supported  
Tags for variable data <tsx:repeat> Supported  
Tags for variable data <tsx:getProperty> Partially supported, database operations supported, beans operations unsupported  

WLS 5.1 のサポートされるカスタム JSP タグ

WLS 5.1 にバンドルされる全てのカスタム JSP タグはサポートされています。ただし、<wl:cache> は no-op として実装されており、サポートされません。

Extension Category Custom JSP Tag Coverage  
Caching JSP output <wl:cache> Partially supported, implements a no-operation  
Parameter based flow control <wl:process> Supported  
Loop construct <wl:repeat> Supported  

Sun ONE Application Server 6.5 のサポートされるカスタム JSP タグ

Sun ONE Application Server 6.5 にバンドルされる全てのカスタム JSP タグはサポートされています。

Extension Category Custom JSP Tag Coverage  
Parameter <ias65:getParameter> Supported  
Parameter <ias65:set> Supported  
Parameter <ias65:get> Supported  

WLS 6.0/6.1 のサポートされるカスタム JSP タグ

WLS 6.1 にバンドルされる全てのカスタム JSP タグはサポートされています。 ただし、 <wl:prefetch> と <wl:beanparam> はサポートされません。

Extension Category Custom JSP Tag Coverage  
Caching JSP output <wl:cache> Partially Supported, does not implement cluster scope and administration of cache.  
Tag for input validation <wl:summary> Supported  
Tag for input validation <wl:form> Supported  
Tag for input validation <wl:validator> Supported  
Tag for database <wl:query> Supported  
Encode tag <wl:encode> Supported  
Anchor tag <wl:formanchor> Supported  
No output tag <wl:nooutput> Supported  
Include tag <wl:include> Supported  

プロプライエタリ API の実装

マイグレーションツールの本バージョンは、一部のプロプライエタリな API のみサポートします。

Table 6-8 サポートされる WAS 4.0 プロプライエタリ API

Package Coverage  
com.ibm.websphere.advanced.cm.factory Supported  
com.ibm.websphere.servlet.session Supported  
com.ibm.websphere.servlet.filter Supported  
com.ibm.websphere.servlet.cache Supported, except for two interfaces CacheEntry and ServletsCacheRequest  
com.ibm.websphere.servlet.error Supported  
com.ibm.websphere.servlet.response Supported  
com.ibm.websphere.servlet.request Supported  
com.ibm.websphere.exception Supported  

Table 6-9 サポートされる WLS 5.1 プロプライエタリ API

Package Coverage  
weblogic.common (t3 services) Only Timer and Scheduler services supported  
weblogic.time.common Supported  
weblogic.db.jdbc.oracle Supported  
weblogic.rmi Supported  
weblogic.rmi.dgc Supported  
weblogic.rmi.registry Supported  
weblogic.rmi.Remote Supported  
weblogic.rmi.server Supported  
weblogic.db.jdbc Supported, except for EventFulRecord and EventFulTableDataSet classes  
weblogic.jndi Only WLInitialContextFactory supported for supporting Times and Scheduler Services  

Table 6-10 サポートされる WLS 6.0/6.1 プロプライエタリ API

Package Coverage  
weblogic.common (t3 services) Only Timer and Scheduler services supported  
weblogic.rmi Supported  
weblogic.rmi.dgc Supported  
weblogic.rmi.registry Supported  
weblogic.rmi.Remote Supported  
weblogic.rmi.server Supported  
weblogic.db.jdbc Supported, except for Column, DataSet, QueryDataSet, Schema, TableDataSet, EventFulRecord and EventFulTableDataSet classes  
weblogic.jndi Only WLInitialContextFactory supported for supporting Times and Scheduler Services  

上記アプリケーションサーバの現在サポートされていないAPI についても、サポートするようマイグレーションツールを拡張する事が可能です。

IDE との統合

マイグレーションツールの本バージョンは下記 IDE との統合をサポートします:

  • Sun ONE Studio Enterprise/Community Edition 3.0 / 4.0
  • Borland JBuilder IDE, Version 6.0

ビルドスクリプトの生成

移行するアプリケーションをコンパイル、パッケージするのに利用する Ant ベースのスクリプトを、マイグレーションツールは自動で生成します。Ant はクロスプラットフォームソフトウェア開発を単純化するために多くの企業で利用されているオープンソース Java プロジェクトです。マイグレーションツールは Solaris と Windows 向けに 3 タイプのスクリプトを生成します。

  • build_jar.sh / build_jar.cmd
  • build_war.sh / build_war.cmd
  • build_ear.sh / build_ear.cmd
    これらヘルパースクリプトは対応する XML (build_jar.xml, build_war.xml, build_ear.xml) ビルドスクリプトで Ant を起動します。
    これら Ant スクリプトは以下の想定のもと生成されます:
  • build_jar スクリプトは実行されると EJB とその他リソース (ヘルパークラスなど) をパッケージした、配備可能な jar を生成します。このスクリプトは以下を実行します:

javac で全クラスをコンパイルします。
Ant jar タスクで、全クラスと EJB に含まれる XML DD を含む JAR を生成します。,

  • build_war は実行されると、サーブレット、JSP その他リソースを含む配備可能な WAR を生成します。そのために、スクリプトは次の処理をおこないます:

javac で WAR に含まれる全クラスをコンパイルします。
Ant war タスクで, WAR に必要な全リソースと XML DD を含む WAR を生成します。,

  • build_ear スクリプトは実行されると前のステップで生成された JAR と WAR を含む EAR を生成します。

クラスファイルのバンドル

入力のアプリケーションが .class ファイルのみを含む場合、生成されたビルドスクリプトはコンパイルはせずに、移行された配備記述子と共にクラスファイルをパッケージします。
入力アプリケーションがクラスファイルと共に Java ソースファイルも含む場合は、生成されたビルドスクリプトは javac Ant ターゲットを利用し、オリジナルのクラスではなく、コンパイルされたクラスをパッケージします。この点については、 制限事項 セクションで詳細に解説しています。

ログ

マイグレーションツールはデバッグおよびユーザログ情報を生成します。これらのログは
<INSTALL_DIR>\asmt\logs ディレクトリにあり、ASMTDebug.log, ASMTUser.log という名前のファイルです。
ASMTDebug.log はマイグレーション中に生成されるデバッグ情報を含みます。このログはエラーや予期しない挙動をトレースできるようにするためのものなので、開発者がマイグレーションの流れを追跡するのにこの情報が役立つでしょう。ユーザにこのログは理解されないかも知れませんが、バグや予期しない挙動を報告する際にこのログを添付することは重要です。
ASMTUser.logASMTDebug.log にかなりフィルターをかけたものです。マイグレーションに固有の、ユーザが興味をもつ情報を含むこのログは、マイグレーション中に何がおこなわれたかを示します。例えば、配備記述子を移行する際、マイグレーションツールが、ある配備記述子がその DTD に合っていないことを見つけるとします。この様な場合には、マイグレーションツールは配備記述子を必要に応じて更新しつつ、ASMTUser.log ファイルを使ってファイルを更新したことをユーザに通知します。この通知の他、ログファイルは、ビルドスクリプトの生成、ビルドプロセスの自動生成、例外の短い説明、などの情報を含んでいます。バグや、予期しない挙動を報告する際には、このログを提供して下さい。

戻る 進む


日本語翻訳: ogino

英文 (翻訳したバージョン: 4)