Codeless Server Administration Manual

(1)

PDF generated using the open source mwlib toolkit. See http://code.pediapress.com/ for more information. PDF generated at: Tue, 12 Aug 2014 11:37:19 CEST

Codeless Server

(2)

Articles

1. Revisions

₁ 1. Revisions 1

2. Introduction

₂ 2. Introduction 2

3. Starting the Administration Page

₃

3. Starting the Administration Page 3

4. Server Monitor

₄ 4. Server Monitor 4

5. Server Options

₈ 5. Server Options 8

6. Server Information

₁₀ 6. Server Information 10

7. Server configuration

₁₁ 7. Server configuration 11

8. Class information

₁₂ 8. Class information 12

9. Database Management

₁₄ 9. Database Management 14

References

Article Sources and Contributors 21 Image Sources, Licenses and Contributors 22

(3)

1

1. Revisions

Revisions:

Version Date Author Modification

3.0.0.0 09/09/2011 Veronica Chiritoiu Initial document

3.1.0.0 14/09/2011 George Melinte Updated print screens. Added chapters Server Configuration and Class Information 3.1.0.1 3/11/2013 Teofil Cobzaru Add Database management chapter.

(4)

2

2. Introduction

Introduction

The following manual is a user guide to Codeless Server Administration.

After reading through this manual, the user should be familiar with the Codeless server administration functionality and its usage.

(5)

3

3. Starting the Administration Page

Starting the Administration Page

The Administration Page can be started accessed Environment Page. After that the Codeless Admin pages should be open.

(6)

4

4. Server Monitor

Server Monitor

Main (Stop, Drain Stop, Start, Reset)

Regarding to the Server Monitor some buttons are available with the following functionalities:

* Stop– through this button the server will be stopped; the button Confirm should be pressed if you want to stop the server;

*Drain Stop - trough this button the server takes a break and enters in maintenance mode;

(7)

4. Server Monitor 5

Active Clients

– when this link is pressed all the active clients for the corresponding environment are shown;

When the “Select” is pressed another page is open, and from here a certain user can be blocked. You can specify the user that will be blocked, the time (in minutes) for which the access is blocked and the message that should be displayed when that user wants to access the application. In order to save the data press the OK button.

Blocked Users

– when this link is pressed all blocked users for the corresponding environment are shown;

When the “Select” is pressed another page is open and from here a user can be unblocked. You can specify the user that will be unblocked and press OK button.

(8)

4. Server Monitor 6

Active Calls

– when this link is pressed all active calls for the corresponding environment are shown; For each call will be shown the type of the action (get object, get new object, modify object, add initialized object etc.), the function in which the action will take place, the state of the call, the duration and other specifications.

(9)

4. Server Monitor 7

Completed Calls

- when this link is followed, all completed calls for the corresponding environment are shown. For each call, will be shown the type of the action (get object, get new object, modify object, add initialized object etc.), the function in which the action is taking place, the state of the call (“Completed”), duration and other specifications.

(10)

8

5. Server Options

– when this link is pressed another page is open, here the user can set some options: •• the message that should appear when the server is in maintenance mode;

•• enable the profiling; •• enable the attribute values;

•• the users that are shown on the profiling page;

•• the machine names that are shown on the profiling page; •• the function Ids that are shown on the profiling page.

(11)

(12)

10

6. Server Information

- – when this link is pressed another page opens, and from here the user can make some actions like:

•• reset the loaded named users; •• reset the loaded meta classes; •• reset the loaded workflow rules; •• reset the loaded profiler rules; •• reset the server settings; •• refresh the version info;

(13)

11

7. Server configuration

– When this link is pressed a new page opens up in which the server administrator can check the configuration information for the managed server, like server addresses, connection strings, error handling information etc.:

(14)

12

8. Class information

- when this link is pressed all classes for the corresponding environment are shown; For each class, will be shown the Class Id, Name, Model Version, Model Loaded (date time stamp), Model State, MslVersion, Msl Loaded (date time stamp), Msl State and Msl Error.

The following actions are available for the server administrator:

• Reset All Meta – When this button is pressed the metadata used by the server will be reset.

• Load All Meta – When this button is pressed, all metadata used by the server will be loaded in the class information list.

• Compile all MSL – By pressing this button all Msl statements used throughout the whole package are re-compiled based on the settings defined in the server configuration.

(15)

8. Class information 13 •• Refresh - When this button is pressed the whole page is refreshed.

Whenever the class information list is loaded or any of the actions from above are executed, each Class and Msl statement will be marked in a proper manner in the Class information list:

• Red – if it generates an error, • Green – if it is ok

• Purple – if the msl is ok but it was re-compiled a long time ago, so it is outdated.

Each entry present in the class information list can be further analyzed by pressing the Select button, for the corresponding object. This will open up the following window in which the Class Details are displayed. Eventually the error messages are displayed either they are related to Compilation or Execution:

(16)

14

9. Database Management

Database Management

The Database Management functionality replaces the older Database Checker stand-alone application. Using Database Management you can create/edit/delete class groups.

Class groups are saved as xml files under Server Files\Class Groups folder, for easy migration between environments. Once a class group is selected, several actions become available:

- Check if the classes require synchronization - Perform synchronization step

- Change persistency level - Copy/Move/Delete data

Database Management can be accesed from the Administrator page, by clicking on the corresponding link.

Creating class groups

On the Database Management page, you have the option of adding a new group.

You must provide a name for the group, and select the classes you want to include in it. A list of all classes in the system will be available to select from.

(17)

9. Database Management 15

You can add/remove classes to group either individually, all classes at once or by specifying a range of class ids. A group has a name, a number of classes included and a persistency level. If all classes have the same persistency, the class group will have the same persistency level, otherwise its persistency level will be Various.

(18)

Performing actions on class groups

Check classes

This function checks if the database structures for the classes included in the group are synchronized with the classes’ metadata. This includes checking the table structure, views structure, permissions on stored procedures, Unicode support (see Unicode support), etc. – everything that the Database Synchronizer checks during a normal Package Update. If a class requires synchronization, this will be indicated in the Needs sync column.

Repair classes

If at least one class needs synchronization, the Repair button will be enabled. You can use it to fix the classes that are out of sync.

Change persistency

This feature is available only for class groups with Concern or Company persistency. If the group’s persistency is Company, using the Change persistency to CONCERN button will change the persistency to Concern. No further input is required.

(19)

If the group’s persistency is Concern, pressing the Change persistency to COMPANY button will lead to a page where you can associate run units with the company you want the data to be related to.

After you made the selection, use the Apply button to perform the operation.

After changing persistency, you must reset the Codeless Server (see section Server Monitor - Main (Stop, Drain Stop, Start, Reset))

(20)

Copy/Move data

This feature is available only for class groups with Concern or Company persistency. You can copy/move data between distinct run units and/or companies using the Copy/Move data button.

If the group’s persistency is Concern, you can copy/move data between different run units. You must select the source and target run units, and press Apply. You cannot copy or move data from and to the same run unit.

If the group’s persistency is Company, you can either copy/move data between two distinct companies from the same run unit, or between distinct run units and companies.

(21)

Delete data

This functionality is not available for groups with Various persistency.

Use the Delete Data button. This will lead to a page where you can select what you want to delete. You can either delete all data (from all run units and companies), or select a specific run unit. If the group’s persistency is Company, you can additionally select a specific company to delete data from.

Unicode support

Starting with version 3.2, Codeless supports Unicode data. In order to enable this feature, the setting

(22)

9. Database Management 20 Once this change is done, you can use the Database Management to convert classes to Unicode. This operation is performed by checking and then repairing the classes. During the check, if a class has not yet been converted to Unicode and Unicode support is enabled, that class is detected as out of sync. You can synchronize it (thus converting it to Unicode) by pressing the Repair button (see section Repair classes).

Known limitations

Conversion to Unicode has several limitations:

1. If a class has too many attributes in the model, it is possible that the class cannot be converted to Unicode (due to SQL Server restrictions). You can test whether a class can be converted to Unicode or not by using the Check classes functionality (described in section Check classes) and opting to check if conversion to Unicode is possible.

If a class cannot be converted to Unicode, you may have to make changes to the model in order to reduce its size (in terms of total attributes length).

2. If you have a lot of data in your system, you will require a considerable amount of disk space for Unicode conversion (this is related to how SQL Server operates). Also, some versions of SQL Server (like SQL Server Express) will not be supported in this case.

(23)

Article Sources and Contributors 21

Article Sources and Contributors

1. Revisions Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3524 Contributors: DanielPopescu

2. Introduction Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3525 Contributors: AnaTurcan, DanielPopescu

3. Starting the Administration Page Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3526 Contributors: AnaTurcan, DanielPopescu

4. Server Monitor Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3527 Contributors: AnaTurcan, DanielPopescu

5. Server Options Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3528 Contributors: AnaTurcan, DanielPopescu

6. Server Information Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3529 Contributors: AnaTurcan, DanielPopescu

7. Server configuration Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3530 Contributors: AnaTurcan, DanielPopescu

8. Class information Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?oldid=3531 Contributors: AnaTurcan, DanielPopescu

(24)

Image Sources, Licenses and Contributors 22

Image Sources, Licenses and Contributors

File:Server Admin1.png Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?title=File:Server_Admin1.png License: unknown Contributors: AnaTurcan

File:Server Admin 100.png Source: http://hosting1.codeless.com/CodelessDevelopmentWiki/index.php?title=File:Server_Admin_100.png License: unknown Contributors: AnaTurcan

Codeless Server Administration Manual

Codeless Server

Contents

Articles

1. Revisions

2. Introduction

3. Starting the Administration Page

4. Server Monitor

5. Server Options

6. Server Information

7. Server configuration

8. Class information

9. Database Management

References

1. Revisions

1. Revisions

2. Introduction

2. Introduction

Introduction

3. Starting the Administration Page

3. Starting the Administration Page

Starting the Administration Page

4. Server Monitor

4. Server Monitor

Server Monitor

Main (Stop, Drain Stop, Start, Reset)

Active Clients

Blocked Users

Active Calls

Completed Calls

5. Server Options

5. Server Options

6. Server Information

6. Server Information

7. Server configuration

7. Server configuration

8. Class information

8. Class information

9. Database Management

9. Database Management

Database Management

Creating class groups

Performing actions on class groups

Unicode support

Article Sources and Contributors

Image Sources, Licenses and Contributors