PowerServer Toolkit User Guide
Using Configure Tool

Profile Settings

Profile Name

Assign a name to the PowerServer profile.

You should use names that are easy to remember and identify (for example "PowerServer for Test" or "Remote PowerServer").

PowerServer Settings

Server Type

Select J2EE if PowerServer is installed to JBoss, JEUS, WebLogic, or WebSphere; select .NET if PowerServer is installed to Microsoft .NET Framework.

Server

Enter the IP address or the machine name of the PowerServer.

Server Port

Enter the HTTP or HTTPS port number used by PowerServer.

AEM Settings

AEM URL

The URL for AEM will be automatically generated after you specify the Server and Server Port. The URL will be in the following format: http://server:port/AEM, (for example, http://localhost:8080/AEM).

Note: Do not use a "localhost" listener in a production environment.

Connection method

Use HTTP or HTTPS (secure) option to connect to PowerServer.

Deployment Security Settings

Deployment Security

The Get State button can get the state of the Deployment Security settings in AEM. If Deployment Security is set to ON, the state will be "Enabled" and you must specify the deployment user name and password. By default, the Deployment Security in AEM is OFF, so the state is "Disabled".

Username

Enter the username used to deploy the application.

The username and password for the deployment security feature are configured in AEM.

The username can be left blank if the deployment security feature is turned off in AEM.

Password

Enter the password used to deploy the application.

The username and password for the deployment security feature are configured in AEM.

The password can be left blank if the deployment security feature is turned off in AEM.

Profile Settings

Profile Name

Assign a name to the Web Server profile.

You should use names that are easy to remember and identify such as "Web Server for Test" or "Production Web Server".

File Transfer Type

Select Local Server if the Web Server is on the local machine.

Select FTP Server or SFTP Server if the Web Server is on a machine different from the PowerServer Toolkit machine.

Web Server Settings

Server Type

Select the Web server type.

PowerServer supports the following Web Server types: Apache, IIS, JBoss, WebLogic, WebSphere, and JEUS.

Server

Enter the IP address or the domain name of Web Server.

Server Port

Enter the HTTP or HTTPS port number of Web Server.

Local Server Settings

Web Root Path

Enter the home directory of the Web server where the application WAR file will be deployed to.

For example:

For Apache, the home directory is <apache root>\htdocs

For IIS, the home directory is <systemdrive>:\Inetpub\wwwroot;

For WildFly and JBoss EAP, the home directory is <jboss root>\standalone\deployments;

For WebLogic 8, the home directory is <systemdrive>:\bea\user_projects\domains\appeon_domain\applications;

For WebLogic 9/10, the home directory is <systemdrive>:\bea\user_projects\domains\appeon_domain\autodeploy;

For WebSphere, the home directory is <systemdrive>:\IBM\WebSphere6\AppServer\installableApps;

For JEUS, the home directory is

Note: For WebLogic (started in production mode) and WebSphere, you will need to manually deploy the WAR file in the server administrative control. This is required by the WebLogic and WebSphere, not by PowerServer. It is similar to deploying the PowerServer EAR package; you can follow the instructions in the section called "Deploying appeonserver.ear package" in the Installation Guide.

FTP Settings

Port

Enter the FTP server port number. The typical FTP port is port 21.

If you use a remote Web Server, PowerServer Toolkit will upload the files to Web Server using FTP protocol. Note that PowerServer Toolkit works as a passive FTP client when uploading files. So you need to make sure that you are using passive FTP and the FTP data port and command port are configured properly in the firewall.

Username

Enter the username for FTP login.

If the FTP server offers anonymous access then the username should be anonymous.

Password

Enter the password for FTP login.

If no password is set for the FTP server or the FTP Username is anonymous, leave this field blank.

Require explicit FTP over TLS/SSL

Select this checkbox if you want PowerServer Toolkit to upload the files via FTPS protocol.

Make sure the FTP server is configured to "Require SSL Connections" (not "Allow SSL Connections") for the control channel and the data channel. Also, a server SSL certificate should be specified, although PowerServer Toolkit will not verify whether the certificate is signed by a trusted certificate authority, or verify the certificate's name against the host.

The supported TLS/SSL protocols include TLSv1.2, TLSv1.1, TLSv1.0, SSLv3, and SSLv2.

And the FTP server should not be configured to require the client-side SSL certificate, otherwise PowerServer Toolkit will fail to connect with the server, because PowerServer Toolkit does not support validating the client-side SSL certificate.

SFTP Settings

Port

Enter the SFTP server port number. The typical SFTP port is port 22.

Username

Enter the username for SFTP login.

Password

Enter the password for SFTP login.

Private key file

Enter or select the private key file for the SFTP server.

Key file passphrase

Enter the key file passphrase for the SFTP server.