Professional Documents
Culture Documents
Installation guide
Edition 11.08.2020 for version 2.18.5.173
Contents
Part I Purpose 4
3
4 AlphaCENTER Utilities
1 Purpose
3.4 Setup
To set the parameters of the AlphaCENTER Utilities program, select the menu item
Server-> Options .... This form is shown in the figures below. The form consists of the
following tabs:
· Backup - parameters for performing hot and cold backup operations;
· Hot Recovery — Parameters for performing a hot recovery operation;
«Hot backup»
· The checkbox “Use hot backup of AlphaCENTER database” - setting this flag turns on the
hot backup mode and turns off the cold backup mode;
· Database connection parameters - database name, user name, password, folder for
Oracle HOME. You must specify these parameters and click the "Test Connection" button
to verify the correctness. CNT user is allowed.
· In the case of a multivariate installation by the client part of Oracle, the program may not
be able to find the executable files necessary to perform data export operations. It is
possible to specify the exact file for export and the “Use first” checkbox, indicating that
the program will first use the file specified by the user;
· The checkbox “Perform table space size correction” indicates that after a successful
backup, the program will analyze the table spaces USERS and INDX, and if they have less
than 25% free space, the program will expand the table spaces so that there is about 25%
free space .
«Cold backup»
Cold backup is a shutdown of the Oracle DBMS and a copy of all the data files
needed for the backup. There are two ways to stop a database server. The first is to stop
only the Oracle DBMS, while the Windows service responsible for the DBMS operation will
continue. The second option is to stop the Windows service. In any case, at the time of
stopping the server, the AlphaCENTER database will be unavailable. It is preferable to use
the first option to stop the database server - stop only the Oracle database server itself.
To stop an Oracle DBMS, you must specify a stop option:
· Usually - the DBMS will be stopped after the last user completes his work, the connection
of new users is prohibited;
· Immediately - Oracle DBMS will be stopped immediately, current operations will be
canceled until the last agreed state, the connection of new users is prohibited;
· Transactional - Oracle DBMS will be stopped after the completion of current operations,
all current operations will be completed until the end and the database is in a consistent
state, the connection of new users is prohibited;
To perform a database shutdown operation, you must use the SYS user (or another
member of the SYSDBA group), you must also specify its password, and when using the
Oracle x64 DBMS, you must specify the Database Name. To check the connection to the
database, click the "Check Connection" button.
It is recommended to stop Oracle DBMS, and not the OS service.
It is also possible to stop the OS service responsible for the operation of the Oracle
DBMS, thus the database itself will be stopped. To do this, you need to specify the OS
service, stopping which will stop the entire database, as well as the OS service, whose launch
will lead to the launch of the entire database (this is relevant only for versions of Oracle 8.0
PE or 8.1 SE, if the Alpha CENTER service is running Oracle Server Run). It is also desirable to
specify the user and his password, which has rights to start and stop Windows services, and
you must specify the reaction time of the service in seconds - the time it takes the service to
completely stop or start is at least 30 seconds.
Using the option “Stop the OS service” is less preferable than the use of the Oracle
DBMS shutdown.
«Горячее восстановление»
The tab "Hot Recovery" has the following options:
· Database connection options - database name, username, password and folder for Oracle
HOME. You must specify these parameters and click the "Test Connection" button to
verify the correctness. Only the user SYSTEM is allowed;
· In case of a multivariate installation by the client part of Oracle, the program may not be
able to find the executable files necessary for performing data import operations. It is
possible to specify the exact file for import and the “Use first” checkbox, indicating that
the program will first use the file specified by the user;
· Checkbox “Restore tablespaces size” - when this box is checked, when restoring the
database from an archive copy, the program will first try to restore the size of the
tablespaces USERS and INDX to the sizes that were when the backup was taken
(information about the size of the tablespaces is collected automatically when backing
up). It is recommended to set the data checkbox;
· The checkbox “Restore CNT user password” - when this check box is selected, after
restoring the AlphaCENTER database from a hot backup, the CNT user will be set a
password that was at the time when the AlphaCENTER database was created.
· The field "Password after recovery" - for the restore operation, you can specify a default
password, i.e. after the recovery operation is completed, the password you set will not be
set by CNT, not. Leave this field blank to set the default password - cnt;
On the Advanced tab, the user can specify the following parameters:
· Number of archive copies - the user can limit the number of archive copies to be created.
This is especially important with automatic copy mode. There is a limit - the number of
archival copies. By default, this restriction is disabled. The program AlphaCENTER Utilities
at the start, end and after the successful creation of an archive copy checks for this
restriction. Excess backup copies are automatically deleted. Be extremely careful when
activating and configuring this restriction.
· Specify the folder to store files -
· AC5 files - the file contains a backup copy (extension .ac5) and is intended for storage on
other media (CD / DVD);
· TMP-files - temporary files required for the application to work (extensions
.tmp, .log, .dmp) are deleted automatically after the operation is completed;
· “Minimize to tray during backup / restore” - determines whether the program will
minimize to tray (about Windows hours) when it is backed up or restored;
The "Services" tab contains parameters for interacting with communication and
accounting servers. The need for interaction is caused by the requirement to stop the survey
and calculations when creating a backup and start them after the backup operation is
completed. The “Services” tab contains two more tabs - for the communication and
accounting server, respectively. The following options are available:
· The checkbox “Manage server” - this flag determines the activity of the entire server
management mechanism;
· Server connection settings - user, password, and computer. To control the server (its
shutdown and start), you must specify:
o The name of the computer on which the server is running, or leave the field blank if the
server is running on the same computer as the AlphaCENTER Utilities module;
o Username - the network name of the user that will allow you to connect to a remote
computer with the rights necessary to stop / start services;
o Password - user password;
· Wait for the service to respond — the time in minutes that the application will wait before
checking the server status;
· The checkbox “Continue operation in case of server failure” - this flag determines whether
the operation will continue if the server did not respond within the allotted time period;
To determine the current status of the server, click "Determine the status of the
server." To fully verify the ability to manage the server, specify all the parameters and click
the "Check server management" button. After that, the application will perform the
following actions:
o It will try to make a network connection to the specified computer using the specified
parameters;
o Check the availability of the appropriate service;
o Determine its current state;
o Will perform operations to stop and start the service;
o If at one of the stages fails, the program will inform the user.
Tab "Archiving" contains parameters for managing the process of archiving the
database dump file. AlphaCENTER Utilities has the following options for processing a
database dump:
· Do not archive - the internal archiver does not compress the required files;
· Use internal archiver - an internal archiver is used, which provides a dump compression
ratio of ~ 1/10. You can set the level of compression. It is recommended to use level 5-7;
· Use external archiver - an external archiver is used (for example, WinRAR) with the
appropriate settings;
To set up an external archiver, you need to specify the full path to it, commands for
archiving / unzipping, and a separate command for unarchiving for cold backup. The
following substitutions are used:
· %SOURCE% - the name of the input file CNT.DMP - is set by the program automatically;
· %LIST% - the name of the input list file, archived files;
· %DEST% - the name of the output file CNT.ARC - is set by the program automatically;
· %TMP% - directory for temporary files - defined on the "Advanced" tab;
· %AC5% - the directory for AC5-files - is defined on the "Advanced" tab;
· %FILENAME% - the name of the file to be extracted from the archive;
· %DESTFOLDER% - destination directory for the extracted file;
If the external archiver changes the name of the output file compared to the% DEST
% parameter, for example, installs the .exe extension instead of .arc, then you need to
specify the postfix - the string that is used to convert the file name as follows: the postfix
string consists of two parts - the left and right, while the separator is the last (right point). In
this case, the left part will be added to the file name, and the right will be used as a new
extension of the output file. For example:
· The name of the input file is CNT.DMP;
· The name of the output file CNT.ARC;
· The external archiver is configured, so it automatically creates an sfx-archive, i.e. output file
extension; exe;
· It turns out that when you call the external archiver, the CNT.DMP file is archived into the
CNT.exe file, not CNT.ARC. For the application to work properly, you must specify the
postfix .exe.
· The checkbox "Show a message about the work of an external archiver". When it is
installed during the operation of the external archiver / unarchiver, a message will be
displayed, stating that the archiver / unarchiver is working.
Parameter Desciption
%SOURCE% Name of input file-list, archived files
%LIST% Name of input file-list, archived files
%DEST% Name of the output (archive) file
If you need to organize the server in 7x24 mode (around the clock), you need to
refer to the Oracle Database Server Administration Guide for setting up Archive Log mode
and ensuring redundancy using Oracle's Recovery Manager (RMAN).
· To create a backup, you need to connect to the source database. To do this, on the
“Service” tab, select the “Parameters” item;
· In the appeared “Parameters” form, it is necessary to choose which backup method will
use Hot Backup or Cold Backup.
· For hot backups, on the “Backup” tab -> “Hot Backup”, you must specify the connection
to the database and other required parameters. For cold backups and recovery from cold
backups, on the “Backup” tab -> “Cold Backup”, you must specify the connection to the
database and other required parameters;
· In the main window, in the "Comment" field, the user can specify a comment for this
backup. You can use the following macro substitutions (framing with% is required, only
capital letters):
%DATE% - current date;
%TIME% - current time;
%NOW% - current date and time;
%USERNAME% - user name in the OS;
· To create a backup, click the “Backup” button. The following actions are performed:
o Testing the ability to create a backup;
o Service management, if appropriate parameters are set;
o With hot backup - export data from the database to a temporary file. This can take quite a
lot of time depending on the amount of data and the current server load, then the
resulting temporary file is archived;
o When cold backup - stop the server or OS service, archiving all the necessary files;
o General backup build, if an external archiver is used;
o Adding a backup copy record to the appropriate table of the Alfa-CENTER Utilities
program;
o The process of exporting and archiving data is quite long and non-linear in time, so when
performing this operation, the indicator is shown to the user.
o All information about the program's actions is shown in the “Protocol” field in the lower
part of the window. You can view backup and restore protocols, as well as save them to a
separate file, by selecting the required backup and clicking the "Protocols" button.
· Upon completion of the backup operation, the user will be notified of the completion of
the reservation.
· After that you need to view the creation protocol. The protocol contains all the
information about the database backup process.
DB Backup operation completed.
All data and information necessary for recovery are stored together in a single file with the
extension AC5. By default, the backup is saved in the \ Files folder. In the future, the user can
copy a specific backup, as well as add a backup file or delete it if it is no longer required.
o All information about the program's actions is shown in the “Protocol” field in the lower
part of the window. You can view backup and restore protocols, as well as save them to a
separate file, by selecting the required backup and clicking the "Protocols" button.
· After the recovery operation is completed, the user will be prompted to complete the
recovery.
· After that, you need to view the recovery protocol. The protocol contains all the
information about the process of restoring the database.
Parameter Purpose
DATE Adding to the name of the saved file the backup date in the format
yyyy_mm_dd. Used with the BACKUP and SAVE parameters;
TIME Adding to the name of the saved file the date and time of the backup in the
format yyyyy_mm_dd__hh_mi_ss; Used with the BACKUP and SAVE
parameters;
NOLIST After the backup operation is completed, the backup will be removed from
the backup list, but the file itself will remain;
LOGSAVE After performing the backup operation, the protocol will be saved to a
separate file with the * .ac5log extension.
Examples:
· C:\AlphaCenter\ACUtils\ACUtils.exe C:\Rezerv_Copy\cnt.ac5 -BACKUP - creating a
backup copy and saving it in the file C: \ Rezerv_Copy \ cnt.ac5;
· C:\AlphaCenter\ACUtils\ACUtils.exe C:\Rezerv_Copy\cnt.ac5 -BACKUP -NOLIST -
creating a backup copy and saving it in the file C: \ Rezerv_Copy \ cnt.ac5. After saving the
backup to a file, the copy will be removed from the backup list;
· C:\AlphaCenter\ACUtils\ACUtils.exe C:\Rezerv_Copy\cnt.ac5 -BACKUP -DATE -SAVE -
creating a backup copy and saving it to the file C: \ Rezerv_Copy \ cnt2007_01_20.ac5
(20_01_2007 is the current date);
Warning:
· All settings in the “Parameters” form fully affect the operation of the batch mode.
· To automate the launch of the AlphaCENTER Utilities application, the startup command
itself must be added to the Windows schedule service on its own;
· Also, for automation, you can use the AlphaCENTER Task Manager and AlphaCENTER
modules Launch external applications;
4.7 Recovery
A backup copy of the database may be needed in many situations, but it is not a
panacea for all cases. Below we consider the two most frequently encountered situations for
the restoration of the AlphaCENTER database.
Due to various manipulations, data is lost in the database (for example, deleted by
mistake), but the database server itself works correctly. In this situation, you can help restore
lost data without collecting them from the counters in a timely archived copy. Simply select
the required copy from the list and click the restore button. If successful, all lost data will be
restored;
Due to various manipulations with the database server, it does not work or does not
work correctly. In this case, before using the AlphaCENTER Utilities program, it is necessary
to restore the functionality of the database server itself. To do this, it must be completely
removed and reinstalled from the distribution disk.
1. Stop all services related to Oracle (must be 7) (start - >settings - >control Panel -
>Administration - >Services);
2. Stop all AlphaCENTER services (maximum 4) (start - >settings - >control Panel -
>Administration - >Services);
3. Exit all programs, especially those relating to AlphaCENTER;
4. To remove the directory where you previously set the Oracle (drives C, D, etc.). If not
removed, then go through all the points to the end, and then repeat the removal;
5. To delete a directory in Oracle C:\Program Files;
6. Start regedit.exe (WindowsDir\SYSTEM32) or just start- > Run - >regedit;
7. To remove all registry from the LOCAL_MACHINE\SOFTWARE\ORACLE (ORACLE only
delete, not LOCAL_MACHINE or SOFTWARE);
8. To remove all registry CURRENT_USER\SOFTWARE\ORACLE, if any (to remove only the
ORACLE and not CURRENT_USER or SOFTWARE);
9. Remove from LOCAL_MACHINE\SYSTEM\CurrentControlSet\Service\Oracle*.* - must
be the same as in step 1 (only ORACLE, not LOCAL_MACHINE or SYSTEM, etc.));
10.Close RegEdit.exe;
11.Go to"My computer"->Properties->Advanced->environment Variables". Find the PATH
variable. Remove from it (by clicking "Change") all related to Oracle. As a rule, C:
\ORACLE\BIN, C:\PROGRAM FILES\ORACLE\JRE\BIN, C:\ORANT;
12.Remove from menu "start" all about Oracle and AlphaCENTER;
13.Reboot the computer.
After rearranging the server, use the AlphaCENTER Utilities program to restore the data
from the archive as described in the “Restoring the database from backup” section.
Attention! To restore the functionality of the database server, you may need to completely
reinstall the MS Windows operating system (format drive C).
To collect information about the database - the "AlphaCENTER database" tab - you
need to connect to the target database - the "Connect to database" button. To collect
statistical information, it is necessary to press the "Collect data" button - this process can be
lengthy, therefore an indicator will be shown during the collection process. After the end of
data collection, all collected information will be shown in the appropriate table.
To save data, click the "Save Data" button. To download for viewing, click the
"Download data" button. To save report in xls / xml / html / txt formats, click the "Save
Report" button.
The "AlphaCENTER DB Updates" tab is intended for viewing installed updates and
saving installation logs to a file. To save the installation log to a file, you must click the
"Save log to file" button.
The "Backup copies" tab is intended for viewing the list of previously created backup
copies of the AlphaCENTER database. This list contains all the backup copies of the
database that were ever made successfully by the Utility module and are stored in the
AlphaCENTER database itself. The list contains the name of the computer from which the
backup was made, and the name of the backup file on the computer from which the
backup was made. To view the backup protocol, you must click the "View Protocol" button.
The "Database objects with errors" tab is intended for viewing and correcting
database objects with errors. To correct objects, click the "Correct errors" button. To correct
errors you need to connect to the database. This form is shown in the figure below.
· Connect to the database server - the "Connect to the database" button. You must use
the SYSTEM user. After connecting to the database and before exiting this form,
new connections to the database server will be prohibited. To allow new
connections it is necessary in the form "Execution of SQL queries" under the user
SYSTEM to give the command
alter system disable restricted session;
· Delete main index - the "Delete main index" button. This operation frees up space in the
tablespaces to create the auxiliary index. After the removal is completed, it is
imperative to create a main index;
· Create auxiliary index - the "Create auxiliary index" button. This operation creates a
temporary index that is required for quick data deletion. This index must be deleted after
deleting the old data and before creating the main index. Creating an additional index
takes a long time;
· Define the first data - the button "Define the first data". This operation determines the
date of the first and last data and may take a long time;
· Select the date until which the primary data will be deleted - the "Delete data to:" field;
· Delete primary data - the button "Delete old data". This operation takes a long time
and its progress is displayed on the indicator at the bottom of the window. The operation
can be interrupted by the button "Abort deletion";
· Delete sub index - the "Delete sub index" button. This operation removes the auxiliary
index, freeing up space for the main index and should not take a long time;
· Create a main index - the "Create a main index" button. This operation creates the main
index and takes a long time. It is necessary to create the main index after deleting
the old data.
· Allow new connections. New connections will also be allowed upon leaving this form.
After the main index is created, the operation to delete old data is considered completed.
To perform all actions without user participation, you must select the date "Delete data to:"
and click the "Execute all operations and delete old data" button.
To call additional dispatchers (Connections, Table Spaces and Extents) use the buttons of
the same name.
The "Delete old data and reindexation" form on the "Reindexation" tab is intended
for reindexing all AlphaCENTER database data.
To re-index (re-create all indices) all the data in the AlphaCENTER database, you
must:
· Connect to the database server - the "Connect to the database" button. You must use
the SYSTEM user. After connecting to the database and before exiting this form,
new connections to the database server will be prohibited. To allow new
connections it is necessary in the form "Execution of SQL queries" under the user
SYSTEM to give the command
alter system disable restricted session;
· Reindex - Run Reindex button. This operation sequentially creates new indexes for the
data and replaces the old indexes with new ones. To cancel the operation, you must click
the "Abort Reindex" button.
· Allow new connections. New connections will also be allowed upon leaving this form.
To add a new user, click the Add User button (see figure below). In this form, you
must specify the user's role (view, maintenance, work with communications or an
administrator who has the rights to maintain and work with communications), name,
password and password confirmation. You can also specify additional information about
the user - name, department, phone number and email address. User data will also be
visible in the "Connection Manager" form.
To change the password, select a user from the list and click the "Change Password"
button. In the “Change user password” window that appears in the “Change user password”
picture, select a user and enter the old password in the “Old password” field, a new
password in the “New password” field and confirm that the new password has been entered
correctly in the Confirmation field . To change the password, click "OK".
Attention! The password must begin with a letter, i.e. password "123" does not fit, correct
password is "s123". The case of letters is not taken into account. In case of input errors, the
program will report this. If the password is successfully changed, the program informs you
about it. The new password will not be shown anywhere, so be careful when changing the
password, especially users SYS, SYSTEM and CNT.
To change user data (name, department, telephone, E-mail), click the "Change User"
button and enter new data in the "Change User Data" form.
This form is used for two purposes - creating a new table space and adding a new
data file to an existing table space. In the first case, you must specify the name of the space,
the name of the data file, its size and the autogrow property. When the “Auto-Expand”
checkbox is selected, the database server itself will increase the size of the table space / data
file if necessary.
To increase the size of an existing data file, you must:
· Select the required data file or space;
· Go to the “Tabular space (Total)” column (highlighted in pink) or click the “Increase space”
button;
· Press F2 or double click;
· In the edit box that appears, specify the new size;
· Click the "Apply" button.
To automatically correct the size of the required table spaces, click the “Make
Correction” button. Also, this operation is automatically done when performing a
backup operation.
Attention! User CNT has NO RIGHTS for working with tablespaces (adding,
resizing, etc.). To perform these operations requires user SYS or SYSTEM. You can use
the CNT user to perform the defragmentation operation. This form does not allow
you to delete a file or space - use standard Oracle tools or call technical support. The
“Connect to DB” button is used to temporarily connect another user to the database
(usually SYSTEM) to perform an operation with files / spaces.
The ability to add space / file, as well as resizing is available only when
working on the database server.
button “Connections to the database”. Over time, new sessions may appear or current ones
disappear - to update the list of sessions, click the Refresh button. Also, the current list of
sessions can be saved as a * .xls, * .html, * .xml or * .txt file - the “Save to file” button.
It is possible to forcibly disconnect the selected user from the server. It is not
recommended to do this unless absolutely necessary. To disconnect a user from the server,
you must have SYSDBA rights (for example, user SYS).
To read the HASP key via RDP, you must click the button "Allow RDP" - in this
mode, the port selection for the HASP key will be impossible and the information will be
read only for the first installed HASP key. This mode is not saved and is activated only by
pressing this button while working with the form "Information about HASP-key".
To perform the operation of replacing the LPT-key with USB, you must: