Managing TextChart Studio users

A fresh installation of i2 TextChart Studio comes with a pre-populated user account named rosoka that has administrator privileges. The initial password is the same as the username.

To add users to the system, or to change the password for a user, you use a command-line utility from the TextChart Studio installation directory. On Microsoft Windows, the utility is rosokastudio.bat; on Apple macOS and Linux, the utility is rosokastudio.sh.

To manage TextChart users, navigate to the TextChart Studio installation directory and run the command for your operating system, providing three parameters:

The command name (passwd)
The name of the user to add or modify
The new password for the named user

For example, to create a user named joe and set their password to xx7799, run this command on Windows:

rosokastudio.bat passwd joe xx7799

Or this command on macOS and Linux:

./rosokastudio.sh passwd joe xx7799

On completion, the command provides the following output:

The new encrypted password for the user 'joe' is

   CRYPT:joKVahDE8hMXY

Copy this into the file 'conf/auth.properties' on the appropriate
line for the user 'joe'. Here is the full line for a user:

joe: CRYPT:joKVahDE8hMXY,rosokauser

Follow the instructions in the command output:

Using a text editor, open the auth.properties file, which is located in the conf directory under the TextChart Studio installation directory.
Paste the text from the output into the file, either replacing a line (to change the password for an existing user) or adding a line to the end (to add a new user).
For example, after adding joe to the default user provided with TextChart Studio, the edited file would look like this:
```
rosoka: CRYPT:roVsWZ.bWXgsk,rosoka
joe: CRYPT:joKVahDE8hMXY,rosoka
```
Save the file, and then start or restart the TextChart Studio server.

On completion of the above steps, the new or modified user becomes available for logging in to i2 TextChart Studio.