Once EQuIS Professional has been installed, the following items will be required.
•Name of the server where the EQuIS Professional Database is located.
•Valid user name and password. See the Change Password section of this article for password requirements.
To obtain this information, contact an EQuIS Database Administrator. You can log in to EQuIS Professional using one or more of the following methods, depending on the database configuration:
2.using an established (SQL Server) user name and password
Note: When using network licensing, one EQuIS Professional Standard license will automatically be consumed on successful login.
To open the EQuIS Professional window, execute the steps below.
1.Click Windows > Start.
2.Expand EarthSoft under the Programs list.
3.Select EQuIS Professional.
4.EQuIS Professional will open to the backstage view.
Connect to a database by following the steps below.
1.EQuIS Professional will automatically open to the Connect tab.
2.Select Server Type: EQuIS Enterprise or SQL Server (select from drop-down next to Server Name). Alternately, EQuIS Professional can automatically detect and switch server types based on the input of the following step.
3.Enter a Server Name or EQuIS Enterprise Site URL: The name (or IP address) of the server that is being connected to. If the server name is unknown, contact the system administrator.
4.Select User Authentication type from the drop-down. See the Note box that follows the image just below for guidance on authentication types.
5.If applicable, enter User Name and Password information.
6.Connection String Options: : This option will appear if a SQL Server was picked in Step 2. Click “Connection String” under the Server Name to enter user-specific connection string options for database level connections. SQL users may need to specify their database name here, e.g.:
See Connection String Options below for details.
7.Click Sign In.
Note: Selecting the EQuIS Enterprise server type for Application Level Security connections will hide the connection string options. Refer to the EarthSoft Online Help article Configuration File for information on editing Connection String Options in the EQuIS.exe.config file.
After connecting to a database in EQuIS Professional, the database can be expanded to view facility groups and individual facilities. Facility groups are displayed in the left-hand pane under the database within a given connection. Individual facilities display in the right-hand pane of the connection window.
Select a facility by expanding the database or facility group folders until the expected facility is displayed in the right pane. The Search bar above the database list can also be used to find a facility within a selected database.
Open a facility by double-clicking the facility entry in the right pane (e.g. Springfield). To open a Facility Group, select a Facility Group folder on the left-hand side of the screen and double-click the Facility Group.
After logging into a facility, the remembered license level or lowest (Standard, if present) available license will automatically be checked out.
EQuIS Professional connection files can be saved, pinned and launched from your Desktop or a folder. See Professional Connections for additional information.
Change a user password in EQuIS Professional by following the steps below.
1.From the Connect tab on the backstage, enter the database connection information.
2.Enter the Username and Password for the user whose password will be changed.
3.Click the Change Password button to right of the password field.
4.Enter the current password.
5.Enter a new password.
6.Confirm the new password and click OK.
The new password must meet the default complexity requirements:
•Between 6 and 30 characters in length
•At least one lowercase character
•At least one uppercase character
•At least one numeric digit
•Each previously saved *.equis connection for this user will need to be updated with the new password.
•Password Complexity requirements can be configured in ST_CONFIG.
The Connection String Options field is available for advanced connection string settings for users with SQL logins. Click the "Connection String" text after inputting a server name to reveal this field:
For example, when connecting to a SQL Server Database with large datasets, it may be necessary to increase the Connection Timeout to avoid timeout errors. Timeout errors may occur anytime the database is accessed, commonly when first connecting to the database, but also when reference values are called when creating reports. Type Connection Timeout=xx in the Connection String Options field (where xx is the number of seconds) as shown below.
Connection Timeout = 300;
SQL accounts set up for specific databases may need to specify the database name in the connection string to be able to connect, e.g.:
Notes about Connection Strings:
•Adding this option through the Connection String Options field will apply it to the current connection only.
•Be sure to include a semicolon (;) at the end of the connection string.
Additional Connection String Options
For SQL Accounts:
•If the database needs to be specified in EQuIS, it will also need to be specified in SQL Server Management Studio (SSMS) in the Options tab of the Connect window, as shown below.
•For additional options, refer to the Microsoft SqlConnection.ConnectionString Property page.
Additional Information: Which type of authentication should I use?
Contact a database and/or system administrator to find out what type of authentication to use. The administrator will either provide a username and password or grant a Windows domain user account permission to log in to the database.
The Authentication mode that the server is using is indicated in SQL Server Management Studio by right-clicking on the database engine name>Properties>in the Security Section.
There are two possible modes, which are explained below.
Windows Authentication Mode
Windows Authentication mode enables Windows Authentication and disables SQL Server Authentication. Mixed mode enables both Windows Authentication and SQL Server Authentication. Windows Authentication is always available and cannot be disabled. When connecting through a Windows user account, SQL Server validates the account name and password using the Windows principal token in the operating system.
If Mixed Mode Authentication is selected during setup, the user must provide, and then confirm, a strong password for the built-in SQL Server system administrator account named sa. The sa account connects by using SQL Server Authentication. More information about this is available in the Microsoft Library article Choosing an Authentication Mode.
Only the roles of user indicated in the ST_LICENSE connection string will be used for the linking process. License Linking is independent of the individual logging in to a specific Professional Database.
EQuIS uses only the credentials of the user indicated in the connection string in ST_LICENSE for license linking. This user will need to have read capability on ST_LICENSE and read/write capability on ST_LICENSE_USE. The EarthSoft Online Help article Application Level Security has more information on configuring SQL roles. All other users will be able to access any database, regardless of their user roles.
Copyright © 2021 EarthSoft, Inc • Modified: 09 Aug 2021