WebSphere 调优文档.docx

线程池设置使用此页面来配置应用程序服务器使用的线程池。线程池使服务器的组件能够重复使用线程，从而不必在运行时创建新线程。创建新的线程将耗费时间和资源。要查看此管理控制台页面，可以选择多个导航路径。例如，单击服务器 应用程序服务器 server_name 线程池，然后选择需要配置的线程池。要为 ORB 服务配置线程池，请单击服务器 应用程序服务器 server_name 容器服务 ORB 服务。然后，在“线程池设置”下面，执行下列任何一个操作： 选择“使用与线程池管理器相关联的 ORB 线程池设置（推荐）”，然后单击 ORB 线程池设置 选择“使用与 ORB 服务直接相关的线程池设置”，然后单击线程池设置。注： 由于这些控制台面板动态地显示信息，因此，并不是在所有特定面板上都能看到全部这些字段。配置选项卡名称 要创建的线程池的名称。此名称在服务器中必须唯一。如果单击线程池设置，那么不会显示此字段。数据类型字符串描述 线程池的文本描述。如果单击线程池设置，那么不会显示此字段。数据类型字符串最小大小 指定池中允许的最小线程数。应用程序服务器启动时，一开始未对线程池指定任何线程。线程将添加至线程池，原因是分配给应用程序服务器的工作负载需要它们，直到池中的线程数等于在“最小大小”字段中指定的数字。此时间点后，当工作负载更改时会添加和除去其他线程。但是，池中的线程数永远不会降至“最小大小”字段中指定的数字之下，即使某些线程空闲。如果单击线程池设置，那么不会显示此字段。数据类型整型缺省值10最大大小 指定要在缺省线程池中维护的最大线程数。如果 Tivoli Performance Viewer 显示最大百分比度量值以始终保持在双精度数字，那么考虑增加最大大小。最大百分比度量值表明使用已配置线程的时间量。数据类型整型缺省值50建议50（Linux 系统上 25 个）线程不活动超时 指定在收回线程之前应该经过的不活动的毫秒数。为 0 的值表明不等待而负值（小于 0）意味着永远等待。注： 管理控制台不允许您将不活动超时设置为负数。要执行该操作，您必须直接在 server.xml 文件中修改值。数据类型整型单位毫秒缺省值3500允许线程分配超过最大线程大小 指定线程数是否能增加到超出为线程池配置的最大大小。可以创建的最大线程数仅受 Java 虚拟机和操作系统限制。当允许增长的线程池超出最大大小后，不会重复使用其他线程，并且在处理完使用这些线程的工作项后，就会从池中废弃这些线程。创建其他线程时，会在系统日志文件中记录一条消息以指示已超出为线程池设置的最大大小。数据类型布尔值缺省值未启用（false）连接池设置使用此页面来配置连接池设置。此管理控制台页面是一系列资源类型（例如 JDBC 数据源和 JMS 队列连接工厂）的通用页面。要查看此页面，根据资源的类型决定路径，但通常选择资源提供程序的实例，然后选择资源类型的实例，并单击连接池。例如，单击 资源 JDBC JDBC 提供程序 JDBC_provider 数据源 data_source 连接池。JMS 队列连接工厂的路径是： 资源 JMS JMS 提供程序 缺省消息传递 JMS 队列连接工厂 JMS_queue_connection_factory 连接池属性。配置选项卡连接超时 指定时间间隔（以秒计），这个时间间隔过后连接请求超时并抛出 ConnectionWaitTimeoutException。此值表明空闲池中没有可用连接或无法创建新连接（通常这是因为特定连接池中的连接数达到了最大值）时，请求连接所等待的秒数。例如，如果连接超时设置为 300，并且最大连接数都在使用，那么池管理器等待 300 秒以使物理连接可供使用。如果物理连接在这段时间内不可用，那么池管理器将产生 ConnectionWaitTimeout 异常。通常，重试 getConnection() 方法没有用；如果需要更长的等待时间，您应该增加连接超时设置值。如果应用程序捕捉到 ConnectionWaitTimeout 异常，那么管理员应该查看需要的应用程序连接池用法，并相应地调整连接池和数据库。如果连接超时设置为 0，那么在连接可用之前，只要需要池管理器将一直等下去。此情况发生在应用程序完成事务并将连接返回到池的时候，或发生在连接数降到最大连接值之下（允许创建新的物理连接）的时候。如果最大连接数设置为 0（允许无限多个物理连接数），那么将忽略连接超时值。数据类型整型单位秒缺省值180范围0 到最大整数最大连接数 指定您可以在此池中创建的最大物理连接数。这些是到后端资源的物理连接。一旦达到此数，便不再创建新的物理连接，并且在当前使用的物理连接返回池或抛出 ConnectionWaitTimeoutException 之前，请求者会一直等待。例如，如果最大连接值设置为 5，并已使用了 5 个物理连接，那么池管理器等待连接超时中指定的时间，直至物理连接为空闲。了解可能向后端（如 DB2 数据库或 CICS 服务器）请求连接的连接池数目可帮助您确定“最大连接数”属性的值。对于使用同一数据源配置的多个独立应用程序服务器或 J2C 连接工厂配置，每个服务器都有单独的物理连接池。如果克隆相同的应用程序服务器，那么 WebSphere Application Server 会为每个克隆实现单独的连接池。所有这些连接池对应于同一数据源或连接工厂配置。因此所有这些连接池都可能同时向同一后端资源请求连接。在此控制台面板上设置的单个“最大连接”值将应用于每个连接池。因此，设置较高的“最大连接值”可能导致连接请求过多从而使后端资源严重不足。数据类型整型缺省值10范围0 至最大整数 如果最大连接数设置为 0，那么忽略连接超时值。提示： 要获得更好的性能，将连接池的值设置为小于 Web 容器中最大连接数的值选项。越小的设置（如 10-30 个连接），性能比越高的设置（如 100）更好。 您可使用 Tivoli Performance Viewer 查找池中最优连接数。如果并发等待者的数目大于 0，但是 CPU 负载未接近 100%，那么考虑增加连接池大小。如果使用百分比值一直低于正常工作负载，那么考虑减少池中的连接数。最小连接数 指定要保持的最小物理连接数。如果连接池的大小处于最小连接池大小或比它还小，那么未使用超时线程不废弃物理连接。但是，池不会只为了确保维持最小连接池大小而创建连接。同样，如果您设置时效超时值，那么废弃时效到期的连接，而无论最小池大小设置是什么。例如，如果最小连接数值设置为 3，并且已创建了一个物理连接，那么“未使用超时”线程不废弃该连接。同样的原因，线程不自动创建达到最小连接数设置的两个其他物理连接。数据类型整型缺省值1范围0 到最大整数收集时间 指定运行池维护线程之间的时间间隔（以秒计）。例如，如果“收集时间”设置为 60，那么池维护线程每 60 秒运行一次。此收集时间的时间间隔影响“未使用超时”和“时效超时”设置的准确度。时间间隔越小，准确度越大。如果启用了池维护线程，那么您应该将“收集时间”值设置为小于“未使用超时”和“时效超时”的值。当池维护线程运行时，它废弃所有未使用的时间长于“未使用超时”中指定的时间值的连接，直到它达到“最小连接数”中指定的连接数为止。池维护线程还废弃所有活动时间长于“时效超时”中指定的时间值的连接。收集时间间隔还影响性能。更短的时间间隔意味着池维护线程将更频繁的运行并降低性能。要禁用池维护线程，“收集时间”设置为 0，或“未使用超时”和“时效超时”都设置为 0。禁用池维护线程的建议方法是将“收集时间”设置为 0，在这种情况下，将忽略“未使用超时”和“时效超时”。但是，如果“未使用超时”和“时效超时”都设置为 0，那么池维护线程将运行，但是仅废弃由于非零超时值引起的超时的物理连接。数据类型整型单位秒缺省值180范围0 到最大整数未使用超时 指定废弃未使用的或空闲连接后的时间间隔，以秒为单位。为了优化性能，设置“未使用超时”值高于“收集超时”值。如果当前连接数超过最小连接数设置，那么仅废弃未使用的物理连接。例如，如果未使用超时值设置为 120，并且启用池维护线程（收集时间不是 0），那么将废弃两分钟没有使用的任何物理连接。此超时的精度和性能受“收集时间”值影响。请参阅收集时间，以了解更多信息。数据类型整型单位秒缺省值1800范围0 到最大整数时效超时 指定废弃物理连接前的时间间隔（以秒计）。将“时效超时”设置为 0 支持活动的物理连接无限期地保留在池中。为了优化性能，设置“时效超时”值高于“收集超时”值。例如，如果“时效超时”值设置为 1200，并且“收集时间”值不是 0，那么从池中废弃已经存在 1200 秒（20 分钟）的所有物理连接。唯一的例外情况是：如果达到时效超时后该连接正被某个事务使用，那么应用程序服务器将不会废弃该连接，直到事务完成且连接关闭后为止。此超时的精度和性能受“收集时间”值影响。请参阅收集时间，以了解更多信息。数据类型整型单位秒缺省值0范围0 到最大整数清除策略 指定检测到失效连接或致命连接错误时如何清除连接。有效值是 EntirePool 和 FailingConnectionOnly。数据类型字符串缺省值 EntirePool，用于 J2C 连接工厂和与 JMS 有关的连接工厂 EntirePool，用于 WebSphere V4.0 数据源 EntirePool，用于通过管理控制台创建的当前版本数据源 EntirePool，用于通过 wsadmin AdminConfig 命令进行脚本编制并且调用构建到 WebSphere Application Server 中的 JDBC 模板的当前版本数据源（有关 createUsingTemplate 命令的信息，请参阅信息中心中的“AdminConfig 对象的命令。”一文）。 FailingConnectionOnly，用于在 wsadmin 中进行脚本编制但未调用 JDBC 模板的数据源: 范围EntirePool 池中的所有连接都标记为失效。立即关闭任何未使用的连接。关闭在使用的连接并在该连接上执行下一个操作期间产生失效的连接异常。应用程序发出的后续 getConnection() 请求会导致打开到数据库的新连接。使用此清除策略时，可能会不必要地关闭池中不是失效连接的一些连接。然而，这种情况不太可能会发生。在多数情况下，EntirePool 的清除策略是最佳选项。FailingConnectionOnly 仅关闭导致失效的连接异常的连接。虽然此设置消除不必要地关闭有效连接的可能性，但从应用程序角度看来，它使恢复更为复杂。因为仅关闭了当前失败的连接，因此极有可能的是，应用程序发出的下一个 getConnection() 请求从池中返回的连接可能也是失效的，这会导致产生更多失效的连接异常。 连接预测试功能尝试将应用程序与无效的合用的连接隔离。在后端资源（如数据库）停止时，空闲池中可能存在无效的合用的连接。尤其当清除策略为 failingConnectionOnly 时存在此情况；在这种情况下，将失败的连接从池中除去。由于此故障，池中剩余的连接也可能无效。数据源设置使用此页面来编辑数据源的属性。可以通过下面两种方法中的一种方法来访问此管理控制台页面： 资源 JDBC 数据源 data_source 资源 JDBC JDBC 提供程序 JDBC_provider 数据源 data_source 版本需求： 如果应用程序使用 Enterprise JavaBean（EJB）1.1 或 Java Servlet 2.2 模块，那么必须使用数据源（WebSphere Application Server V4） data_source 控制台页面。配置选项卡测试连接 激活测试连接服务，以便验证应用程序与数据源的连接。在单击测试连接之前，请设置数据源属性，然后单击应用。作用域 指定支持此数据源的 JDBC 提供程序的作用域。只有安装在此作用域内的应用程序才能使用此数据源。提供程序 指定 JDBC 提供程序，该 JDBC 提供程序封装了用于支持此数据源的驱动程序实现类。名称 指定数据源的显示名。此名称的有效字符包括字母和数字，但并不包含多数特殊字符。例如，您可将该字段设置为测试数据源。但任何以句点（）开头或包含特殊字符（ / , : ; * ? | = + & % ）的名称都不是有效名称。数据类型字符串JNDI 名称 指定 Java 命名和目录接口（JNDI）名称。分布式计算环境经常使用命名和目录服务来获取共享组件和资源。命名和目录服务将名称与位置、服务、信息和资源关联起来。命名服务提供名称到对象映射。目录服务提供对象的信息和查找那些对象所需的搜索工具。有很多命名和目录服务实现，它们的接口也各不相同。JNDI 提供用于访问各种命名和目录服务的公共接口。 例如，您可使用名称 jdbc/markSection。如果您将此字段保留为空白，那么将从数据源的名称生成一个 JNDI 名称。例如，markSection 的数据源名称生成 jdbc/markSection 的 JNDI 名称。设置此值后，将它保存并重新启动服务器，当您运行转储名称空间工具时，您可以看到此字符串。数据类型字符串容器管理的持久性 指定此数据源是否用于企业 bean 的容器管理的持久性。如果选取此字段，那么为关系资源适配器创建与此数据源相应的 CMP 连接器工厂。数据类型复选框缺省值启用（字段已选取。）描述 指定资源的文本描述。数据类型字符串类别 指定可用于分类或分组资源的类别字符串。数据类型字符串数据存储辅助控件类名 指定 DataStoreHelper 实现类的名称，该类可扩展您所选的 JDBC 驱动程序实现类的能力以执行数据库特定的功能。WebSphere Application Server 为每个它所支持的 JDBC 提供程序驱动程序提供一组 DataStoreHelper 实现类。这些实现类在包 com.ibm.websphere.rsadapter 中。例如，如果 JDBC 提供程序是 DB2，那么缺省 DataStoreHelper 类是 com.ibm.websphere.rsadapter.DB2DataStoreHelper。然而，您正在查看的管理控制台页面可能使多个 DataStoreHelper 类名在下拉列表中可用；确保选择一个您的数据库配置所需的类名。否则，您的应用程序可能不能正确地运行。如果您要使用不在下拉列表中显示的 DataStoreHelper，那么选择指定用户定义的 DataStoreHelper 并输入标准类名。请参阅信息中心主题“示例：开发您自己的 DataStoreHelper 类。”数据类型下拉列表或字符串（如果选择了用户定义的 DataStoreHelper）组件管理的认证别名 此别名用于运行时的数据库认证。仅当应用程序资源引用在使用 res-auth = Application 时才使用组件管理的认证别名。如果您的数据库（例如 Cloudscape）不支持用户标识和密码，那么不要在“组件管理的认证别名”字段或“容器管理的认证别名”字段中设置别名。否则，您在系统日志中会看到警告消息，表明用户和密码不是有效属性。（此消息仅为警告消息；创建数据源仍成功。）如果您未设置别名（组件管理的或其他），而您的数据库要求用户标识和密码获取连接，那么您在运行时期间接收到异常。 数据类型下拉列表用于 XA 恢复的认证别名 此可选字段用于指定应该在 XA 恢复处理期间使用的认证别名。如果资源适配器不支持 XA 事务，那么不会显示此字段。缺省值将来自所选的应用程序认证别名（如果指定）。使用组件管理的认证别名 选择此单选按钮指定在 XA 恢复时使用为组件管理的认证设置的别名。 数据类型单选按钮指定： 选择此单选按钮使您能从已配置别名的下拉列表中选择认证别名。 数据类型单选按钮容器管理的认证别名（建议不要使用） 为到资源的容器管理的登录指定认证数据（转换到用户标识和密码的字符串路径）。注： 从 WebSphere Application Server V6.0 开始，对于 res-auth=Container 的组件，容器管理的认证别名由部署时有关资源引用映射的登录配置规范取代。从列表中选择别名。要定义列表中未显示的新别名： 单击应用。在“相关项”下，您现在将看到 J2EE 连接器体系结构（J2C）认证数据条目列表。 单击 J2EE 连接器体系结构（J2C）认证数据条目。 单击新建。 定义别名。 单击确定。控制台现在显示别名集合页面。此页面包含一个表，该表列示了所有已配置的别名。在该表前面，此页面还显示了连接工厂的名称。 单击 J2C 连接工厂的名称。您现在看到连接工厂的配置页面。 在“容器管理的认证别名”列表中选择新别名。 单击应用。数据类型下拉列表映射配置别名（建议不要使用） 指定此连接工厂使用的 Java 认证和授权服务（JAAS）映射配置的认证别名。注： 从 WebSphere Application Server V6.0 开始，对于 res-auth=Container 的组件，映射配置别名由部署时有关资源引用映射的登录配置规范取代。单击安全性 安全管理、应用程序和基础结构 Java 认证和授权服务 应用程序登录，然后从表中选择别名。DefaultPrincipalMapping JAAS 配置将认证别名映射至用户标识和密码。您可定义和使用其他映射配置。数据类型下拉列表重要数据源属性 这些属性特定于与您所选的 JDBC 提供程序相关的数据源。它们是数据源所需的，或对于数据源特别有用。您可以在信息中心中的主题“特定于供应商的数据源最小必需设置”中找到所有支持的 JDBC 提供程序所需的完整属性列表。manageprofiles 命令manageprofiles 命令行工具创建所有应用程序服务器运行时环境。该命令创建概要文件，即定义 独立应用程序服务器的运行时环境的文件集合。manageprofiles 命令在称为概要文件的文件集中为 WebSphere Application Server 进程创建运行时环境。该概要文件定义运行时环境并包括运行时环境中服务器进程可以更改的所有文件。manageprofiles 命令及其图形用户界面概要管理工具是创建运行时环境的唯一方法。命令文件位于 app_server_root /bin 目录。命令文件是名为 manageprofiles 的脚本。要了解有关从何处运行此命令的更多信息，请参阅使用命令行工具。 注： 如果对受管概要文件模板使用此命令，那么未创建应用程序服务器。但是，如果您正在联合节点，那么仍然使用了端口。有关在 Microsoft Windows Vista 操作系统上运行 manageprofiles 命令的注意事项： 在 Microsoft Windows Vista 操作系统上安装 WebSphere Application Server V6.1 之后，在尝试使用 manageprofiles 命令来创建任何概要文件之前应安装一个包含 V 或更高版本的 service pack。 如果您正在 Microsoft Windows Vista 操作系统上运行 V 或更高版本，那么您必须在具备经过提升的管理员特权的情况下运行 manageprofiles 命令。 要在具备管理员特权的情况下运行 manageprofiles，请在命令提示符窗口中运行此命令，通过执行以下操作可以启动命令提示符窗口： o 右键单击“命令提示符”快捷方式。o 单击用管理员帐户运行。语法 manageprofiles 命令用来执行以下操作： 创建概要文件（-create） 删除概要信息（-delete） 扩充概要文件（-augment） 缩小概要文件（-unaugment） 删除所有概要文件（-deleteAll） 列出所有概要文件（-listProfiles） 获取概要文件名称（-getName） 获取概要文件路径（-getPath） 验证概要文件注册表（-validateRegistry） 验证并更新概要文件注册表（-validateAndUpdateRegistry） 获取缺省概要文件名称（-getDefaultName） 设置缺省概要文件名称（-setDefaultName） 备份概要文件（-backupProfile） 恢复概要文件（-restoreProfile）对于用 manageprofiles 命令完成的每个任务，要在包括必需参数时获取详细的帮助，请使用 -help 参数。以下示例说明在 Windows 操作系统上对 manageprofiles -augment 命令使用 help 参数：app_server_rootbinmanageprofiles.bat -augment -helphelp 命令的输出将指定哪些参数是必需的以及哪些参数是可选的。根据您要用 manageprofiles 命令执行的操作的不同，您将需要提供以下一个或多个参数。命令行概要管理工具验证是否提供了必需的参数以及对这些参数输入的值是否有效。因为命令行概要管理工具不会验证参数名称的大小写，所以一定要以正确的大小写输入参数的名称。如果输入的参数的大小写不正确，那么可能导致错误的结果。 -profileName profile_name -profilePath profile_root -templatePath template_path -nodeName node_name -cellName cell_name -hostName host_name -adminUserName adminUser_ID -adminPassword adminPassword -backupFile backupFile_name -debug -enableAdminSecurity true | false -isDefault -isDeveloperServer -omitAction feature1 feature2. featureN -response reponse_file -samplesPassword samplesPassword -startingPort starting_port | -portsFile file_path | -defaultPorts -validatePorts -webServerCheck true | false -webServerHostnamewebserver_host_name -webServerInstallPath webserver_installpath_name -webServerName webserver_name -webServerOS webserver_operating_system -webServerPluginPath webserver_plugin_path -webServerPort webserver_port -webServerType webserver_type -enableService true | false -serviceUserName service_user_ID -winserviceCheck true | false -winserviceAccountType specifieduser | localsystem -winservicePassword winservice_password -winserviceStartupType manual | automatic | disabled -winserviceUserName winservice_user_ID 以下示例说明在诸如 AIX 或 Linux 这样的操作系统上使用 manageprofiles -create 命令：app_server_root/bin/manageprofiles.sh -create -profileName profile_name -profilePath profile_root -templatePath template_path 参数 下列选项可用于 manageprofiles 命令：-adminUserName adminUser_ID 指定用于管理安全性的用户标识。-adminPassword adminPassword 为使用 -adminUserName 参数指定的管理安全性用户标识指定密码。-augment 使用 augment 参数以通过扩充模板对现有概要文件进行更改。augment 参数导致 manageprofiles 命令使用 -templatePath 参数中的模板更新或扩充在 -profileName 参数中标识的概要文件。您可以使用哪些扩充模板取决于您的环境中安装的 IBM 产品及其版本。 注： WebSphere Application Server 附带提供的模板只能用来创建概要文件，而不能用来扩充现有概要文件，因为随该产品只提供了创建模板。 此外，不要手动修改 install_dir/ profileTemplates 目录中的文件。例如，如果要在创建概要文件期间更改端口，那么使用概要管理工具，或者对 manageprofiles 命令使用 -startingPort 或 -portsFile 参数，而不要修改概要文件模板目录中的文件。请对 -templatePath 指定标准文件路径。例如： manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath fully_qualified_template_path对 -templatePath 参数指定相对文件路径会导致不能充分扩充指定的概要文件。另请参阅 -unaugment 参数。-backupProfile 对概要文件文件夹和概要文件注册表文件中的概要文件元数据执行文件系统备份。在调用带 -backupProfile 选项的 manageprofiles 命令之前，必须首先停止任何正在使用要备份的概要文件的服务器。-backupProfile 参数必须与 -backupFile 和 -profileName 参数一起使用，例如：manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name在使用 -backupProfile 选项备份概要文件时，必须先停止服务器和正在运行的进程（这些进程属于您想要备份的概要文件）。-backupFile backupFile_name 将概要文件注册表文件备份到指定的文件。您必须为 backupFile_name 提供标准文件路径。-cellName cell_name 指定概要文件的单元名。请对每个概要文件使用唯一单元名。 这是 WebSphere Application Server - Express 的可选参数。如果您省略该参数，那么将指定缺省单元名。此参数的缺省值以短主机名、常量单元和尾随数字的组合为基础，例如：if (DMgr)shortHostNameCellCellNumberelseshortHostNameNodeNodeNumberCell其中 CellNumber 是从 01 开始的连续数字，NodeNumber 是您用来定义节点名的节点号。 此参数的值不得包含空格或任何无效字符，如：*、?、,、/、| 等等。-create 创建概要文件。 指定 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help 以获取关于创建概要文件的特定信息。可用的模板包括： 缺省值 应用程序服务器-debug 打开 manageprofiles 命令使用的 Ant 实用程序的调试功能。-defaultPorts 对概要文件指定缺省端口值或基本端口值。 不要在使用 -startingPort 或 -portsFile 参数时使用此参数。在创建概要文件时，如果您未指定 -startingPort 参数、-defaultPorts 参数或 -portsFile 参数，那么 manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性，建议的端口值可与缺省端口值不同。注： 如果您要使用受管概要文件模板，那么请不要使用此参数。-delete 删除概要文件。 删除概要文件不会删除概要文件目录。例如，假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后，该目录仍然存在。您可以删除或保留该目录。然而， profile_root /logs 目录包含关于卸载概要文件的信息。例如，您可以保留 _nodeuninst.log 文件以确定在卸载过程中发生的任何问题的原因。如果您在概要文件注册表中删除某个概要文件，而该概要文件已有扩充模板向它注册，那么会自动执行缩小操作。-deleteAll 删除所有已注册的概要文件。 删除概要文件不会删除概要文件目录。例如，假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后，该目录仍然存在。您可以删除或保留该目录。然而， profile_root /logs 目录包含关于卸载概要文件的信息。例如，您可以保留 _nodeuninst.log 文件以确定在卸载过程中发生的任何问题的原因。如果您在概要文件注册表中删除某个概要文件，而该概要文件已有扩充模板向它注册，那么会自动执行缩小操作。-enableAdminSecurity true | false 启用管理安全性。有效值包括 true 或 false。缺省值为 false。当 enableAdminSecurity 设置为 true 时，您还必须指定参数 -adminUserName 和 -adminPassword 以及这些参数的值。如果在应用程序服务器安装期间安装了样本，那么在创建启用了管理安全性的概要文件时，还必须指定 -samplesPassword 参数。如果启用了管理安全性而未指定 -samplesPassword 参数，虽然会成功创建该概要文件，但当您尝试运行样本时，服务器系统输出日志中将记录异常和故障。-enableService true | false 允许创建 Linux 服务。有效值包括 true 或 false。此参数的缺省值为 false。 在将 -enableService 选项设置为 true 的情况下运行 manageprofiles 命令时，如果该命令由 root 用户运行，那么会与概要文件一起创建 Linux 服务。当非 root 用户运行 manageprofiles 命令时，会创建概要文件，但不会创建 Linux 服务。因为非 root 用户没有足够的许可权来设置 Linux 服务，所以不会创建该服务。在结束创建概要文件时将显示 INSTCONPARTIALSUCCESS 结果，并且概要文件创建日志 app_server_root /logs/manageprofiles_create_profilename.log 包含一条消息，指示当前用户没有足够的许可权来设置 Linux 服务。-federateLater true | false 指示是在概要文件创建期间联合受管概要文件，还是稍后使用 addNode 命令联合它。如果 dmgrHost、dmgrPort、dmgrAdminUserName 和 dmgrAdminPassword 参数没有值，那么此参数的缺省值为 true。有效值包括 true 或 false。-getDefaultName 返回缺省概要文件的名称。-getName 获取以给定的 -profilePath 参数注册的概要文件的名称。-getPath 获取给定名称的概要文件的文件系统位置。需要 profileName 参数。-help 显示命令语法。-hostName host_name 指定您创建概要文件的主机名。这应该与您在初始产品安装过程中指定的主机名相匹配。此参数的缺省值为长格式的域名系统。此参数的值必须是有效的 IPv6 主机名且不得包含空格或任何无效字符，如：*、 ?、,、/、| 等等。-ignoreStack 这是一个可选参数，它与 -templatePath 参数一起用来取消扩充已经扩充的特定概要文件。请参阅 -unaugment 参数。-isDefault 指定由一起使用的 -profileName 参数标识的概要文件在注册后将成为缺省概要文件。当发出针对缺省概要文件的命令时，那么不必使用命令的 -profileName 属性。-isDeveloperServer 指定服务器是否仅用于开发目的。在将应用程序部署到生产应用程序服务器上之前，创建概要文件以在非生产服务器上测试应用程序时，此参数很有用。-listProfiles 列出所有已定义的概要文件。-nodeName node_name 指定用新概要文件创建的节点的节点名。请在机器上使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一节点名。 此参数的缺省值以短主机名、概要文件类型和尾随数字为基础，例如：if (DMgr)shortHostNameCellManagerNodeNumberelseshortHostNameNodeNodeNumber其中 NodeNumber 是从 01 开始的连续号码。此参数的值不得包含空格或任何无效字符，如：*、?、,、/、| 等等。-omitAction feature1 feature2. featureN 排除概要文件功能的可选参数。 每个概要文件模板都预定义了某些可选功能。仅当在选择了样本应用程序的情况下安装 WebSphere Application Server 时，samplesInstallAndConfig 选项才可用。以下可选功能可与以下概要文件模板的 -omitAction 参数一起使用： 缺省值 应用程序服务器 o deployAdminConsoleo samplesInstallAndConfigo defaultAppDeployAndConfig-portsFile file_path 指定文件路径的可选参数，该文件定义新概要文件的端口设置。 不要在使用 -startingPort 或 -defaultPorts 参数时使用此参数。在创建概要文件时，如果您未指定 -startingPort 参数、-defaultPorts 参数或 -portsFile 参数，那么 manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性，建议的端口值可与缺省端口值不同。-profileName profile_name 指定概要文件的名称。创建概要文件时使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一名称。缺省概要文件名称以概要文件类型和一个尾随数字为基础，例如：profileType ProfileNumber其中 profileType 是诸如 AppSrv、Dmgr 或 Custom 的值，ProfileNumber 是用于创建唯一概要文件名称的连续号码。 此参数的值不得包含空格或无效字符，如：*、?、,、/、| 等等。不能选择已被使用的概要文件名称。-profilePath profile_root 指定概要文件的标准路径，此路径在信息中心中始终指 profile_root。 如果标准路径包含空格，那么将该值包括在引号中。缺省值以 app_server_root 目录、概要文件子目录和文件的名称为基础。例如，缺省值为：WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName其中 WS_WSPROFILE_DEFAULT_PROFILE_HOME 是在 app_server_root/properties 目录中的 perties 文件中定义的。此参数的值必须是目标系统的有效路径且当前未被使用。您必须具有写入该目录的许可权。-response reponse_file 使用 manageprofiles 命令从命令行访问所有 API 函数。 命令行界面可以由响应文件驱动，该响应文件以键和值格式包含属性文件中给定命令的输入参数。以下是创建操作的示例响应文件：createprofileName=testResponseFileCreateprofilePath=profile_roottemplatePath=app_server_root/profileTemplates/defaultnodeName=myNodeNamecellName=myCellNamehostName=myHostNameomitAction=myOptionalAction1, myOptionalAction2Windows 操作系统中的路径语句可以使用正斜杠（/）或反斜杠（）。如果路径语句使用反斜杠，那么响应文件需要使用双反斜杠才能正确识别路径。以下是使用双反斜杠的创建操作的响应文件示例：createtemplatePath=C:WebSphereAppServerprofileTemplatesdefault要确定各种类型的概要文件模板和操作需要哪些输入参数，可使用带有 -help 参数的 manageprofiles 命令。-restoreProfile 恢复概要文件备份。必须与 -backupFile 参数一起使用，例如：manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name要恢复概要文件，请执行以下步骤： 1. 从文件系统中手动删除概要文件的目录。2. 运行 manageprofiles 命令的 -validateAndUpdateRegistry 选项。3. 停止服务器和正在运行的进程（这些进程属于您想要恢复的概要文件）。4. 通过使用 manageprofiles 命令的 -restoreProfile 选项来恢复概要文件。-samplesPassword samplesPassword 创建要用于样本的密码。该密码用来限制对安装应用程序服务器期间安装的 Web 应用程序样本的访问。-serviceUserName service_user_ID 指定在创建 Linux 服务期间使用的用户标识，以便 Linux 服务将在此用户标识下运行。无论此用户标识何时登录，Linux 服务都会运行。-setDefaultName 将缺省概要文件设置为现有概要文件中的一个。必须与 -profileName 参数一起使用，例如：manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name-startingPort startingPort 指定为概要文件生成和指定所有端口时使用的起始端口号。 端口值是从 -startingPort 值开始按顺序指定的，但是要省略已经在使用的那些端口值。系统识别并解析当前正在使用的端口，并确定端口分配以避免端口冲突。不要将此参数与 -defaultPorts 或 -portsFile 参数一起使用。在创建概要文件时，如果您未指定 -startingPort 参数、-defaultPorts 参数或 -portsFile 参数，那么 manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性，建议的端口值可与缺省端口值不同。注： 如果您要使用受管概要文件模板，那么请不要使用此参数。-templatePath template_path 指定