Setting Up the MashZone NextGen Environment
When you install ActiveTransfer using the Software AG Installer, the monitoring MashApps for ActiveTransfer Server are downloaded but are not installed on the MashZone NextGen server. Use this procedure to complete the configuration of MashZone NextGen.
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 directory MashZone_Installation_directory\MashZoneNG\mashzone\data\jdbcdrivers.
For details on the which JDBC drivers to copy, see MashZone NextGen documentation.
b. Copy the Red.less file from the directory Integration Server_directory \IntegrationServer\instances\instance_name\packages\WmMFT\mashzone\columnchart to the directory MashZone_Installation_directory\MashZoneNG\apache-tomcat\webapps\mashzone\hub\dashboard\assets\custom-look-and-feel\dashboard\default\columnchart.
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 directory Integration Server_directory \IntegrationServer\instances\instance_name\packages\WmMFT\mashzone\security-filter
b. Using an XML editor, open the file applicationContext-security-filters.xml.
c. Copy the complete header content (all content within the open and close tags) for the following to a temporary file like a text file.
http pattern="/**/*.jsp" use-expressions="false" http pattern="/hub/(login|reset_password)\.html.*" request-matcher="regex" http pattern="/**/*.html" use-expressions="false" d. In the copied header content, locate each instance of otherServerHost:otherServerPort and replace:
otherServerHost with your
My webMethods Server host name.
otherServerPort with your
My webMethods Server Server port number.
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="/hub/(login|reset_password)\.html.*" request-matcher="regex" http pattern="/**/*.html" use-expressions="false" i. Save and close the applicationContext-security-filters.xml file.
3. Start the MashZone NextGen server.
4. 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.
5. Depending on the system directory 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 the permission to view or manage
ActiveTransfer analytical information as follows:
1. In the MashZone NextGen welcome page, click Administrator > Admin Console.
2. On the Admin Console page, click Users & Groups > Users.
3. Click Add new user.
4. Specify the login ID defined for the user in My webMethods Server and other relevant details.
5. 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.
6. 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 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.
7. Import the ActiveTransfer analytics dashboard into MashZone NextGen by using the following command at the command prompt:
a. Navigate to the directory Integration Server_directory \IntegrationServer\instances\default\packages\WmMFT\mashzone\dashboard.
b. Copy the file ActiveTransfer_Analytics_Dashboard.zip to any location on your local machine.
c. Navigate to the directory MashZone_Installation_directory\MashZoneNG\prestocli\bin.
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
8. 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 . 9. 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.
10. Add the following parameter in the Integration Server_directory \profiles\MWS_default\configuration\custom_wrapper.conf file:
wrapper.java.additional.n = -Dcom.webmethods.content.security.hosts="MashZone_host:MashZone_port"
11. Restart My webMethods Server.
Postrequisite: