Installing WISECP

979 Aufrufe Markdown

WISECP installs through a six-step wizard in the browser. You create the database yourself beforehand; the wizard does the rest and tells you what is left to do afterwards.

Opening the Wizard

Download the package from your licence page on wisecp.com (see Choosing Your WISECP Version). Upload the files to the directory the site will be served from, then open install.php in a browser. The wizard runs on its own and does not need a working installation, so it also works on a completely empty server.

Create the database first. WISECP does not create one for you: make a database and a user in your hosting panel (cPanel, Plesk, DirectAdmin), and give that user full access to that database.

What Is on the Screen

The wizard is a full-screen dark stage with one column of content. It opens directly on the Start Setup face. That face names the server you are on (address, PHP, web server, ionCube), and Start opens the first step. A counter at the top right shows the step you are in; the language switcher sits beside it. Thin lines on the left mark progress. The Enter key moves on whenever the primary button is enabled. You can go back to a finished step; you cannot skip ahead past a step that has not passed.

1 · StartThe licence agreement. The next step stays closed until it is accepted; the language can be changed at the top right on any step.

2 · Server checkEvery server requirement with its measured value, PHP version first. Re-runnable after you fix something; the licence step stays closed until every blocking requirement passes.

3 · LicenceYour licence key, usually already inside the package. It is checked against the licence server here; the lock to your domain and server IP is written when setup completes.

4 · DatabaseConnection details, with an optional TLS section. The wizard tests the connection first, then writes the tables and shows the time elapsed.

5 · AdministratorYour own account and the site title. Four settings taken from your server and browser (panel address, country, currency, time zone) fold away under the form; open the fold to change any of them.

6 · FinishedYour addresses, and what to do next.

Fields

Database

HostDefaults to localhost. Use the host your provider gives you when the database is on another server.

PortDefaults to 3306.

Database nameThe database you created. It has to exist already.

UsernameA user with full access to that database. Limited privileges stop the installation.

PasswordThat user's password.

CA Certificate PathIn the Connect over TLS section. Path of the CA file on this server. When it is set the connection uses TLS; leave it empty for a database on the same machine. A wrong path, or a server certificate this CA did not sign, stops the test with a TLS error instead of a connection error.

Verify the Server CertificateOn whenever a CA file is set. Turn it off only for a development server with a self-signed certificate.

Administrator and Site

Full nameYour name as it appears in the panel.

EmailYour login address, and where system notifications go.

PasswordYour login password.

Admin folderThe address the management panel answers on. A suggestion is filled in; change it to something of your own.

Site titleShown on the customer-facing site and in emails.

CountrySets the defaults the rest of the installation starts from.

CurrencyYour primary currency. You can add more later.

Time zoneDetected from your browser and pre-selected; correct it if the detection is wrong.

Tasks

Install WISECP

Create the database and its user in your hosting panel, and grant that user full access.
Upload the files, open install.php, click Start on the opening face and accept the agreement.
Clear every failing requirement, then re-run the check. The PHP version comes first. The package needs PHP 8.2 or newer: switch the PHP version of the install directory or subdomain before the licence check.
Enter your licence key.
Enter the database details and continue once the connection succeeds.
Create your administrator account, set the admin folder, title, country, currency and time zone.
Note the addresses on the last step, then set up the cron job.

Result: the database is filled in, coremio/configuration/database.php is written, and the installation is stamped as established, which permanently blocks the wizard from running again.

Install From the Command Line

The wizard's steps can also be run from the command line. This helps when the server has no browser access, or when you install the same system more than once. The installation is the same one: validation, database, administrator account and settings all follow the wizard's path.

Ask whether the server is ready first. This command changes nothing.

requirement check

php install.php --check --url=https://example.com

--url is required. The command line does not know your site address. Licence verification, the panel address and generated links all come from this value. --accept is the agreement consent. It stands for the box you tick in the wizard, and the install does not start without it.

install

php install.php --install --url=https://example.com --accept \
  --license=WISECP-XXXX-XXXX-XXXX-XXXX \
  --db-name=database --db-user=user --db-pass=password \
  --admin-name="Full Name" [email protected] --admin-pass=yourpassword \
  --title="Your Site"

Result: each step is shown as it runs, and your admin panel and site addresses appear at the end. The exit code is 0 on success and 1 on failure. The admin folder is generated at random unless you set it with --admin-folder.

Finish the Setup

The last step lists what is still missing. In order: set up the cron job, enter the licence key if the check did not come back valid, add a payment method, configure email delivery, and create your first product.

Things to Watch

Check that the installer removed itself

The wizard deletes its own entry point at the end and tells you the outcome instead of doing it silently. When the delete succeeds, the last step prints “Setup files were removed from the server.” under its heading. If a file could not be deleted you get a warning card naming it instead; remove that file by hand. A reachable install.php on a live system is a real hole.

Nothing runs on schedule until you add the cron job

Invoicing, renewals, suspensions, reminders and provisioning all wait on scheduled tasks. A fresh installation with no cron entry looks healthy and quietly does nothing.

Two checks the command line cannot make

Session writing and mod_rewrite can only be measured on a real browser request, so the command line skips them. Rewriting stays unmeasured, so the URL structure falls back to the one that asks nothing of the server. Addresses then carry index.php?route=. If you know mod_rewrite works, add --rich-url=on or change it from the panel afterwards.

The wizard cannot be re-run

Once the installation is stamped, opening install.php shows a locked page instead of the first step. That is deliberate: a second run would overwrite a live configuration.

War das hilfreich?

Vielen Dank für Ihre Rückmeldung!

Brauchen Sie weitere Hilfe?

Unser Support-Team ist rund um die Uhr für Sie da, wenn Sie oben nicht fündig werden.

Kontakt aufnehmen Ticket eröffnen