LESSON

Password Reset with GWCMD

Description

Locked yourself out of your Gateway? No worries! In this lesson we'll take a look at how to use GWCMD utility to gain access back into the Gateway.

Video recorded using: Ignition 8.3

Transcript

(open in window)

[00:00] In this lesson, we're going to take a look at how to reset our password when we're locked out of our ignition gateway. So for starters, I'm at the login page and I'm unable to remember what my password is. Not all hope is lost though, as I can perform a password reset with the gateway command utility. This tool is located within the Ignition installation directory, so you'll need access to the machine containing those files as well as administrator or root access to use it. I'll be demonstrating the tool in Windows, but it's also available for Mac and Linux. I've included a link to the user manual page below this video showing where to access the tool for each operating system. Let's open a command line interface so we can run these commands. We'll open the start menu and search CMD for the command prompt. Choose the run the application as an administrator. This step is very important. If you forget to run your command prompt as an administrator, you'll get access denied errors.

[01:07] Next, we'll navigate to our installation folder. So we'll type out CD to change directories, and then we'll add a space and paste in the file path. By default this is in the C drive, so C colon forward slash program files, forward slash inductive automation, forward slash ignition. We can press our enter key now and move into the directory. To run the utility, we can type out gwcmd for gateway command and append dot bat for the batch file. In other operating systems, this will be a shell script that you can treat as an executable. Let's also add a space and then a dash h for the help command. If we look through this list, we can see that dash P is used to reset the gateway login password. We can press the up arrow key to bring back our last command, and we can initiate a password reset by replacing dash H with dash p and pressing enter.

[02:05] After executing this command, we should see this message that says password has been reset, gateway needs to be restarted. We can restart our gateway from right here using dash r. So again, we'll press the up arrow key and replace dash p with dash r and execute. We'll get this message saying, waiting for the gateway to restart. So we'll wait for the gateway to restart here and I'll just refresh my webpage. Eventually we'll get this menu that allows us to create a new user. You can of course type in any username and password you'd like, but it's okay to use something that's very easy to remember here. As this user is only temporary, I'll pass in the username admin and I'll just use the word password as my password. There's a prompt asking us if we want to launch the gateway now, and we'll click on start gateway to make sure our new user works. We'll wait a bit for the gateway to start back up and bring us to the homepage.

[03:04] Let's click on login here on the top right of the page, and we'll type in our new credentials and click on continue. We can see I'm logged in now and I have full access to the gateway. This is a temporary user however, and if we go into platform and then security, we'll find that a temp user source was created along with an identity provider. You can learn more about these security concepts in the cecurity in ignition inductive university course, but the important thing to know is that both the temp user source and identity provider are being used now to access the gateway and designer. You can see that configuration under our general settings, and if you want to set these back to what was there before, you can directly type into those fields. I'll set these both back to default as that's what my gateway was using. Once those fields are updated, you can click on save Changes up here in the top right.

[04:10] When you save these changes, that temp user will no longer be able to log in, so unless you are able to remember the password for your actual user, then we should update its password as well. User configuration is under user sources. Again, you can learn more about these settings in that security course I mentioned, but very quickly, we can access our users by clicking on this settings icon next to our desired user source, and then click on manage users. From here, you can open up the settings for any particular user by clicking on that same icon in this window. We can check off this change password box and you can create one that agrees with the following rules listed here by hovering over this information icon. After creating a new password, you can click on save changes down below, and you should be all set with using your admin account.

You are editing this transcript.

Make any corrections to improve this transcript. We'll review any changes before posting them.