Using the map editor

Use the Map Editor to create and edit maps.

Before you begin

Functionality delivered in fix pack 19The Map Editor is available from Web GUI Fix Pack 19 onwards.

You can download the Map Editor from the Web GUI welcome page. You can also download the Map Editor from the Map Creation window. After you download and decompress the compressed file, several subdirectories are created in the mapeditor directory.

Complete the following prerequisite steps:
  • Install JRE on the client side, where the standalone Map Editor is installed.
  • Set the JAVA_HOME environment variable.

If FIPS 140–2 mode has been enabled, you can use only FIPS 140–2 mode password encryption. You must have IBM®® JRE installed to use the mapeditor_fips_crypt tool.

About this task

To create a map by using the Map Editor, complete the following steps:

Procedure

  1. Click Administration > Event Management Tools > Maps > Map Creation.
  2. To download the Map Editor, select Download Map Editor. Unpack the mapeditor.zip file.
  3. Provide connection details. Configure the following parameters in the mapeditor/etc/mapeditor.init file or in the command line:
    • mapeditor.host - your Web GUI server address
    • mapeditor.port - default Web GUI SSL port, 16311
    • mapeditor.secure - set to on
    • mapeditor.contextpath
    • mapeditor.user
    • mapeditor.password - If using AES or FIPS encryption, run the password tool (mapeditor_pwd_crypt or mapeditor_fips_crypt for Unix systems and mapeditor_pwd.crypt.cmd or mapeditor_fips_crypt.cmd for Windows systems, located in the MAP_EDITOR_HOME/bin/mapeditor_pwd_crypt and MAP_EDITOR_HOME/bin/mapeditor_fips_crypt directories) and copy the generated string
    • mapeditor.password.encryption - set to none, aes, or fips
    • mapeditor.mapname - This parameter is optional.
    If these parameters are not provided, a new map is created.
    Note: If the parameters are specified in the command line, those values take precedence over the values set in the mapeditor.init file.
  4. Set up an SSL connection. Extract the certificate from the Web GUI server.
    1. Go to: WAS Administration Console > SSL certificate and key management > SSL configurations > NodeDefaultSSLSettings > Key stores and certificates > NodeDefaultKeyStore > Personal certificates > Extract certificate
    2. Provide the path and name for the extracted certificate in the Certicate file name field, for example: /tmp/webguicert
    3. Copy webguicert to the machine where the Map Editor is running.
    4. Add webguicert to the trusted cacerts by running one of the following commands:
      Linux®:
      JAVA_HOME/bin/keytool -import -trustcacerts -Keystore <PATH_TO_JAVA_HOME>/lib/security/cacerts -alias default -file /<PATH_TO_WEBGUICERT_FILE>/webguicert
      Windows:
      JAVA_HOME/bin/keytool.exe -importcert -trustcacerts -keystore <PATH_TO_JAVA_HOME>\lib\security\cacerts -alias default -file <PATH_TO_WEBGUICERT_FILE>\webguicert
  5. To start the Map Editor, run the ./runmapeditor command, located in the bin directory, as in the following example. Or, run the runmapeditor.cmd command on Windows operating systems. 
    ./runmapeditor -user smadmin -password netcool