Axional Studio provides the shells to start and stop the application and more shells utilities to help to obtain system information.

Use the provided shell script start.sh to start and studio.sh to stop the application

To start the service use the option:

$ cd /home/axional
$ cd studio
$ bin/studio.sh --start

to starts the service setting the JVM parameters for memory.

By default the stop option is unavailable. To configure it edit the configuration file config.xml and set the parameters:

• stop.port: the port where the server is attending the stop request.
• stop.pass: the string (plain without encoding) to authorize the stop.

...        
        <stop>
            <port>8777</port>
            <pass>Password2Stop</pass>
       </stop>
    ...

To stop the service run

$ bin/studio.sh --stop

or kill the process if the stop option is not configured or it doesn't take effect

$ bin/studio.sh --kill

Adding services in systemd daemons make it is easier to supervise and control processes and parallelized job execution

systemctl command provides the administrator with more detailed error messages including runtime and start-up errors.

Process attributes such as function and ownership are much easier to ascertain. For example, under Systemd, sub-processes, once spawned, become 'children' and are organized under the appropriate 'parent' group to show inheritance.

Edit the new file /etc/systemd/system/ax-studio.service and add the content asuming the path of studio server is on /home/axional/studio:

[Unit]
Description=Deister Axional Studio Service
After=network.target
Wants=ax-microservices.service

[Service]
User=axional
Type=forking
KillMode=control-group
ExecStart=/bin/sh -a -c 'cd /home/axional/studio && bin/studio.sh --start'
#ExecStop=/bin/kill -SIGTERM $MAINPID
ExecStop=/bin/sh -a -c 'cd /home/axional/studio && bin/studio.sh --stop'
Restart=on-failure
RestartSec=30s

[Install]
WantedBy=multi-user.target

Where:

• Wants: indicates that is required the axional studio microservices to start the service. If the microservices is not in the same server you need to comment this line. This ensure that the microservices will be started when the studio starts.
• ExecStop: uses the command stop asumes that the port to stop is configured in the config.xml If not you must use kill.

Enable the service:

systemctl enable ax-studio

When the axional studio microservices is in the same server you need to add this service in systemd. Edit the new file /etc/systemd/system/ax-microservices.service and add the content asuming the path of the installation is /home/axional/microservices:

[Unit]
Description=Deister Axional Microservices Service
After=network.target

[Service]
User=axional
Type=forking
KillMode=control-group
ExecStart=/bin/sh -a -c 'cd /home/axional/microservices && bin/services.sh --start'
ExecStop=/bin/kill -SIGTERM $MAINPID
Restart=on-failure
RestartSec=30s

[Install]
WantedBy=multi-user.target

Enable the service:

systemctl enable ax-microservices

To start the services you can execute:

systemctl start ax-studio

and this commands checks that microservices is started and starts it if not.

To stop the service you can execute

systemctl stop ax-studio

Create the file

vi /etc/sudoers.d/axional

and add this content

## ---------------- ##
## AXIONAL COMMANDS ##
## ---------------- ##
Cmnd_Alias AXSTUDIO = /usr/bin/systemctl start ax-studio, /usr/bin/systemctl stop ax-studio, /usr/bin/systemctl restart ax-studio, /usr/bin/systemctl status ax-studio
Cmnd_Alias AXMICROSERVICES = /usr/bin/systemctl start ax-microservices, /usr/bin/systemctl stop ax-microservices, /usr/bin/systemctl restart ax-microservices, /usr/bin/systemctl status ax-microservices    
Cmnd_Alias AXSTUDIOSII = /usr/bin/systemctl start ax-studio-sii, /usr/bin/systemctl stop ax-studio-sii, /usr/bin/systemctl restart ax-studio-sii, /usr/bin/systemctl status ax-studio-sii
Cmnd_Alias AXSTUDIOTPV = /usr/bin/systemctl start ax-studio-tpv, /usr/bin/systemctl stop ax-studio-tpv, /usr/bin/systemctl restart ax-studio-tpv, /usr/bin/systemctl status ax-studio-tpv
Cmnd_Alias AXFRONTENDTPV = /usr/bin/systemctl start ax-frontend-tpv, /usr/bin/systemctl stop ax-frontend-tpv, /usr/bin/systemctl restart ax-frontend-tpv, /usr/bin/systemctl status ax-frontend-tpv

## Allows user "axional" to stop/start Axional services.
axional ALL=(ALL) NOPASSWD: AXSTUDIO, AXMICROSERVICES, AXSTUDIOSII, AXSTUDIOTPV, AXFRONTENDTPV

Now, with axional user you can use the following commands:

Restart the service.

sudo systemctl restart ax-studio

Stop the service.

sudo systemctl stop ax-studio

Start the service.

sudo systemctl start ax-studio

Commands for ax-studio-sii service:

Restart the service.

sudo systemctl restart ax-studio-sii

Stop the service.

sudo systemctl stop ax-studio-sii

Start the service.

sudo systemctl start ax-studio-sii

The file bin/studio_java.properties contains the default values for Java modifiers. So settings like memory, product compatibility options, etc can be adjusted in this file.

The -Xms and -Xmx parameters define the minimum and maximum heap sizes, respectively. Since GC occurs when the generations fill up, throughput is inversely proportional to the amount of the memory available. By default, the JVM grows or shrinks the heap at each GC to try to keep the proportion of free space to the living objects at each collection within a specific range.

Memory parameters:

To size the Java heap see the following recommendation table:

For example, in a host with more than 12 GB of RAM, the following line in bin/.studio.env

JAVA_MEM_FLAGS="-Xms256M -Xmx1024M"

should be changed to

JAVA_MEM_FLAGS="-Xms1024M -Xmx10240M"

Usual issues that can occur with the memory are:

• OutOfMemory: One common indication of a memory leak is the java.lang.OutOfMemoryError exception. Usually, this error is thrown when there is insufficient space to allocate an object in the Java heap. In this case, The garbage collector cannot make space available to accommodate a new object, and the heap cannot be expanded further. Also, this error may be thrown when there is insufficient native memory to support the loading of a Java class. In a rare instance, a java.lang.OutOfMemoryError may be thrown when an excessive amount of time is being spent doing garbage collection and little memory is being freed. To solve this issue increase 'Java heap space' modifying the arguments -Xms and -Xmx.
• GC Allocation Failure: The detail message "GC Allocation Failure" indicates that there is an allocation request that is bigger than the available space in young generation. To solve this issue increase the 'Java heap young space' modifying the arguments -XX:NewSize and -XX:MaxNewSize
• GC Overhead limit exceeded: The detail message "GC overhead limit exceeded" indicates that the garbage collector is running all the time and Java program is making very slow progress. After a garbage collection, if the Java process is spending more than approximately 98% of its time doing garbage collection and if it is recovering less than 2% of the heap and has been doing so far the last 5 (compile time constant) consecutive garbage collections, then a java.lang.OutOfMemoryError is thrown. This exception is typically thrown because the amount of live data barely fits into the Java heap having little free space for new allocations. Action: Increase the heap size. The java.lang.OutOfMemoryError exception for GC Overhead limit exceeded can be turned off with the command line flag -XX:-UseGCOverheadLimit.

The JVM property "memoryDumpOnThreshold" can be set to "true" to enable the creation of memory dumps when reaching the memory threshold. The default value for this property is "false" (so, memory dumps not enabled). You can add this properties on JAVA_AXIONAL_FLAGS property:

JAVA_AXIONAL_FLAGS="${JAVA_AXIONAL_FLAGS} -DmemoryDumpOnThreshold=true"

Installation of the Application Server generates a digital certificate in JSSE (Java Secure Socket Extension) format suitable for internal testing. By default, the Application Server stores its certificate information in two files in the domain-dir/config directory:

• Keystore file,, keystore.jks contains the Application Server’s certificate, including its private key. The keystore file is protected with a password, initially changeit. Change the password using keytool. For more information about keytool, read Using the keytool Utility.
• Truststore file, cacerts.jks, contains the Application Server’s trusted certificates, including public keys for other entities. For a trusted certificate, the server has confirmed that the public key in the certificate belongs to the certificate’s owner. Trusted certificates generally include those of certification authorities (CAs).

A example to add external certificates to the cacerts.jks file is the Gmail certificates for the mailtool or for the SMTP group configuration.

Download the certificates for the services POP and SMTP. The POP service allows to each user to download the e-mails from the server. The SMTP service allows to send e-mails using the Google account (the protocol must be SMTPS and the port 465).

mkdir /tmp/certs

echo | openssl s_client -connect pop.gmail.com:995 2>&1 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/certs/gmail_pop.pem

echo | openssl s_client -connect smtp.gmail.com:465 2>&1 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/certs/gmail_smtp.pem

Then add this certificates to the cacerts file.

keytool -keystore /opt/jdk-9.0.4/lib/security/cacerts -importcert -alias pop.gmail.com -trustcacerts -file /tmp/certs/gmail_pop.pem

keytool -keystore /opt/jdk-9.0.4/lib/security/cacerts -importcert -alias smtp.gmail.com -trustcacerts -file /tmp/certs/gmail_smtp.pem

The Java virtual machine (Java VM ) has built-in instrumentation that enables you to monitor and manage it using the Java Management Extensions (JMX) technology. These built-in management utilities are often referred to as out-of-the-box management tools for the Java VM. You can also monitor any appropriately instrumented applications using the JMX API.

Monitor the Java VM with a tool that complies to the JMX specification, such as JConsole.

The server provides some shell utilities to obtain information about the system:

• bin/jps.sh:
• bin/jstack.sh: prints the current server stacktrace.
• bin/jvmtop.sh: prints the current CPU load information and the 10 threads with more of CPU.
• bin/jmap.sh: prints shared object memory maps or heap memory details of a given process or core file or a remote debug server. Generates a file called heapdump.hprof.
• bin/serverconsole.sh: interactive console that allow get system information.