Installing WISECP

194 vues 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

Upload the WISECP 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

A rail on the left lists the six steps and marks where you are. The working area on the right holds the current step. You can go back to a finished step; you cannot skip ahead past a step that has not passed.

1 · StartLanguage choice and the licence agreement. The next step stays closed until the agreement is accepted.

2 · LicenceYour licence key. The key is checked against the licence server here, not after installation.

3 · RequirementsEvery server requirement with its measured value. Re-runnable after you fix something.

4 · DatabaseConnection details. The wizard connects before letting you continue.

5 · AdministratorYour own account plus the first site settings.

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.

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, pick your language and accept the agreement.
Enter your licence key.
Clear every failing requirement, then re-run the check.
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.

Cet article vous a-t-il été utile ?

Merci pour votre retour !

Besoin d'aide supplémentaire ?

Notre équipe d'assistance est disponible 24h/24 pour tout ce que vous ne trouvez pas ci-dessus.

Nous contacter Ouvrir un ticket