Setting Up the MashZone NextGen Server Environment
When you install ActiveTransfer using Software AG Installer, the monitoring MashApps for ActiveTransfer Server are downloaded but not installed on the MashZone NextGen server. Complete the configuration of MashZone NextGen environment as listed below.
To set up the
MashZone NextGen environment
1. Copy the necessary files to the MashZone NextGen installation as follows:
a. Copy the relevant JDBC drivers to the MashZone_Installation_directory\MashZoneNG\mashzone\data\jdbcdrivers directory.
For details on which JDBC drivers to copy, see the MashZone NextGen documentation.
b. Copy the Red.less file from the Integration Server_directory \IntegrationServer\instances\instance_name\packages\WmMFT\mashzone\columnchart directory to the MashZone_Installation_directory\MashZoneNG\apache-tomcat\webapps\mashzone\hub\dashboard\assets\custom-look-and-feel\dashboard\default\columnchart directory.
2. Update the XFrame-Options filters and content security policies in the MashZone NextGen directory using the contents of the ActiveTransfer file as follows:
a. Navigate to the Integration Server_directory \IntegrationServer\instances\instance_name\packages\WmMFT\mashzone\security-filter directory.
b. Using an XML editor, open the applicationContext-security-filters.xml file.
c. Copy the complete header content (all content within the open and close tags) for the following to a temporary file, such as a text file.
http pattern="/**/*.jsp" use-expressions="false"http pattern="/**/*.html" use-expressions="false" d. In the copied header content, locate each instance of otherServerHost:otherServerPort and replace:
otherServerHost with the
ActiveTransfer Server host name.
otherServerPort with the port for
ActiveTransfer Server user interface.
Important: Once you perform these configuration changes, you will not be able to view the reports in My webMethods Server.
e. Close the applicationContext-security-filters.xml file.
f. Navigate to the directory MashZone_Installation_directory\MashZoneNG\apache-tomcat\webapps\mashzone\WEB-INF\classes.
g. Open the file applicationContext-security-filters.xml.
h. Replace the following header content (all content within the open and close tags) with the corresponding header content that you copied and edited earlier:
http pattern="/**/*.jsp" use-expressions="false" http pattern="/**/*.html" use-expressions="false" i. Save and close the applicationContext-security-filters.xml file.
3. To configure Single Sign On (SSO), configure ssoProcessingFilter in the MashZone_Installation_ directory\MashZoneNG\apache-tomcat\webapps\mashzone\WEB-INF\classes\applicationContext-security.xml file. To do this:
a. Open applicationContext-security.xml file in any text or XML editor. This file is located in the MashZone_Installation_ directory\MashZoneNG\apache-tomcat\webapps\mashzone\WEB-INF\classes folder.
b. Add a comment to the ssoProcessingFilter bean <bean id="ssoProcessingFilter" class="com.jackbe.jbp.sas.security.ui.sso.SSONullPreAutheticatedFilter"> as follows:
c. Remove the comment for the bean <bean id="ssoProcessingFilter" class="com.jackbe.jbp.sas.security.ui.sso.SSOPreAuthenticatedFilter">.
d. For this bean, configure the principalExtractor property with the following settings:
e. Configure the principalTransformation property with the following settings:
<property name="principalTransformation">
<bean class="com.jackbe.jbp.common.util.
NoOpStringTransformation"></bean>
</property>
For more details, see the "Configuration for Agent-Based SSO Solutions" section in the MashZone NextGen documentation.
4. Start the MashZone NextGen server.
5. Browse to the MashZone NextGen welcome page http://host:8080/mashzone, and log on as a system user.
The default system user name and password are Administrator and manage respectively.
6. Depending on the system directory that you use to store user credentials, do the following
By default,
ActiveTransfer uses the
My webMethods Server system directory. If you use the
My webMethods Server system directory to store user profiles, create a matching user profile in
MashZone NextGen for each user who has permission to view or manage
ActiveTransfer analytical information as follows:
i. In the MashZone NextGen welcome page, click Administrator > Admin Console.
ii. On the Admin Console page, click Users & Groups > Users.
iii. Click Add new user.
iv. Specify the login ID defined for the user in My webMethods Server and other relevant details.
v. Click Add this user.
Instead of the
My webMethods Server system directory, if you use LDAP as your central user profile repository, integrate your LDAP directory with
Software AG MashZone NextGen.
For details on how to integrate your LDAP repository with MashZone NextGen, see theMashZone NextGen documentation.
7. In the MashZone NextGen, Admin Console page, add user groups and associate users with the user groups, as required.
For details on how to add user groups and associate users to user groups, see the MashZone NextGen documentation.
Tip: Instead of specifying privileges for each user individually, define privileges for multiple users at a time by creating a user group, and then associating users with the group.
8. Import the ActiveTransfer analytics dashboard into MashZone NextGen:
a. Navigate to the Integration Server_directory \IntegrationServer\instances\default\packages\WmMFT\mashzone\dashboard directory.
b. Copy the ActiveTransfer_Analytics_Dashboard.zip file to any location on your local machine.
c. Navigate to the MashZone_Installation_directory\MashZoneNG\prestocli\bin directory.
d. Open the command prompt and run the following command:
Note: The arrow symbol in this code snippet represents a forced line break for improved readability. When copying this code, delete the arrow symbol and the line break without introducing new character spaces or deleting existing character spaces.
padmin importDashboard -l http://host:port►
/mashzone -f Location of ActiveTransfer_Analytics_Dashboard.zip -u►
Administrator -w manage –o
9. Define a data source in MashZone NextGen to the ActiveTransfer database as follows:
a. On the Admin Console page, click JDBC Configuration > Data Sources.
b. Click Add data source.
c. In Data Source Name, type MFTDB, the name of the ActiveTransfer database.
For the ActiveTransfer analytics dashboard to work, the MFTDB database is mandatory.
d. Specify other relevant details for the ActiveTransfer database component.
e. Click Save Changes.
f. To test the database connection, click 
. 10. Share the dashboard with the users or groups you defined previously as follows:
a. On the MashZone NextGen welcome page, open the ActiveTransfer Analytics dashboard.
b. In the menu, click 
> Manage > Permissions. c. In the Manage dashboard permissions dialog box, select view or edit permissions for the user or group.
d. Click Save.