Voyager WebAdmin login and password creation
- Product: Voyager
- Product Version: 8
- Relevant for Installation Type: Multi-Tenant Direct, Dedicated-Direct, Local, TotalCare
Question
How do I create a login for WebAdmin?
Answer
WebAdmin logins are different than Voyager client logins and must be created and managed on the Voyager server.
Instructions follow for setting up the password file for WebAdmin or simply adding to it. This info is taken from Chapter 30 of the Voyager Technical User's Guide.
You must have root (administrative) access to the Voyager server to work with WebAdmin logins. Contact support for assistance.
There are two different workflows described below. One is for creating the first login/password for WebAdmin (e.g., no other logins have been previously created). The second is for adding an additional login. Do not use the first workflow if you already have existing logins! It will delete them!
Creating WebAdmin Users and Passwords
The file that defines and encrypts users and passwords is named htpasswd and it is located in the /m1/shared/apache2/bin directory. The login and password information will be stored in a text file named xxxdb.users which is located in the /m1/shared/apache2/conf directory. Here, xxxdb is the name of the database.
Creating a New Login/Password for the First Time
Use the following to create a new login/password for the first time:
- Login as root and enter:
cd /m1/shared/apache2/bin - At the prompt enter:
./htpasswd -c /m1/shared/apache2/conf/AuthorizedUsers/xxxdb.users webadminwhere webadmin is the user name.- NOTE: The
-cflag will truncate and recreate the password file! Use the Add procedure if the file already exists!
- NOTE: The
- Then, the system prompts you to enter that user’s password two times.
Result: A new login and password is created.
Adding an Additional Login/Password to the Existing File
Use the following to add an additional login/password to the existing file.
- Login as root and enter:
cd /m1/shared/apache2/bin - At the prompt enter:
./htpasswd /m1/shared/apache2/conf/AuthorizedUsers/xxxdb.users newnamewhere newname is the new user. - Then, the system prompts you to enter the password for newname two times.
Result: An additional login and password is created.
Deleting a Login/Password for an Existing User
Use the following to delete a login/password for an existing user.
- Login as root and enter:
cd /m1/shared/apache2/conf - Open the
xxxdb.usersfile using vi or another server text editor. - Delete the line for the specific user you want to delete then save the
xxxdb.users
file.
Result: The login and password are deleted.
Modifying a Login/Password for an Existing User
Use the following to modify a login/password for an existing user.
- Login as root and move to the /bin directory, enter:
cd /m1/shared/apache2/bin - At the bin prompt, enter:
./htpasswd /m1/shared/apache2/conf/AuthorizedUsers/ xxxdb.users webadminwhere webadmin is the user name. - Then, the system prompts you to enter the new password two times.
Result: The login and password are modified.
- Article last edited: 17-Oct-2019