How to Change or Reset Admin Username and Password for Central
Posted by Aly Essa, Last modified by Aly Essa on 15 July 2016 02:43 PM

Overview

FileCatalyst Central has two types of User Accounts, these accounts are an Admin level and User level. Both accounts store their username and password in the FileCatalyst Central configuration file. Passwords for both accounts are not visible in clear text and are converted to a hash value, however, the account names are visible in clear text. The configuration file is not accessible to anyone who does not have access to the filesystem where FileCatalyst Central is installed. The Admin User Account gives full control over the Web User Interface and Configurations page.  This article will outline how to identify the Admin Username, change the Admin Username if desired and how to reset the Admin User password temporarily. All changes that are made to the Admin Account and the configuration file should be performed from the machine that hosts FileCatalyst Central.

Environment

FileCatalyst Central v3.5 and later.

Resolution

  1. Identify or Change Admin Username

    There are two ways to identify and change the Admin User Name. If you have access to the Web Interface you will know what the Admin Username is since you will be able to login. If you do not know what the Admin Username is you can retrieve it from the FileCatalyst Central configuration file (maconfig.conf) and it can be changed directly from this file. Use the following instructions to confirm or modify the Admin Username:

    1. Shutdown the FileCatalyst Central Service. You can verify this by trying to access the FileCatalyst Central instance from a web browser.
    2. Create a copy of the configuration file (maconfig.conf) for recovery purposes.This file can be found in the installation directory of FileCatalyst Central.
    3. Using a text editor, open the maconfig.conf  configuration file. 
    4. Locate the for a parameter called FCMonitoringAgent.config.wac.admin.user.username. The value that this parameter is set to will indicate what your username is. By default it is admin and the parameter will look like:

      FCMonitoringAgent.config.wac.admin.user.username=admin

      If you would like to change the Admin Username enter the account name after the equal sign. For example, if you want your new Admin Username to be newadmin, the parameter would look like:


      FCMonitoringAgent.config.wac.admin.user.username=newadmin
    5. Save your changes and close the editor.
    6. Start the FileCatalyst Central Service.
    7. Access FileCatalyst Central from a web browser, if you are on the machine hosting it you can use http://127.0.0.1:8080/login.jsp.

  2. Change Admin Password

    The Admin Password can be changed from the Web UI and the configuration file (maconfig.conf), however, unlike the Admin Username, you will not be able to view it in plain text from the configuration file. This can only be made to the configuration file directly and it is recommended to perform this change from the machine that is hosting FileCatalyst Central. If you have misplaced your password or need to reset it follow these steps:

    1. Shutdown the FileCatalyst Central Service. You can verify this by trying to access the FileCatalyst Central instance from a web browser.
    2. Create a copy of the configuration file (maconfig.conf) for recovery purposes.This file can be found in the installation directory of FileCatalyst Central.
    3. Using a text editor, open maconfig.conf file.
    4. Locate a parameter called FCMonitoringAgent.config.wac.admin.user.password. It will probably have a has value assigned to it and look similar to:

      FCMonitoringAgent.config.wac.admin.user.password=AES_3368667a38326631e73b11ac9c6c0061f7dfbe4af95085be

      Change this parameter back to the default entry of admin. This will be temporary. The new command should look like:

      FCMonitoringAgent.config.wac.admin.user.password=admin

    5. Save your changes and close the editor.
    6. Start the FileCatalyst Central Service.
    7. Access FileCatalyst Central from a web browser, if you are on the machine hosting it, you can use http://127.0.0.1:8080/login.jsp
    8. Login using the username admin and the password admin.
    9. Hover over the gear icon on the top right-hand corner of the page and select Configuration.
    10. Under the Web Administration Configuration section you can change your Admin Username and Admin New Password. Please note the field Admin Password is checking for your current password, enter the password from Step d there.
    11. Hit the Apply changes button.
    12. If you re-open maconfig.conf in a text editor, you will notice that FCMonitoringAgent.config.wac.admin.user.password parameter will now have a hash value assigned to it.