Setting Up the Software AG MashZone 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 server. Use this procedure to complete the configuration of MashZone.
To set up the MashZone environment
1. Copy the necessary files to the MashZone installation as follows:
a. Copy the relevant JDBC drivers to the MashZone_Installation_directory\ppmmashzone\server\bin\work\work_mashzone_a\mashzone_data\jdbcdrivers directory.
b. Copy the M_MFT_Monitoring_Dashboard.mzp file from Integration Server_directory \instances\instance_name\packages\WmMFT\mashzone\mashapp to MashZone_Installation_directory\ppmmashzone\server\bin\work\work_mashzone_a\mashzone_data\importexport.
c. Copy the customColor1.xml and customColor2.xml files from Integration Server_directory \instances\instance_name\packages\WmMFT\mashzone\assets\colorSchemes to MashZone_Installation_directory\ppmmashzone\server\bin\work\work_mashzone_a\mashzone_data\assets\colorSchemes.
Note: | In the directory paths specified above, the a in “work_mashzone_a” reflects the type of system configuration you specified during MashZone installation (that is, “s” for a small installation, “m” for a medium installation, or “l” for a large installation). |
2. Start the MashZone server.
3. Browse to the MashZone administration interface at http://host:port/mashzone and log in as a system user using the default user name system and password manager.
For the host, specify the host name of the machine on which MashZone is installed. For the port, specify the MashZone load balancer port or SSL port you specified during installation.
Note: | If you log on to the administration interface using the MashZone SSL port, precede the URL with “https” instead of “http.” |
4. Click Open central user management and log on to Central User Management as a system user using the default user name system and password manager.
5. Upload the MashZone license as follows:
a. At the top of the Central User Management page, click Licenses.
b. Click
. c. Browse to and select the MashZone license file, and then click Upload.
6. If you are using the internal My webMethods Server system directory to store user profiles, do the following to create a matching user profile in MashZone for each user who will be viewing or managing ActiveTransfer analytical information:
a. At the top of the Central User Management page, click User management.
b. On the User Management page, click the Users tab.
c. Click
. d. On the Create User page, supply the same user name (login ID) as defined for that user on My webMethods Server.
e. Click Save.
7. If you are using LDAP to store central user configuration, rather than storing user definitions in the internal My webMethods Server system directory, do the following to import users into MashZone:
a. Ensure that LDAP is configured in Integration Server and My webMethods Server. For details, see webMethods Integration Server Administrator’s Guide and Administering My webMethods Server .
b. At the top of the Central User Management page, click Configuration.
c. From the list at the top of the Configuration page, select LDAP connectivity and set the LDAP connectivity properties as appropriate for your installation. For details about these properties, see the ARIS Central User Management help.
d. From the list at the top of the Configuration page, select LDAP attribute mappings and set the LDAP attribute mapping properties as appropriate for your installation. For details about these properties, see the ARIS Central User Management help.
e. Import users from the LDAP system into MashZone. For details, see the section on importing LDAP users in the ARIS Central User Management help.
8. Create a group to represent the users who will be viewing analytical information on the My webMethods Analytics page as follows:
Tip: | Creating a user group, and then associating users with that group, enables you to define privileges for multiple users at once instead of specifying privileges for each user individually. |
a. At the top of the Central User Management page, click User management.
b. On the User Management page, click the User groups tab.
c. Click
. d. Provide a name for the group and, optionally, a description.
e. Click Save.
9. Associate users with the group as follows:
a. On the User groups tab of the User Management page, select the group.
b. On the group’s detail page, click the Associated users tab.
c. Click
. d. Select the users to associate with the group.
10. Set MashZone privileges for the user group as follows:
a. On the User Management page, click the Privileges tab.
b. Click the triangle to the left of the License privileges link to expand the list.
c. Click MashZone Viewer, click
, and then select the group you created in the previous steps. d. Click MashZone user, click
, and then select the group you created in the previous steps. Note: | Make sure that MashZone viewer and user privileges are granted to the system user as well. |
11. Configure single sign-on for the MashZone users you defined in previous steps by setting SAML properties as follows:
a. At the top of the Central User Management page, click Configuration.
b. Set the following properties:
com.aris.umc.saml.active=true
com.aris.umc.saml.provider.url=http://MWS_hostname:8585/services/SAML
com.aris.umc.saml.login.mode.dn.active=true
com.aris.umc.saml.login.mode.keyword.active=true
com.aris.umc.saml.login.mode.keyword.name=uid
c. Add the following properties to the mashzone.properties file located in the server\bin\work\work_mashzone_m\base\webapps\mashzone\WEB-INF directory of your MashZone installation:
mashzone.saml.artifact.param.name=SAMLart
d. Stop MashZone and add the following two keys to the <installDir>\ppmmashzone\server\bin\work\work_mashzone_m\base\webapps\mashzone\WEB-INF\mashzone.properties file to get the old settings:
mashzone.httpheader.xframe.options.enabled=false
mashzone.httpheader.xframe.options= SAMEORIGIN
12. Define a connection to the ActiveTransfer database component you created with the webMethods Database Component Configurator when you installed ActiveTransfer, as follows:
a. In the MashZone administration interface, on the Administration page, click Database Connections and then click Create.
b. On the database connection creation form, supply valid data for the connection and then click Save.
It is recommended that you maintain the alias as “MFTDB” If you specify a different alias, you must modify the default ActiveTransfer MashApp to reflect the new alias. For more information about modifying MashApps, data feeds, and data sources, see the MashZone online help.
c. Click Test database connection to test the connection.
MashZone with ActiveTransfer is certified with JDBC thin drivers (type 4) for supported Oracle databases and Microsoft SQL Servers. These drivers are available with their respective database installations and can also be downloaded from the Oracle and Microsoft websites.
13. Import the ActiveTransfer analytics dashboard into MashZone as follows:
a. In the MashZone administration interface, on the Administration page, click Import/Export/Delete.
b. On the Import tab, click the Import button and select M_MFT_Monitoring_Dashboard.mzp When prompted to specify the import of access privileges, select Always transfer.
MashZone imports the MashApp and extracts the relevant data feeds.
14. Share the dashboard with the users or groups you defined previously, as follows:
a. In the MashZone administration interface, click Home.
b. Select the MFT Monitoring Dashboard MashApp.
c. Click More, and then click Share.
d. On the Share dialog box, select the users or groups you want to share the dashboard with. Grant them view and/or edit privileges as desired, select the Pass on view privilege and Access to data from assigned data feeds check boxes, and click Share.
Tip: | If users are unable to see analytical information on the Analytics page in My webMethods, open the MashApp and click the Refresh all data link at the bottom of the MashApp to refresh the MashApp’s data feeds. |