Voyager WebAdmin login and password creation

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

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 webadmin where webadmin is the user name.
1. NOTE: The -c flag will truncate and recreate the password file! Use the Add procedure if the file already exists!
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 newname where 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.users file 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 webadmin where 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