FAQ

# Question about Operation

# How to install and start AASv10?

Based on the type of the installation package obtained, use the corresponding method to install it; typically, it is AAS-V10.zip or AAS-V10.tar.gz. Copy the installation package to the appropriate directory and unzip it to complete the installation. For other types of installation packages, refer to the "Installation Manual".

There are several ways to start AASv10, usually by entering the installation directory ${APUSIC_HOME}/bin and executing asadmin start-domain to complete the startup of the default domain. For other startup methods, refer to the "Installation Manual".

# How to stop and uninstall AASv10?

There are several ways to stop AASv10, usually by entering the installation directory ${APUSIC_HOME}/bin and executing asadmin stop-domain to complete the stop of the default domain. For other stop methods, refer to the "Installation Manual".

# How to access the Console of AASv10?

Typically, you can directly access the console login page by visiting https://[IP]:6848 in your browser.

# How to view the version?

Executing command ./asadmin version ,you can view the version information of AAS .

# How to set and change user password?

By default, AAS v10 has three role-based administrator users: system administrator (admin), security administrator (secure), and auditor administrator (audit). The default password for each of these users is the one set during initialization.

Here are the methods to change user passwords:

Method 1: If you forget the password for a non-security management user, such as admin, log in to the management platform using a security administrator account and reset the password for that user.

Method 2: If you forget the password for an administrator, including a security administrator or system administrator, but remember the password for another user, you can copy the password from another user's entry in the mydomain/config/admin-keyfile file located under Installation path and replace the password for the user whose password needs to be changed. This requires a system restart to take effect.

Method 3: If you forget the password for an administrator, including a security administrator, but remember the system administrator's password (such as admin), log in as the system administrator. Navigate to the [Configurations] - [server-config] - [Security] - [Realms] - [admin-realm] - [Manage Users] page, click on the username to edit the user, and change the user password.

Method 4: Modify the password for the corresponding user in the mydomain/config/admin-keyfile file located under Installation path. Replace the existing password with the following: "{SSHA256}iU4Ef2uGWYh3V+BQjpW5f8BTbgGWzKp7pfrNU020Nu2l9YLEwCWOpA==" to reset it to an empty password. Restart the system, and then you will need to set a new password.

# How to specify the Java environment?

Editting ${APUSIC_HOME}/config/asenv.conf and add the AS_JAVA variable:

AS_JAVA=/opt/java/jdk1.8.0_281

Start AAS after save the file.

By the way ,if you want to create a SSH instance,should configure the java environment to ~/.bashrc for system environment variable.

# How to change the running memory size?

Method 1: The system administrator logs in the Manager, enters [Configurations] - [server-config] - [JVM Settings] - [JVM Options], changes the value of "-xmx", saves and restarts AAS.

Method 2: Modify the value of the jvm-options item -Xmx in the configuration file domain.xml, save and start AAS.

# How to change the default port?

Method 1: Modify the value of the port in the configuration file domain.xml, network-listeners-network-listener, save and start AAS.

Method 2: The system administrator logs in the Manager, enters [Configurations] - [server-config] - [Network Config] - [Network Listeners], modify the port number of the listener, saves and restarts AAS.

# How to configure GM/T certificates?

AAS supports configure GM/T ssl certificates. For detailed information, refer to the "Apusic Application Server v10 User Manual."

1.Enable GM/T ssl Certificates.In the domain.xml file, under the java-config section, change the value of <jvm-options>-Dcom.apusic.security.ssl.EnableGMTLS=false</jvm-options> from false to true.

2.Configure Certificate Information. In the domain.xml file, within the network-config/protocols/protocol sub-element, for the required port's protocol, set the security-enabled attribute to "true", add an ssl sub-element, and set the sm11-enabled attribute to "true". Also, add the corresponding keystore and truststore related attributes. Here is an example:

 <protocol name="http-listener-2" security-enabled="true">
 <http max-connections="250" default-virtual-server="server">
 <file-cache></file-cache>
 </http>
 <ssl classname="com.sun.enterprise.security.ssl.ApusicSSLImpl"
 sm11-enabled="true"
 key-store-type="PKCS12"
 key-store="${com.apusic.aas.instanceRoot}/config/keystore.p12"
 key-store-password="fdjaio%^&2123f"
 client-auth="want"></ssl>
 </protocol>

3.Start AAS.

# How to configure HTTP2?

The Apusic Application Server supoorts HTTP2,configure as following:

Modify the Protocols HTTP2 page of console ,enabled http2Enabled option.

# How to change the size of thread Pool?

Method 1: Modify the parameters of thread-pools-thread-pool in file domain.xml, save and start AAS.

Method 2：The system administrator logs in the Manager, enters [Configurations] - [server-config] - [Thread Pools] - [Network Listeners], modify the information of the thread pool, saves and restarts AAS.

# How to depoly application?

AAS offers multiple methods for deploying applications. For detailed information, refer to the "Apusic Application Server v10 User Manual." Common methods include:

Method 1: The system administrator logs in the Manager, enters [Applications], deploys application.

Method 2: Copy the application package to the installation directory ${DOMAIN_HOME}/autodeploy.

# How to configure IPV6?

The Apusic Application Server supoorts IPV6,configure as following:

Modify the JVM Options page of console or domain.xml,delete the option as follow:

-Djava.net.preferIPv4Stack=true
1

Start the AAS.

View the IPv6 address of the system, remove the % and the following part, such as fe80::29aa:7867:5c4e:589b%11, and obtain the value fe80::29aa:7867:5c4e:589b.

Access the URL,http://fe80::29aa:7867:5c4e:589b:6888.

Note:

  • AAS installed operating system's network adapter has enabled IPv6 support, as in Windows' network configuration.
  • If it is Linux, remote access requires switch support for IPv6 to access, otherwise it can only be accessed locally.

# How to do if the application cannot find the referenced resources during deployment?

Before deploying the application, the resource environment needs to be configured, or the resource will not be found. Note that JNDI names need to correspond.

# What if there is a garbled code problem?

Problem 1: Chinese garbled problem when accessing the html files of the application.

Solution:

Add a fileEncoding param in domains/mydomain/config/default-web.xml

<init-param>
    <param-name>fileEncoding</param-name>
    <param-value>utf-8</param-value>
</init-param>
1
2
3
4

Problem 2: Chinese garbled problem when application using JSP include html file.

Solution:

Set the encoding of html file in web.xml

<jsp-config>
    <jsp-property-group>
        <display-name>JSPConfiguration</display-name>
        <url-pattern>*.html</url-pattern>
        <page-encoding>UTF-8</page-encoding>
    </jsp-property-group>
</jsp-config>
1
2
3
4
5
6
7

General solution:

Add apusic-wenb.xml to the WEB_INF directory of the application.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE aas-web-app PUBLIC "-//Apusic.com//DTD Apusic Application Server 10.1 Servlet3.0//EN" "http://apusic.com/dtds/apusic-web-app_3_0-1.dtd">
<aas-web-app>
    <class-loader delegate="false"/>
    <locale-charset-info>
        <parameter-encoding default-charset="UTF-8"/>
    </locale-charset-info>
</aas-web-app>
1
2
3
4
5
6
7
8

# How to configure log?

Method 1: Enter the configuration file config/logging.properties, modify the corresponding parameter values, save, and start AAS.

Method 2: The system administrator logs in the Manager, enters [Configurations] - [server-config] - [Logger Settings], modify the corresponding parameter values, save, and start AAS.

# Changing log level

AAS supports changing log level. For detailed information, refer to the "Apusic Application Server v10 User Manual."

Method 1: Enter the configuration file logging.properties, modify the value of "level", save and start AAS. The possible values that can be set are ALL/OFF/FINEST/FINER/FINE/CONFIG/INFO/WARNING/SEVERE/ALERT/EMERGENCY.

Method 2: The system administrator logs in the Manager, enters [Configurations] - [server-config] - [Logger Settings] - [Log Levels], modify the corresponding parameter values, generally effective in real time.

# Changing log file name or output directory

AAS supports changing log file name and output directory. For detailed information, refer to the "Apusic Application Server v10 User Manual."

Method 1: Enter the configuration file logging.properties, modify the value of "com.apusic.enterprise.server.logging.ApusicFileHandler.file", directory files require permissions, save and start AAS.

Method 2: The system administrator logs in the Manager, enters [Configurations] - [server-config] - [Logger Settings] - [General], modify the values of "Log File", save and restart ASS.

# Changing the log file size

AAS supports changing log file size. For detailed information, refer to the "Apusic Application Server v10 User Manual."

Method 1: Enter the configuration file logging.properties, modify the value of "com.apusic.enterprise.server.logging.ApusicFileHandler.rotationLimitInBytes" or "com.apusic.enterprise.server.logging.ApusicFileHandler.rotationTimelimitInMinutes", save and start AAS.

Method 2: The system administrator logs in the Manager, enters [Configurations] - [server-config] - [Logger Settings] - [General], modify the values of "File Rotaiton Limit" or "File Rotaiton Time Limit", save and restart ASS.

# How to clear an application's cache?

Delete the related files in directory ${DOMAIN_HOME}/osgi-cache/felix.

# How to set the class loading order?

AAS supports setting class loading order. For detailed information, refer to the "Apusic Application Server v10 User Manual."

The general setting method is to set the attribute "class loading strategy" when deploying the application, select the parent class loader first, and do not select the child class loader to load.

# What should we do if our authorization code expires or is invalid?

In most cases, Apusic provides the corresponding authorization code based on the product version purchased by the user. If you encounter issues such as an expired or invalid license during use, it is recommended to first contact the Apusic service representative assigned to you to reapply for the appropriate license. When reapplying for the appropriate license, you need to provide the product's feature code to the Apusic representative, as shown in the figure:

If the node has authorization problems, you can check the log, and the log will print out the corresponding characteristic code, copy the code and provide it to Apusic personnel to reapply for the corresponding license.

# How to modify the default error page?

If you want to hide the error page,add the attribute -Dapusic.http.errorpage.server.disabled=true of JVM option.

If you want to custom the error page ,add the attribute -Dapusic.http.errorpage.custom.enabled=true of JVM option.After adding,you need to add the attribute -Dapusic.http.errorpage.custom.file as well,otherwise, return to the default page.

Add [error code] after -Dapusic.http.errorpage.custom.file to specify the return page for a certain type of error. For example, -Dapusic.http.errorpage.custom.file.404 indicates the page returned for a 404 error.

Example:

-Dapusic.http.errorpage.custom.enabled=true                       ##Enable custom error page
-Dapusic.http.errorpage.custom.file=/opt/ApusicAS/error.html      ##Configure the error page file
-Dapusic.http.errorpage.custom.file.404=/opt/ApusicAS/404.html    ##Configure the error page for 404 error
1
2
3
编辑页面 (opens new window)

← 用户手册→